@wbern/claude-instructions 2.2.0 → 2.3.0

package/README.md

@@ -145,10 +145,10 @@ flowchart TB
     Start --> Step1[<b>1. PLAN</b>]
 
     Step1 --> Issue[📋 /issue<br/>Have GitHub issue<br/><i>Requires: GitHub MCP</i>]
-    Step1 --> Plan[📝 /plan<br/>No issue yet<br/><i>Optional: Beads MCP</i>]
+    Step1 --> CreateIssues[📝 /create-issues<br/>No issue yet<br/><i>Optional: Beads MCP</i>]
 
     Issue --> Step2[<b>2. CODE with TDD</b>]
-    Plan --> Step2
+    CreateIssues --> Step2
 
     Step2 -->|Manual| Red[🔴 /red<br/>Write failing test]
     Red --> Green[🟢 /green<br/>Make it pass]
@@ -186,7 +186,7 @@ flowchart TB
 ### Planning
 
 - `/issue` - Analyze GitHub issue and create TDD implementation plan
-- `/plan` - Create implementation plan from feature/requirement with PRD-style discovery and TDD acceptance criteria
+- `/create-issues` - Create implementation plan from feature/requirement with PRD-style discovery and TDD acceptance criteria
 
 ### Test-Driven Development
 

package/bin/cli.js

