agent-method 1.5.5 → 1.5.6

package/README.md

@@ -1,6 +1,6 @@
 # wwa
 
-A file-structure-first methodology for AI-agent-assisted development. Files are the interface — no proprietary tools, no vendor lock-in. Works with Claude Code, Cursor, or any agent that reads markdown.
+A file-structure-first methodology for AI-agent-assisted development. Files are the interface — no proprietary tools, no vendor lock-in. Works with Claude Code, Cursor, Gemini, Codex, or any agent that reads markdown.
 
 `ai-agents` `prompt-engineering` `developer-tools` `context-engineering` `agent-framework` `mcp` `model-context-protocol` `cursor` `claude-code`
 
@@ -10,16 +10,16 @@ A file-structure-first methodology for AI-agent-assisted development. Files are
 
 There is real stigma around AI-assisted development, and it's warranted. Most "vibe coding" produces work that no one fully understands — not the developer, not the agent, and certainly not the next person who reads the code.
 
-This project takes a different position. Three active case studies are being run to examine how development agents reason, where they lose context, and what structures keep their output connected to human-readable, auditable decisions. The methodology tracks agent behavior session over session — what worked, what was revised, what the human had to correct — and feeds that data back into improving future collaboration.
+This spec-drive development project takes a different position. Three active case studies are being run to examine how development agents reason, where they lose context, and what structures keep their output connected to human-readable, auditable decisions. The methodology tracks agent behavior session over session — what worked, what was revised, what the human had to correct — and feeds that data back into improving future collaboration.
 
