@wbern/claude-instructions 1.7.0 → 1.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (40) hide show
  1. package/README.md +1 -0
  2. package/downloads/with-beads/add-command.md +27 -0
  3. package/downloads/with-beads/ask.md +5 -1
  4. package/downloads/with-beads/beepboop.md +2 -8
  5. package/downloads/with-beads/busycommit.md +9 -2
  6. package/downloads/with-beads/commit.md +9 -2
  7. package/downloads/with-beads/cycle.md +4 -0
  8. package/downloads/with-beads/gap.md +17 -5
  9. package/downloads/with-beads/green.md +4 -0
  10. package/downloads/with-beads/issue.md +12 -3
  11. package/downloads/with-beads/plan.md +22 -1
  12. package/downloads/with-beads/red.md +9 -2
  13. package/downloads/with-beads/refactor.md +6 -0
  14. package/downloads/with-beads/ship.md +5 -1
  15. package/downloads/with-beads/show.md +5 -1
  16. package/downloads/with-beads/spike.md +4 -0
  17. package/downloads/with-beads/summarize.md +15 -0
  18. package/downloads/with-beads/tdd.md +3 -0
  19. package/downloads/with-beads/worktree-add.md +17 -13
  20. package/downloads/with-beads/worktree-cleanup.md +18 -14
  21. package/downloads/without-beads/add-command.md +25 -0
  22. package/downloads/without-beads/ask.md +1 -1
  23. package/downloads/without-beads/beepboop.md +1 -1
  24. package/downloads/without-beads/busycommit.md +7 -2
  25. package/downloads/without-beads/commit.md +7 -2
  26. package/downloads/without-beads/cycle.md +2 -0
  27. package/downloads/without-beads/gap.md +11 -1
  28. package/downloads/without-beads/green.md +2 -0
  29. package/downloads/without-beads/issue.md +8 -3
  30. package/downloads/without-beads/plan.md +12 -2
  31. package/downloads/without-beads/red.md +7 -2
  32. package/downloads/without-beads/refactor.md +4 -0
  33. package/downloads/without-beads/ship.md +1 -1
  34. package/downloads/without-beads/show.md +1 -1
  35. package/downloads/without-beads/spike.md +2 -0
  36. package/downloads/without-beads/summarize.md +12 -1
  37. package/downloads/without-beads/tdd.md +1 -0
  38. package/downloads/without-beads/worktree-add.md +15 -13
  39. package/downloads/without-beads/worktree-cleanup.md +16 -14
  40. package/package.json +2 -1
@@ -9,10 +9,13 @@ argument-hint: [optional-response-to-last-message]
9
9
  ## General Guidelines
10
10
 
11
11
  ### Output Style
12
+
12
13
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
13
14
  - Write natural, descriptive code without meta-commentary about the development process
14
15
  - The code should speak for itself - TDD is the process, not the product
15
16
 
17
+ Beads is available for task tracking. Use `mcp__beads__*` tools to manage issues (the user interacts via `bd` commands).
18
+
16
19
  ## TDD Fundamentals
17
20
 
18
21
  ### The TDD Cycle
@@ -9,10 +9,13 @@ argument-hint: <branch-name-or-github-issue-url> [optional-base-branch]
9
9
  ## General Guidelines
10
10
 
11
11
  ### Output Style
12
+
12
13
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
13
14
  - Write natural, descriptive code without meta-commentary about the development process
14
15
  - The code should speak for itself - TDD is the process, not the product
15
16
 
17
+ Beads is available for task tracking. Use `mcp__beads__*` tools to manage issues (the user interacts via `bd` commands).
18
+
16
19
  Create a new git worktree for branch: $ARGUMENTS
17
20
 
18
21
  <current_state>
