@wbern/claude-instructions 1.8.1 → 1.10.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 (46) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +21 -11
  3. package/bin/cli.js +796 -47
  4. package/downloads/with-beads/ask.md +1 -4
  5. package/downloads/with-beads/beepboop.md +0 -1
  6. package/downloads/with-beads/busycommit.md +16 -1
  7. package/downloads/with-beads/code-review.md +248 -0
  8. package/downloads/with-beads/commands-metadata.json +57 -15
  9. package/downloads/with-beads/commit.md +16 -1
  10. package/downloads/with-beads/cycle.md +0 -1
  11. package/downloads/with-beads/gap.md +1 -0
  12. package/downloads/with-beads/green.md +0 -1
  13. package/downloads/with-beads/issue.md +0 -1
  14. package/downloads/with-beads/plan.md +1 -3
  15. package/downloads/with-beads/pr.md +82 -0
  16. package/downloads/with-beads/red.md +0 -1
  17. package/downloads/with-beads/refactor.md +0 -1
  18. package/downloads/with-beads/ship.md +1 -4
  19. package/downloads/with-beads/show.md +1 -4
  20. package/downloads/with-beads/spike.md +0 -1
  21. package/downloads/with-beads/summarize.md +0 -1
  22. package/downloads/with-beads/tdd.md +0 -1
  23. package/downloads/with-beads/worktree-add.md +0 -1
  24. package/downloads/with-beads/worktree-cleanup.md +0 -1
  25. package/downloads/without-beads/ask.md +1 -4
  26. package/downloads/without-beads/beepboop.md +0 -1
  27. package/downloads/without-beads/busycommit.md +16 -1
  28. package/downloads/without-beads/code-review.md +246 -0
  29. package/downloads/without-beads/commands-metadata.json +57 -15
  30. package/downloads/without-beads/commit.md +16 -1
  31. package/downloads/without-beads/cycle.md +0 -1
  32. package/downloads/without-beads/gap.md +1 -0
  33. package/downloads/without-beads/green.md +0 -1
  34. package/downloads/without-beads/issue.md +0 -1
  35. package/downloads/without-beads/plan.md +0 -1
  36. package/downloads/without-beads/pr.md +70 -0
  37. package/downloads/without-beads/red.md +0 -1
  38. package/downloads/without-beads/refactor.md +0 -1
  39. package/downloads/without-beads/ship.md +1 -4
  40. package/downloads/without-beads/show.md +1 -4
  41. package/downloads/without-beads/spike.md +0 -1
  42. package/downloads/without-beads/summarize.md +0 -1
  43. package/downloads/without-beads/tdd.md +0 -1
  44. package/downloads/without-beads/worktree-add.md +0 -1
  45. package/downloads/without-beads/worktree-cleanup.md +0 -1
  46. package/package.json +7 -3
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 wbern
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -21,6 +21,10 @@ TDD workflow commands for Claude Code CLI.
21
21
 
22
22
  ```bash
23
23
  npx @wbern/claude-instructions
24
+
25
+ // or
26
+
27
+ pnpm dlx @wbern/claude-instructions
24
28
  ```
25
29
 
26
30
  The interactive installer lets you choose:
@@ -57,13 +61,14 @@ This ensures commands are regenerated whenever anyone runs `npm install`, `pnpm
57
61
 
58
62
  | Option | Description |
59
63
  |--------|-------------|
60
- | `--variant=with-beads` | Include Beads MCP integration |
61
- | `--variant=without-beads` | Standard commands only |
62
- | `--scope=project` | Install to `.claude/commands` in current directory |
63
- | `--scope=user` | Install to `~/.claude/commands` (global) |
64
- | `--prefix=my-` | Add prefix to command names (e.g., `my-commit.md`) |
65
- | `--skip-template-injection` | Don't inject CLAUDE.md template content |
64
+ | `--variant=with-beads` | Command variant (with-beads, without-beads) |
65
+ | `--scope=project` | Installation scope (project, user) |
66
+ | `--prefix=my-` | Add prefix to command names |
66
67
  | `--commands=commit,red,green` | Install only specific commands |
68
+ | `--skip-template-injection` | Skip injecting project CLAUDE.md customizations |
69
+ | `--update-existing` | Only update already-installed commands |
70
+ | `--overwrite` | Overwrite conflicting files without prompting |
71
+ | `--skip-on-conflict` | Skip conflicting files without prompting |
67
72
 
68
73
  ## Customizing Commands
69
74
 
@@ -190,9 +195,10 @@ flowchart TB
190
195
  - `/issue` - Analyze GitHub issue and create TDD implementation plan
191
196
  - `/plan` - Create implementation plan from feature/requirement with PRD-style discovery and TDD acceptance criteria
192
197
 
193
- ### TDD Cycle
198
+ ### Test-Driven Development
194
199
 
195
200
  - `/spike` - Execute TDD Spike Phase - exploratory coding to understand problem space before TDD
201
+ - `/tdd` - Remind agent about TDD approach and continue conversation
196
202
  - `/red` - Execute TDD Red Phase - write ONE failing test
197
203
  - `/green` - Execute TDD Green Phase - write minimal implementation to pass the failing test
198
204
  - `/refactor` - Execute TDD Refactor Phase - improve code structure while keeping tests green
@@ -202,11 +208,16 @@ flowchart TB
202
208
 
203
209
  - `/commit` - Create a git commit following project standards
204
210
  - `/busycommit` - Create multiple atomic git commits, one logical change at a time
205
- - `/ship` - Ship code directly to main - for small, obvious changes that don't need review (Cursor's modern alternative to PRs)
206
- - `/show` - Show code to team with auto-merge - for changes that should be visible but don't need approval (Cursor's modern workflow)
207
- - `/ask` - Request team review and approval - for complex changes needing discussion (OK fine, traditional PRs still have their place - Cursor)
211
+ - `/pr` - Creates a pull request using GitHub MCP
208
212
  - `/summarize` - Summarize conversation progress and next steps
209
213
  - `/gap` - Analyze conversation context for unaddressed items and gaps
214
+ - `/code-review` - Code review using dynamic category detection and domain-specific analysis
215
+
216
+ ### Ship / Show / Ask
217
+
218
+ - `/ship` - Ship code directly to main - for small, obvious changes that don't need review
219
+ - `/show` - Show code to team with auto-merge - for changes that should be visible but don't need approval
220
+ - `/ask` - Request team review and approval - for complex changes needing discussion
210
221
 
211
222
  ### Worktree Management
212
223
 
@@ -215,7 +226,6 @@ flowchart TB
215
226
 
216
227
  ### Utilities
217
228
 
218
- - `/tdd` - Remind agent about TDD approach and continue conversation
219
229
  - `/beepboop` - Communicate AI-generated content with transparent attribution
220
230
  - `/add-command` - Guide for creating new slash commands
221
231