@@ -1336,9 +1336,15 @@ async function main(args) {
 
 If Claude Code is already running, restart it to pick up the new commands.
 
-Try it out: /red clicking submit with empty email shows validation error
+Try it out:
 
-Happy TDD'ing!`
+  /kata                  \u2192 Pick a practice challenge
+  /red 1 returns "1"     \u2192 Write first failing test for your kata
+  /green                 \u2192 Make it pass
+
+See a full example: https://github.com/wbern/claude-instructions#example-conversations
+
+Happy coding!`
   );
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wbern/claude-instructions",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "TDD workflow commands for Claude Code CLI",
   "type": "module",
   "bin": "./bin/cli.js",
@@ -29,7 +29,7 @@
   "scripts": {
     "build": "pnpm build:readme && pnpm build:commands && pnpm exec markdownlint --fix .claude/commands/*.md",
     "build:readme": "tsx scripts/build.ts",
-    "build:commands": "pnpm build:cli && node bin/cli.js --scope=project --flags=beads,no-plan-files --include-contrib-commands --overwrite",
+    "build:commands": "pnpm build:cli && rm -f .claude/commands/*.md && node bin/cli.js --scope=project --flags=beads,no-plan-files --include-contrib-commands --overwrite",
     "build:cli": "tsup",
     "test:manual": "pnpm build:cli && TMPDIR=$(mktemp -d) && pnpm pack --pack-destination $TMPDIR && cd $TMPDIR && tar -xzf *.tgz && cd package && pnpm i && node bin/cli.js",
     "test:quick-manual": "pnpm build:cli && node bin/cli.js",
@@ -45,6 +45,7 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.1",
+    "@semantic-release/git": "^10.0.1",
     "@types/fs-extra": "^11.0.4",
     "@types/node": "^24.10.1",
     "@vitest/coverage-v8": "^4.0.15",
@@ -57,6 +58,7 @@
     "markdownlint-cli": "^0.46.0",
     "picocolors": "^1.1.1",
     "prettier": "^3.7.2",
+    "semantic-release": "^25.0.2",
     "tsup": "^8.5.1",
     "tsx": "^4.20.6",
     "typescript": "^5.9.3",
@@ -77,7 +79,16 @@
       "@semantic-release/commit-analyzer",
       "@semantic-release/release-notes-generator",
       "@semantic-release/npm",
-      "@semantic-release/github"
+      "@semantic-release/github",
+      [
+        "@semantic-release/git",
+        {
+          "assets": [
+            "package.json"
+          ],
+          "message": "chore(release): ${nextRelease.version}"
+        }
+      ]
     ]
   }
 }

package/src/README.md

@@ -135,10 +135,10 @@ flowchart TB
     Start --> Step1[<b>1. PLAN</b>]
 
     Step1 --> Issue[📋 /issue<br/>Have GitHub issue<br/><i>Requires: GitHub MCP</i>]
-    Step1 --> Plan[📝 /plan<br/>No issue yet<br/><i>Optional: Beads MCP</i>]
+    Step1 --> CreateIssues[📝 /create-issues<br/>No issue yet<br/><i>Optional: Beads MCP</i>]
 
     Issue --> Step2[<b>2. CODE with TDD</b>]
-    Plan --> Step2
+    CreateIssues --> Step2
 
     Step2 -->|Manual| Red[🔴 /red<br/>Write failing test]
     Red --> Green[🟢 /green<br/>Make it pass]

package/src/sources/_contribute-a-command.md

@@ -9,6 +9,12 @@ _order: 99
 <!-- docs INCLUDE path='src/fragments/universal-guidelines.md' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
+<!-- /docs -->
+
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 Create a new custom command in `src/sources/` following the patterns below. Assess the structure carefully using the below info but also researching the repo.
 
 Command to create: $ARGUMENTS

package/src/sources/add-command.md

@@ -12,6 +12,9 @@ _order: 3
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 # Slash Command Creator Guide
 
 ## How This Command Works

package/src/sources/ask.md

@@ -15,6 +15,9 @@ _selectedByDefault: false
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 **Ship/Show/Ask Pattern - ASK**
 
 Ask is for complex changes that need team discussion and approval. Examples:

package/src/sources/beepboop.md

@@ -16,6 +16,9 @@ Execute the user's requested task (e.g., posting PR comments, GitHub issue comme
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 ## Instructions
 
 Arguments: $ARGUMENTS

package/src/sources/busycommit.md

@@ -12,6 +12,9 @@ _order: 2
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 Create multiple atomic git commits, committing the smallest possible logical unit at a time
 
 Include any of the following info if specified: $ARGUMENTS

package/src/sources/code-review.md

@@ -19,6 +19,9 @@ _requested-tools:
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 # Code Review
 
 Perform a code review using dynamic category detection.

package/src/sources/{plan.md → create-issues.md}

@@ -1,12 +1,12 @@
 ---
 description: Create implementation plan from feature/requirement with PRD-style discovery and TDD acceptance criteria
 argument-hint: <feature/requirement description or GitHub issue URL/number>
-_hint: Plan feature
+_hint: Create issues
 _category: Planning
 _order: 2
 ---
 
-# Plan: PRD-Informed Task Planning for TDD
+# Create Issues: PRD-Informed Task Planning for TDD
 
 Create structured implementation plan that bridges product thinking (PRD) with test-driven development.
 
@@ -16,11 +16,14 @@ Create structured implementation plan that bridges product thinking (PRD) with t
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 ## Input
 
 $ARGUMENTS
 
-(If no input provided, check conversation context<!-- docs INCLUDE path='src/fragments/plan-beads-context-hint.md' featureFlag='beads' -->
+(If no input provided, check conversation context<!-- docs INCLUDE path='src/fragments/create-issues-beads-context-hint.md' featureFlag='beads' -->
 <!-- /docs -->)
 
 ## Input Processing
@@ -69,7 +72,7 @@ Extract from GitHub issue:
 <!-- docs INCLUDE path='src/fragments/discovery-phase.md' -->
 <!-- /docs -->
 
-<!-- docs INCLUDE path='src/fragments/plan-beads-details.md' featureFlag='beads' -->
+<!-- docs INCLUDE path='src/fragments/create-issues-beads-details.md' featureFlag='beads' -->
 <!-- /docs -->
 
 ## Key Principles
@@ -89,7 +92,7 @@ Extract from GitHub issue:
 
 ## Integration with Other Commands
 
-- **Before /plan**: Use `/spike` if you need technical exploration first
-- **After /plan**: Use `/red` to start TDD on first task
-<!-- docs INCLUDE path='src/fragments/plan-beads-integration.md' featureFlag='beads' -->
+- **Before /create-issues**: Use `/spike` if you need technical exploration first
+- **After /create-issues**: Use `/red` to start TDD on first task
+<!-- docs INCLUDE path='src/fragments/create-issues-beads-integration.md' featureFlag='beads' -->
 <!-- /docs -->

package/src/sources/cycle.md

@@ -16,6 +16,9 @@ $ARGUMENTS
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 <!-- docs INCLUDE path='src/fragments/fallback-arguments-beads.md' featureFlag='beads' elsePath='src/fragments/fallback-arguments.md' -->
 <!-- /docs -->
 

package/src/sources/gap.md

@@ -12,6 +12,9 @@ _order: 11
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 Analyze the current conversation context and identify things that have not yet been addressed. Look for:
 
 1. **Incomplete implementations** - Code that was started but not finished

package/src/sources/green.md

@@ -16,6 +16,9 @@ $ARGUMENTS
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 <!-- docs INCLUDE path='src/fragments/fallback-arguments-beads.md' featureFlag='beads' elsePath='src/fragments/fallback-arguments.md' -->
 <!-- /docs -->
 

package/src/sources/issue.md

@@ -14,6 +14,9 @@ Analyze GitHub issue and create TDD implementation plan.
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 Process:
 
 1. Get Issue Number

package/src/sources/kata.md

@@ -22,6 +22,9 @@ Generate a complete TDD practice setup:
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 ## Input
 
 $ARGUMENTS

package/src/sources/pr.md

@@ -14,6 +14,9 @@ _order: 5
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 Create a pull request for the current branch using GitHub MCP tools.
 
 ## Workflow

package/src/sources/red.md

@@ -16,6 +16,9 @@ $ARGUMENTS
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 <!-- docs INCLUDE path='src/fragments/fallback-arguments-beads.md' featureFlag='beads' elsePath='src/fragments/fallback-arguments.md' -->
 <!-- /docs -->
 

package/src/sources/refactor.md

@@ -14,6 +14,9 @@ Apply this document (specifically the Refactor phase), to the info given by user
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 <!-- docs INCLUDE path='src/fragments/fallback-arguments-beads.md' featureFlag='beads' elsePath='src/fragments/fallback-arguments.md' -->
 <!-- /docs -->
 

package/src/sources/ship.md

@@ -15,6 +15,9 @@ _selectedByDefault: false
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 **Ship/Show/Ask Pattern - SHIP**
 
 Ship is for small, obvious changes that don't need code review. Examples:

package/src/sources/show.md

@@ -15,6 +15,9 @@ _selectedByDefault: false
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 **Ship/Show/Ask Pattern - SHOW**
 
 Show is for changes that teammates should see, but don't require approval. Examples:

package/src/sources/spike.md

@@ -16,6 +16,9 @@ $ARGUMENTS
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 <!-- docs INCLUDE path='src/fragments/fallback-arguments-beads.md' featureFlag='beads' elsePath='src/fragments/fallback-arguments.md' -->
 <!-- /docs -->
 

package/src/sources/summarize.md

@@ -12,6 +12,9 @@ _order: 10
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 Create a concise summary of the current conversation suitable for transferring context to a new conversation.
 
 Additional info: $ARGUMENTS

package/src/sources/tdd-review.md

@@ -12,6 +12,9 @@ _order: 45
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 <!-- docs INCLUDE path='src/fragments/fallback-arguments-beads.md' featureFlag='beads' elsePath='src/fragments/fallback-arguments.md' -->
 <!-- /docs -->
 

package/src/sources/tdd.md

@@ -14,6 +14,9 @@ _order: 1
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 <!-- docs INCLUDE path='src/fragments/tdd-fundamentals.md' -->
 <!-- /docs -->
 

package/src/sources/worktree-add.md

@@ -14,6 +14,9 @@ _order: 1
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 Create a new git worktree for branch: $ARGUMENTS
 
 <current_state>

package/src/sources/worktree-cleanup.md

@@ -14,6 +14,9 @@ _order: 2
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
+<!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
+<!-- /docs -->
+
 Clean up merged worktrees by finding the oldest merged branch, consolidating settings, and removing stale worktrees.
 
 Additional info: $ARGUMENTS