@@ -72,7 +75,7 @@ Uncommitted changes: !git status --short`
72
75
  <input>The user-provided arguments</input>
73
76
  <expected_format>branch-name-or-github-url [optional-base-branch]</expected_format>
74
77
  <example>fix/issue-123-main-content-area-visually-clipped main</example>
75
- <example_github_url>https://github.com/owner/project/issues/123 main</example_github_url>
78
+ <example_github_url><https://github.com/owner/project/issues/123> main</example_github_url>
76
79
  <default_base_branch>main (if not specified)</default_base_branch>
77
80
  </step_1>
78
81
 
@@ -182,7 +185,7 @@ Uncommitted changes: !git status --short`
182
185
  - packages/*/.env.local
183
186
  - (any other .env.local files found)
184
187
  </common_locations>
185
- <copy_command>find . -name ".env.local" -type f -exec sh -c 'mkdir -p "$(dirname "${parent_path}/${branch_name}/$1")" && cp "$1" "${parent_path}/${branch_name}/$1"' _ {} \;</copy_command>
188
+ <copy_command>find . -name ".env.local" -type f -exec sh -c 'mkdir -p "$(dirname "${parent_path}/${branch_name}/$1")" && cp "$1" "${parent_path}/${branch_name}/$1"' _{} \;</copy_command>
186
189
  <purpose>Preserve local environment configurations for development</purpose>
187
190
  <note>Only copies files that exist; ignores missing ones</note>
188
191
  </step_9>
@@ -249,14 +252,15 @@ EOF</create_file_command>
249
252
  </execution_steps>
250
253
 
251
254
  <important_notes>
252
- - Automatically detects and uses your current IDE (VS Code, VS Code Insiders, Cursor, Zed, etc.)
253
- - Creates VS Code-specific tasks.json only for VS Code variants (auto-starts Claude on folder open)
254
- - Branch names with slashes (feat/, fix/, etc.) are fully supported
255
- - The worktree directory path will match the full branch name including slashes
256
- - Settings are copied to maintain the same permissions across worktrees
257
- - Environment files (.env.local) are copied to preserve local configurations
258
- - Each worktree has its own node_modules installation
259
- - Uncommitted changes are automatically stashed and moved to the new worktree
260
- - Your work-in-progress seamlessly transfers to the new branch
261
- - IDE detection fallback: checks available editors and uses priority order
262
- </important_notes>
255
+
256
+ - Automatically detects and uses your current IDE (VS Code, VS Code Insiders, Cursor, Zed, etc.)
257
+ - Creates VS Code-specific tasks.json only for VS Code variants (auto-starts Claude on folder open)
258
+ - Branch names with slashes (feat/, fix/, etc.) are fully supported
259
+ - The worktree directory path will match the full branch name including slashes
260
+ - Settings are copied to maintain the same permissions across worktrees
261
+ - Environment files (.env.local) are copied to preserve local configurations
262
+ - Each worktree has its own node_modules installation
263
+ - Uncommitted changes are automatically stashed and moved to the new worktree
264
+ - Your work-in-progress seamlessly transfers to the new branch
265
+ - IDE detection fallback: checks available editors and uses priority order
266
+ </important_notes>
@@ -9,10 +9,13 @@ argument-hint: (no arguments)
9
9
  ## General Guidelines
10
10
 
11
11
  ### Output Style
12
+
12
13
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
13
14
  - Write natural, descriptive code without meta-commentary about the development process
14
15
  - The code should speak for itself - TDD is the process, not the product
15
16
 
17
+ Beads is available for task tracking. Use `mcp__beads__*` tools to manage issues (the user interacts via `bd` commands).
18
+
16
19
  Clean up merged worktrees by finding the oldest merged branch, consolidating settings, and removing stale worktrees.
17
20
 
18
21
  Additional info: $ARGUMENTS
@@ -212,17 +215,18 @@ Current worktrees: !git worktree list`
212
215
  </execution_steps>
213
216
 
214
217
  <important_notes>
215
- - Uses GitHub PR merge status as the ONLY reliable way to verify if a branch was merged
216
- - DOES NOT use "git branch --merged" command as it's unreliable for merge verification
217
- - Only processes branches with PRs that were definitively merged to main
218
- - Skips worktrees without merged PRs and continues to next oldest candidate
219
- - Checks and optionally closes related GitHub issues
220
- - Prioritizes oldest worktrees by directory age first for systematic cleanup
221
- - Warns about very recent worktrees (created within 24 hours) to avoid cleaning active work
222
- - Preserves useful development settings before deletion
223
- - Requires explicit confirmation before any destructive actions
224
- - Handles locked worktrees automatically
225
- - Processes one worktree at a time to maintain control
226
- - Must be run from main branch for safety
227
- - Works with standard GitHub repository URLs (owner/repo format)
228
- </important_notes>
218
+
219
+ - Uses GitHub PR merge status as the ONLY reliable way to verify if a branch was merged
220
+ - DOES NOT use "git branch --merged" command as it's unreliable for merge verification
221
+ - Only processes branches with PRs that were definitively merged to main
222
+ - Skips worktrees without merged PRs and continues to next oldest candidate
223
+ - Checks and optionally closes related GitHub issues
224
+ - Prioritizes oldest worktrees by directory age first for systematic cleanup
225
+ - Warns about very recent worktrees (created within 24 hours) to avoid cleaning active work
226
+ - Preserves useful development settings before deletion
227
+ - Requires explicit confirmation before any destructive actions
228
+ - Handles locked worktrees automatically
229
+ - Processes one worktree at a time to maintain control
230
+ - Must be run from main branch for safety
231
+ - Works with standard GitHub repository URLs (owner/repo format)
232
+ </important_notes>
@@ -3,10 +3,20 @@ description: Guide for creating new slash commands
3
3
  argument-hint: <command-name> <description>
4
4
  ---
5
5
 
6
+ ## General Guidelines
7
+
8
+ ### Output Style
9
+
10
+ - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
11
+ - Write natural, descriptive code without meta-commentary about the development process
12
+ - The code should speak for itself - TDD is the process, not the product
13
+
6
14
  # Slash Command Creator Guide
7
15
 
8
16
  ## How This Command Works
17
+
9
18
  The `/add-command` command shows this guide for creating new slash commands. It includes:
19
+
10
20
  - Command structure and syntax
11
21
  - Common patterns and examples
12
22
  - Security restrictions and limitations
@@ -15,6 +25,7 @@ The `/add-command` command shows this guide for creating new slash commands. It
15
25
  **Note for AI**: When creating commands, you CAN use bash tools like `Bash(mkdir:*)`, `Bash(ls:*)`, `Bash(git status:*)` in the `allowed-tools` frontmatter of NEW commands - but ONLY for operations within the current project directory. This command itself doesn't need bash tools since it's just documentation.
16
26
 
17
27
  ## Command Locations
28
+
18
29
  - **Personal**: `~/.claude/commands/` (available across all projects)
19
30
  - **Project**: `.claude/commands/` (shared with team, shows "(project)")
20
31
 
@@ -41,33 +52,40 @@ Bash command output: (exclamation)git status(backticks)
41
52
  ## ⚠️ Security Restrictions
42
53
 
43
54
  **Bash Commands (exclamation prefix)**: Limited to current working directory only.
55
+
44
56
  - ✅ Works: `! + backtick + git status + backtick` (in project dir)
45
57
  - ❌ Blocked: `! + backtick + ls /outside/project + backtick` (outside project)
46
58
  - ❌ Blocked: `! + backtick + pwd + backtick` (if referencing dirs outside project)
47
59
 
48
60
  **File References (`@` prefix)**: No directory restrictions.
61
+
49
62
  - ✅ Works: `@/path/to/system/file.md`
50
63
  - ✅ Works: `@../other-project/file.js`
51
64
 
52
65
  ## Common Patterns
53
66
 
54
67
  ### Simple Command
68
+
55
69
  ```bash
56
70
  echo "Review this code for bugs and suggest fixes" > ~/.claude/commands/review.md
57
71
  ```
58
72
 
59
73
  ### Command with Arguments
74
+
60
75
  **Note for AI**: The example below uses a fullwidth dollar sign ($, U+FF04) to prevent interpolation in this documentation. When creating actual commands, use the regular `$` character.
76
+
61
77
  ```markdown
62
78
  Fix issue $ARGUMENTS following our coding standards
63
79
  ```
64
80
 
65
81
  ### Command with File References
82
+
66
83
  ```markdown
67
84
  Compare @src/old.js with @src/new.js and explain differences
68
85
  ```
69
86
 
70
87
  ### Command with Bash Output (Project Directory Only)
88
+
71
89
  ```markdown
72
90
  ---
73
91
  allowed-tools: Bash(git status:*), Bash(git branch:*), Bash(git log:*)
@@ -82,7 +100,9 @@ Create commit for these changes.
82
100
  **Note**: Only works with commands in the current project directory.
83
101
 
84
102
  ### Namespaced Command
103
+
85
104
  **Note for AI**: The example below uses a fullwidth dollar sign ($, U+FF04) to prevent interpolation in this documentation. When creating actual commands, use the regular `$` character.
105
+
86
106
  ```bash
87
107
  mkdir -p ~/.claude/commands/ai
88
108
  echo "Ask GPT-5 about: $ARGUMENTS" > ~/.claude/commands/ai/gpt5.md
@@ -90,6 +110,7 @@ echo "Ask GPT-5 about: $ARGUMENTS" > ~/.claude/commands/ai/gpt5.md
90
110
  ```
91
111
 
92
112
  ## Frontmatter Options
113
+
93
114
  - `allowed-tools`: Tools this command can use
94
115
  - **Important**: Intrusive tools like `Write`, `Edit`, `NotebookEdit` should NEVER be allowed in commands unless the user explicitly requests them. These tools modify files and should only be used when the command's purpose is to make changes.
95
116
  - ✅ Safe for most commands: `Read`, `Glob`, `Grep`, `Bash(git status:*)`, `Task`, `AskUserQuestion`
@@ -100,6 +121,7 @@ echo "Ask GPT-5 about: $ARGUMENTS" > ~/.claude/commands/ai/gpt5.md
100
121
  ## Best Practices
101
122
 
102
123
  ### Safe Commands (No Security Issues)
124
+
103
125
  ```markdown
104
126
  # System prompt editor (file reference only)
105
127
  (@)path/to/system/prompt.md
@@ -108,6 +130,7 @@ Edit your system prompt above.
108
130
  ```
109
131
 
110
132
  ### Project-Specific Commands (Bash OK)
133
+
111
134
  ```markdown
112
135
  ---
113
136
  allowed-tools: Bash(git status:*), Bash(npm list:*)
@@ -119,6 +142,7 @@ Review project state and suggest next steps.
119
142
  ```
120
143
 
121
144
  ### Cross-Directory File Access (Use @ not !)
145
+
122
146
  ```markdown
123
147
  # Compare config files
124
148
  Compare (@)path/to/system.md with (@)project/config.md
@@ -127,6 +151,7 @@ Show differences and suggest improvements.
127
151
  ```
128
152
 
129
153
  ## Usage
154
+
130
155
  After creating: `/<command-name> [arguments]`
131
156
 
132
157
  Example: `/review` or `/ai:gpt5 "explain this code"`
@@ -9,6 +9,7 @@ argument-hint: [optional-pr-title-and-description]
9
9
  ## General Guidelines
10
10
 
11
11
  ### Output Style
12
+
12
13
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
13
14
  - Write natural, descriptive code without meta-commentary about the development process
14
15
  - The code should speak for itself - TDD is the process, not the product
@@ -132,4 +133,3 @@ Use **Ask** when:
132
133
  Use **/show** instead if: confident in approach, just want visibility
