@wbern/claude-instructions 1.6.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.
- package/README.md +1 -0
- package/downloads/with-beads/add-command.md +31 -2
- package/downloads/with-beads/ask.md +5 -1
- package/downloads/with-beads/beepboop.md +2 -8
- package/downloads/with-beads/busycommit.md +9 -2
- package/downloads/with-beads/commit.md +9 -2
- package/downloads/with-beads/cycle.md +4 -0
- package/downloads/with-beads/gap.md +17 -5
- package/downloads/with-beads/green.md +4 -0
- package/downloads/with-beads/issue.md +12 -3
- package/downloads/with-beads/plan.md +22 -1
- package/downloads/with-beads/red.md +9 -2
- package/downloads/with-beads/refactor.md +6 -0
- package/downloads/with-beads/ship.md +5 -1
- package/downloads/with-beads/show.md +5 -1
- package/downloads/with-beads/spike.md +4 -0
- package/downloads/with-beads/summarize.md +15 -0
- package/downloads/with-beads/tdd.md +3 -0
- package/downloads/with-beads/worktree-add.md +17 -13
- package/downloads/with-beads/worktree-cleanup.md +18 -14
- package/downloads/without-beads/add-command.md +29 -2
- package/downloads/without-beads/ask.md +1 -1
- package/downloads/without-beads/beepboop.md +1 -1
- package/downloads/without-beads/busycommit.md +7 -2
- package/downloads/without-beads/commit.md +7 -2
- package/downloads/without-beads/cycle.md +2 -0
- package/downloads/without-beads/gap.md +11 -1
- package/downloads/without-beads/green.md +2 -0
- package/downloads/without-beads/issue.md +8 -3
- package/downloads/without-beads/plan.md +12 -2
- package/downloads/without-beads/red.md +7 -2
- package/downloads/without-beads/refactor.md +4 -0
- package/downloads/without-beads/ship.md +1 -1
- package/downloads/without-beads/show.md +1 -1
- package/downloads/without-beads/spike.md +2 -0
- package/downloads/without-beads/summarize.md +12 -1
- package/downloads/without-beads/tdd.md +1 -0
- package/downloads/without-beads/worktree-add.md +15 -13
- package/downloads/without-beads/worktree-cleanup.md +16 -14
- 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
|
|
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"' _
|
|
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
|
-
|
|
253
|
-
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
|
|
257
|
-
|
|
258
|
-
|
|
259
|
-
|
|
260
|
-
|
|
261
|
-
|
|
262
|
-
|
|
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
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
222
|
-
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
|
|
226
|
-
|
|
227
|
-
|
|
228
|
-
|
|
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,32 +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
|
+
|
|
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
|
+
|
|
60
77
|
```markdown
|
|
61
|
-
Fix issue
|
|
78
|
+
Fix issue $ARGUMENTS following our coding standards
|
|
62
79
|
```
|
|
63
80
|
|
|
64
81
|
### Command with File References
|
|
82
|
+
|
|
65
83
|
```markdown
|
|
66
84
|
Compare @src/old.js with @src/new.js and explain differences
|
|
67
85
|
```
|
|
68
86
|
|
|
69
87
|
### Command with Bash Output (Project Directory Only)
|
|
88
|
+
|
|
70
89
|
```markdown
|
|
71
90
|
---
|
|
72
91
|
allowed-tools: Bash(git status:*), Bash(git branch:*), Bash(git log:*)
|
|
@@ -81,13 +100,17 @@ Create commit for these changes.
|
|
|
81
100
|
**Note**: Only works with commands in the current project directory.
|
|
82
101
|
|
|
83
102
|
### Namespaced Command
|
|
103
|
+
|
|
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
|
+
|
|
84
106
|
```bash
|
|
85
107
|
mkdir -p ~/.claude/commands/ai
|
|
86
|
-
echo "Ask GPT-5 about: ARGUMENTS" > ~/.claude/commands/ai/gpt5.md
|
|
108
|
+
echo "Ask GPT-5 about: $ARGUMENTS" > ~/.claude/commands/ai/gpt5.md
|
|
87
109
|
# Creates: /ai:gpt5
|
|
88
110
|
```
|
|
89
111
|
|
|
90
112
|
## Frontmatter Options
|
|
113
|
+
|
|
91
114
|
- `allowed-tools`: Tools this command can use
|
|
92
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.
|
|
93
116
|
- ✅ Safe for most commands: `Read`, `Glob`, `Grep`, `Bash(git status:*)`, `Task`, `AskUserQuestion`
|
|
@@ -98,6 +121,7 @@ echo "Ask GPT-5 about: ARGUMENTS" > ~/.claude/commands/ai/gpt5.md
|
|
|
98
121
|
## Best Practices
|
|
99
122
|
|
|
100
123
|
### Safe Commands (No Security Issues)
|
|
124
|
+
|
|
101
125
|
```markdown
|
|
102
126
|
# System prompt editor (file reference only)
|
|
103
127
|
(@)path/to/system/prompt.md
|
|
@@ -106,6 +130,7 @@ Edit your system prompt above.
|
|
|
106
130
|
```
|
|
107
131
|
|
|
108
132
|
### Project-Specific Commands (Bash OK)
|
|
133
|
+
|
|
109
134
|
```markdown
|
|
110
135
|
---
|
|
111
136
|
allowed-tools: Bash(git status:*), Bash(npm list:*)
|
|
@@ -117,6 +142,7 @@ Review project state and suggest next steps.
|
|
|
117
142
|
```
|
|
118
143
|
|
|
119
144
|
### Cross-Directory File Access (Use @ not !)
|
|
145
|
+
|
|
120
146
|
```markdown
|
|
121
147
|
# Compare config files
|
|
122
148
|
Compare (@)path/to/system.md with (@)project/config.md
|
|
@@ -125,6 +151,7 @@ Show differences and suggest improvements.
|
|
|
125
151
|
```
|
|
126
152
|
|
|
127
153
|
## Usage
|
|
154
|
+
|
|
128
155
|
After creating: `/<command-name> [arguments]`
|
|
129
156
|
|
|
130
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
|
-
|
|
7
|
+
## General Guidelines
|
|
8
8
|
|
|
9
|
-
|
|
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
|
-
|
|
7
|
+
## General Guidelines
|
|
8
8
|
|
|
9
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|