@wbern/claude-instructions 2.9.0 → 2.9.1

package/README.md

@@ -78,7 +78,7 @@ Then add a postinstall script to your `package.json`:
     "postinstall": "claude-instructions --scope=project --overwrite"
   },
   "devDependencies": {
-    "@wbern/claude-instructions": "^2.9.0"
+    "@wbern/claude-instructions": "^2.9.1"
   }
 }
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wbern/claude-instructions",
-  "version": "2.9.0",
+  "version": "2.9.1",
   "description": "TDD workflow commands for Claude Code CLI",
   "type": "module",
   "bin": "./bin/cli.js",

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

@@ -17,7 +17,11 @@ _order: 99
 
 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
+**User arguments:**
+
+Contribute-a-command: $ARGUMENTS
+
+**End of user arguments**
 
 ## File Structure
 
@@ -49,9 +53,13 @@ Optional: `_requested-tools` (array), `_selectedByDefault: false`
 ### Test-Driven Development (spike, red, green, refactor, cycle)
 
 ```markdown
-[PHASE] PHASE! Apply the below to the info given by user input here:
+**User arguments:**
+
+[CommandName]: [DOLLAR]ARGUMENTS
 
-[DOLLAR]ARGUMENTS
+**End of user arguments**
+
+[PHASE] PHASE! Apply the below to the user input above.
 
 < !-- docs INCLUDE path='src/fragments/universal-guidelines.md' -->
 < !-- /docs -->
@@ -80,7 +88,13 @@ Add for red: `aaa-pattern.md`
 < !-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 < !-- /docs -->
 
-[Description and [DOLLAR] embedded in flow]
+[Description]
+
+**User arguments:**
+
+[CommandName]: [DOLLAR]ARGUMENTS
+
+**End of user arguments**
 
 < !-- docs INCLUDE path='src/fragments/discovery-phase.md' -->
 < !-- /docs -->
@@ -100,7 +114,11 @@ Add for red: `aaa-pattern.md`
 
 [Workflow description]
 
-[DOLLAR]
+**User arguments:**
+
+[CommandName]: [DOLLAR]ARGUMENTS
+
+**End of user arguments**
 
 [Process steps]
 ```

package/src/sources/add-command.md

@@ -43,8 +43,12 @@ argument-hint: [required-arg] [optional-arg]
 
 Your command instructions here.
 
+**User arguments:**
+
 Add-command: $ARGUMENTS
 
+**End of user arguments**
+
 File reference: @path/to/file.js
 
 Bash command output: (exclamation)git status(backticks)

package/src/sources/ask.md

@@ -47,8 +47,12 @@ Current branch status:
 Recent commits:
 !`git log --oneline -5`
 
+**User arguments:**
+
 Ask: $ARGUMENTS
 
+**End of user arguments**
+
 **This is the traditional Pull Request workflow**, but with explicit intent that review and approval are required.
 
 **Process:**

package/src/sources/beepboop.md

@@ -21,8 +21,12 @@ Execute the user's requested task (e.g., posting PR comments, GitHub issue comme
 
 ## Instructions
 
+**User arguments:**
+
 Beepboop: $ARGUMENTS
 
+**End of user arguments**
+
 **IMPORTANT Communication Format:**
 
 1. **Opening**: Begin with "*Beep boop, I am Claude Code 🤖, my user has reviewed and approved the following written by me:*"

package/src/sources/busycommit.md

@@ -17,8 +17,12 @@ _order: 2
 
 Create multiple atomic git commits, committing the smallest possible logical unit at a time
 
+**User arguments:**
+
 Busycommit: $ARGUMENTS
 
+**End of user arguments**
+
 <!-- docs INCLUDE path='src/fragments/commit-process.md' -->
 <!-- /docs -->
 

package/src/sources/code-review.md

@@ -239,4 +239,8 @@ Provide a ready-to-paste PR description:
 
 ---
 
-Review target (branch name, PR number, or PR URL - leave empty for current branch): $ARGUMENTS
+**User arguments:**
+
+Code-review: $ARGUMENTS
+
+**End of user arguments**

package/src/sources/commit.md

@@ -17,7 +17,11 @@ _order: 1
 
 Create a git commit following project standards
 
+**User arguments:**
+
 Commit: $ARGUMENTS
 
+**End of user arguments**
+
 <!-- docs INCLUDE path='src/fragments/commit-process.md' -->
 <!-- /docs -->