133
134
 
134
135
  Use **/ship** instead if: change is tiny, obvious, and safe
135
-
@@ -11,11 +11,11 @@ Execute the user's requested task (e.g., posting PR comments, GitHub issue comme
11
11
  ## General Guidelines
12
12
 
13
13
  ### Output Style
14
+
14
15
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
15
16
  - Write natural, descriptive code without meta-commentary about the development process
16
17
  - The code should speak for itself - TDD is the process, not the product
17
18
 
18
-
19
19
  ## Instructions
20
20
 
21
21
  Arguments: $ARGUMENTS
@@ -4,12 +4,17 @@ description: Create multiple atomic git commits, one logical change at a time
4
4
  argument-hint: [optional-commit-description]
5
5
  ---
6
6
 
7
- Create multiple atomic git commits, committing the smallest possible logical unit at a time
7
+ ## General Guidelines
8
8
 
9
- Include any of the following info if specified: $ARGUMENTS
9
+ ### Output Style
10
10
 
11
+ - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
12
+ - Write natural, descriptive code without meta-commentary about the development process
13
+ - The code should speak for itself - TDD is the process, not the product
11
14
 
15
+ Create multiple atomic git commits, committing the smallest possible logical unit at a time
12
16
 
17
+ Include any of the following info if specified: $ARGUMENTS
13
18
 
