@wbern/claude-instructions 1.8.0 → 1.9.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 (41) hide show
  1. package/README.md +14 -10
  2. package/bin/cli.js +677 -49
  3. package/downloads/with-beads/ask.md +1 -4
  4. package/downloads/with-beads/beepboop.md +0 -1
  5. package/downloads/with-beads/busycommit.md +0 -1
  6. package/downloads/with-beads/commands-metadata.json +43 -15
  7. package/downloads/with-beads/commit.md +0 -1
  8. package/downloads/with-beads/cycle.md +0 -1
  9. package/downloads/with-beads/green.md +0 -1
  10. package/downloads/with-beads/issue.md +0 -1
  11. package/downloads/with-beads/plan.md +0 -1
  12. package/downloads/with-beads/pr.md +82 -0
  13. package/downloads/with-beads/red.md +0 -1
  14. package/downloads/with-beads/refactor.md +0 -1
  15. package/downloads/with-beads/ship.md +1 -4
  16. package/downloads/with-beads/show.md +1 -4
  17. package/downloads/with-beads/spike.md +0 -1
  18. package/downloads/with-beads/summarize.md +0 -1
  19. package/downloads/with-beads/tdd.md +0 -1
  20. package/downloads/with-beads/worktree-add.md +0 -1
  21. package/downloads/with-beads/worktree-cleanup.md +0 -1
  22. package/downloads/without-beads/ask.md +1 -4
  23. package/downloads/without-beads/beepboop.md +0 -1
  24. package/downloads/without-beads/busycommit.md +0 -1
  25. package/downloads/without-beads/commands-metadata.json +43 -15
  26. package/downloads/without-beads/commit.md +0 -1
  27. package/downloads/without-beads/cycle.md +1 -5
  28. package/downloads/without-beads/green.md +1 -5
  29. package/downloads/without-beads/issue.md +0 -1
  30. package/downloads/without-beads/plan.md +0 -1
  31. package/downloads/without-beads/pr.md +70 -0
  32. package/downloads/without-beads/red.md +1 -5
  33. package/downloads/without-beads/refactor.md +1 -5
  34. package/downloads/without-beads/ship.md +1 -4
  35. package/downloads/without-beads/show.md +1 -4
  36. package/downloads/without-beads/spike.md +1 -5
  37. package/downloads/without-beads/summarize.md +0 -1
  38. package/downloads/without-beads/tdd.md +0 -1
  39. package/downloads/without-beads/worktree-add.md +0 -1
  40. package/downloads/without-beads/worktree-cleanup.md +0 -1
  41. package/package.json +4 -1
@@ -0,0 +1,70 @@
1
+ ---
2
+ description: Creates a pull request using GitHub MCP
3
+ argument-hint: [optional-pr-title-and-description]
4
+ ---
5
+
6
+ # Create Pull Request
7
+
8
+ ## General Guidelines
9
+
10
+ ### Output Style
11
+
12
+ - **Never explicitly mention TDD** in code, comments, commits, PRs, or issues
13
+ - Write natural, descriptive code without meta-commentary about the development process
14
+ - The code should speak for itself - TDD is the process, not the product
15
+
16
+ Create a pull request for the current branch using GitHub MCP tools.
17
+
18
+ ## Workflow
19
+
20
+ Current branch status:
21
+ !`git status`
22
+
23
+ Recent commits:
24
+ !`git log --oneline -5`
25
+
26
+ Arguments: $ARGUMENTS
27
+
28
+ **Process:**
29
+
30
+ 1. **Ensure Branch is Ready**:
31
+ !`git status`
32
+ - Commit all changes
33
+ - Push to remote: `git push origin [branch-name]`
34
+
35
+ 2. **Create PR**: Create a well-formatted pull request
36
+
37
+ Title: conventional commits format, like `feat(#123): add user authentication`
38
+
39
+ Description template:
40
+
41
+ ```markdown
42
+ <!--
43
+ Are there any relevant issues / PRs / mailing lists discussions?
44
+ Please reference them here.
45
+ -->
46
+
47
+ ## References
48
+
49
+ - [links to github issues referenced in commit messages]
50
+
51
+ ## Summary
52
+
53
+ [Brief description of changes]
54
+
55
+ ## Test Plan
56
+
57
+ - [ ] Tests pass
58
+ - [ ] Manual testing completed
59
+ ```
60
+
61
+ 3. **Set Base Branch**: Default to main unless specified otherwise
62
+
63
+ 4. **Link Issues**: Reference related issues found in commit messages
64
+
65
+ ## Use GitHub MCP Tools
66
+
67
+ 1. Check current branch and ensure it's pushed
68
+ 2. Create a well-formatted pull request with proper title and description
69
+ 3. Set the base branch (default: main)
70
+ 4. Include relevant issue references if found in commit messages
@@ -1,5 +1,4 @@
1
1
  ---