package/src/sources/commitlint-checklist-nodejs.md

@@ -16,8 +16,12 @@ _order: 25
 
 Scan the Node.js repository and report what commit automation is in place.
 
+**User arguments:**
+
 Commitlint-checklist: $ARGUMENTS
 
+**End of user arguments**
+
 ## Checks to Scan
 
 Scan the repository for these configurations (do not display this list to user):

package/src/sources/create-issues.md

@@ -19,8 +19,12 @@ Create structured implementation plan that bridges product thinking (PRD) with t
 <!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
 <!-- /docs -->
 
+**User arguments:**
+
 Create-issues: $ARGUMENTS
 
+**End of user arguments**
+
 (If no input provided, check conversation context<!-- docs INCLUDE path='src/fragments/create-issues-beads-context-hint.md' featureFlag='beads' -->
 <!-- /docs -->)
 

package/src/sources/cycle.md

@@ -6,9 +6,13 @@ _category: Test-Driven Development
 _order: 5
 ---
 
+**User arguments:**
+
 Cycle: $ARGUMENTS
 
-RED+GREEN+REFACTOR (one cycle) PHASE! Apply the below to the info given by user input.
+**End of user arguments**
+
+RED+GREEN+REFACTOR (one cycle) PHASE! Apply the below to the user input above.
 
 <!-- docs INCLUDE path='src/fragments/universal-guidelines.md' -->
 <!-- /docs -->

package/src/sources/forever.md

@@ -12,7 +12,11 @@ _order: 20
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
-# Forever Mode: $ARGUMENTS
+**User arguments:**
+
+Forever: $ARGUMENTS
+
+**End of user arguments**
 
 Run autonomously, finding and completing work until interrupted or truly stuck.
 

package/src/sources/gap.md

@@ -37,4 +37,8 @@ Present findings as a prioritized list with:
 
 If there are no gaps, confirm that everything discussed has been addressed.
 
+**User arguments:**
+
 Gap: $ARGUMENTS
+
+**End of user arguments**

package/src/sources/green.md

@@ -6,9 +6,13 @@ _category: Test-Driven Development
 _order: 3
 ---
 
+**User arguments:**
+
 Green: $ARGUMENTS
 
-GREEN PHASE! Apply the below to the info given by user input.
+**End of user arguments**
+
+GREEN PHASE! Apply the below to the user input above.
 
 <!-- docs INCLUDE path='src/fragments/universal-guidelines.md' -->
 <!-- /docs -->

package/src/sources/issue.md

@@ -21,8 +21,12 @@ Process:
 
 1. Get Issue Number
 
+**User arguments:**
+
 Issue: $ARGUMENTS
 
+**End of user arguments**
+
 - Check if argument is an issue number
 - Otherwise try branch name patterns: issue-123, 123-feature, feature/123, fix/123
 - If not found: ask user

package/src/sources/kata.md

@@ -25,8 +25,12 @@ Generate a complete TDD practice setup:
 <!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
 <!-- /docs -->
 
+**User arguments:**
+
 Kata: $ARGUMENTS
 
+**End of user arguments**
+
 (This command is interactive - arguments are ignored)
 
 ## Data Source

package/src/sources/polish.md

@@ -161,4 +161,8 @@ Additional cross-cutting checks:
 
 ---
 
+**User arguments:**
+
 Polish: $ARGUMENTS
+
+**End of user arguments**

package/src/sources/pr.md

@@ -27,8 +27,12 @@ Current branch status:
 Recent commits:
 !`git log --oneline -5`
 
+**User arguments:**
+
 PR: $ARGUMENTS
 
+**End of user arguments**
+
 **Process:**
 
 1. **Ensure Branch is Ready**:

package/src/sources/red.md

@@ -6,9 +6,13 @@ _category: Test-Driven Development
 _order: 2
 ---
 
+**User arguments:**
+
 Red: $ARGUMENTS
 
-RED PHASE! Apply the below to the info given by user input.
+**End of user arguments**
+
+RED PHASE! Apply the below to the user input above.
 
 <!-- docs INCLUDE path='src/fragments/universal-guidelines.md' -->
 <!-- /docs -->

package/src/sources/refactor.md

@@ -6,9 +6,13 @@ _category: Test-Driven Development
 _order: 4
 ---
 