14
19
  ## Process
15
20
 
@@ -4,12 +4,17 @@ description: Create a git commit following project standards
4
4
  argument-hint: [optional-commit-description]
5
5
  ---
6
6
 
7
- Create a git commit following project standards
7
+ ## General Guidelines
8
8
 
9
- Include any of the following info if specified: $ARGUMENTS
9
+ ### Output Style
10
10
 
11
+ - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
12
+ - Write natural, descriptive code without meta-commentary about the development process
13
+ - The code should speak for itself - TDD is the process, not the product
11
14
 
15
+ Create a git commit following project standards
12
16
 
17
+ Include any of the following info if specified: $ARGUMENTS
13
18
 
14
19
  ## Process
15
20
 
@@ -11,11 +11,13 @@ $ARGUMENTS
11
11
  ## General Guidelines
12
12
 
13
13
  ### Output Style
14
+
14
15
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
15
16
  - Write natural, descriptive code without meta-commentary about the development process
16
17
  - The code should speak for itself - TDD is the process, not the product
17
18
 
18
19
  (If there was no info above, fallback to:
20
+
19
21
  1. Context of the conversation, if there's an immediate thing
20
22
  2. `bd ready` to see what to work on next and start from there)
21
23
 
@@ -1,16 +1,26 @@
1
1
  ---
