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.
Files changed (69) hide show
  1. package/package.json +1 -1
  2. package/templates/command-archive/ask.md +56 -0
  3. package/templates/command-archive/ck-help.md +129 -0
  4. package/templates/command-archive/coding-level.md +48 -0
  5. package/templates/command-archive/docs/init.md +38 -0
  6. package/templates/command-archive/docs/summarize.md +22 -0
  7. package/templates/command-archive/docs/update.md +76 -0
  8. package/templates/command-archive/journal.md +18 -0
  9. package/templates/command-archive/kanban.md +99 -0
  10. package/templates/command-archive/plan/archive.md +57 -0
  11. package/templates/command-archive/plan/red-team.md +200 -0
  12. package/templates/command-archive/plan/validate.md +188 -0
  13. package/templates/command-archive/preview.md +283 -0
  14. package/templates/command-archive/review/codebase/parallel.md +122 -0
  15. package/templates/command-archive/review/codebase.md +49 -0
  16. package/templates/command-archive/test/ui.md +92 -0
  17. package/templates/command-archive/test.md +8 -0
  18. package/templates/command-archive/use-mcp.md +38 -0
  19. package/templates/command-archive/watzup.md +8 -0
  20. package/templates/command-archive/worktree.md +109 -0
  21. package/templates/hooks/.logs/hook-log.jsonl +26 -0
  22. package/templates/settings.local.json +13 -0
  23. package/templates/commands/bootstrap/auto/fast.md +0 -111
  24. package/templates/commands/bootstrap/auto/parallel.md +0 -66
  25. package/templates/commands/bootstrap/auto.md +0 -115
  26. package/templates/commands/bootstrap.md +0 -137
  27. package/templates/commands/code/auto.md +0 -203
  28. package/templates/commands/code/no-test.md +0 -174
  29. package/templates/commands/code/parallel.md +0 -100
  30. package/templates/commands/code.md +0 -205
  31. package/templates/commands/content/cro.md +0 -43
  32. package/templates/commands/content/enhance.md +0 -14
  33. package/templates/commands/content/fast.md +0 -13
  34. package/templates/commands/content/good.md +0 -16
  35. package/templates/commands/cook/auto/fast.md +0 -26
  36. package/templates/commands/cook/auto/parallel.md +0 -49
  37. package/templates/commands/cook/auto.md +0 -15
  38. package/templates/commands/cook.md +0 -105
  39. package/templates/commands/debug.md +0 -13
  40. package/templates/commands/design/3d.md +0 -83
  41. package/templates/commands/design/describe.md +0 -23
  42. package/templates/commands/design/fast.md +0 -31
  43. package/templates/commands/design/good.md +0 -35
  44. package/templates/commands/design/screenshot.md +0 -34
  45. package/templates/commands/design/video.md +0 -34
  46. package/templates/commands/fix/ci.md +0 -17
  47. package/templates/commands/fix/fast.md +0 -19
  48. package/templates/commands/fix/hard.md +0 -39
  49. package/templates/commands/fix/logs.md +0 -26
  50. package/templates/commands/fix/parallel.md +0 -54
  51. package/templates/commands/fix/test.md +0 -20
  52. package/templates/commands/fix/types.md +0 -9
  53. package/templates/commands/fix/ui.md +0 -48
  54. package/templates/commands/fix.md +0 -43
  55. package/templates/commands/plan/ci.md +0 -33
  56. package/templates/commands/plan/cro.md +0 -69
  57. package/templates/commands/plan/fast.md +0 -82
  58. package/templates/commands/plan/hard.md +0 -108
  59. package/templates/commands/plan/parallel.md +0 -145
  60. package/templates/commands/plan/two.md +0 -45
  61. package/templates/commands/plan.md +0 -30
  62. package/templates/commands/scout/ext.md +0 -39
  63. package/templates/commands/scout.md +0 -28
  64. package/templates/commands/skill/add.md +0 -36
  65. package/templates/commands/skill/create.md +0 -29
  66. package/templates/commands/skill/fix-logs.md +0 -22
  67. package/templates/commands/skill/optimize/auto.md +0 -25
  68. package/templates/commands/skill/optimize.md +0 -34
  69. 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":""}
@@ -0,0 +1,13 @@
1
+ {
2
+ "permissions": {
3
+ "allow": [
4
+ "Bash(cat:*)",
5
+ "Bash(ls:*)",
6
+ "Bash(test:*)",
7
+ "Bash(chmod:*)",
8
+ "Bash(./install.sh)",
9
+ "Bash(.venv/bin/pip install:*)",
10
+ "Bash(grep:*)"
11
+ ]
12
+ }
13
+ }
@@ -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)