thanh-kit 2.5.1 → 2.5.2

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 (123) hide show
  1. package/dist/index.js +20 -61
  2. package/dist/index.js.map +1 -1
  3. package/package.json +1 -1
  4. package/templates/{commands → command-archive}/ask.md +5 -5
  5. package/templates/{commands → command-archive}/ck-help.md +18 -2
  6. package/templates/command-archive/docs/init.md +38 -0
  7. package/templates/command-archive/docs/summarize.md +22 -0
  8. package/templates/command-archive/docs/update.md +76 -0
  9. package/templates/command-archive/journal.md +18 -0
  10. package/templates/{commands → command-archive}/kanban.md +5 -7
  11. package/templates/{commands → command-archive}/plan/archive.md +2 -2
  12. package/templates/command-archive/plan/red-team.md +200 -0
  13. package/templates/command-archive/plan/validate.md +188 -0
  14. package/templates/command-archive/preview.md +283 -0
  15. package/templates/command-archive/review/codebase/parallel.md +122 -0
  16. package/templates/{commands → command-archive}/test/ui.md +3 -3
  17. package/templates/{commands → command-archive}/use-mcp.md +6 -2
  18. package/templates/command-archive/worktree.md +109 -0
  19. package/templates/{workflows → rules}/development-rules.md +12 -53
  20. package/templates/rules/orchestration-protocol.md +43 -0
  21. package/templates/{workflows → rules}/primary-workflow.md +16 -4
  22. package/templates/rules/team-coordination-rules.md +90 -0
  23. package/templates/schemas/ck-config.schema.json +381 -0
  24. package/templates/commands/README.md +0 -251
  25. package/templates/commands/bootstrap/auto/fast.md +0 -111
  26. package/templates/commands/bootstrap/auto/parallel.md +0 -66
  27. package/templates/commands/bootstrap/auto.md +0 -115
  28. package/templates/commands/bootstrap.md +0 -137
  29. package/templates/commands/brainstorm.md +0 -74
  30. package/templates/commands/build.md +0 -39
  31. package/templates/commands/checkpoint.md +0 -156
  32. package/templates/commands/code/auto.md +0 -170
  33. package/templates/commands/code/no-test.md +0 -158
  34. package/templates/commands/code/parallel.md +0 -55
  35. package/templates/commands/code-simplifier.md +0 -71
  36. package/templates/commands/code.md +0 -176
  37. package/templates/commands/compact.md +0 -57
  38. package/templates/commands/content/cro.md +0 -43
  39. package/templates/commands/content/enhance.md +0 -14
  40. package/templates/commands/content/fast.md +0 -13
  41. package/templates/commands/content/good.md +0 -16
  42. package/templates/commands/context.md +0 -48
  43. package/templates/commands/cook/auto/fast.md +0 -26
  44. package/templates/commands/cook/auto/parallel.md +0 -49
  45. package/templates/commands/cook/auto.md +0 -15
  46. package/templates/commands/cook/fast.md +0 -47
  47. package/templates/commands/cook/hard.md +0 -80
  48. package/templates/commands/cook/parallel.md +0 -90
  49. package/templates/commands/cook.md +0 -105
  50. package/templates/commands/create-feature.md +0 -48
  51. package/templates/commands/db-migrate.md +0 -52
  52. package/templates/commands/debug.md +0 -13
  53. package/templates/commands/design/3d.md +0 -83
  54. package/templates/commands/design/describe.md +0 -23
  55. package/templates/commands/design/fast.md +0 -31
  56. package/templates/commands/design/good.md +0 -35
  57. package/templates/commands/design/screenshot.md +0 -34
  58. package/templates/commands/design/video.md +0 -34
  59. package/templates/commands/docs/init.md +0 -39
  60. package/templates/commands/docs/summarize.md +0 -31
  61. package/templates/commands/docs/update.md +0 -57
  62. package/templates/commands/feature.md +0 -62
  63. package/templates/commands/fix/ci.md +0 -17
  64. package/templates/commands/fix/fast.md +0 -19
  65. package/templates/commands/fix/hard.md +0 -39
  66. package/templates/commands/fix/logs.md +0 -26
  67. package/templates/commands/fix/parallel.md +0 -54
  68. package/templates/commands/fix/test.md +0 -20
  69. package/templates/commands/fix/types.md +0 -9
  70. package/templates/commands/fix/ui.md +0 -48
  71. package/templates/commands/fix-issue.md +0 -177
  72. package/templates/commands/fix.md +0 -43
  73. package/templates/commands/generate-dto.md +0 -67
  74. package/templates/commands/git/cm.md +0 -5
  75. package/templates/commands/git/cp.md +0 -4
  76. package/templates/commands/git/merge.md +0 -40
  77. package/templates/commands/git/pr.md +0 -48
  78. package/templates/commands/integrate/polar.md +0 -28
  79. package/templates/commands/integrate/sepay.md +0 -28
  80. package/templates/commands/investigate.md +0 -324
  81. package/templates/commands/journal.md +0 -7
  82. package/templates/commands/lint.md +0 -47
  83. package/templates/commands/migration.md +0 -111
  84. package/templates/commands/performance.md +0 -110
  85. package/templates/commands/plan/ci.md +0 -33
  86. package/templates/commands/plan/cro.md +0 -69
  87. package/templates/commands/plan/fast.md +0 -86
  88. package/templates/commands/plan/hard.md +0 -103
  89. package/templates/commands/plan/parallel.md +0 -152
  90. package/templates/commands/plan/preview.md +0 -40
  91. package/templates/commands/plan/two.md +0 -52
  92. package/templates/commands/plan/validate.md +0 -132
  93. package/templates/commands/plan.md +0 -36
  94. package/templates/commands/pr.md +0 -49
  95. package/templates/commands/preview.md +0 -87
  96. package/templates/commands/release-notes.md +0 -144
  97. package/templates/commands/review/post-task.md +0 -157
  98. package/templates/commands/review-changes.md +0 -46
  99. package/templates/commands/review.md +0 -56
  100. package/templates/commands/scout/ext.md +0 -35
  101. package/templates/commands/scout.md +0 -283
  102. package/templates/commands/security.md +0 -119
  103. package/templates/commands/skill/add.md +0 -36
  104. package/templates/commands/skill/create.md +0 -29
  105. package/templates/commands/skill/fix-logs.md +0 -22
  106. package/templates/commands/skill/optimize/auto.md +0 -25
  107. package/templates/commands/skill/optimize.md +0 -34
  108. package/templates/commands/skill/plan.md +0 -45
  109. package/templates/commands/worktree.md +0 -126
  110. package/templates/memory/session-log.md +0 -186
  111. package/templates/router/README.md +0 -294
  112. package/templates/router/agents-guide.md +0 -38
  113. package/templates/router/commands-guide.md +0 -122
  114. package/templates/router/decision-flow.md +0 -92
  115. package/templates/router/skills-guide.md +0 -127
  116. package/templates/router/workflows-guide.md +0 -68
  117. package/templates/workflows/README.md +0 -241
  118. package/templates/workflows/orchestration-protocol.md +0 -16
  119. /package/templates/{commands → command-archive}/coding-level.md +0 -0
  120. /package/templates/{commands → command-archive}/review/codebase.md +0 -0
  121. /package/templates/{commands → command-archive}/test.md +0 -0
  122. /package/templates/{commands → command-archive}/watzup.md +0 -0
  123. /package/templates/{workflows → rules}/documentation-management.md +0 -0
