eawf — Eä Workflow

State-first, agent-driven development framework. Parallel waves, strict schema, Claude Code adapter.

Install

git clone <repo> && cd eawf && uv sync
# or, install as a tool from the local checkout:
uv tool install --from . eawf

Quickstart (new project)

cd /path/to/your/repo
eawf init                            # interactive wizard
eawf plugin install claude           # render local .claude/ skills/agents/hooks
eawf phase open --auto --title "Bootstrap"

Workflow

research → plan → execute (parallel waves) → cherry-pick → ship phase

Use slash commands /research, /prep, /audit, /ship, /review, /polish, or /flow to drive the lifecycle.

What gets committed

• .ea/state.json — canonical project ledger (only mutator: eawf state CLI).
• AGENTS.md — agent contract (regenerated by eawf sync; user region preserved on re-render).

The Claude Code plugin tree (.claude/ + CLAUDE.md) and any user-local files (.claude/settings.local.json) stay gitignored — they are machine-specific renders, not committed assets. Re-render anytime via eawf plugin install claude.

Suggested setup (Claude Code users)

Pick one mode — running both at once makes Claude Code see every skill / agent / hook twice (CC dedups by name; active body is undefined). eawf plugin install claude detects an existing marketplace install under ~/.claude/plugins/ and prompts before proceeding; pass --force to acknowledge a duplicate render.

Project-local mode (renders into the working repo; ideal when dogfooding eawf or working only on one project):

eawf plugin install claude    # render local skills/agents/hooks
eawf doctor                   # readiness checks
eawf plugin doctor claude     # local drift check

Marketplace mode (portable install, ideal when using eawf across many repos; emits the skills + agents + six session-level hooks SessionStart / Stop / Pre/PostToolUse filtered to bash git commit/git push):

eawf plugin package claude --target ./build/eawf-plugin

Then in Claude Code:

/plugin marketplace add ./build/eawf-plugin
/plugin install eawf@eawf-local

Other harnesses

eawf plugin install also supports two non-Claude harnesses; no package step is needed because neither has a marketplace concept — the renderer writes directly into the workspace root:

eawf plugin install codex      # writes .codex/{skills,agents,hooks}/ + config.toml
eawf plugin install opencode   # writes opencode.json (managed block) + plugin.js
eawf plugin doctor codex       # codex drift check
eawf plugin doctor opencode    # opencode drift check

plugin update is currently Claude-only; codex / opencode update support ships in v0.4.

Verify

uv run pytest
uv run pre-commit run --all-files
uv run mypy src/

Docs

See docs/ — architecture, CLI surface, schemas, policy.

License

MIT — see LICENSE.