2
2
  description: Analyze conversation context for unaddressed items and gaps
3
+ argument-hint: [optional additional info]
3
4
  ---
4
5
 
6
+ ## General Guidelines
7
+
8
+ ### Output Style
9
+
10
+ - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
11
+ - Write natural, descriptive code without meta-commentary about the development process
12
+ - The code should speak for itself - TDD is the process, not the product
13
+
5
14
  Analyze the current conversation context and identify things that have not yet been addressed. Look for:
6
15
 
7
16
  1. **Incomplete implementations** - Code that was started but not finished
8
17
  2. **Unused variables/results** - Values that were captured but never used
9
18
  3. **Missing tests** - Functionality without test coverage
10
- 4. **User requests** - Things the user asked for that weren't fully completed
19
+ 4. **User requests** - Things the user asked for that weren't fully completed
11
20
  5. **TODO comments** - Any TODOs mentioned in conversation
12
21
  6. **Error handling gaps** - Missing error cases or edge cases
13
22
  7. **Documentation gaps** - Undocumented APIs or features
23
+ 8. **Consistency check** - Look for inconsistent patterns, naming conventions, or structure across the codebase
14
24
 
15
25
  Present findings as a prioritized list with:
16
26
 
@@ -11,11 +11,13 @@ $ARGUMENTS
11
11
  ## General Guidelines
12
12
 
13
13
  ### Output Style
14
+
14
15
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
15
16
  - Write natural, descriptive code without meta-commentary about the development process
16
17
  - The code should speak for itself - TDD is the process, not the product