@@ -1,26 +0,0 @@
1
- ---
2
- description: ⚡ No research. Only scout, plan & implement ["trust me bro"]
3
- argument-hint: [tasks-or-prompt]
4
- ---
5
-
6
- Think harder to plan & start working on these tasks 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
- **IMPORTANT**: Analyze the list of skills at `.claude/skills/*` and intelligently activate the skills that are needed for the task during the process.
20
- **Ensure token efficiency while maintaining high quality.**
21
-
22
- ## Workflow:
23
-
24
- - **Scout**: Use `scout` subagent to find related resources, documents, and code snippets in the current codebase.
25
- - **Plan**: Trigger slash command `/plan:fast <detailed-instruction-prompt>` to create an implementation plan based on the reports from `scout` subagent.
26
- - **Implementation**: Trigger slash command `/code "skip code review step" <plan-path-name>` to implement the plan.
@@ -1,49 +0,0 @@
1
- ---
2
- description: ⚡⚡⚡ Plan parallel phases & execute with fullstack-developer agents
3
- argument-hint: [tasks]
4
- ---
5
-
6
- **Ultrathink parallel** to implement: <tasks>$ARGUMENTS</tasks>
7
-
8
- **IMPORTANT:** Activate needed skills. Ensure token efficiency. Sacrifice grammar for concision.
9
-
10
- ## Workflow
11
-
12
- ### 1. Research (Optional)
13
- - Use max 2 `researcher` agents in parallel if tasks complex
14
- - Use `/scout:ext` to search codebase
15
- - Keep reports ≤150 lines
16
-
17
- ### 2. Parallel Planning
18
- - Trigger `/plan:parallel <detailed-instruction>`
19
- - Wait for plan with dependency graph, execution strategy, file ownership matrix
20
-
21
- ### 3. Parallel Implementation
22
- - Read `plan.md` for dependency graph
23
- - Launch multiple `fullstack-developer` agents in PARALLEL for concurrent phases
24
- - Example: "Phases 1-3 parallel" → launch 3 agents simultaneously
25
- - Pass phase file path: `{plan-dir}/phase-XX-*.md`
26
- - Include environment info
27
- - Wait for all parallel phases complete before dependent phases
28
- - Sequential phases: launch one agent at a time
29
-
30
- ### 4. Testing
31
- - Use `tester` subagent for full test suite
32
- - NO fake data/mocks/cheats
33
- - If fail: use `debugger`, fix, repeat
34
-
35
- ### 5. Code Review
36
- - Use `code-reviewer` for all changes
37
- - If critical issues: fix, retest
38
-
39
- ### 6. Project Management & Docs
40
- - If approved: use `project-manager` + `docs-manager` in parallel
41
- - Update plan files, docs, roadmap
42
- - If rejected: fix and repeat
43
-
44
- ### 7. Final Report
45
- - Summary of all parallel phases
46
- - Guide to get started
47
- - Ask to commit (use `git-manager` if yes)
48
-
49
- **Example:** Phases 1-3 parallel → Launch 3 fullstack-developer agents → Wait → Phase 4 sequential
@@ -1,15 +0,0 @@
1
- ---
2
- description: ⚡⚡ Implement a feature automatically ("trust me bro")
3
- argument-hint: [tasks]
4
- ---
5
-
6
- **Ultrathink** to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
7
- <tasks>$ARGUMENTS</tasks>
8
-
9
- **IMPORTANT:** Analyze the list of skills at `.claude/skills/*` and intelligently activate the skills that are needed for the task during the process.
10
- **Ensure token efficiency while maintaining high quality.**
11
-
12
- ## Workflow:
13
- 1. Trigger slash command `/plan <detailed-instruction-prompt>` to create an implementation plan based on the given tasks.
14
- 2. Trigger slash command `/code <plan>` to implement the plan.
15
- 3. Finally use `AskUserQuestion` tool to ask user if he wants to commit to git repository, if yes trigger `/git:cm` slash command to create a commit.
@@ -1,47 +0,0 @@
1
- ---
2
- description: ⚡ Fast implementation - skip research, minimal planning
3
- argument-hint: [tasks]
4
- ---
5
-
6
- Start working on these tasks immediately with minimal planning:
7
- <tasks>$ARGUMENTS</tasks>
8
-
9
- **Mode:** FAST - Skip research, minimal planning, trust your knowledge.
10
-
11
- ## Workflow
12
-
13
- 1. **Quick Planning** (skip research phase)
14
- - Analyze task requirements directly
15
- - Create minimal todo list with `TodoWrite`
16
- - NO researcher subagents, NO scout commands
17
-
18
- 2. **Rapid Implementation**
19
- - Use `/code` directly on tasks
20
- - Skip multi-step planning documents
21
- - Focus on working code over documentation
22
-
23
- 3. **Quick Validation**
24
- - Run type-check and compile
25
- - Manual spot-check over full test suite
26
- - Skip code-reviewer subagent
27
-
28
- 4. **Commit** (optional)
29
- - Ask user if ready to commit via `AskUserQuestion`
30
- - If yes, use `/git:cm`
31
-
32
- ## When to Use
33
-
34
- - Simple features with clear requirements
35
- - Bug fixes with known solutions
36
- - Refactoring tasks
37
- - When user says "just do it"
38
-
39
- ## Trade-offs
40
-
41
- | Aspect | Fast Mode | Full Mode |
42
- |--------|-----------|-----------|
43
- | Research | Skipped | Multiple agents |
44
- | Planning | Minimal | Full plan docs |
45
- | Testing | Quick check | Full test suite |
46
- | Review | Skipped | Code-reviewer |
47
- | Speed | ~2x faster | Thorough |
@@ -1,80 +0,0 @@
1
- ---
2
- description: ⚡⚡⚡⚡ Thorough implementation with maximum verification
3
- argument-hint: [tasks]
4
- ---
5
-
6
- **Ultrathink** to plan and implement these tasks with maximum verification:
7
- <tasks>$ARGUMENTS</tasks>
8
-
9
- **Mode:** HARD - Extra research, detailed planning, mandatory reviews.
10
-
11
- ## Workflow
12
-
13
- ### 1. Deep Research Phase
14
- - Launch 2-3 `researcher` subagents in parallel covering:
15
- - Technical approach validation
16
- - Edge cases and failure modes
17
- - Security implications
18
- - Performance considerations
19
- - Use `/scout:ext` for comprehensive codebase analysis
20
- - Generate research reports (max 150 lines each)
21
-
22
- ### 2. Comprehensive Planning
23
- - Use `planner` subagent with all research reports
24
- - Create full plan directory with:
25
- - `plan.md` - Overview with risk assessment
26
- - `phase-XX-*.md` - Detailed phase files
27
- - Success criteria for each phase
28
- - Rollback strategy
29
-
30
- ### 3. Verified Implementation
31
- - Implement one phase at a time
32
- - After each phase:
33
- - Run type-check and compile
34
- - Run relevant tests
35
- - Self-review before proceeding
36
-
37
- ### 4. Mandatory Testing
38
- - Use `tester` subagent for full test coverage
39
- - Write tests for:
40
- - Happy path scenarios
41
- - Edge cases from research
42
- - Error handling paths
43
- - NO mocks or fake data allowed
44
- - Repeat until all tests pass
45
-
46
- ### 5. Mandatory Code Review
47
- - Use `code-reviewer` subagent
48
- - Address all critical and major findings
49
- - Re-run tests after fixes
50
- - Repeat until approved
51
-
52
- ### 6. Documentation Update
53
- - Use `docs-manager` to update relevant docs
54
- - Use `project-manager` to update project status
55
- - Record any architectural decisions
56
-
57
- ### 7. Final Report
58
- - Summary of all changes
59
- - Test coverage metrics
60
- - Security considerations addressed
61
- - Unresolved questions (if any)
62
- - Ask user to review and approve
63
-
64
- ## When to Use
65
-
66
- - Critical production features
67
- - Security-sensitive changes
68
- - Public API modifications
69
- - Database schema changes
70
- - Cross-service integrations
71
-
72
- ## Quality Gates
73
-
74
- | Gate | Criteria |
75
- |------|----------|
76
- | Research | 2+ researcher reports |
77
- | Planning | Full plan directory |
78
- | Tests | All pass, no mocks |
79
- | Review | 0 critical/major findings |
80
- | Docs | Updated if needed |
@@ -1,90 +0,0 @@
1
- ---
2
- description: ⚡⚡⚡ Parallel implementation - multiple tasks simultaneously
3
- argument-hint: [tasks]
4
- ---
5
-
6
- Execute these tasks in parallel for maximum efficiency:
7
- <tasks>$ARGUMENTS</tasks>
8
-
9
- **Mode:** PARALLEL - Multiple subagents working concurrently.
10
-
11
- ## Workflow
12
-
13
- ### 1. Task Decomposition
14
- - Analyze tasks for independence
15
- - Group into parallelizable work units
16
- - Identify dependencies between units
17
- - Create dependency graph
18
-
19
- ### 2. Parallel Research (if needed)
20
- Launch multiple `researcher` subagents simultaneously:
21
- ```
22
- Task A research ──┐
23
- Task B research ──┼──► Synthesis
24
- Task C research ──┘
25
- ```
26
-
27
- ### 3. Parallel Planning
28
- - Use `planner` subagent with synthesized research
29
- - Create plan with parallel-safe phases
30
- - Mark file ownership boundaries (prevent conflicts)
31
-
32
- ### 4. Parallel Implementation
33
- Launch multiple `fullstack-developer` subagents:
34
- ```
35
- Phase 1 (Backend API) ──┐
36
- Phase 2 (Frontend UI) ──┼──► Integration
37
- Phase 3 (Tests) ──┘
38
- ```
39
-
40
- **Critical:** Each subagent must stay within file ownership boundaries.
41
-
42
- ### 5. Integration & Testing
43
- - Merge parallel outputs
44
- - Use `tester` subagent for integration tests
45
- - Use `debugger` if integration issues found
46
-
47
- ### 6. Review & Report
48
- - Use `code-reviewer` for final review
49
- - Consolidate all changes
50
- - Report to user
51
-
52
- ## Parallelization Rules
53
-
54
- | Rule | Description |
55
- |------|-------------|
56
- | **File Ownership** | Each subagent owns specific files - no overlap |
57
- | **Dependency Order** | Respect dependency graph |
58
- | **Max Concurrent** | 3 subagents max to prevent conflicts |
59
- | **Sync Points** | Integration checkpoints between phases |
60
-
61
- ## When to Use
62
-
63
- - Multi-component features (backend + frontend)
64
- - Large refactoring across independent modules
65
- - Parallel test writing
66
- - Documentation updates alongside code
67
-
68
- ## Example Task Split
69
-
70
- ```
71
- "Add user authentication with login UI"
72
- ├── Backend API (subagent 1)
73
- │ ├── auth-controller.ts
74
- │ └── auth-service.ts
75
- ├── Frontend UI (subagent 2)
76
- │ ├── login-page.component.ts
77
- │ └── login-form.component.ts
78
- └── Tests (subagent 3)
79
- ├── auth.spec.ts
80
- └── login.e2e.ts
81
- ```
82
-
83
- ## Trade-offs
84
-
85
- | Aspect | Parallel | Sequential |
86
- |--------|----------|------------|
87
- | Speed | ~2-3x faster | Baseline |
88
- | Coordination | Higher complexity | Simple |
89
- | Conflicts | Risk of merge issues | None |
90
- | Context | Split across agents | Unified |
@@ -1,105 +0,0 @@
1
- ---
2
- description: ⚡⚡⚡ Implement a feature [step by step]
3
- argument-hint: [tasks]
4
- ---
5
-
6
- Think harder to plan & start working on these tasks 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
- - Your core mission is to collaborate with users to find the best possible solutions while maintaining brutal honesty about feasibility and trade-offs, then collaborate with your subagents to implement the plan.
14
- - 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.
15
-
16
- ---
17
-
18
- ## Your Approach
19
-
20
- 1. **Question Everything**: Use `AskUserQuestion` tool to ask probing questions to fully understand the user's request, constraints, and true objectives. Don't assume - clarify until you're 100% certain.
21
-
22
- 2. **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. Use `AskUserQuestion` tool to ask the user for their preferences.
23
-
24
- 3. **Explore Alternatives**: Always consider multiple approaches. Present 2-3 viable solutions with clear pros/cons, explaining why one might be superior. Use `AskUserQuestion` tool to ask the user for their preferences.
25
-
26
- 4. **Challenge Assumptions**: Question the user's initial approach. Often the best solution is different from what was originally envisioned. Use `AskUserQuestion` tool to ask the user for their preferences.
27
-
28
- 5. **Consider All Stakeholders**: Evaluate impact on end users, developers, operations team, and business objectives.
29
-
30
- ---
31
-
32
- ## Workflow:
33
-
34
- ### Fullfill the request
35
-
36
- * If you have any questions, use `AskUserQuestion` tool to ask the user to clarify them.
37
- * Ask 1 question at a time, wait for the user to answer before moving to the next question.
38
- * If you don't have any questions, start the next step.
39
-
40
- **IMPORTANT:** Analyze the list of skills at `.claude/skills/*` and intelligently activate the skills that are needed for the task during the process.
41
-
42
- ### Research
43
-
44
- * Use multiple `researcher` subagents in parallel to explore the user's request, idea validation, challenges, and find the best possible solutions.
45
- * Keep every research markdown report concise (≤150 lines) while covering all requested topics and citations.
46
- * Use `/scout:ext` (preferred) or `/scout` (fallback) slash command to search the codebase for files needed to complete the task
47
-
48
- ### Plan
49
-
50
- *. Use `planner` subagent to analyze reports from `researcher` and `scout` subagents to create an implementation plan using the progressive disclosure structure:
51
- - Create a directory using naming pattern from `## Naming` section.
52
- - Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
53
- - 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).
54
-
55
- ### Implementation
56
-
57
- * Use `/code` Slash Command to implement the plan step by step, follow the implementation plan in `./plans` directory.
58
- * Use `ui-ux-designer` subagent to implement the frontend part follow the design guidelines at `./docs/design-guidelines.md` file.
59
- * Use `ai-multimodal` skill to generate image assets.
60
- * Use `ai-multimodal` skill to analyze and verify generated assets.
61
- * Use `media-processing` skill for image editing (crop, resize, remove background) if needed.
62
- * Run type checking and compile the code command to make sure there are no syntax errors.
63
-
64
- ### Testing
65
-
66
- * Write the tests for the plan, **make sure you don't use fake data, mocks, cheats, tricks, temporary solutions, just to pass the build or github actions**, tests should be real and cover all possible cases.
67
- * Use `tester` subagent to run the tests, make sure it works, then report back to main agent.
68
- * 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 and
69
- * Repeat the process until all tests pass or no more issues are reported. Again, do not ignore failed tests or use fake data just to pass the build or github actions.
70
-
71
- ### Code Review
72
-
73
- * 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.
74
- * Repeat the "Testing" process until all tests pass.
75
- * 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.
76
- * **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
77
-
78
- ### Project Management & Documentation
79
-
80
- **If user approves the changes:**
81
- * Use `project-manager` and `docs-manager` subagents in parallel to update the project progress and documentation:
82
- * Use `project-manager` subagent to update the project progress and task status in the given plan file.
83
- * Use `docs-manager` subagent to update the docs in `./docs` directory if needed.
84
- * Use `project-manager` subagent to create a project roadmap at `./docs/project-roadmap.md` file.
85
- * **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
86
-
87
- **If user rejects the changes:**
88
- * Ask user to explain the issues and ask main agent to fix all of them and repeat the process.
89
-
90
- ### Onboarding
91
-
92
- * Instruct the user to get started with the feature if needed (for example: grab the API key, set up the environment variables, etc).
93
- * Help the user to configure (if needed) step by step, ask 1 question at a time, wait for the user to answer and take the answer to set up before moving to the next question.
94
- * If user requests to change the configuration, repeat the previous step until the user approves the configuration.
95
-
96
- ### Final Report
97
- * Report back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
98
- * 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.
99
- - **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
100
- - **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
101
-
102
- **REMEMBER**:
103
- - You can always generate images with `ai-multimodal` skill on the fly for visual assets.
104
- - You always read and analyze the generated assets with `ai-multimodal` skill to verify they meet requirements.
105
- - For image editing (removing background, adjusting, cropping), use ImageMagick or similar tools as needed.
@@ -1,48 +0,0 @@
1
- ---
2
- description: Scaffold a new feature with backend and frontend components
3
- allowed-tools: Bash, Read, Write, Edit, Glob, Grep, TodoWrite, Task
4
- ---
5
-
6
- Create a new feature: $ARGUMENTS
7
-
8
- ## Steps:
9
-
10
- 1. **Analyze Requirements**
11
- - Break down the feature requirements
12
- - Identify the scope (backend only, frontend only, or full-stack)
13
-
14
- 2. **Identify Service Location**
15
- - Determine the appropriate microservice for backend
16
- - Identify the Angular app/module for frontend
17
-
18
- 3. **Plan Implementation**
19
- - Domain entities needed
20
- - CQRS Commands/Queries
21
- - API endpoints (controllers)
22
- - Angular components and services
23
- - DTOs and validation
24
-
25
- 4. **Use Platform Patterns**
26
- - Reference patterns from CLAUDE.md
27
- - Use `.github/prompts/` templates for scaffolding:
28
- - `create-cqrs-command.prompt.md`
29
- - `create-cqrs-query.prompt.md`
30
- - `create-entity-event.prompt.md`
31
- - `create-angular-component.prompt.md`
32
- - `create-api-service.prompt.md`
33
-
34
- 5. **Wait for Approval**
35
- - Present the implementation plan
36
- - **DO NOT proceed without explicit approval**
37
-
38
- 6. **Create Files (After Approval)**
39
- Execute in this order:
40
- 1. Domain entities (`.Domain/Entities/`)
41
- 2. Application layer (`.Application/UseCaseCommands/`, `.Application/UseCaseQueries/`)
42
- 3. Entity DTOs (`.Application/EntityDtos/`)
43
- 4. API controllers (`.Api/Controllers/`)
44
- 5. Frontend components and services
45
-
46
- 7. **Verify**
47
- - Build backend: `dotnet build`
48
- - Build frontend: `nx build <app-name>`
@@ -1,52 +0,0 @@
1
- ---
2
- description: Run or create database migrations
3
- allowed-tools: Bash, Read, Write, Edit, Glob, TodoWrite
4
- ---
5
-
6
- Database migration: $ARGUMENTS
7
-
8
- ## Instructions
9
-
10
- 1. **Parse arguments**:
11
- - `add <name>` → Create new EF Core migration
12
- - `update` → Apply pending migrations
13
- - `list` → List all migrations and status
14
- - `rollback` → Revert last migration
15
- - No argument → Show migration status
16
-
17
- 2. **Identify database provider** from project:
18
- - SQL Server: `PlatformExampleApp.TextSnippet.Persistence`
19
- - PostgreSQL: `PlatformExampleApp.TextSnippet.Persistence.PostgreSql`
20
- - MongoDB: Uses `PlatformMongoMigrationExecutor` (code-based)
21
-
22
- 3. **For EF Core (SQL Server/PostgreSQL)**:
23
-
24
- Add migration:
25
-
26
- ```bash
27
- cd src/PlatformExampleApp/PlatformExampleApp.TextSnippet.Persistence
28
- dotnet ef migrations add <MigrationName> --startup-project ../PlatformExampleApp.TextSnippet.Api
29
- ```
30
-
31
- Update database:
32
-
33
- ```bash
34
- dotnet ef database update --startup-project ../PlatformExampleApp.TextSnippet.Api
35
- ```
36
-
37
- List migrations:
38
-
39
- ```bash
40
- dotnet ef migrations list --startup-project ../PlatformExampleApp.TextSnippet.Api
41
- ```
42
-
43
- 4. **For MongoDB migrations**:
44
- - MongoDB uses code-based migrations via `PlatformMongoMigrationExecutor`
45
- - Location: `*.Persistence.Mongo/Migrations/`
46
- - Migrations run automatically on application startup
47
- - To create: Generate new migration class following existing patterns
48
-
49
- 5. **Safety checks**:
50
- - Warn before applying migrations to production
51
- - Show what changes will be applied
52
- - Recommend backup before destructive operations
@@ -1,13 +0,0 @@
1
- ---
2
- description: ⚡⚡ Debugging technical issues and providing solutions.
3
- argument-hint: [issues]
4
- ---
5
-
6
- **Reported Issues**:
7
- $ARGUMENTS
8
-
9
- Use the `debugger` subagent to find the root cause of the issues, then analyze and explain the reports to the user.
10
-
11
- **IMPORTANT**: **Do not** implement the fix automatically.
12
- **IMPORTANT:** Analyze the skills catalog and activate the skills that are needed for the task during the process.
13
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
@@ -1,83 +0,0 @@
1
- ---
2
- description: Create immersive interactive 3D designs with Three.js
3
- argument-hint: [tasks]
4
- ---
5
-
6
- Think hard to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
7
- <tasks>$ARGUMENTS</tasks>
8
-
9
- ## Required Skills (Priority Order)
10
- 1. **`ui-ux-pro-max`** - Design intelligence database (ALWAYS ACTIVATE FIRST)
11
- 2. **`threejs`** - Three.js/WebGL expertise
12
- 3. **`frontend-design`** - Implementation patterns
13
-
14
- **Ensure token efficiency while maintaining high quality.**
15
-
16
- ## Workflow:
17
- 0. **FIRST**: Run `ui-ux-pro-max` searches for 3D design context:
18
- ```bash
19
- python3 $HOME/.claude/skills/ui-ux-pro-max/scripts/search.py "<product-type>" --domain product
20
- python3 $HOME/.claude/skills/ui-ux-pro-max/scripts/search.py "immersive 3d" --domain style
21
- python3 $HOME/.claude/skills/ui-ux-pro-max/scripts/search.py "animation" --domain ux
22
- ```
23
- 1. Use `ui-ux-designer` subagent and `researcher` subagent to create a comprehensive 3D design plan following the progressive disclosure structure:
24
- - Create a directory using naming pattern from `## Naming` section.
25
- - Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
26
- - 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).
27
- - Keep every research markdown report concise (≤150 lines) while covering all requested topics and citations.
28
- 2. Then use `ui-ux-designer` subagent to implement the plan step by step.
29
- 3. Create immersive 3D experiences using Three.js with particle effects, custom shaders, and interactive elements.
30
- 4. Leverage all available Gemini skills (ai-multimodal, ai-multimodal) for asset generation and validation.
31
- 5. Report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
32
- 6. If user approves the changes, update the `./docs/design-guidelines.md` docs if needed.
33
-
34
- ## 3D Design Requirements:
35
- - Implement Three.js scenes with proper optimization
36
- - Create custom GLSL shaders for unique visual effects
37
- - Design GPU-accelerated particle systems
38
- - Add immersive camera controls and cinematic effects
39
- - Implement post-processing effects and render pipelines
40
- - Ensure responsive behavior across all devices
41
- - Optimize performance for real-time rendering
42
- - Add interactive elements and smooth animations
43
-
44
- ## Gemini Skills Integration:
45
-
46
- ### ai-multimodal Skills & ImageMagick Skill (Asset Generation & Processing):
47
- - Generate textures, skyboxes, and environment maps with ai-multimodal skills
48
- - Create custom particle sprites and effect assets via ai-multimodal prompts
49
- - Generate 3D object textures with specific styles using ai-multimodal skills
50
- - Create video backgrounds for immersive scenes with ai-multimodal capabilities
51
- - Apply camera movements, inpainting, and outpainting through ai-multimodal skills
52
- - Refine, batch edit, and optimize outputs with imagemagick skill workflows
53
-
54
- ### ImageMagick Skill (Image Processing):
55
- - Process and optimize textures for WebGL
56
- - Create normal maps and height maps from images
57
- - Generate sprite sheets for particle systems
58
- - Remove backgrounds for transparent textures
59
- - Resize and optimize assets for performance
60
- - Apply masks for complex texture effects
61
-
62
- ### Eyes Tools (Visual Analysis):
63
- - Analyze reference images for 3D scene composition
64
- - Compare design mockups with implementation
65
- - Validate texture quality and visual consistency
66
- - Extract color palettes from reference materials
67
- - Verify shader effects and visual output
68
-
69
- ## Implementation Stack:
70
- - Three.js for 3D rendering
71
- - GLSL for custom vertex and fragment shaders
72
- - HTML/CSS/JS for UI integration
73
- - WebGL for GPU-accelerated graphics
74
- - Post-processing libraries for effects
75
-
76
- ## Notes:
77
- - Remember that you have the capability to generate images, videos, edit images, etc. with ai-multimodal skill. Use them extensively to create realistic 3D assets.
78
- - Always review, analyze and double check generated assets with ai-multimodal skill.
79
- - Leverage ai-multimodal skills and imagemagick skill to create custom textures, particle sprites, environment maps, and visual effects.
80
- - Use imagemagick skill to process and optimize all visual assets for WebGL performance.
81
- - Test 3D scenes across different devices and optimize for smooth 60fps performance.
82
- - Maintain and update `./docs/design-guidelines.md` docs with 3D design patterns and shader libraries.
83
- - Document shader code, particle systems, and reusable 3D components for future reference.
@@ -1,23 +0,0 @@
1
- ---
2
- description: Describe a design based on screenshot/video
3
- argument-hint: [screenshot]
4
- ---
5
-
6
- Think hard to describe the design based on this screenshot/video:
7
- <screenshot>$ARGUMENTS</screenshot>
8
-
9
- ## Required Skills (Priority Order)
10
- 1. **`ui-ux-pro-max`** - Design intelligence database (ALWAYS ACTIVATE FIRST)
11
- 2. **`frontend-design`** - Visual analysis
12
-
13
- **Ensure token efficiency while maintaining high quality.**
14
-
15
- ## Workflow:
16
- 1. Use `ai-multimodal` skills to describe super details of the screenshot/video so the developer can implement it easily.
17
- - Be specific about design style, every element, elements' positions, every interaction, every animation, every transition, every color, every border, every icon, every font style, font size, font weight, every spacing, every padding, every margin, every size, every shape, every texture, every material, every light, every shadow, every reflection, every refraction, every blur, every glow, every image, background transparency, etc.
18
- - **IMPORTANT:** Try to predict the font name (Google Fonts) and font size in the given screenshot, don't just use Inter or Poppins.
19
- 2. Use `ui-ux-designer` subagent to create a design implementation plan following the progressive disclosure structure so the result matches the screenshot/video:
20
- - Create a directory using naming pattern from `## Naming` section.
21
- - Save the overview access point at `plan.md`, keep it generic, under 80 lines, and list each phase with status/progress and links.
22
- - 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).
23
- 3. Report back to user with a summary of the plan.
@@ -1,31 +0,0 @@
1
- ---
2
- description: Create a quick design
3
- argument-hint: [tasks]
4
- ---
5
-
6
- Think hard to plan & start working on these tasks follow the Orchestration Protocol, Core Responsibilities, Subagents Team and Development Rules:
7
- <tasks>$ARGUMENTS</tasks>
8
-
9
- ## Required Skills (Priority Order)
10
- 1. **`ui-ux-pro-max`** - Design intelligence database (ALWAYS ACTIVATE FIRST)
11
- 2. **`frontend-design`** - Quick implementation
12
-
13
- **Ensure token efficiency while maintaining high quality.**
14
-
15
- ## Workflow:
16
- 1. **FIRST**: Run `ui-ux-pro-max` searches to gather design intelligence:
17
- ```bash
18
- python3 $HOME/.claude/skills/ui-ux-pro-max/scripts/search.py "<product-type>" --domain product
19
- python3 $HOME/.claude/skills/ui-ux-pro-max/scripts/search.py "<style-keywords>" --domain style
20
- python3 $HOME/.claude/skills/ui-ux-pro-max/scripts/search.py "<mood>" --domain typography
21
- python3 $HOME/.claude/skills/ui-ux-pro-max/scripts/search.py "<industry>" --domain color
22
- ```
23
- 2. Use `ui-ux-designer` subagent to start the design process.
24
- 3. If user doesn't specify, create the design in pure HTML/CSS/JS.
25
- 4. Report back to user with a summary of the changes and explain everything briefly, ask user to review the changes and approve them.
26
- 5. If user approves the changes, update the `./docs/design-guidelines.md` docs if needed.
27
-
28
- ## Notes:
29
- - Remember that you have the capability to generate images, videos, edit images, etc. with `ai-multimodal` skills. Use them to create the design and real assets.
30
- - Always review, analyze and double check generated assets with `ai-multimodal` skills to verify quality.
31
- - Maintain and update `./docs/design-guidelines.md` docs if needed.