@wbern/claude-instructions 2.2.1 → 2.4.0

package/README.md

@@ -82,6 +82,7 @@ This ensures commands are regenerated whenever anyone runs `npm install`, `pnpm
 | `--overwrite` | Overwrite conflicting files without prompting |
 | `--skip-on-conflict` | Skip conflicting files without prompting |
 | `--flags=beads,github` | Enable feature flags (beads, github, gitlab, etc.) |
+| `--allowed-tools=Bash(git diff:*),Bash(git status:*)` | Pre-approve tools for commands (non-interactive mode) |
 | `--help, -h` | Show help message |
 | `--version, -v` | Show version number |
 
@@ -145,10 +146,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]
@@ -173,12 +174,6 @@ flowchart TB
     Ship --> Done([✅ Done])
     Show --> Done
     Ask --> Done
-
-    style Start fill:#e1f5ff
-    style Step1 fill:#fff4e6
-    style Step2 fill:#e8f5e9
-    style Step3 fill:#fce4ec
-    style Done fill:#c8e6c9
 ```
 
 ## Available Commands
@@ -186,7 +181,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

@@ -523,6 +523,13 @@ var CLI_OPTIONS = [
     description: "Enable feature flags (beads, github, gitlab, etc.)",
     example: "--flags=beads,github"
   },
+  {
+    flag: "--allowed-tools",
+    key: "allowedTools",
+    type: "array",
+    description: "Pre-approve tools for commands (non-interactive mode)",
+    example: "--allowed-tools=Bash(git diff:*),Bash(git status:*)"
+  },
   {
     flag: "--include-contrib-commands",
     key: "includeContribCommands",
@@ -1140,6 +1147,7 @@ async function main(args) {
     commandPrefix = args.prefix ?? "";
     selectedCommands = args.commands;
     selectedFlags = args.flags ? v2.parse(FlagsSchema, args.flags) : void 0;
+    selectedAllowedTools = args.allowedTools;
     if (args.updateExisting) {
       cachedExistingFiles = await checkExistingFiles(void 0, scope, {
         commandPrefix: commandPrefix || "",
@@ -1331,14 +1339,44 @@ async function main(args) {
     includeContribCommands: args?.includeContribCommands
   });
   const fullPath = scope === "project" ? `${process.cwd()}/.claude/commands` : `${os2.homedir()}/.claude/commands`;
+  const isInteractiveMode = !args?.scope;
+  let automationNote = "";
+  if (isInteractiveMode) {
+    const parts = ["npx @wbern/claude-instructions"];
+    parts.push(`--scope=${scope}`);
+    if (commandPrefix) {
+      parts.push(`--prefix=${commandPrefix}`);
+    }
+    if (selectedFlags && selectedFlags.length > 0) {
+      parts.push(`--flags=${selectedFlags.join(",")}`);
+    }
+    if (selectedCommands && selectedCommands.length > 0) {
+      parts.push(`--commands=${selectedCommands.join(",")}`);
+    }
+    if (selectedAllowedTools && selectedAllowedTools.length > 0) {
+      parts.push(
+        `--allowed-tools=${selectedAllowedTools.join(",")}`
+      );
+    }
+    automationNote = `
+
+To automate this setup:
+  ${parts.join(" ")}`;
+  }
   outro(
     `Installed ${result.filesGenerated} commands to ${fullPath}
 
 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:
+
+  /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${automationNote}
 
-Happy TDD'ing!`
+Happy coding!`
   );
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wbern/claude-instructions",
-  "version": "2.2.1",
+  "version": "2.4.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]
@@ -163,12 +163,6 @@ flowchart TB
     Ship --> Done([✅ Done])
     Show --> Done
     Ask --> Done
-
-    style Start fill:#e1f5ff
-    style Step1 fill:#fff4e6
-    style Step2 fill:#e8f5e9
-    style Step3 fill:#fce4ec
-    style Done fill:#c8e6c9
 ```
 
 ## Available Commands

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.
 
@@ -23,7 +23,7 @@ Create structured implementation plan that bridges product thinking (PRD) with t
 
 $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
@@ -72,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
@@ -92,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 -->