enhanced-agentic-flow

Enhanced Agentic Flow (EAF)

Master plugin for building software products with Claude Code. Fuses two ideas:

• ICM (Interpreted Context Methodology) — filesystem-as-orchestration. Numbered stage folders carry the workflow shape.
• addyosmani/agent-skills — 22 lifecycle skills encoding senior-engineer practices.

EAF gives you the stages (workspace). The vendored skills give you the playbook. Stage CONTEXT.md files dispatch the right skills at the right phase.

What you get

When you scaffold a project (/eaf-init my-app or npx create-eaf-app my-app), you get:

my-app/
├── CLAUDE.md                    # L0 — always-loaded invariants
├── CONTEXT.md                   # L1 — workspace routing
├── shared/_config/              # L3 — cross-cutting config (tech stack, style, cross-cutting skills)
├── stages/
│   ├── 00-define/   (interview-me, idea-refine)
│   ├── 01-plan/     (spec, planning, api-design)
│   ├── 02-build/    (incremental, TDD, source-driven, frontend)
│   ├── 03-verify/   (browser-testing, debugging)
│   ├── 04-review/   (quality, simplify, security, perf)
│   ├── 05-ship/     (git, ci/cd, launch, ADRs)
│   └── 06-operate/  (deprecation-and-migration — steady state)
└── .eaf/state.json              # stage pointer + handoff history

Each stage has its own CONTEXT.md (the dispatcher), references/ (inputs), and output/ (formal handoff artifacts for the next stage).

Install

As a Claude Code plugin

/plugin marketplace add liam-ai-reality/enhanced-agentic-flow
/plugin install enhanced-agentic-flow@enhanced-agentic-flow

Then in any new directory:

/eaf-init my-app

As a standalone npm CLI

npx create-eaf-app my-app
# or
npx --prefix /path/to/enhanced-agentic-flow create-eaf-app my-app

This works without Claude Code; the resulting directory is meant to be opened in Claude Code afterward.

Slash commands

Command	What it does
/eaf-init <name>	Scaffold a new project tree.
/eaf-stage [N]	Enter stage N (or current). Loads L0+L1+L2 context and lists skills.
/eaf-handoff [--back NN]	Advance to the next stage (or roll back). Validates exit criteria + outputs.
/eaf-status	Show current stage, exit-criteria progress, recent handoffs.

How a project flows

1. npx create-eaf-app my-app && cd my-app
2. Open in Claude Code. Run /eaf-stage 0. Agent loads CLAUDE.md + CONTEXT.md + stages/00-define/CONTEXT.md, then invokes interview-me.
3. Produce stages/00-define/output/CONCEPT.md. Tick exit-criteria. /eaf-handoff.
4. State advances to 01-plan. stages/01-plan/references/00-define-output is symlinked to ../00-define/output/.
5. Repeat through 06-operate. Use /eaf-handoff --back 01-plan if you need to revisit.

Cross-cutting skills

Some skills aren't stage-bound — they auto-fire when triggers match:

• context-engineering (always, via L0)
• doubt-driven-development (confidence checks)
• code-simplification (post-edit in stages 02, 04)
• security-and-hardening (auth/crypto/secrets file globs)
• debugging-and-error-recovery (first test failure)

See skills/eaf-scaffold-project/templates/shared/_config/cross-cutting.md and hooks/stage-transition.json.

Skill provenance

22 lifecycle skills + 1 meta (using-agent-skills) are vendored from addyosmani/agent-skills (MIT). The 24th skill, eaf-scaffold-project, is EAF-native. See references/skills-provenance.md for the upstream commit SHA and re-sync procedure.

Tests

npm test

Runs tests/scaffold.spec.js, which scaffolds into a temp dir and asserts the tree shape matches references/scaffolded-tree.md.

License

MIT.