@wbern/claude-instructions 1.20.0 → 2.0.0

package/README.md

@@ -26,7 +26,9 @@ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
        "\       "      \X/      "       /"
 ```
 
-TDD workflow commands for Claude Code CLI.
+**TDD workflow commands for Claude Code CLI.**
+
+Test-Driven Development (TDD) gives you structure and confidence—a discipline proven by decades of practitioners from Extreme Programming to modern teams. These commands let Claude do the typing while you do the thinking.
 
 ## Installation
 
@@ -72,7 +74,6 @@ This ensures commands are regenerated whenever anyone runs `npm install`, `pnpm
 
 | Option | Description |
 |--------|-------------|
-| `--variant=with-beads` | Command variant (with-beads, without-beads) |
 | `--scope=project` | Installation scope (project, user) |
 | `--prefix=my-` | Add prefix to command names |
 | `--commands=commit,red,green` | Install only specific commands |
@@ -80,6 +81,7 @@ This ensures commands are regenerated whenever anyone runs `npm install`, `pnpm
 | `--update-existing` | Only update already-installed commands |
 | `--overwrite` | Overwrite conflicting files without prompting |
 | `--skip-on-conflict` | Skip conflicting files without prompting |
+| `--flags=beads,github` | Enable feature flags (beads, github, gitlab, etc.) |
 | `--help, -h` | Show help message |
 | `--version, -v` | Show version number |
 
@@ -134,7 +136,7 @@ Only the first file found is used.
 
 ### Main Workflow
 
-Follow this workflow from planning to shipping:
+This is the core TDD workflow. Additional utility commands (worktrees, spikes, etc.) are listed in [Available Commands](#available-commands) below.
 
 ```mermaid
 flowchart TB
@@ -179,28 +181,6 @@ flowchart TB
     style Done fill:#c8e6c9
 ```
 
-### Other Commands
-
-Available anytime during your workflow:
-
-```mermaid
-flowchart TB
-    Utils[<b>UTILITIES</b>]
-    Utils --> Spike[🔬 /spike<br/>Exploratory coding before TDD]
-    Utils --> TDD[📚 /tdd<br/>Remind agent about TDD]
-    Utils --> AddCommand[➕ /add-command<br/>Create custom commands]
-    Utils --> Summarize[📄 /summarize<br/>Summarize conversation<br/><i>Optional: Beads MCP</i>]
-    Utils --> Gap[🔍 /gap<br/>Find unaddressed items<br/><i>Optional: Beads MCP</i>]
-    Utils --> Beepboop[🤖 /beepboop<br/>AI attribution]
-
-    Worktree[<b>WORKTREE MANAGEMENT</b>]
-    Worktree --> WorktreeAdd[➕ /worktree-add<br/>Create new worktree<br/><i>Requires: GitHub MCP</i>]
-    Worktree --> WorktreeCleanup[🧹 /worktree-cleanup<br/>Clean up merged worktrees<br/><i>Requires: GitHub MCP</i>]
-
-    style Utils fill:#fff9c4
-    style Worktree fill:#f3e5f5
-```
-
 ## Available Commands
 
 ### Planning