+**User arguments:**
+
 Refactor: $ARGUMENTS
 
-Apply this document (specifically the Refactor phase) to the info given by user input.
+**End of user arguments**
+
+Apply this document (specifically the Refactor phase) to the user input above.
 
 <!-- docs INCLUDE path='src/fragments/universal-guidelines.md' -->
 <!-- /docs -->

package/src/sources/research.md

@@ -12,7 +12,11 @@ _order: 20
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
-# Research: $ARGUMENTS
+**User arguments:**
+
+Research: $ARGUMENTS
+
+**End of user arguments**
 
 Research the following problem or question thoroughly, like a senior developer would.
 

package/src/sources/ship.md

@@ -45,8 +45,12 @@ Current branch status:
 Recent commits:
 !`git log --oneline -5`
 
+**User arguments:**
+
 Ship: $ARGUMENTS
 
+**End of user arguments**
+
 **Process:**
 
 1. **Verify Change Size**: Check git diff to ensure changes are small and focused

package/src/sources/show.md

@@ -44,8 +44,12 @@ Current branch status:
 Recent commits:
 !`git log --oneline -5`
 
+**User arguments:**
+
 Show: $ARGUMENTS
 
+**End of user arguments**
+
 **Process:**
 
 1. **Verify Quality**: Check that changes meet show criteria

package/src/sources/simplify.md

@@ -12,7 +12,11 @@ _order: 16
 <!-- docs INCLUDE path='src/fragments/beads-awareness.md' featureFlag='beads' -->
 <!-- /docs -->
 
-# Simplify: $ARGUMENTS
+**User arguments:**
+
+Simplify: $ARGUMENTS
+
+**End of user arguments**
 
 <!-- docs INCLUDE path='src/fragments/fallback-arguments.md' -->
 <!-- /docs -->

package/src/sources/spike.md

@@ -6,9 +6,13 @@ _category: Test-Driven Development
 _order: 1
 ---
 
+**User arguments:**
+
 Spike: $ARGUMENTS
 
-SPIKE PHASE! Apply the below to the info given by user input.
+**End of user arguments**
+
+SPIKE PHASE! Apply the below to the user input above.
 
 <!-- docs INCLUDE path='src/fragments/universal-guidelines.md' -->
 <!-- /docs -->

package/src/sources/summarize.md

@@ -17,8 +17,12 @@ _order: 10
 
 Create a concise summary of the current conversation suitable for transferring context to a new conversation.
 
+**User arguments:**
+
 Summarize: $ARGUMENTS
 
+**End of user arguments**
+
 <!-- docs INCLUDE path='src/fragments/summarize-structure.md' -->
 <!-- /docs -->
 

package/src/sources/tdd-review.md

@@ -77,4 +77,8 @@ Output a structured report:
 
 ---
 
-Test path (leave empty for all tests): $ARGUMENTS
+**User arguments:**
+
+TDD-review: $ARGUMENTS
+
+**End of user arguments**

package/src/sources/tdd.md

@@ -22,6 +22,10 @@ _order: 1
 
 ## Continue Conversation
 
+**User arguments:**
+
 TDD: $ARGUMENTS
 
-Please continue with the above response, applying TDD approach.
+**End of user arguments**
+
+Please continue with the user input above, applying TDD approach.

package/src/sources/upgrade-deps.md

@@ -179,4 +179,8 @@ This will:
 
 ---
 
+**User arguments:**
+
 Upgrade: $ARGUMENTS
+
+**End of user arguments**

package/src/sources/worktree-add.md

@@ -17,7 +17,11 @@ _order: 1
 <!-- docs INCLUDE path='src/fragments/no-plan-files.md' featureFlag='no-plan-files' -->
 <!-- /docs -->
 
-Create a new git worktree for branch: $ARGUMENTS
+**User arguments:**
+
+Worktree-add: $ARGUMENTS
+
+**End of user arguments**
 
 <current_state>
 Current branch: `git branch --show-current`

package/src/sources/worktree-cleanup.md

@@ -19,8 +19,12 @@ _order: 2
 
 Clean up merged worktrees by finding the oldest merged branch, consolidating settings, and removing stale worktrees.
 
+**User arguments:**
+
 Worktree-cleanup: $ARGUMENTS
 
+**End of user arguments**
+
 <current_state>
 Current branch: `git branch --show-current`
 Current worktrees: `git worktree list`