17
18
 
18
19
  (If there was no info above, fallback to:
20
+
19
21
  1. Context of the conversation, if there's an immediate thing
20
22
  2. `bd ready` to see what to work on next and start from there)
21
23
 
@@ -9,6 +9,7 @@ Analyze GitHub issue and create TDD implementation plan.
9
9
  ## General Guidelines
10
10
 
11
11
  ### Output Style
12
+
12
13
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
13
14
  - Write natural, descriptive code without meta-commentary about the development process
14
15
  - The code should speak for itself - TDD is the process, not the product
@@ -22,11 +23,12 @@ Process:
22
23
  - Or from this bullet point with custom info: $ARGUMENTS
23
24
  - If not found: ask user
24
25
 
25
- 2. Fetch Issue
26
+ 1. Fetch Issue
26
27
 
27
28
  Try to fetch the issue using GitHub MCP (mcp__github__issue_read tool).
28
29
 
29
30
  If GitHub MCP is not configured, show:
31
+
30
32
  ```
31
33
  GitHub MCP not configured!
32
34
  See: https://github.com/modelcontextprotocol/servers/tree/main/src/github
@@ -35,7 +37,7 @@ Trying GitHub CLI fallback...
35
37
 
36
38
  Then try using `gh issue view [ISSUE_NUMBER] --json` as fallback.
37
39
 
38
- 3. Analyze and Plan
40
+ 1. Analyze and Plan
39
41
 
40
42
  Summarize the issue and requirements, then:
41
43
 
@@ -44,25 +46,28 @@ Summarize the issue and requirements, then:
44
46
  Understand the requirement by asking (use AskUserQuestion if needed):
45
47
 
46
48
  **Problem Statement**
49
+
47
50
  - What problem does this solve?
48
51
  - Who experiences this problem?
49
52
  - What's the current pain point?
50
53
 
51
54
  **Desired Outcome**
55
+
52
56
  - What should happen after this is built?
53
57
  - How will users interact with it?
54
58
  - What does success look like?
55
59
 
56
60
  **Scope & Constraints**
61
+
57
62
  - What's in scope vs. out of scope?
58
63
  - Any technical constraints?
59
64
  - Dependencies on other systems/features?
60
65
 
61
66
  **Context Check**
67
+
62
68
  - Search codebase for related features/modules
63
69
  - Check for existing test files that might be relevant
64
70
 
65
-
66
71
  ## TDD Fundamentals
67
72
 
68
73
  ### The TDD Cycle
@@ -11,6 +11,7 @@ Create structured implementation plan that bridges product thinking (PRD) with t
11
11
  ## General Guidelines
12
12
 
13
13
  ### Output Style
14
+
14
15
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
15
16
  - Write natural, descriptive code without meta-commentary about the development process
16
17
  - The code should speak for itself - TDD is the process, not the product
@@ -24,6 +25,7 @@ $ARGUMENTS
24
25
  ## Input Processing
25
26
 
26
27
  The input can be one of:
28
+
27
29
  1. **GitHub Issue URL** (e.g., `https://github.com/owner/repo/issues/123`)
28
30
  2. **GitHub Issue Number** (e.g., `#123` or `123`)
29
31
  3. **Feature Description** (e.g., "Add user authentication")
@@ -34,12 +36,14 @@ The input can be one of:
34
36
  If input looks like a GitHub issue:
35
37
 
36
38
  **Step 1: Extract Issue Number**
39
+
37
40
  - From URL: extract owner/repo/number
38
41
  - From number: try to infer repo from git remote
39
42
  - From branch name: check patterns like `issue-123`, `123-feature`, `feature/123`
40
43
 
41
44
  **Step 2: Fetch Issue**
42
45
  Try GitHub MCP first:
46
+
43
47
  - If available: use `mcp__github__issue_read` to fetch issue details
44
48
  - If not available: show message and try `gh issue view <number>`
45
49
 
