thanh-kit 2.5.4 → 2.5.5
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/package.json +1 -1
- package/templates/command-archive/ask.md +56 -0
- package/templates/command-archive/ck-help.md +129 -0
- package/templates/command-archive/coding-level.md +48 -0
- package/templates/command-archive/docs/init.md +38 -0
- package/templates/command-archive/docs/summarize.md +22 -0
- package/templates/command-archive/docs/update.md +76 -0
- package/templates/command-archive/journal.md +18 -0
- package/templates/command-archive/kanban.md +99 -0
- package/templates/command-archive/plan/archive.md +57 -0
- package/templates/command-archive/plan/red-team.md +200 -0
- package/templates/command-archive/plan/validate.md +188 -0
- package/templates/command-archive/preview.md +283 -0
- package/templates/command-archive/review/codebase/parallel.md +122 -0
- package/templates/command-archive/review/codebase.md +49 -0
- package/templates/command-archive/test/ui.md +92 -0
- package/templates/command-archive/test.md +8 -0
- package/templates/command-archive/use-mcp.md +38 -0
- package/templates/command-archive/watzup.md +8 -0
- package/templates/command-archive/worktree.md +109 -0
- package/templates/hooks/.logs/hook-log.jsonl +26 -0
- package/templates/settings.local.json +13 -0
- package/templates/commands/bootstrap/auto/fast.md +0 -111
- package/templates/commands/bootstrap/auto/parallel.md +0 -66
- package/templates/commands/bootstrap/auto.md +0 -115
- package/templates/commands/bootstrap.md +0 -137
- package/templates/commands/code/auto.md +0 -203
- package/templates/commands/code/no-test.md +0 -174
- package/templates/commands/code/parallel.md +0 -100
- package/templates/commands/code.md +0 -205
- package/templates/commands/content/cro.md +0 -43
- package/templates/commands/content/enhance.md +0 -14
- package/templates/commands/content/fast.md +0 -13
- package/templates/commands/content/good.md +0 -16
- package/templates/commands/cook/auto/fast.md +0 -26
- package/templates/commands/cook/auto/parallel.md +0 -49
- package/templates/commands/cook/auto.md +0 -15
- package/templates/commands/cook.md +0 -105
- package/templates/commands/debug.md +0 -13
- package/templates/commands/design/3d.md +0 -83
- package/templates/commands/design/describe.md +0 -23
- package/templates/commands/design/fast.md +0 -31
- package/templates/commands/design/good.md +0 -35
- package/templates/commands/design/screenshot.md +0 -34
- package/templates/commands/design/video.md +0 -34
- package/templates/commands/fix/ci.md +0 -17
- package/templates/commands/fix/fast.md +0 -19
- package/templates/commands/fix/hard.md +0 -39
- package/templates/commands/fix/logs.md +0 -26
- package/templates/commands/fix/parallel.md +0 -54
- package/templates/commands/fix/test.md +0 -20
- package/templates/commands/fix/types.md +0 -9
- package/templates/commands/fix/ui.md +0 -48
- package/templates/commands/fix.md +0 -43
- package/templates/commands/plan/ci.md +0 -33
- package/templates/commands/plan/cro.md +0 -69
- package/templates/commands/plan/fast.md +0 -82
- package/templates/commands/plan/hard.md +0 -108
- package/templates/commands/plan/parallel.md +0 -145
- package/templates/commands/plan/two.md +0 -45
- package/templates/commands/plan.md +0 -30
- package/templates/commands/scout/ext.md +0 -39
- package/templates/commands/scout.md +0 -28
- package/templates/commands/skill/add.md +0 -36
- package/templates/commands/skill/create.md +0 -29
- package/templates/commands/skill/fix-logs.md +0 -22
- package/templates/commands/skill/optimize/auto.md +0 -25
- package/templates/commands/skill/optimize.md +0 -34
- package/templates/commands/skill/update.md +0 -36
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: ⚡⚡⚡ Ultrathink edge cases, then parallel verify with code-reviewers
|
|
3
|
+
argument-hint: [scope-or-prompt]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
**Ultrathink** to exhaustively list ALL potential edge cases, then dispatch parallel `code-reviewer` agents to verify: <scope>$ARGUMENTS</scope>
|
|
7
|
+
|
|
8
|
+
**IMPORTANT:** Activate needed skills. Ensure token efficiency. Sacrifice grammar for concision.
|
|
9
|
+
|
|
10
|
+
## Workflow
|
|
11
|
+
|
|
12
|
+
### 1. Ultrathink Edge Cases
|
|
13
|
+
|
|
14
|
+
Main agent deeply analyzes the scope to LIST all potential edge cases FIRST:
|
|
15
|
+
- Read `codebase-summary.md` for context
|
|
16
|
+
- Use `/scout:ext` to find relevant files
|
|
17
|
+
- **Think exhaustively** about what could go wrong:
|
|
18
|
+
- Null/undefined scenarios
|
|
19
|
+
- Boundary conditions (off-by-one, empty, max values)
|
|
20
|
+
- Error handling gaps
|
|
21
|
+
- Race conditions, async edge cases
|
|
22
|
+
- Input validation holes
|
|
23
|
+
- Security vulnerabilities
|
|
24
|
+
- Resource leaks
|
|
25
|
+
- Untested code paths
|
|
26
|
+
|
|
27
|
+
**Output format:**
|
|
28
|
+
```markdown
|
|
29
|
+
## Edge Cases Identified
|
|
30
|
+
|
|
31
|
+
### Category: [scope-area]
|
|
32
|
+
1. [edge case description] → files: [file1, file2]
|
|
33
|
+
2. [edge case description] → files: [file3]
|
|
34
|
+
|
|
35
|
+
### Category: [another-area]
|
|
36
|
+
1. [edge case description] → files: [file4, file5]
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
### 2. Categorize & Assign
|
|
40
|
+
|
|
41
|
+
Group edge cases by similar scope for parallel verification:
|
|
42
|
+
- Each category → one `code-reviewer` agent
|
|
43
|
+
- Max 6 categories (merge small ones)
|
|
44
|
+
- Each reviewer gets specific edge cases to VERIFY, not discover
|
|
45
|
+
|
|
46
|
+
### 3. Parallel Verification
|
|
47
|
+
|
|
48
|
+
Launch N `code-reviewer` subagents simultaneously:
|
|
49
|
+
- Pass: category name, list of edge cases, relevant files
|
|
50
|
+
- Task: **VERIFY** if each edge case is properly handled in code
|
|
51
|
+
- Report: which edge cases are handled vs unhandled
|
|
52
|
+
|
|
53
|
+
**Reviewer instruction:**
|
|
54
|
+
```
|
|
55
|
+
Verify these specific edge cases in the given files:
|
|
56
|
+
[list of edge cases]
|
|
57
|
+
|
|
58
|
+
For each, report:
|
|
59
|
+
- ✅ Handled: [how it's handled]
|
|
60
|
+
- ❌ Unhandled: [what's missing]
|
|
61
|
+
- ⚠️ Partial: [what needs improvement]
|
|
62
|
+
```
|
|
63
|
+
|
|
64
|
+
### 4. Aggregate Results
|
|
65
|
+
|
|
66
|
+
Collect all verification reports:
|
|
67
|
+
```markdown
|
|
68
|
+
## Edge Case Verification Report
|
|
69
|
+
|
|
70
|
+
### Summary
|
|
71
|
+
- Total edge cases: X
|
|
72
|
+
- Handled: Y ✅
|
|
73
|
+
- Unhandled: Z ❌
|
|
74
|
+
- Partial: W ⚠️
|
|
75
|
+
|
|
76
|
+
### Unhandled Edge Cases (Need Fix)
|
|
77
|
+
| # | Edge Case | File | Status |
|
|
78
|
+
|---|-----------|------|--------|
|
|
79
|
+
| 1 | ... | ... | ❌ |
|
|
80
|
+
|
|
81
|
+
### Partial Handling (Need Review)
|
|
82
|
+
| # | Edge Case | File | Issue |
|
|
83
|
+
|---|-----------|------|-------|
|
|
84
|
+
| 1 | ... | ... | ... |
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### 5. Auto-Fix Pipeline
|
|
88
|
+
|
|
89
|
+
**IF** unhandled/partial edge cases found:
|
|
90
|
+
- Ask: "Found N unhandled edge cases. Fix with /fix --parallel? [Y/n]"
|
|
91
|
+
- **IF yes:** Trigger `/fix --parallel` with unhandled list
|
|
92
|
+
|
|
93
|
+
### 6. Final Report
|
|
94
|
+
|
|
95
|
+
- Summary of verification
|
|
96
|
+
- Ask: "Commit? [Y/n]" → use `git-manager`
|
|
97
|
+
|
|
98
|
+
## Example
|
|
99
|
+
|
|
100
|
+
```
|
|
101
|
+
User: /review:codebase:parallel auth module
|
|
102
|
+
|
|
103
|
+
1. Ultrathink → Lists 12 edge cases for auth:
|
|
104
|
+
- Empty password submission
|
|
105
|
+
- Token expiry during request
|
|
106
|
+
- Concurrent login attempts
|
|
107
|
+
- Invalid refresh token
|
|
108
|
+
...
|
|
109
|
+
|
|
110
|
+
2. Categorize → 3 groups:
|
|
111
|
+
- Login flow (4 cases)
|
|
112
|
+
- Token handling (5 cases)
|
|
113
|
+
- Session management (3 cases)
|
|
114
|
+
|
|
115
|
+
3. Parallel → 3 code-reviewers verify simultaneously
|
|
116
|
+
|
|
117
|
+
4. Aggregate → 8 handled, 3 unhandled, 1 partial
|
|
118
|
+
|
|
119
|
+
5. Fix → User approves → /fix --parallel
|
|
120
|
+
|
|
121
|
+
6. Final → Commit changes
|
|
122
|
+
```
|
|
@@ -0,0 +1,49 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: ⚡⚡⚡ Scan & analyze the codebase.
|
|
3
|
+
argument-hint: [tasks-or-prompt]
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Think harder to scan the codebase and analyze it follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
|
|
7
|
+
<tasks>$ARGUMENTS</tasks>
|
|
8
|
+
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
## Role Responsibilities
|
|
12
|
+
- You are an elite software engineering expert who specializes in system architecture design and technical decision-making.
|
|
13
|
+
- You operate by the holy trinity of software engineering: **YAGNI** (You Aren't Gonna Need It), **KISS** (Keep It Simple, Stupid), and **DRY** (Don't Repeat Yourself). Every solution you propose must honor these principles.
|
|
14
|
+
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
|
|
15
|
+
- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
|
|
16
|
+
|
|
17
|
+
---
|
|
18
|
+
|
|
19
|
+
## Workflow:
|
|
20
|
+
|
|
21
|
+
**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
|
|
22
|
+
|
|
23
|
+
### Research
|
|
24
|
+
|
|
25
|
+
* Use 2 `researcher` subagents in parallel to search up to max 5 sources for the user's request, idea validation, best practices, challenges, and find the best possible solutions.
|
|
26
|
+
* Keep every research markdown report concise (≤150 lines) while covering all requested topics and citations.
|
|
27
|
+
* Use `/scout:ext` (preferred) or `/scout` (fallback) slash command to search the codebase for files needed to complete the task
|
|
28
|
+
|
|
29
|
+
### Code Review
|
|
30
|
+
|
|
31
|
+
* After finishing, use multiple `code-reviewer` subagents in parallel to review code.
|
|
32
|
+
* If there are any issues, duplicate code, or security vulnerabilities, ask main agent to improve the code and repeat the "Testing" process until all tests pass.
|
|
33
|
+
* When all tests pass, code is reviewed, the tasks are completed, report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
|
|
34
|
+
* **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
|
|
35
|
+
|
|
36
|
+
### Plan
|
|
37
|
+
* Use `planner` subagent to analyze reports from `researcher` and `scout` subagents to create an improvement plan following the progressive disclosure structure:
|
|
38
|
+
- Create a directory using naming pattern from `## Naming` section.
|
|
39
|
+
- Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
|
|
40
|
+
- For each phase, add `phase-XX-phase-name.md` files containing sections (Context links, Overview with date/priority/statuses, Key Insights, Requirements, Architecture, Related code files, Implementation Steps, Todo list, Success Criteria, Risk Assessment, Security Considerations, Next steps).
|
|
41
|
+
|
|
42
|
+
### Final Report
|
|
43
|
+
* Report back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
|
|
44
|
+
* Ask the user if they want to commit and push to git repository, if yes, use `git-manager` subagent to commit and push to git repository.
|
|
45
|
+
|
|
46
|
+
**REMEMBER**:
|
|
47
|
+
- You can always generate images with `ai-multimodal` skill on the fly for visual assets.
|
|
48
|
+
- You always read and analyze the generated assets with `ai-multimodal` skill to verify they meet requirements.
|
|
49
|
+
- For image editing (removing background, adjusting, cropping), use ImageMagick or similar tools as needed.
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: '⚡⚡ Run UI tests on a website & generate a detailed report.'
|
|
3
|
+
argument-hint: '[url] [options]'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Activate the chrome-devtools skill.
|
|
7
|
+
|
|
8
|
+
## Purpose
|
|
9
|
+
Run comprehensive UI tests on a website and generate a detailed report.
|
|
10
|
+
|
|
11
|
+
## Arguments
|
|
12
|
+
- $1: URL - The URL of the website to test
|
|
13
|
+
- $2: OPTIONS - Optional test configuration (e.g., --headless, --mobile, --auth)
|
|
14
|
+
|
|
15
|
+
## Testing Protected Routes (Authentication)
|
|
16
|
+
|
|
17
|
+
For testing protected routes that require authentication, follow this workflow:
|
|
18
|
+
|
|
19
|
+
### Step 1: User Manual Login
|
|
20
|
+
Instruct the user to:
|
|
21
|
+
1. Open the target site in their browser
|
|
22
|
+
2. Log in manually with their credentials
|
|
23
|
+
3. Open browser DevTools (F12) → Application tab → Cookies/Storage
|
|
24
|
+
|
|
25
|
+
### Step 2: Extract Auth Credentials
|
|
26
|
+
Ask the user to provide one of:
|
|
27
|
+
- **Cookies**: Copy cookie values (name, value, domain)
|
|
28
|
+
- **Access Token**: Copy JWT/Bearer token from localStorage or cookies
|
|
29
|
+
- **Session Storage**: Copy relevant session keys
|
|
30
|
+
|
|
31
|
+
### Step 3: Inject Authentication
|
|
32
|
+
Use the `inject-auth.js` script to inject credentials before testing:
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
cd $SKILL_DIR # .claude/skills/chrome-devtools/scripts
|
|
36
|
+
|
|
37
|
+
# Option A: Inject cookies
|
|
38
|
+
node inject-auth.js --url https://example.com --cookies '[{"name":"session","value":"abc123","domain":".example.com"}]'
|
|
39
|
+
|
|
40
|
+
# Option B: Inject Bearer token
|
|
41
|
+
node inject-auth.js --url https://example.com --token "Bearer eyJhbGciOi..." --header Authorization --token-key access_token
|
|
42
|
+
|
|
43
|
+
# Option C: Inject localStorage
|
|
44
|
+
node inject-auth.js --url https://example.com --local-storage '{"auth_token":"xyz","user_id":"123"}'
|
|
45
|
+
|
|
46
|
+
# Combined (cookies + localStorage)
|
|
47
|
+
node inject-auth.js --url https://example.com --cookies '[{"name":"session","value":"abc"}]' --local-storage '{"user":"data"}'
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
### Step 4: Run Tests
|
|
51
|
+
After auth injection, the browser session persists. Run tests normally:
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
# Navigate and screenshot protected pages
|
|
55
|
+
node navigate.js --url https://example.com/dashboard
|
|
56
|
+
node screenshot.js --url https://example.com/profile --output profile.png
|
|
57
|
+
|
|
58
|
+
# The auth session persists until --close true is used
|
|
59
|
+
node screenshot.js --url https://example.com/settings --output settings.png --close true
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
### Auth Script Options
|
|
63
|
+
- `--cookies '<json>'` - Inject cookies (JSON array)
|
|
64
|
+
- `--token '<token>'` - Inject Bearer token
|
|
65
|
+
- `--token-key '<key>'` - localStorage key for token (default: access_token)
|
|
66
|
+
- `--header '<name>'` - Set HTTP header with token (e.g., Authorization)
|
|
67
|
+
- `--local-storage '<json>'` - Inject localStorage items
|
|
68
|
+
- `--session-storage '<json>'` - Inject sessionStorage items
|
|
69
|
+
- `--reload true` - Reload page after injection
|
|
70
|
+
- `--clear true` - Clear saved auth session
|
|
71
|
+
|
|
72
|
+
## Workflow
|
|
73
|
+
- Use `plan` skill to organize the test plan & report in the current project directory.
|
|
74
|
+
- All the screenshots should be saved in the same report directory.
|
|
75
|
+
- Browse $URL with the specified $OPTIONS, discover all pages, components, and endpoints.
|
|
76
|
+
- Create a test plan based on the discovered structure
|
|
77
|
+
- Use multiple `tester` subagents or tool calls in parallel to test all pages, forms, navigation, user flows, accessibility, functionalities, usability, responsive layouts, cross-browser compatibility, performance, security, seo, etc.
|
|
78
|
+
- Use `ai-multimodal` to analyze all screenshots and visual elements.
|
|
79
|
+
- Generate a comprehensive report in Markdown format, embedding all screenshots directly in the report.
|
|
80
|
+
- Finally respond to the user with a concise summary of findings and recommendations.
|
|
81
|
+
- Use `AskUserQuestion` tool to ask if user wants to preview the report with `/preview` slash command.
|
|
82
|
+
|
|
83
|
+
## Output Requirements
|
|
84
|
+
How to write reports:
|
|
85
|
+
- Format: Use clear, structured Markdown with headers, lists, and code blocks where appropriate
|
|
86
|
+
- Include the test results summary, key findings, and screenshot references
|
|
87
|
+
- **IMPORTANT:** Ensure token efficiency while maintaining high quality.
|
|
88
|
+
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
|
|
89
|
+
- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
|
|
90
|
+
|
|
91
|
+
**IMPORTANT**: **Do not** start implementing the fixes.
|
|
92
|
+
**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: ⚡ Run tests locally and analyze the summary report.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
Use the `tester` subagent to run tests locally and analyze the summary report.
|
|
6
|
+
|
|
7
|
+
**IMPORTANT**: **Do not** start implementing.
|
|
8
|
+
**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
|
|
@@ -0,0 +1,38 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Utilize tools of Model Context Protocol (MCP) servers
|
|
3
|
+
argument-hint: [task]
|
|
4
|
+
---
|
|
5
|
+
Execute MCP operations via **Gemini CLI** to preserve context budget.
|
|
6
|
+
|
|
7
|
+
## Execution Steps
|
|
8
|
+
|
|
9
|
+
1. **Execute task via Gemini CLI** (using stdin pipe for MCP support):
|
|
10
|
+
```bash
|
|
11
|
+
# IMPORTANT: Use stdin piping, NOT -p flag (deprecated, skips MCP init)
|
|
12
|
+
# Read model from .claude/.ck.json: gemini.model (default: gemini-3-flash-preview)
|
|
13
|
+
echo "$ARGUMENTS. Return JSON only per GEMINI.md instructions." | gemini -y -m <gemini.model>
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
2. **Fallback to mcp-manager subagent** (if Gemini CLI unavailable):
|
|
17
|
+
- Use `mcp-manager` subagent to discover and execute tools
|
|
18
|
+
- If the subagent got issues with the scripts of `mcp-management` skill, use `mcp-builder` skill to fix them
|
|
19
|
+
- **DO NOT** create ANY new scripts
|
|
20
|
+
- The subagent can only use MCP tools if any to achieve this task
|
|
21
|
+
- If the subagent can't find any suitable tools, just report it back to the main agent to move on to the next step
|
|
22
|
+
|
|
23
|
+
## Important Notes
|
|
24
|
+
|
|
25
|
+
- **MUST use stdin piping** - the deprecated `-p` flag skips MCP initialization
|
|
26
|
+
- Use `-y` flag to auto-approve tool execution
|
|
27
|
+
- **GEMINI.md auto-loaded**: Gemini CLI automatically loads `GEMINI.md` from project root, enforcing JSON-only response format
|
|
28
|
+
- **Parseable output**: Responses are structured JSON: `{"server":"name","tool":"name","success":true,"result":<data>,"error":null}`
|
|
29
|
+
|
|
30
|
+
## Anti-Pattern (DO NOT USE)
|
|
31
|
+
|
|
32
|
+
```bash
|
|
33
|
+
# BROKEN - deprecated -p flag skips MCP server connections!
|
|
34
|
+
gemini -y -m <gemini.model> -p "..."
|
|
35
|
+
|
|
36
|
+
# ALSO BROKEN - --model flag with -p
|
|
37
|
+
gemini -y -p "..." --model gemini-3-flash-preview
|
|
38
|
+
```
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: ⚡ Review recent changes and wrap up the work
|
|
3
|
+
---
|
|
4
|
+
Review my current branch and the most recent commits.
|
|
5
|
+
Provide a detailed summary of all changes, including what was modified, added, or removed.
|
|
6
|
+
Analyze the overall impact and quality of the changes.
|
|
7
|
+
|
|
8
|
+
**IMPORTANT**: **Do not** start implementing.
|
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 'Create isolated git worktree for parallel development'
|
|
3
|
+
argument-hint: '[feature-description] OR [project] [feature] (monorepo)'
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
Create an isolated git worktree for parallel feature development.
|
|
7
|
+
|
|
8
|
+
## Workflow
|
|
9
|
+
|
|
10
|
+
### Step 1: Get Repo Info
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
node .claude/scripts/worktree.cjs info --json
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
Parse JSON response for: `repoType`, `baseBranch`, `projects`, `worktreeRoot`, `worktreeRootSource`.
|
|
17
|
+
|
|
18
|
+
### Step 2: Detect Branch Prefix
|
|
19
|
+
|
|
20
|
+
From user's description:
|
|
21
|
+
- "fix", "bug", "error", "issue" → `fix`
|
|
22
|
+
- "refactor", "restructure", "rewrite" → `refactor`
|
|
23
|
+
- "docs", "documentation", "readme" → `docs`
|
|
24
|
+
- "test", "spec", "coverage" → `test`
|
|
25
|
+
- "chore", "cleanup", "deps" → `chore`
|
|
26
|
+
- "perf", "performance", "optimize" → `perf`
|
|
27
|
+
- Default → `feat`
|
|
28
|
+
|
|
29
|
+
### Step 3: Convert to Slug
|
|
30
|
+
|
|
31
|
+
"add authentication system" → `add-auth`
|
|
32
|
+
"fix login bug" → `login-bug`
|
|
33
|
+
Max 50 chars, kebab-case.
|
|
34
|
+
|
|
35
|
+
### Step 4: Handle Monorepo
|
|
36
|
+
|
|
37
|
+
If `repoType === "monorepo"` and project not specified, use AskUserQuestion:
|
|
38
|
+
```javascript
|
|
39
|
+
AskUserQuestion({
|
|
40
|
+
questions: [{
|
|
41
|
+
header: "Project",
|
|
42
|
+
question: "Which project for the worktree?",
|
|
43
|
+
options: projects.map(p => ({ label: p.name, description: p.path })),
|
|
44
|
+
multiSelect: false
|
|
45
|
+
}]
|
|
46
|
+
})
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
### Step 5: Execute
|
|
50
|
+
|
|
51
|
+
**Monorepo:**
|
|
52
|
+
```bash
|
|
53
|
+
node .claude/scripts/worktree.cjs create "<PROJECT>" "<SLUG>" --prefix <TYPE>
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
**Standalone:**
|
|
57
|
+
```bash
|
|
58
|
+
node .claude/scripts/worktree.cjs create "<SLUG>" --prefix <TYPE>
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
**Options:**
|
|
62
|
+
- `--prefix` - Branch type: feat|fix|refactor|docs|test|chore|perf
|
|
63
|
+
- `--worktree-root <path>` - Override default location (only if needed)
|
|
64
|
+
- `--json` - JSON output
|
|
65
|
+
- `--dry-run` - Preview
|
|
66
|
+
|
|
67
|
+
### Step 6: Install Dependencies
|
|
68
|
+
|
|
69
|
+
Based on project context, run in background:
|
|
70
|
+
- `bun.lock` → `bun install`
|
|
71
|
+
- `pnpm-lock.yaml` → `pnpm install`
|
|
72
|
+
- `yarn.lock` → `yarn install`
|
|
73
|
+
- `package-lock.json` → `npm install`
|
|
74
|
+
- `poetry.lock` → `poetry install`
|
|
75
|
+
- `requirements.txt` → `pip install -r requirements.txt`
|
|
76
|
+
- `Cargo.toml` → `cargo build`
|
|
77
|
+
- `go.mod` → `go mod download`
|
|
78
|
+
|
|
79
|
+
## Commands
|
|
80
|
+
|
|
81
|
+
| Command | Usage | Description |
|
|
82
|
+
|---------|-------|-------------|
|
|
83
|
+
| `create` | `create [project] <feature>` | Create worktree |
|
|
84
|
+
| `remove` | `remove <name-or-path>` | Remove worktree |
|
|
85
|
+
| `info` | `info` | Repo info with worktree location |
|
|
86
|
+
| `list` | `list` | List worktrees |
|
|
87
|
+
|
|
88
|
+
## Example
|
|
89
|
+
|
|
90
|
+
```
|
|
91
|
+
User: /worktree fix the login validation bug
|
|
92
|
+
|
|
93
|
+
Claude: [Runs: node .claude/scripts/worktree.cjs info --json]
|
|
94
|
+
repoType: standalone
|
|
95
|
+
worktreeRoot: /home/user/worktrees
|
|
96
|
+
worktreeRootSource: sibling directory
|
|
97
|
+
|
|
98
|
+
[Prefix: fix, Slug: login-validation-bug]
|
|
99
|
+
[Runs: node .claude/scripts/worktree.cjs create "login-validation-bug" --prefix fix]
|
|
100
|
+
|
|
101
|
+
Output: Worktree created at /home/user/worktrees/my-project-login-validation-bug
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
## Notes
|
|
105
|
+
|
|
106
|
+
- Script auto-detects superproject, monorepo, and standalone repos
|
|
107
|
+
- Default worktree location is smart: superproject > monorepo > sibling
|
|
108
|
+
- Use `--worktree-root` only to override defaults
|
|
109
|
+
- Env templates (`.env*.example`) auto-copied with `.example` suffix removed
|
|
@@ -0,0 +1,26 @@
|
|
|
1
|
+
{"ts":"2026-03-04T16:03:43.971Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
2
|
+
{"ts":"2026-03-04T16:03:43.978Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
3
|
+
{"ts":"2026-03-04T16:03:56.874Z","hook":"scout-block","tool":"Glob","dur":3,"status":"ok","exit":0,"error":""}
|
|
4
|
+
{"ts":"2026-03-04T16:03:56.880Z","hook":"scout-block","tool":"Bash","dur":7,"status":"block","exit":2,"error":""}
|
|
5
|
+
{"ts":"2026-03-04T16:03:57.560Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
6
|
+
{"ts":"2026-03-04T16:04:18.074Z","hook":"scout-block","tool":"Bash","dur":3,"status":"ok","exit":0,"error":""}
|
|
7
|
+
{"ts":"2026-03-04T16:04:18.082Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
8
|
+
{"ts":"2026-03-04T16:04:26.893Z","hook":"scout-block","tool":"Bash","dur":7,"status":"block","exit":2,"error":""}
|
|
9
|
+
{"ts":"2026-03-04T16:04:32.226Z","hook":"scout-block","tool":"Bash","dur":6,"status":"block","exit":2,"error":""}
|
|
10
|
+
{"ts":"2026-03-04T16:04:32.234Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
11
|
+
{"ts":"2026-03-04T16:04:44.444Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
12
|
+
{"ts":"2026-03-04T16:04:44.445Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
13
|
+
{"ts":"2026-03-04T16:04:56.769Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
14
|
+
{"ts":"2026-03-04T16:04:56.773Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
15
|
+
{"ts":"2026-03-04T16:11:33.817Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
16
|
+
{"ts":"2026-03-04T16:11:40.915Z","hook":"scout-block","tool":"Bash","dur":5,"status":"ok","exit":0,"error":""}
|
|
17
|
+
{"ts":"2026-03-04T16:13:15.301Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
18
|
+
{"ts":"2026-03-04T16:13:22.848Z","hook":"scout-block","tool":"Glob","dur":3,"status":"ok","exit":0,"error":""}
|
|
19
|
+
{"ts":"2026-03-04T16:13:22.859Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
20
|
+
{"ts":"2026-03-04T16:13:25.718Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
21
|
+
{"ts":"2026-03-04T16:13:25.719Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
22
|
+
{"ts":"2026-03-04T16:13:54.959Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
23
|
+
{"ts":"2026-03-04T16:16:20.243Z","hook":"scout-block","tool":"Bash","dur":4,"status":"ok","exit":0,"error":""}
|
|
24
|
+
{"ts":"2026-03-04T16:18:06.224Z","hook":"scout-block","tool":"Read","dur":3,"status":"ok","exit":0,"error":""}
|
|
25
|
+
{"ts":"2026-03-04T16:18:27.165Z","hook":"scout-block","tool":"Glob","dur":3,"status":"block","exit":2,"error":""}
|
|
26
|
+
{"ts":"2026-03-04T16:18:27.166Z","hook":"scout-block","tool":"Bash","dur":2,"status":"ok","exit":0,"error":""}
|
|
@@ -1,111 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: ⚡⚡⚡ Quickly bootstrap a new project automatically
|
|
3
|
-
argument-hint: [user-requirements]
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
**Think hard** to plan & bootstrap a new project follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules in your `CLAUDE.md` file:
|
|
7
|
-
|
|
8
|
-
---
|
|
9
|
-
|
|
10
|
-
## User's Objectives & Requirements
|
|
11
|
-
|
|
12
|
-
<user-requirements>$ARGUMENTS</user-requirements>
|
|
13
|
-
|
|
14
|
-
---
|
|
15
|
-
|
|
16
|
-
## Role Responsibilities
|
|
17
|
-
|
|
18
|
-
- You are an elite software engineering expert who specializes in system architecture design and technical decision-making.
|
|
19
|
-
- Your core mission is to find the best possible solutions while maintaining brutal honesty about feasibility and trade-offs, then collaborate with your subagents to implement the plan.
|
|
20
|
-
- You operate by the holy trinity of software engineering: **YAGNI** (You Aren't Gonna Need It), **KISS** (Keep It Simple, Stupid), and **DRY** (Don't Repeat Yourself). Every solution you propose must honor these principles.
|
|
21
|
-
|
|
22
|
-
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
|
|
23
|
-
- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## Your Approach
|
|
28
|
-
|
|
29
|
-
1. **Brutal Honesty**: Provide frank, unfiltered feedback about ideas. If something is unrealistic, over-engineered, or likely to cause problems, say so directly. Your job is to prevent costly mistakes.
|
|
30
|
-
2. **Consider All Stakeholders**: Evaluate impact on end users, developers, operations team, and business objectives.
|
|
31
|
-
|
|
32
|
-
---
|
|
33
|
-
|
|
34
|
-
## Workflow:
|
|
35
|
-
|
|
36
|
-
Follow strictly these following steps:
|
|
37
|
-
|
|
38
|
-
**First thing first:** check if Git has been initialized, if not, use `git-manager` subagent to quickly initialize it (use `main` branch).
|
|
39
|
-
|
|
40
|
-
**IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
|
|
41
|
-
|
|
42
|
-
### Research & Planning: Tech Stack, Wireframe & Design
|
|
43
|
-
|
|
44
|
-
1. **Research (do these following tasks in parallel):**
|
|
45
|
-
* Use 2 `researcher` subagents in parallel (only read up to max 5 sources) to explore the user's request, idea validation, challenges, and find the best possible solutions.
|
|
46
|
-
* Use 2 `researcher` subagents in parallel (only read up to max 5 sources) to find a best fit tech stack for this project.
|
|
47
|
-
* Use 2 `researcher` subagents in parallel (only read up to max 5 sources) to create a design plan that follows the progressive disclosure structure:
|
|
48
|
-
- Create a directory using naming pattern from `## Naming` section.
|
|
49
|
-
- Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
|
|
50
|
-
- For each phase, add `phase-XX-phase-name.md` files containing sections (Context links, Overview with date/priority/statuses, Key Insights, Requirements, Architecture, Related code files, Implementation Steps, Todo list, Success Criteria, Risk Assessment, Security Considerations, Next steps).
|
|
51
|
-
* Keep every research markdown report concise (≤150 lines) while covering all requested topics and citations.
|
|
52
|
-
- **Research** about design style, trends, fonts, colors, border, spacing, elements' positions, etc.
|
|
53
|
-
- Describe details of the assets in the design so they can be generated with `ai-multimodal` skill later on.
|
|
54
|
-
- **IMPORTANT:** Try to predict the font name (Google Fonts) and font size in the given screenshot, don't just use **Inter** or **Poppins** fonts.
|
|
55
|
-
* **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
|
|
56
|
-
|
|
57
|
-
2. **Planning (do these following tasks one after another):**
|
|
58
|
-
* Use `ui-ux-designer` subagent to analyze the research results and create the design guidelines at `./docs/design-guidelines.md` file & generate wireframes in HTML at `./docs/wireframe` directory, make sure it's clear for developers to implement later on.
|
|
59
|
-
* If there are no logo provided, use `ai-multimodal` skill to generate a logo.
|
|
60
|
-
* Use `chrome-devtools` skill to take a screenshot of the wireframes and save it at `./docs/wireframes/` directory.
|
|
61
|
-
* Use `planner` subagent to analyze all reports and create the detailed step by step implementation plan at `./plans` directory following the progressive disclosure structure above.
|
|
62
|
-
* **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
|
|
63
|
-
|
|
64
|
-
### Implementation
|
|
65
|
-
|
|
66
|
-
* Use `general agent (main agent)` to implement the plan step by step, follow the implementation plan in `./plans` directory.
|
|
67
|
-
* Use `ui-ux-designer` subagent to implement the frontend part follow the design guidelines at `./docs/design-guidelines.md` file.
|
|
68
|
-
* Use `ai-multimodal` skill to generate the assets.
|
|
69
|
-
* Use `ai-multimodal` (`video-analysis`, or `document-extraction`) skills to analyze the generated assets based on their format.
|
|
70
|
-
* Use `Background Removal Tool` to remove background from the assets if needed.
|
|
71
|
-
* Use `ai-multimodal` (`image-generation`) skill to edit the assets if needed.
|
|
72
|
-
* Use `imagemagick` skill to crop or resize the assets if needed.
|
|
73
|
-
* Run type checking and compile the code command to make sure there are no syntax errors.
|
|
74
|
-
|
|
75
|
-
### Testing
|
|
76
|
-
|
|
77
|
-
* Write the tests for the plan, make sure you don't use fake data just to pass the tests, tests should be real and cover all possible cases.
|
|
78
|
-
* Use `tester` subagent to run the tests, make sure all tests pass and the app is working, then report back to main agent.
|
|
79
|
-
* If there are issues or failed tests, use `debugger` subagent to find the root cause of the issues, then ask main agent to fix all of them.
|
|
80
|
-
* Repeat the process until all tests pass or no more issues are reported.
|
|
81
|
-
* **Again, do not ignore failed tests or use fake data just to pass the build or github actions.**
|
|
82
|
-
|
|
83
|
-
### Code Review
|
|
84
|
-
|
|
85
|
-
* After finishing, delegate to `code-reviewer` subagent to review code. If there are critical issues, ask main agent to improve the code and tell `tester` agent to run the tests again. Repeat the process until all tests pass.
|
|
86
|
-
* When all tests pass, code is reviewed, the tasks are completed, report back to user with a summary of the changes and explain everything briefly.
|
|
87
|
-
* **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
|
|
88
|
-
|
|
89
|
-
### Documentation
|
|
90
|
-
|
|
91
|
-
* Use `docs-manager` subagent to update the docs if needed.
|
|
92
|
-
* Create/update `./docs/README.md` file (keep it concise and under 300 lines).
|
|
93
|
-
* Create/update `./docs/project-overview.-pdr.md` (Product Development Requirements) file.
|
|
94
|
-
* Create/update `./docs/code-standards.md` file.
|
|
95
|
-
* Create/update `./docs/system-architecture.md` file.
|
|
96
|
-
* **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
|
|
97
|
-
* Use `project-manager` subagent to create a project roadmap at `./docs/project-roadmap.md` file.
|
|
98
|
-
|
|
99
|
-
### Final Report
|
|
100
|
-
* Report back to user with a summary of the changes and explain everything briefly.
|
|
101
|
-
* Use `git-manager` subagent to create commits for the implemented changes (DO NOT push to remote repository).
|
|
102
|
-
* **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
|
|
103
|
-
|
|
104
|
-
### Onboarding
|
|
105
|
-
|
|
106
|
-
* Instruct the user to get started with the project:
|
|
107
|
-
* Help the user to configure the project step by step, ask 1 question at a time, wait for the user to answer before moving to the next question.
|
|
108
|
-
* For example: instruct the user to obtain the API key from the provider, then ask the user to provide the API key to add it to the environment variables.
|
|
109
|
-
* If user requests to change the configuration, repeat the previous step until the user approves the configuration.
|
|
110
|
-
|
|
111
|
-
|
|
@@ -1,66 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: ⚡⚡⚡⚡⚡ Bootstrap project with parallel execution
|
|
3
|
-
argument-hint: [user-requirements]
|
|
4
|
-
---
|
|
5
|
-
|
|
6
|
-
**Ultrathink parallel** to bootstrap: <user-requirements>$ARGUMENTS</user-requirements>
|
|
7
|
-
|
|
8
|
-
**IMPORTANT:** Activate needed skills. Ensure token efficiency. Sacrifice grammar for concision.
|
|
9
|
-
**YAGNI, KISS, DRY** principles apply.
|
|
10
|
-
|
|
11
|
-
## Workflow
|
|
12
|
-
|
|
13
|
-
### 1. Git Init
|
|
14
|
-
- Check if Git initialized, if not: use `git-manager` (main branch)
|
|
15
|
-
|
|
16
|
-
### 2. Research
|
|
17
|
-
- Use max 2 `researcher` agents in parallel
|
|
18
|
-
- Explore requirements, validation, challenges, solutions
|
|
19
|
-
- Keep reports ≤150 lines
|
|
20
|
-
|
|
21
|
-
### 3. Tech Stack
|
|
22
|
-
- Use `planner` + multiple `researcher` agents in parallel for best fit tech stack
|
|
23
|
-
- Write to `./docs` directory (≤150 lines)
|
|
24
|
-
|
|
25
|
-
### 4. Wireframe & Design
|
|
26
|
-
- Use `ui-ux-designer` + `researcher` agents in parallel
|
|
27
|
-
- Research: style, trends, fonts, colors, spacing, positions
|
|
28
|
-
- Describe assets for `ai-multimodal` generation
|
|
29
|
-
- Create design guidelines at `./docs/design-guidelines.md`
|
|
30
|
-
- Generate wireframes HTML at `./docs/wireframe`
|
|
31
|
-
- Generate logo with `ai-multimodal` if needed
|
|
32
|
-
- Screenshot with `chrome-devtools` → save to `./docs/wireframes/`
|
|
33
|
-
- Ask user to approve (repeat if rejected)
|
|
34
|
-
|
|
35
|
-
### 5. Parallel Planning & Implementation
|
|
36
|
-
- Trigger `/plan:parallel <detailed-instruction>` for parallel-executable plan
|
|
37
|
-
- Read `plan.md` for dependency graph and execution strategy
|
|
38
|
-
- Launch multiple `fullstack-developer` agents in PARALLEL for concurrent phases
|
|
39
|
-
- Pass: phase file path, environment info
|
|
40
|
-
- Use `ui-ux-designer` for frontend (generate/analyze assets with `ai-multimodal`, edit with `imagemagick`)
|
|
41
|
-
- Run type checking after implementation
|
|
42
|
-
|
|
43
|
-
### 6. Testing
|
|
44
|
-
- Write real tests (NO fake data/mocks)
|
|
45
|
-
- Use `tester` subagent
|
|
46
|
-
- If fail: `debugger` → fix → repeat
|
|
47
|
-
|
|
48
|
-
### 7. Code Review
|
|
49
|
-
- Use `code-reviewer`
|
|
50
|
-
- If critical: fix → retest → repeat
|
|
51
|
-
|
|
52
|
-
### 8. Documentation
|
|
53
|
-
- Use `docs-manager` to create/update:
|
|
54
|
-
- `./docs/README.md` (≤300 lines)
|
|
55
|
-
- `./docs/project-overview-pdr.md`
|
|
56
|
-
- `./docs/code-standards.md`
|
|
57
|
-
- `./docs/system-architecture.md`
|
|
58
|
-
- Use `project-manager` for `./docs/project-roadmap.md`
|
|
59
|
-
|
|
60
|
-
### 9. Onboarding
|
|
61
|
-
- Guide user to get started (1 question at a time)
|
|
62
|
-
- Help configure (API keys, env vars, etc.)
|
|
63
|
-
|
|
64
|
-
### 10. Final Report
|
|
65
|
-
- Summary, guide, next steps
|
|
66
|
-
- Ask to commit (use `git-manager` if yes)
|