2
- allowed-tools: Read, Glob, Grep, Bash(pnpm test:*)
3
2
  description: Execute TDD Red Phase - write ONE failing test
4
3
  argument-hint: [optional additional info]
5
4
  ---
@@ -16,10 +15,7 @@ $ARGUMENTS
16
15
  - Write natural, descriptive code without meta-commentary about the development process
17
16
  - The code should speak for itself - TDD is the process, not the product
18
17
 
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)
18
+ (If there was no info above, fallback to the context of the conversation)
23
19
 
24
20
  ## TDD Fundamentals
25
21
 
@@ -1,5 +1,4 @@
1
1
  ---
2
- allowed-tools: Read, Glob, Grep, Bash(pnpm test:*)
3
2
  description: Execute TDD Refactor Phase - improve code structure while keeping tests green
4
3
  argument-hint: <refactoring description>
5
4
  ---
@@ -14,10 +13,7 @@ Apply this document (specifically the Refactor phase), to the info given by user
14
13
  - Write natural, descriptive code without meta-commentary about the development process
15
14
  - The code should speak for itself - TDD is the process, not the product
16
15
 
17
- (If there was no info above, fallback to:
18
-
19
- 1. Context of the conversation, if there's an immediate thing
20
- 2. `bd ready` to see what to work on next and start from there)
16
+ (If there was no info above, fallback to the context of the conversation)
21
17
 
22
18
  ## TDD Fundamentals
23
19
 
@@ -1,6 +1,5 @@
1
1
  ---
2
- allowed-tools: Bash(git status:*), Bash(git log:*), Bash(git diff:*), Bash(git checkout:*), Bash(git pull:*), Bash(git merge:*), Bash(git push:*), Bash(git branch:*)
3
- description: Ship code directly to main - for small, obvious changes that don't need review (Cursor's modern alternative to PRs)
2
+ description: Ship code directly to main - for small, obvious changes that don't need review
4
3
  argument-hint: [optional-commit-message]
5
4
  ---
6
5
 
@@ -16,8 +15,6 @@ argument-hint: [optional-commit-message]
16
15
 
17
16
  **Ship/Show/Ask Pattern - SHIP**
18
17
 
19
- > 🎯 **Cursor says**: It's 2025! Not everything needs a PR. Ship small, obvious changes directly.
20
-
21
18
  Ship is for small, obvious changes that don't need code review. Examples:
22
19
 
23
20
  - Typo fixes
@@ -1,6 +1,5 @@
1
1
  ---
2
- allowed-tools: mcp__github__create_pull_request, mcp__github__update_pull_request, Bash(git status:*), Bash(git log:*), Bash(git push:*), Bash(git branch:*)
3
- description: Show code to team with auto-merge - for changes that should be visible but don't need approval (Cursor's modern workflow)
2
+ description: Show code to team with auto-merge - for changes that should be visible but don't need approval
4
3
  argument-hint: [optional-pr-title-and-description]
5
4
  ---
6
5
 
@@ -16,8 +15,6 @@ argument-hint: [optional-pr-title-and-description]
16
15
 