@@ -50,6 +54,7 @@ Trying GitHub CLI fallback...
50
54
  ```
51
55
 
52
56
  **Step 3: Use Issue as Discovery Input**
57
+
53
58
  - Title → Feature name
54
59
  - Description → Problem statement and context
55
60
  - Labels → Type/priority hints
@@ -57,6 +62,7 @@ Trying GitHub CLI fallback...
57
62
  - Linked issues → Dependencies
58
63
 
59
64
  Extract from GitHub issue:
65
+
60
66
  - Problem statement and context
61
67
  - Acceptance criteria (if present)
62
68
  - Technical notes (if present)
@@ -69,38 +75,42 @@ Extract from GitHub issue:
69
75
  Understand the requirement by asking (use AskUserQuestion if needed):
70
76
 
71
77
  **Problem Statement**
78
+
72
79
  - What problem does this solve?
73
80
  - Who experiences this problem?
74
81
  - What's the current pain point?
75
82
 
76
83
  **Desired Outcome**
84
+
77
85
  - What should happen after this is built?
78
86
  - How will users interact with it?
79
87
  - What does success look like?
80
88
 
81
89
  **Scope & Constraints**
90
+
82
91
  - What's in scope vs. out of scope?
83
92
  - Any technical constraints?
84
93
  - Dependencies on other systems/features?
85
94
 
86
95
  **Context Check**
96
+
87
97
  - Search codebase for related features/modules
88
98
  - Check for existing test files that might be relevant
89
99
 
90
-
91
100
  ## Key Principles
92
101
 
93
102
  **From PRD World:**
103
+
94
104
  - Start with user problems, not solutions
95
105
  - Define success criteria upfront
96
106
  - Understand constraints and scope
97
107
 
98
108
  **From TDD World:**
109
+
99
110
  - Make acceptance criteria test-ready
100
111
  - Break work into small, testable pieces
101
112
  - Each task should map to test(s)
102
113
 
103
-
104
114
  ## Integration with Other Commands
105
115
 
106
116
  - **Before /plan**: Use `/spike` if you need technical exploration first
@@ -1,21 +1,26 @@
1
1
  ---
2
2
  allowed-tools: Read, Glob, Grep, Bash(pnpm test:*)
3
3
  description: Execute TDD Red Phase - write ONE failing test
4
+ argument-hint: [optional additional info]
4
5
  ---
5
6
 
6
7
  RED PHASE! Apply the below to the info given by user input here:
7
8
 
8
9
  $ARGUMENTS
9
10
 
10
- (If there was no info above, use info from the current context of conversation. If there was not enough info, ask for it.)
11
-
12
11
  ## General Guidelines
13
12
 
14
13
  ### Output Style
14
+
15
15
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
16
16
  - Write natural, descriptive code without meta-commentary about the development process
17
17
  - The code should speak for itself - TDD is the process, not the product
18
18
 
19
+ (If there was no info above, fallback to:
20
+
21
+ 1. Context of the conversation, if there's an immediate thing
22
+ 2. `bd ready` to see what to work on next and start from there)
23
+
19
24
  ## TDD Fundamentals
20
25
 
21
26
  ### The TDD Cycle
@@ -9,11 +9,13 @@ Apply this document (specifically the Refactor phase), to the info given by user
9
9
  ## General Guidelines
10
10
 
11
11
  ### Output Style
12
+
12
13
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
13
14
  - Write natural, descriptive code without meta-commentary about the development process
14
15
  - The code should speak for itself - TDD is the process, not the product
15
16
 
16
17
  (If there was no info above, fallback to:
18
+
17
19
  1. Context of the conversation, if there's an immediate thing
18
20
  2. `bd ready` to see what to work on next and start from there)
19
21
 
@@ -88,3 +90,5 @@ This phase is **not part of the regular TDD workflow** and must only be applied
88
90
  - In the refactor phase, it is perfectly fine to refactor both test and implementation code. That said, completely new functionality is not allowed. Types, clean up, abstractions, and helpers are allowed as long as they do not introduce new behavior.
89
91
  - Adding types, interfaces, or a constant in order to replace magic values is perfectly fine during refactoring.
90
92
  - Provide the agent with helpful directions so that they do not get stuck when blocking them.
93
+
94
+ 1. **Consistency check** - Look for inconsistent patterns, naming conventions, or structure across the codebase
@@ -9,6 +9,7 @@ argument-hint: [optional-commit-message]
9
9
  ## General Guidelines
10
10
 
11
11
  ### Output Style
12
+
12
13
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
13
14
  - Write natural, descriptive code without meta-commentary about the development process
14
15
  - The code should speak for itself - TDD is the process, not the product
@@ -86,4 +87,3 @@ If tests fail, linter fails, or changes are large/complex, STOP and suggest:
86
87
 
87
88
  - Use `/show` for changes that should be seen but don't need approval
88
89
  - Use `/ask` (traditional PR) for complex changes needing discussion
89
-
@@ -9,6 +9,7 @@ argument-hint: [optional-pr-title-and-description]
9
9
  ## General Guidelines
10
10
 
11
11
  ### Output Style
12
+
12
13
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
13
14
  - Write natural, descriptive code without meta-commentary about the development process
14
15
  - The code should speak for itself - TDD is the process, not the product
@@ -102,4 +103,3 @@ Use **Show** when:
102
103
  Use **/ship** instead if: change is tiny and obvious (typo, formatting)
103
104
 
104
105
  Use **/ask** instead if: change needs discussion, breaks APIs, or you're uncertain
105
-
@@ -11,11 +11,13 @@ $ARGUMENTS
11
11
  ## General Guidelines
12
12
 
13
13
  ### Output Style
14
+
14
15
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
15
16
  - Write natural, descriptive code without meta-commentary about the development process
16
17
  - The code should speak for itself - TDD is the process, not the product
17
18
 
18
19
  (If there was no info above, fallback to:
20
+
19
21
  1. Context of the conversation, if there's an immediate thing
20
22
  2. `bd ready` to see what to work on next and start from there)
21
23
 
@@ -1,8 +1,17 @@
1
1
  ---
2
2
  allowed-tools: AskUserQuestion
3
3
  description: Summarize conversation progress and next steps
4
+ argument-hint: [optional additional info]
4
5
  ---
5
6
 
7
+ ## General Guidelines
8
+
9
+ ### Output Style
10
+
11
+ - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
12
+ - Write natural, descriptive code without meta-commentary about the development process
13
+ - The code should speak for itself - TDD is the process, not the product
14
+
6
15
  Create a concise summary of the current conversation suitable for transferring context to a new conversation.
7
16
 
8
17
  Additional info: $ARGUMENTS
@@ -12,16 +21,19 @@ Additional info: $ARGUMENTS
12
21
  Provide a summary with these sections:
13
22
 
14
23
  ### What We Did
24
+
15
25
  - Key accomplishments and changes made
16
26
  - Important decisions or discoveries
17
27
  - Files created, modified, or analyzed
18
28
 
19
29
  ### What We're Doing Next
30
+
20
31
  - Immediate next steps
21
32
  - Pending tasks or work in progress
22
33
  - Goals or objectives to continue
23
34
 
24
35
  ### Blockers & User Input Needed
36
+
25
37
  - Any issues requiring user intervention
26
38
  - Decisions that need to be made
27
39
  - Missing information or clarifications needed
@@ -29,4 +41,3 @@ Provide a summary with these sections:
29
41
  ## Output Format
30
42
 
31
43
  Keep the summary concise and actionable - suitable for pasting into a new conversation to quickly restore context without needing the full conversation history.
32
-
@@ -9,6 +9,7 @@ argument-hint: [optional-response-to-last-message]
9
9
  ## General Guidelines
10
10
 
11
11
  ### Output Style
12
+
12
13
  - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
13
14
  - Write natural, descriptive code without meta-commentary about the development process
14
15
  - The code should speak for itself - TDD is the process, not the product