-If you want to build with an agent but also want full visibility into the work being done, the decisions being made, and a path to measurably improving your agent's effectiveness over time — this is for you.
+If you want to build with an agent but also want full visibility into the work being done, the decisions being made, and a path to measurably improving your agent's effectiveness over time.
 
 ---
 
 ## Requirements
 
 - **Node.js >= 18** — [download](https://nodejs.org/)
-- **A supported AI runtime** — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Cursor](https://cursor.sh), or any agent that reads markdown files
+- **A supported AI runtime** — [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Cursor](https://cursor.sh) / Composer, [Gemini](https://gemini.google.com), [Codex](https://openai.com/index/codex/), or any agent that reads markdown
 
 ---
 
@@ -27,18 +27,19 @@ If you want to build with an agent but also want full visibility into the work b
 
 ### Quick start (recommended)
 
-One command, guided prompts:
+Install once, use everywhere:
 
 ```bash
-npx agent-method init
+npm install -g agent-method
+wwa init
 ```
 
 The installer walks you through everything:
 
 1. **Project type** — Code, Data, Analytical, Mixed, or General
 2. **Directory** — where to set up (default: current directory)
-3. **Runtime** — Claude Code, Cursor, or all (creates the right entry point)
-4. **Template tier** — Starter (7 files, most projects) or Full (11+ files, complex projects)
+3. **Runtime** — Claude Code, Cursor, or Other/All (Gemini, Codex, Composer, etc.)
+4. **Template tier** — Starter (17 files, most projects) or Full (30 files, complex projects)
 5. **Integration profile** — Standard (Sonnet, recommended), Lite (Haiku), or Full (Opus)
 
 Done. Open `PROJECT.md` and start working with your AI agent.
@@ -46,26 +47,18 @@ Done. Open `PROJECT.md` and start working with your AI agent.
 To update an existing project later:
 
 ```bash
-npx agent-method upgrade    # adds new methodology sections, never overwrites
-npx agent-method status     # check your current version
+wwa upgrade    # adds new methodology sections, never overwrites
+wwa status     # check your current version
 ```
 
 <details>
-<summary><strong>Install globally</strong> — skip <code>npx</code> each time</summary>
-
-```bash
-npm install -g agent-method
-```
-
-After this, use `wwa` directly:
+<summary><strong>Zero-install</strong> — no global install needed</summary>
 
 ```bash
-wwa init
-wwa check
-wwa status
+npx agent-method init
 ```
 
-Both `wwa` and `agent-method` work as command names.
+Runs directly via npx without installing anything. Useful for one-time setup or CI.
 
 </details>
 
@@ -76,16 +69,16 @@ Specify everything on the command line (no prompts):
 
 ```bash
 # Full options
-npx agent-method init code ~/my-project --runtime claude --tier starter --profile standard
+wwa init code ~/my-project --runtime claude --tier starter --profile standard
 
 # Just type and directory (defaults for the rest)
-npx agent-method init code ~/my-project
+wwa init code ~/my-project
 
 # Data project for Cursor
-npx agent-method init data ~/my-data --runtime cursor
+wwa init data ~/my-data --runtime cursor
 
 # Analytical project with full methodology
-npx agent-method init context ~/my-analysis --tier full --profile full
+wwa init context ~/my-analysis --tier full --profile full
 ```
 
 **Options:**
@@ -95,6 +88,7 @@ npx agent-method init context ~/my-analysis --tier full --profile full
 | `--runtime` | `claude`, `cursor`, `all` | `all` |
 | `--tier` | `starter`, `full` | `starter` |
 | `--profile` | `lite`, `standard`, `full` | `standard` |
+| `--onboarding` | `greenfield`, `brownfield`, `auto` | `auto` |
 
 </details>
 
@@ -136,7 +130,7 @@ Interactive — asks project name, type, runtime, tier, lifecycle, and profile.
 ## Verify
 
 ```bash
-npx agent-method check
+wwa check
 ```
 
 Validates your entry point, auto-detects project type, and reports any issues.
@@ -146,13 +140,13 @@ Validates your entry point, auto-detects project type, and reports any issues.
 ## Staying Updated
 
 ```bash
-npx agent-method upgrade
+wwa upgrade
 ```
 
 Brownfield-safe — appends new methodology sections without overwriting your customizations.
 
 ```bash
-npx agent-method status    # check your current version
+wwa status    # check your current version
 ```
 
 ---
@@ -161,13 +155,21 @@ npx agent-method status    # check your current version
 
 | Command | What it does |
 |---------|-------------|
-| `wwa init` | Set up a new project (interactive) |
+| `wwa init` | Set up a new project (interactive — copies templates, feature registry, creates doc-tokens) |
 | `wwa check` | Validate your entry point |
 | `wwa scan` | Detect project type from directory contents |
 | `wwa route "<query>"` | Show how a query routes through the pipeline |
+| `wwa plan` | Display current plan status from PLAN.md |
+| `wwa implement` | Show implementation guidance for current step |
+| `wwa review` | Display project review dashboard |
+| `wwa digest` | Show management digest |
+| `wwa close` | Session close checklist, project snapshot, updates .context/doc-tokens.yaml |
 | `wwa refine` | Extract refinement report from SESSION-LOG.md |
+| `wwa casestudy` | Extract case study with project tokens + methodology reference data |
+| `wwa docs` | Show docs coverage report from .context/DOCS-MAP.md |
 | `wwa status` | Check if your methodology version is current |
 | `wwa upgrade` | Brownfield-safe methodology update |
+| `wwa completion` | Generate shell tab-completion (bash/zsh/fish/PowerShell) |
 | `wwa serve` | Start MCP server for IDE integration |
 | `wwa watch` | Watch files, validate on save |
 
@@ -182,8 +184,8 @@ Add to your IDE's MCP config (VS Code, Cursor, Claude Code, Cline):
 {
   "mcpServers": {
     "wwa": {
-      "command": "npx",
-      "args": ["agent-method", "serve"]
+      "command": "wwa",
+      "args": ["serve"]
     }
   }
 }
@@ -233,9 +235,22 @@ your-project/
   STATE.md              # Decisions, blockers, current position
   ROADMAP.md            # Phase breakdown with gate criteria
   PLAN.md               # Current task with verification criteria
+  SUMMARY.md            # Session audit trail
+  SESSION-LOG.md        # Session metrics for case study data
   .context/
     BASE.md             # Core context — always loaded with entry point
     METHODOLOGY.md      # Workflows, conventions overflow
+    feature-registry.yaml  # Feature registry (populated from package)
+    doc-tokens.yaml        # Project metrics (updated by wwa close)
+  Management/
+    DIGEST.md           # High-effort task digest for managers
+    STATUS.md           # Project health snapshot
+  Reviews/
+    INDEX.md            # Project intelligence dashboard
+  agentWorkflows/
+    INDEX.md            # Agent workflow performance overview
+  intro/
+    README.md           # Methodology overview + link to full docs
 ```
 
 <details>
@@ -243,18 +258,27 @@ your-project/
 
 ```
   REQUIREMENTS.md       # Formal requirements with traceability
-  SUMMARY.md            # Session audit trail
   .context/
     REGISTRY.md         # Navigation registry for large projects
-  docs/
-    index.md            # Documentation hub
+    COMPOSITION.md      # Specialist template for analytical projects
+  Reviews/
+    roadmap.md          # Phase progress synthesis
+    plan.md             # Plan execution history
+    project.md          # Project scope evolution
+    requirements.md     # Requirements traceability matrix
+    state.md            # Decision trends and blocker analysis
+    backlog.md          # Backlog health and aging
+  agentWorkflows/
+    sessions.md         # Session analysis from SESSION-LOG.md
+    patterns.md         # Extracted behavioral patterns
+    observations.md     # Case study observations
   todos/
     backlog.md          # Ideas and future work
 ```
 
 </details>
 
-Every file ships with **inline instructions** — the agent reads them and helps you populate each section.
+Every file ships with **inline instructions** — the agent reads them and helps you populate each section. The agent also creates `.context/DOCS-MAP.md` during your first session to map project components to documentation files.
 
 ---
 
@@ -291,9 +315,9 @@ Existing solutions tie you to specific agent runtimes through CLI tools and slas
 
 | Profile | Best for | What's included |
 |---------|----------|-----------------|
-| **Lite** | Haiku, simple projects | STATE.md, minimal rules, 2 cascade rules |
-| **Standard** | Sonnet (recommended) | + PLAN.md, context pairing, 6 cascade rules |
-| **Full** | Opus, complex projects | All rules inline, all intelligence layer files |
+| **Lite** | Haiku, GPT-3.5, Gemini Flash | STATE.md, minimal rules, 2 cascade rules |
+| **Standard** | Sonnet, GPT-4, Gemini Pro, Codex (recommended) | + PLAN.md, context pairing, 6 cascade rules |
+| **Full** | Opus, o1, Gemini Ultra | All rules inline, all intelligence layer files |
 
 Three rules followed consistently beat ten rules followed inconsistently.
 
@@ -328,8 +352,10 @@ Three rules followed consistently beat ten rules followed inconsistently.
 | File | Runtime | Auto-loaded? |
 |------|---------|:------------:|
 | `CLAUDE.md` | Claude Code | Yes |
-| `.cursorrules` | Cursor | Yes |
-| `AGENT.md` | Any agent | No (paste or reference manually) |
+| `.cursorrules` | Cursor / Cursor Composer | Yes |
+| `AGENT.md` | Gemini, Codex, Cline, Aider, or any agent that reads markdown | No (paste or reference manually) |
+
+The methodology is **agent-agnostic**. `AGENT.md` works with any AI assistant — copy its contents into your tool's system prompt or context window. The file format is standard markdown; no runtime-specific features are required.
 
 </details>
 
@@ -341,6 +367,8 @@ Three rules followed consistently beat ten rules followed inconsistently.
 |----------|----------|
 | [Quick start guide](docs/guides/quick-start.md) | Setup and first session |
 | [For developers](docs/guides/for-developers.md) | Workflows, context, troubleshooting |
+| [CLI tools reference](docs/guides/for-developers/cli-tools.md) | All 22 commands with examples |
+| [Command reference](docs/guides/for-developers/command-reference.md) | Tabular quick-lookup by project type |
 | [MCP Integration](docs/guides/mcp-integration.md) | IDE integration (VS Code, Cursor, Claude Code, Cline) |
 | [For managers](docs/guides/for-managers.md) | Reading project status from methodology files |
 | [Template kit](templates/README.md) | Template tiers, extensions, bootstrapping |

package/bin/wwa.js

@@ -6,7 +6,8 @@
  * Thin entry point: each command is registered from lib/cli/*.js modules.
  *
  * Three-tier command structure:
- *   Tier 1 (developer):  check, scan, route, refine, status, upgrade, init
+ *   Tier 1 (developer):  check, scan, route, refine, status, upgrade, init,
+ *                        plan, implement, review, digest, close
  *   Tier 2 (pipeline):   wwa pipeline classify/select/resolve/cascade/test
  *   Tier 3 (server):     serve (MCP server), watch (file watcher)
  */
@@ -21,9 +22,17 @@ import { register as refine } from "../lib/cli/refine.js";
 import { register as status } from "../lib/cli/status.js";
 import { register as upgrade } from "../lib/cli/upgrade.js";
 import { register as init } from "../lib/cli/init.js";
+import { register as planCmd } from "../lib/cli/plan.js";
+import { register as implementCmd } from "../lib/cli/implement.js";
+import { register as reviewCmd } from "../lib/cli/review.js";
+import { register as digestCmd } from "../lib/cli/digest.js";
+import { register as closeCmd } from "../lib/cli/close.js";
 import { register as pipeline } from "../lib/cli/pipeline.js";
 import { register as serve } from "../lib/cli/serve.js";
 import { register as watchCmd } from "../lib/cli/watch.js";
+import { register as completionCmd } from "../lib/cli/completion.js";
+import { register as casestudyCmd } from "../lib/cli/casestudy.js";
+import { register as docsCmd } from "../lib/cli/docs.js";
 
 const program = new Command();
 
@@ -32,13 +41,20 @@ program
   .description(
     "Methodology tools for AI-agent-assisted development.\n\n" +
       "Developer commands:\n" +
-      "  check     Validate your entry point and project setup\n" +
-      "  scan      Detect project type from directory contents\n" +
-      "  route     Show how a query routes through the pipeline\n" +
-      "  refine    Extract a refinement report from session history\n" +
-      "  status    Check if your methodology version is current\n" +
-      "  upgrade   Update your project to the latest methodology\n" +
-      "  init      Set up a new project with methodology templates\n\n" +
+      "  check       Validate your entry point and project setup\n" +
+      "  scan        Detect project type from directory contents\n" +
+      "  route       Show how a query routes through the pipeline\n" +
+      "  refine      Extract a refinement report from session history\n" +
+      "  status      Check if your methodology version is current\n" +
+      "  upgrade     Update your project to the latest methodology\n" +
+      "  init        Set up a new project with methodology templates\n" +
+      "  plan        Display current plan status from PLAN.md\n" +
+      "  implement   Show implementation guidance for current step\n" +
+      "  review      Display project review dashboard\n" +
+      "  digest      Show management digest\n" +
+      "  close       Session close checklist and cascade reminders\n" +
+      "  casestudy   Extract structured case study from project files\n" +
+      "  docs        Show docs coverage report from DOCS-MAP.md\n\n" +
       "Pipeline commands (advanced):\n" +
       "  pipeline classify   Classify a query against registry patterns\n" +
       "  pipeline select     Select workflow for a query type\n" +
@@ -47,7 +63,9 @@ program
       "  pipeline test       Run YAML test fixtures\n\n" +
       "Server commands:\n" +
       "  serve               Start MCP server on stdio transport\n" +
-      "  watch               Watch files and validate on change"
+      "  watch               Watch files and validate on change\n\n" +
+      "Shell completion:\n" +
+      "  completion          Generate tab-completion for bash/zsh/fish/powershell"
   )
   .version(pkg.version, "-V, --version");
 
@@ -59,8 +77,16 @@ refine(program);
 status(program);
 upgrade(program);
 init(program);
+planCmd(program);
+implementCmd(program);
+reviewCmd(program);
+digestCmd(program);
+closeCmd(program);
 pipeline(program);
 serve(program);
 watchCmd(program);
+completionCmd(program);
+casestudyCmd(program);
+docsCmd(program);
 
 program.parse();