17
16
  **Ship/Show/Ask Pattern - SHOW**
18
17
 
19
- > 🚀 **Cursor says**: Not every change needs a traditional review. Show your work, then merge.
20
-
21
18
  Show is for changes that teammates should see, but don't require approval. Examples:
22
19
 
23
20
  - Refactoring with test coverage
@@ -1,5 +1,4 @@
1
1
  ---
2
- allowed-tools: Read, Glob, Grep, Task
3
2
  description: Execute TDD Spike Phase - exploratory coding to understand problem space before TDD
4
3
  argument-hint: <exploration description>
5
4
  ---
@@ -16,10 +15,7 @@ $ARGUMENTS
16
15
  - Write natural, descriptive code without meta-commentary about the development process
17
16
  - The code should speak for itself - TDD is the process, not the product
18
17
 
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)
18
+ (If there was no info above, fallback to the context of the conversation)
23
19
 
24
20
  ## TDD Fundamentals
25
21
 
@@ -1,5 +1,4 @@
1
1
  ---
2
- allowed-tools: AskUserQuestion
3
2
  description: Summarize conversation progress and next steps
4
3
  argument-hint: [optional additional info]
5
4
  ---
@@ -1,5 +1,4 @@
1
1
  ---
2
- allowed-tools: Read, Glob, Grep, Task
3
2
  description: Remind agent about TDD approach and continue conversation
4
3
  argument-hint: [optional-response-to-last-message]
5
4
  ---
@@ -1,5 +1,4 @@
1
1
  ---
2
- allowed-tools: Bash(code-insiders:*), Bash(code:*), Bash(zed:*), Bash(cursor:*), Bash(which:*), Read, mcp__github__issue_read, mcp__ide__getDiagnostics, ListMcpResourcesTool
3
2
  description: Add a new git worktree from branch name or GitHub issue URL, copy settings, install deps, and open in current IDE
4
3
  argument-hint: <branch-name-or-github-issue-url> [optional-base-branch]
5
4
  ---
@@ -1,5 +1,4 @@
1
1
  ---
2
- allowed-tools: Read, mcp__mcp-jq__jq_query, mcp__mcp-jq__jq_query_file, mcp__github__search_pull_requests, mcp__github__pull_request_read, mcp__github__issue_read, mcp__github__issue_write, mcp__github__add_issue_comment, ListMcpResourcesTool
3
2
  description: Clean up merged worktrees by verifying PR/issue status, consolidating settings, and removing stale worktrees
4
3
  argument-hint: (no arguments)
5
4
  ---
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@wbern/claude-instructions",
3
- "version": "1.8.0",
3
+ "version": "1.9.0",
4
4
  "description": "TDD workflow commands for Claude Code CLI",
5
5
  "type": "module",
6
6
  "bin": "./bin/cli.js",
@@ -31,6 +31,7 @@
31
31
  "build": "tsx scripts/build.ts",
32
32
  "build:cli": "tsup",
33
33
  "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",
34
+ "test:quick-manual": "pnpm build:cli && node bin/cli.js",
34
35
  "generate": "tsx scripts/cli-generator.ts",
35
36
  "test": "vitest run",
36
37
  "test:watch": "vitest",
@@ -44,6 +45,7 @@
44
45
  "@eslint/js": "^9.39.1",
45
46
  "@types/fs-extra": "^11.0.4",
46
47
  "@types/node": "^24.10.1",
48
+ "diff": "^8.0.2",
47
49
  "eslint": "^9.39.1",
48
50
  "husky": "^9.1.7",
49
51
  "jscpd": "^4.0.5",
@@ -51,6 +53,7 @@
51
53
  "lint-staged": "^16.2.7",
52
54
  "markdown-magic": "^4.0.4",
53
55
  "markdownlint-cli": "^0.46.0",
56
+ "picocolors": "^1.1.1",
54
57
  "prettier": "^3.7.2",
55
58
  "tsup": "^8.5.1",
56
59
  "tsx": "^4.20.6",