cokit-cli 1.0.5 → 1.0.6

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 (94) hide show
  1. package/.vscode/settings.json +70 -0
  2. package/INIT.md +154 -0
  3. package/agents/git-manager.agent.md +1 -3
  4. package/instructions/ck-development.instructions.md +14 -0
  5. package/package.json +1 -1
  6. package/prompts/ck-bootstrap.prompt.md +8 -8
  7. package/prompts/ck-brainstorm.prompt.md +48 -11
  8. package/prompts/ck-code-auto.prompt.md +5 -4
  9. package/prompts/ck-code-no-test.prompt.md +3 -2
  10. package/prompts/ck-code-parallel.prompt.md +2 -1
  11. package/prompts/ck-code.prompt.md +2 -1
  12. package/prompts/ck-cook-auto-parallel.prompt.md +2 -1
  13. package/prompts/ck-cook-auto.prompt.md +5 -3
  14. package/prompts/ck-cook.prompt.md +7 -6
  15. package/prompts/ck-fix-hard.prompt.md +2 -2
  16. package/prompts/ck-git-merge.prompt.md +1 -1
  17. package/prompts/ck-plan-archive.prompt.md +8 -9
  18. package/prompts/ck-plan-ci.prompt.md +4 -3
  19. package/prompts/ck-plan-fast.prompt.md +38 -2
  20. package/prompts/ck-plan-hard.prompt.md +42 -6
  21. package/prompts/ck-plan-parallel.prompt.md +40 -7
  22. package/prompts/ck-plan-two.prompt.md +40 -5
  23. package/prompts/ck-plan-validate.prompt.md +4 -5
  24. package/prompts/ck-plan.prompt.md +80 -30
  25. package/prompts/ck-skill-add.prompt.md +5 -5
  26. package/prompts/ck-skill-create.prompt.md +5 -5
  27. package/prompts/ck-skill-fix-logs.prompt.md +2 -2
  28. package/prompts/ck-skill-optimize-auto.prompt.md +5 -5
  29. package/prompts/ck-skill-optimize.prompt.md +5 -5
  30. package/prompts/ck-skill-plan.prompt.md +7 -7
  31. package/prompts/ck-test-ui.prompt.md +1 -1
  32. package/prompts/ck-worktree.prompt.md +7 -7
  33. package/skills/ck-chrome-devtools/scripts/README.md +1 -1
  34. package/skills/ck-markdown-novel-viewer/scripts/server.cjs +1 -1
  35. package/skills/ck-payment-integration/README.md +1 -1
  36. package/skills/ck-repomix/references/usage-patterns.md +2 -2
  37. package/skills/ck-shopify/README.md +5 -5
  38. package/skills/ck-skill-creator/SKILL.md +12 -14
  39. package/templates/repo/.github/agents/brainstormer.agent.md +71 -0
  40. package/templates/repo/.github/agents/code-reviewer.agent.md +128 -0
  41. package/templates/repo/.github/agents/database-admin.agent.md +91 -0
  42. package/templates/repo/.github/agents/debugger.agent.md +128 -0
  43. package/templates/repo/.github/agents/docs-manager.agent.md +121 -0
  44. package/templates/repo/.github/agents/fullstack-developer.agent.md +96 -0
  45. package/templates/repo/.github/agents/git-manager.agent.md +390 -0
  46. package/templates/repo/.github/agents/mcp-manager.agent.md +93 -0
  47. package/templates/repo/.github/agents/planner.agent.md +94 -0
  48. package/templates/repo/.github/agents/project-manager.agent.md +124 -0
  49. package/templates/repo/.github/agents/researcher.agent.md +32 -0
  50. package/templates/repo/.github/agents/scout-external.agent.md +141 -0
  51. package/templates/repo/.github/agents/scout.agent.md +107 -0
  52. package/templates/repo/.github/agents/tester.agent.md +106 -0
  53. package/templates/repo/.github/agents/ui-ux-designer.agent.md +225 -0
  54. package/templates/repo/.github/collections/ck-core.collection.yml +30 -0
  55. package/templates/repo/.github/collections/ck-development-rules.collection.yml +18 -0
  56. package/templates/repo/.github/collections/ck-documentation.collection.yml +18 -0
  57. package/templates/repo/.github/collections/ck-git-workflow.collection.yml +18 -0
  58. package/templates/repo/.github/collections/ck-orchestration.collection.yml +22 -0
  59. package/templates/repo/.github/collections/ck-ui-design.collection.yml +18 -0
  60. package/templates/repo/.github/instructions/ck-development.instructions.md +14 -0
  61. package/templates/repo/.github/prompts/ck-bootstrap.prompt.md +8 -8
  62. package/templates/repo/.github/prompts/ck-brainstorm.prompt.md +48 -11
  63. package/templates/repo/.github/prompts/ck-code-auto.prompt.md +5 -4
  64. package/templates/repo/.github/prompts/ck-code-no-test.prompt.md +3 -2
  65. package/templates/repo/.github/prompts/ck-code-parallel.prompt.md +2 -1
  66. package/templates/repo/.github/prompts/ck-code.prompt.md +2 -1
  67. package/templates/repo/.github/prompts/ck-cook-auto-parallel.prompt.md +2 -1
  68. package/templates/repo/.github/prompts/ck-cook-auto.prompt.md +5 -3
  69. package/templates/repo/.github/prompts/ck-cook.prompt.md +7 -6
  70. package/templates/repo/.github/prompts/ck-fix-hard.prompt.md +2 -2
  71. package/templates/repo/.github/prompts/ck-git-merge.prompt.md +1 -1
  72. package/templates/repo/.github/prompts/ck-plan-archive.prompt.md +8 -9
  73. package/templates/repo/.github/prompts/ck-plan-ci.prompt.md +4 -3
  74. package/templates/repo/.github/prompts/ck-plan-fast.prompt.md +38 -2
  75. package/templates/repo/.github/prompts/ck-plan-hard.prompt.md +42 -6
  76. package/templates/repo/.github/prompts/ck-plan-parallel.prompt.md +40 -7
  77. package/templates/repo/.github/prompts/ck-plan-two.prompt.md +40 -5
  78. package/templates/repo/.github/prompts/ck-plan-validate.prompt.md +4 -5
  79. package/templates/repo/.github/prompts/ck-plan.prompt.md +80 -30
  80. package/templates/repo/.github/prompts/ck-skill-add.prompt.md +5 -5
  81. package/templates/repo/.github/prompts/ck-skill-create.prompt.md +5 -5
  82. package/templates/repo/.github/prompts/ck-skill-fix-logs.prompt.md +2 -2
  83. package/templates/repo/.github/prompts/ck-skill-optimize-auto.prompt.md +5 -5
  84. package/templates/repo/.github/prompts/ck-skill-optimize.prompt.md +5 -5
  85. package/templates/repo/.github/prompts/ck-skill-plan.prompt.md +7 -7
  86. package/templates/repo/.github/prompts/ck-test-ui.prompt.md +1 -1
  87. package/templates/repo/.github/prompts/ck-worktree.prompt.md +7 -7
  88. package/templates/repo/.github/skills/ck-chrome-devtools/scripts/README.md +1 -1
  89. package/templates/repo/.github/skills/ck-markdown-novel-viewer/scripts/server.cjs +1 -1
  90. package/templates/repo/.github/skills/ck-payment-integration/README.md +1 -1
  91. package/templates/repo/.github/skills/ck-repomix/references/usage-patterns.md +2 -2
  92. package/templates/repo/.github/skills/ck-shopify/README.md +5 -5
  93. package/templates/repo/.github/skills/ck-skill-creator/SKILL.md +12 -14
  94. package/templates/repo/.vscode/settings.json +66 -2
@@ -18,13 +18,13 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
18
18
 
19
19
  ## Your Approach
20
20
 
21
- 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
+ 1. **Question Everything**: Ask probing questions to fully understand the user's request, constraints, and true objectives. Don't assume - clarify until you're 100% certain.
22
22
 
23
- 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
+ 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. Ask the user for their preferences.
24
24
 
25
- 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
+ 3. **Explore Alternatives**: Always consider multiple approaches. Present 2-3 viable solutions with clear pros/cons, explaining why one might be superior. Ask the user for their preferences.
26
26
 
27
- 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
+ 4. **Challenge Assumptions**: Question the user's initial approach. Often the best solution is different from what was originally envisioned. Ask the user for their preferences.
28
28
 
29
29
  5. **Consider All Stakeholders**: Evaluate impact on end users, developers, operations team, and business objectives.
30
30
 
@@ -34,7 +34,7 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
34
34
 
35
35
  ### Fullfill the request
36
36
 
37
- * If you have any questions, use `AskUserQuestion` tool to ask the user to clarify them.
37
+ * If you have any questions, ask the user to clarify them.
38
38
  * Ask 1 question at a time, wait for the user to answer before moving to the next question.
39
39
  * If you don't have any questions, start the next step.
40
40
 
@@ -86,7 +86,8 @@ Think harder to plan & start working on these tasks follow the Orchestration Pro
86
86
 
87
87
  ### Final Report
88
88
  * Report back to user with a summary of the changes and explain everything briefly, guide user to get started and suggest the next steps.
89
- * Ask the user if they want to commit and push to git repository, if yes, commit and push to git repository.
89
+ * Ask the user if they want to commit changes to git repository, if yes, commit to local repository only.
90
+ * **IMPORTANT:** Do NOT push to remote repository. Only commit locally. If user wants to push, suggest them to run `/commit` or `git push` manually.
90
91
  - **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
91
92
  - **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
92
93
 
@@ -12,9 +12,9 @@ tools: ['search/codebase', 'search/changes', 'read/problems', 'read/terminalLast
12
12
  If the user provides a screenshots or videos,
13
13
 
14
14
  ### Fullfill the request
15
- **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.
15
+ **Question Everything**: Ask probing questions to fully understand the user's request, constraints, and true objectives. Don't assume - clarify until you're 100% certain.
16
16
 
17
- * If you have any questions, use `AskUserQuestion` tool to ask the user to clarify them.
17
+ * If you have any questions, ask the user to clarify them.
18
18
  * Ask 1 question at a time, wait for the user to answer before moving to the next question.
19
19
  * If you don't have any questions, start the next step.
20
20
 
@@ -37,5 +37,5 @@ git push origin {TO_BRANCH}
37
37
 
38
38
  ## Notes
39
39
  - If `gh` command is not available, instruct the user to install and authorize GitHub CLI first.
40
- - If you need more clarifications, use `AskUserQuestion` tool to ask the user for more details.
40
+ - If you need more clarifications, ask the user for more details.
41
41
  - Always fetch and pull latest remote state before merging to avoid stale conflicts.
@@ -20,7 +20,7 @@ Read the plan directory:
20
20
  - `phase-*.md` - 20 first lines of each phase file to understand the progress and status
21
21
 
22
22
  ### Step 2: Summarize the plans and document them with `/journal`
23
- Use `AskUserQuestion` tool to ask if user wants to document journal entries or not.
23
+ Ask if user wants to document journal entries or not.
24
24
  Skip this step if user selects "No".
25
25
  If user selects "Yes":
26
26
  - Analyze the information in previous steps.
@@ -29,8 +29,8 @@ If user selects "Yes":
29
29
  - Keep journal entries in the `./docs/journals/` directory.
30
30
 
31
31
  ### Step 3: Ask user to confirm the action before archiving these plans
32
- Use `AskUserQuestion` tool to ask if user wants to proceed with archiving these plans, select specific plans to archive or all completed plans only.
33
- Use `AskUserQuestion` tool to ask if user wants to delete permanently or move to the `.s/archive` directory.
32
+ Ask if user wants to proceed with archiving these plans, select specific plans to archive or all completed plans only.
33
+ Ask if user wants to delete permanently or move to the `.s/archive` directory.
34
34
 
35
35
  ### Step 4: Archive the plans
36
36
  Start archiving the plans based on the user's choice:
@@ -38,7 +38,7 @@ Start archiving the plans based on the user's choice:
38
38
  - Delete the plans permanently: `rm -rf .s/<plan-1> .s/<plan-2> ...`
39
39
 
40
40
  ### Step 5: Ask if user wants to commit the changes
41
- Use `AskUserQuestion` tool to ask if user wants to commit the changes with these options:
41
+ Ask if user wants to commit the changes with these options:
42
42
  - Stage and commit the changes (Use `/git:cm` )
43
43
  - Commit and push the changes (Use `/git:cp` )
44
44
  - Nah, I'll do it later
@@ -51,8 +51,7 @@ After archiving the plans, provide summary:
51
51
  - Table of journal entries that are created (title, status, created date, LOC)
52
52
 
53
53
  ## Important Notes
54
-
55
- **IMPORTANT:** Only ask questions about genuine decision points - don't manufacture artificial choices.
56
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
57
- **IMPORTANT:** In the last summary report, list any unresolved questions at the end, if any.
58
- **IMPORTANT:** Ensure token efficiency while maintaining high quality.
54
+ - **IMPORTANT:** Only ask questions about genuine decision points - don't manufacture artificial choices.
55
+ - **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
56
+ - **IMPORTANT:** In the last summary report, list any unresolved questions at the end, if any.
57
+ - **IMPORTANT:** Ensure token efficiency while maintaining high quality.
@@ -29,6 +29,7 @@ read the github actions logs, analyze and find the root causes of the issues, th
29
29
  **Output:**
30
30
  Provide at least 2 implementation approaches with clear trade-offs, and explain the pros and cons of each approach, and provide a recommended approach.
31
31
 
32
- **IMPORTANT:** Ask the user for confirmation before implementing.
33
- **IMPORTANT:**
34
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
32
+ ## Important Notes
33
+ - **IMPORTANT:** Ask the user for confirmation before implementing.
34
+ - **IMPORTANT:** Sacrifice grammar for the sake of concision when writing outputs.
35
+ - **IMPORTANT:** **Do not** start implementing.
@@ -59,9 +59,45 @@ Use to:
59
59
  - Save the overview access point at `{plan-dir}.md`. Keep it generic, under 80 lines, and list each implementation phase with status and progress plus links to phase files.
60
60
  - For each phase, create `{plan-dir}/phase-XX-phase-name-here.md` containing the following sections in order: Context links (reference parent plan, dependencies, docs), Overview (date, description, priority, implementation status, review status), Key Insights, Requirements, Architecture, Related code files, Implementation Steps, Todo list, Success Criteria, Risk Assessment, Security Considerations, Next steps.
61
61
 
62
+ ## Clarification & Finalization Flow
63
+
64
+ After creating the initial plan:
65
+
66
+ 1. **If questions exist** → List questions at the end of your response (max 3-5 questions)
67
+ 2. **After user answers** → Update `plan.md` with clarified requirements
68
+ 3. **Repeat** until no ambiguities remain
69
+ 4. **Finalize** → Confirm plan is complete and ready for implementation
70
+
71
+ **Question format:**
72
+ ```
73
+ ## Questions before finalizing:
74
+ 1. [Question 1]?
75
+ 2. [Question 2]?
76
+ ...
77
+ ```
78
+
79
+ ## Next Steps Suggestion
80
+
81
+ After plan is finalized, suggest the appropriate implementation command:
82
+
83
+ | Task Type | Suggested Command |
84
+ |-----------|-------------------|
85
+ | Feature development | `/cook` or `/code` |
86
+ | Bug fix | `/fix` |
87
+ | Refactoring | `/refactor` |
88
+ | Documentation | `/docs` |
89
+
90
+ **Example output:**
91
+ ```
92
+ ✅ Plan finalized: {plan-dir}/plan.md
93
+
94
+ Ready to implement? Run one of these:
95
+ - `/cook` - Full-featured implementation with tests
96
+ - `/code` - Quick implementation
97
+ ```
98
+
62
99
  ## Important Notes
63
100
  - **IMPORTANT:** Ensure token consumption efficiency while maintaining high quality.
64
- - **IMPORTANT:**
65
101
  - **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
66
102
  - **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
67
- - **IMPORTANT**: **Do not** start implementing.
103
+ - **IMPORTANT:** **Do not** start implementing.
@@ -39,7 +39,7 @@ Check the `## Plan Context` section in the injected context:
39
39
  | `auto` | Automatically execute :validate {plan-path}` |
40
40
  | `off` | Skip validation step entirely |
41
41
 
42
- **If mode is `prompt`:** Use `AskUserQuestion` tool with options above.
42
+ **If mode is `prompt`:** Ask user with options above.
43
43
  **If user chooses validation or mode is `auto`:** Execute :validate {plan-path}` SlashCommand.
44
44
 
45
45
  ## Output Requirements
@@ -81,9 +81,45 @@ Check the `## Plan Context` section in the injected context:
81
81
  - Save the overview access point at `{plan-dir}.md`. Keep it generic, under 80 lines, and list each implementation phase with status and progress plus links to phase files.
82
82
  - For each phase, create `{plan-dir}/phase-XX-phase-name-here.md` containing the following sections in order: Context links (reference parent plan, dependencies, docs), Overview (date, description, priority, implementation status, review status), Key Insights, Requirements, Architecture, Related code files, Implementation Steps, Todo list, Success Criteria, Risk Assessment, Security Considerations, Next steps.
83
83
 
84
+ ## Clarification & Finalization Flow
85
+
86
+ After creating the initial plan:
87
+
88
+ 1. **If questions exist** → List questions at the end of your response (max 3-5 questions)
89
+ 2. **After user answers** → Update `plan.md` with clarified requirements
90
+ 3. **Repeat** until no ambiguities remain
91
+ 4. **Finalize** → Confirm plan is complete and ready for implementation
92
+
93
+ **Question format:**
94
+ ```
95
+ ## Questions before finalizing:
96
+ 1. [Question 1]?
97
+ 2. [Question 2]?
98
+ ...
99
+ ```
100
+
101
+ ## Next Steps Suggestion
102
+
103
+ After plan is finalized, suggest the appropriate implementation command:
104
+
105
+ | Task Type | Suggested Command |
106
+ |-----------|-------------------|
107
+ | Feature development | `/cook` or `/code` |
108
+ | Bug fix | `/fix` |
109
+ | Refactoring | `/refactor` |
110
+ | Documentation | `/docs` |
111
+
112
+ **Example output:**
113
+ ```
114
+ ✅ Plan finalized: {plan-dir}/plan.md
115
+
116
+ Ready to implement? Run one of these:
117
+ - `/cook` - Full-featured implementation with tests
118
+ - `/code` - Quick implementation
119
+ ```
120
+
84
121
  ## Important Notes
85
- **IMPORTANT:**
86
- **IMPORTANT:** Ensure token efficiency while maintaining high quality.
87
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
88
- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
89
- **IMPORTANT**: **Do not** start implementing.
122
+ - **IMPORTANT:** Ensure token efficiency while maintaining high quality.
123
+ - **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
124
+ - **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
125
+ - **IMPORTANT:** **Do not** start implementing.
@@ -31,7 +31,7 @@ ${input}
31
31
  | `auto` | Automatically execute :validate {plan-path}` |
32
32
  | `off` | Skip validation step entirely |
33
33
 
34
- **If mode is `prompt`:** Use `AskUserQuestion` tool with options above.
34
+ **If mode is `prompt`:** Ask user with options above.
35
35
  **If user chooses validation or mode is `auto`:** Execute :validate {plan-path}` SlashCommand.
36
36
 
37
37
  ## Special Requirements for Parallel Execution
@@ -117,10 +117,43 @@ Phase 04: Integration Tests (depends on 01, 02, 03)
117
117
  - Execution strategy (e.g., "Phases 1-3 parallel, then Phase 4")
118
118
  - File ownership matrix (which phase owns which files)
119
119
 
120
+ ## Clarification & Finalization Flow
121
+
122
+ After creating the initial plan:
123
+
124
+ 1. **If questions exist** → List questions at the end of your response (max 3-5 questions)
125
+ 2. **After user answers** → Update `plan.md` with clarified requirements
126
+ 3. **Repeat** until no ambiguities remain
127
+ 4. **Finalize** → Confirm plan is complete and ready for implementation
128
+
129
+ **Question format:**
130
+ ```
131
+ ## Questions before finalizing:
132
+ 1. [Question 1]?
133
+ 2. [Question 2]?
134
+ ...
135
+ ```
136
+
137
+ ## Next Steps Suggestion
138
+
139
+ After plan is finalized, suggest the parallel execution command:
140
+
141
+ **Example output:**
142
+ ```
143
+ ✅ Plan finalized: {plan-dir}/plan.md
144
+
145
+ Parallel execution strategy:
146
+ - Phases 1-3: Can run in parallel
147
+ - Phase 4: Depends on 1-3
148
+
149
+ Ready to implement? Run:
150
+ - `/cook:parallel` - Execute phases in parallel
151
+ - `/cook` - Execute phases sequentially
152
+ ```
153
+
120
154
  ## Important Notes
121
- **IMPORTANT:**
122
- **IMPORTANT:** Ensure token efficiency while maintaining high quality.
123
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
124
- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
125
- **IMPORTANT:** Do not start implementing.
126
- **IMPORTANT:** Each phase MUST have exclusive file ownership - no file can be modified by multiple phases.
155
+ - **IMPORTANT:** Ensure token efficiency while maintaining high quality.
156
+ - **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
157
+ - **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
158
+ - **IMPORTANT:** Do not start implementing.
159
+ - **IMPORTANT:** Each phase MUST have exclusive file ownership - no file can be modified by multiple phases.
@@ -35,9 +35,44 @@ create 2 detailed implementation plans for this following task:
35
35
  ---
36
36
  ```
37
37
 
38
+ ## Clarification & Finalization Flow
39
+
40
+ After creating the initial plans:
41
+
42
+ 1. **If questions exist** → List questions at the end of your response (max 3-5 questions)
43
+ 2. **After user chooses approach** → Update selected `plan.md` with clarified requirements
44
+ 3. **Finalize** → Confirm plan is complete and ready for implementation
45
+
46
+ **Question format:**
47
+ ```
48
+ ## Questions before finalizing:
49
+ 1. Which approach do you prefer? (A or B)
50
+ 2. [Other questions]?
51
+ ...
52
+ ```
53
+
54
+ ## Next Steps Suggestion
55
+
56
+ After plan is finalized, suggest the appropriate implementation command:
57
+
58
+ | Task Type | Suggested Command |
59
+ |-----------|-------------------|
60
+ | Feature development | `/cook` or `/code` |
61
+ | Bug fix | `/fix` |
62
+ | Refactoring | `/refactor` |
63
+ | Documentation | `/docs` |
64
+
65
+ **Example output:**
66
+ ```
67
+ ✅ Plan finalized: {plan-dir}/plan.md (Approach A selected)
68
+
69
+ Ready to implement? Run one of these:
70
+ - `/cook` - Full-featured implementation with tests
71
+ - `/code` - Quick implementation
72
+ ```
73
+
38
74
  ## Important Notes
39
- **IMPORTANT:**
40
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
41
- **IMPORTANT:** Ensure token efficiency while maintaining high quality.
42
- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
43
- **IMPORTANT**: **Do not** start implementing.
75
+ - **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
76
+ - **IMPORTANT:** Ensure token efficiency while maintaining high quality.
77
+ - **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
78
+ - **IMPORTANT:** **Do not** start implementing.
@@ -75,7 +75,7 @@ Options:
75
75
 
76
76
  ### Step 4: Interview User
77
77
 
78
- Use `AskUserQuestion` tool to present questions.
78
+ Present questions to user.
79
79
 
80
80
  **Rules:**
81
81
  - Use question count from `## Plan Context` → `Validation: mode=X, questions=MIN-MAX`
@@ -112,7 +112,6 @@ After validation completes, provide summary:
112
112
  - Recommendation: proceed to implementation or revise plan first
113
113
 
114
114
  ## Important Notes
115
-
116
- **IMPORTANT:** Only ask questions about genuine decision points - don't manufacture artificial choices.
117
- **IMPORTANT:** If plan is simple with few decisions, it's okay to ask fewer than min questions.
118
- **IMPORTANT:** Prioritize questions that could change implementation significantly.
115
+ - **IMPORTANT:** Only ask questions about genuine decision points - don't manufacture artificial choices.
116
+ - **IMPORTANT:** If plan is simple with few decisions, it's okay to ask fewer than min questions.
117
+ - **IMPORTANT:** Prioritize questions that could change implementation significantly.
@@ -1,29 +1,80 @@
1
- ---
2
- agent: 'agent'
3
- description: 'Intelligent plan creation with prompt enhancement'
4
- tools: ['search/codebase', 'search/changes', 'web/fetch', 'read/problems']
5
- ---
6
-
7
- ## Your mission
8
- <task>
9
- ${input}
10
- </task>
11
-
12
- ## Pre-Creation Check (Active vs Suggested Plan Detection)
13
-
14
- Check the `## Plan Context` section in the injected context:
15
- - If "Plan:" shows a path → Active plan exists. Ask user: "Active plan found: {path}. Continue with this? [Y/n]"
16
- - If "Suggested:" shows a path → Branch-matched plan hint only. Ask user if they want to activate it or create new.
17
- - If "Plan: none" → Proceed to create new plan using naming pattern from `## Naming` section.
18
-
19
- ## Workflow
20
- - Analyze the given task and use `AskUserQuestion` tool to ask for more details if needed.
21
- - Decide to use :fast` or :hard` SlashCommands based on the complexity.
22
- - Execute SlashCommand: :fast <detailed-instructions-prompt>` or :hard <detailed-instructions-prompt>`
23
- Note: `detailed-instructions-prompt` is **an enhanced prompt** that describes the task in detail based on the provided task description.
24
-
25
- ## Important Notes
26
- **IMPORTANT:**
27
- **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
28
- **IMPORTANT:** Ensure token efficiency while maintaining high quality.
29
- **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
30
- **IMPORTANT**: **Do not** start implementing.
1
+ ---
2
+ agent: 'agent'
3
+ description: 'Intelligent plan creation with prompt enhancement'
4
+ tools: ['search/codebase', 'search/changes', 'web/fetch', 'read/problems']
5
+ ---
6
+
7
+ ## Your mission
8
+ <task>
9
+ ${input}
10
+ </task>
11
+
12
+ ## Pre-Creation Check (Active vs Suggested Plan Detection)
13
+
14
+ Check the `## Plan Context` section in the injected context:
15
+ - If "Plan:" shows a path → Active plan exists. Ask user: "Active plan found: {path}. Continue with this? [Y/n]"
16
+ - If "Suggested:" shows a path → Branch-matched plan hint only. Ask user if they want to activate it or create new.
17
+ - If "Plan: none" → Proceed to create new plan using naming pattern from `## Naming` section.
18
+
19
+ ## Workflow
20
+ - Analyze the given task and ask user for more details if needed.
21
+ - Decide complexity:
22
+ - **Simple task** (clear scope, no research needed) → Use `/plan:fast`
23
+ - **Complex task** (needs research, multiple aspects) Use `/plan:hard`
24
+ - Execute the chosen SlashCommand with an **enhanced detailed prompt**:
25
+ - `/plan:fast <detailed-instructions-prompt>`
26
+ - `/plan:hard <detailed-instructions-prompt>`
27
+
28
+ **Note:** The `detailed-instructions-prompt` must describe the task in detail based on user's input.
29
+
30
+ ## Output
31
+ The output MUST be markdown plan files saved to `plans/` directory:
32
+ ```
33
+ {plan-dir}/
34
+ ├── plan.md ← Main plan with YAML frontmatter
35
+ ├── phase-XX-*.md ← Implementation phases
36
+ └── reports/ ← Any analysis reports
37
+ ```
38
+
39
+ ## Clarification & Finalization Flow
40
+
41
+ After creating the initial plan:
42
+
43
+ 1. **If questions exist** → List questions at the end of your response (max 3-5 questions)
44
+ 2. **After user answers** → Update `plan.md` with clarified requirements
45
+ 3. **Repeat** until no ambiguities remain
46
+ 4. **Finalize** → Confirm plan is complete and ready for implementation
47
+
48
+ **Question format:**
49
+ ```
50
+ ## Questions before finalizing:
51
+ 1. [Question 1]?
52
+ 2. [Question 2]?
53
+ ...
54
+ ```
55
+
56
+ ## Next Steps Suggestion
57
+
58
+ After plan is finalized, suggest the appropriate implementation command:
59
+
60
+ | Task Type | Suggested Command |
61
+ |-----------|-------------------|
62
+ | Feature development | `/cook` or `/code` |
63
+ | Bug fix | `/fix` |
64
+ | Refactoring | `/refactor` |
65
+ | Documentation | `/docs` |
66
+
67
+ **Example output:**
68
+ ```
69
+ ✅ Plan finalized: {plan-dir}/plan.md
70
+
71
+ Ready to implement? Run one of these:
72
+ - `/cook` - Full-featured implementation with tests
73
+ - `/code` - Quick implementation
74
+ ```
75
+
76
+ ## Important Notes
77
+ - **IMPORTANT:** Sacrifice grammar for the sake of concision when writing reports.
78
+ - **IMPORTANT:** Ensure token efficiency while maintaining high quality.
79
+ - **IMPORTANT:** In reports, list any unresolved questions at the end, if any.
80
+ - **IMPORTANT:** **Do not** start implementing.
@@ -5,7 +5,7 @@ tools: ['search/codebase', 'search/changes', 'web/fetch', 'read/problems']
5
5
  ---
6
6
 
7
7
  Think harder.
8
- Use `skill-creator` and `claude-code` skills.
8
+ Use `skill-creator` skill.
9
9
 
10
10
  ## Arguments
11
11
  $1: skill name (required, default: "")
@@ -24,13 +24,13 @@ $2
24
24
  Base on the requirements:
25
25
  - Always keep in mind that `SKILL.md` and reference files should be token consumption efficient, so that **progressive disclosure** can be leveraged at best.
26
26
  - `SKILL.md` is always short and concise, straight to the point, treat it as a quick reference guide.
27
- - If you're given nothing, use `AskUserQuestion` tool for clarifications and to research about the topic.
27
+ - If you're given nothing, ask for clarifications and to research about the topic.
28
28
  - If you're given an URL, it's documentation page, explore every internal link and .
29
29
  - If you receive a lot of URLs, use multiple s to explore them , .
30
30
  - If you receive a lot of files, use multiple s to explore them , .
31
31
  - If you're given a Github URL, use [](https://repomix.com/guide/usage) command to summarize ([install it](https://repomix.com/guide/installation) if needed) and spawn multiple s to explore it , .
32
32
 
33
33
  **IMPORTANT:**
34
- - Skills are not documentation, they are practical instructions for Claude Code to use the tools, packages, plugins or APIs to achieve the tasks.
35
- - Each skill teaches Claude how to perform a specific development task, not what a tool does.
36
- - Claude Code can activate multiple skills automatically to achieve the user's request.
34
+ - Skills are not documentation, they are practical instructions for GitHub Copilot to use the tools, packages, plugins or APIs to achieve the tasks.
35
+ - Each skill teaches GitHub Copilot how to perform a specific development task, not what a tool does.
36
+ - GitHub Copilot can activate multiple skills automatically to achieve the user's request.
@@ -5,7 +5,7 @@ tools: ['search/codebase', 'search/changes', 'web/fetch', 'read/problems']
5
5
  ---
6
6
 
7
7
  Ultrathink.
8
- Use `skill-creator` and `claude-code` skills.
8
+ Use `skill-creator` skill.
9
9
 
10
10
  ## Your mission
11
11
  Create a new skill in directory.
@@ -17,13 +17,13 @@ Create a new skill in directory.
17
17
  Base on the requirements:
18
18
  - Always keep in mind that `SKILL.md` and reference files should be token consumption efficient, so that **progressive disclosure** can be leveraged at best.
19
19
  - `SKILL.md` is always short and concise, straight to the point, treat it as a quick reference guide.
20
- - If you're given nothing, use `AskUserQuestion` tool for clarifications and to research about the topic.
20
+ - If you're given nothing, ask for clarifications and to research about the topic.
21
21
  - If you're given an URL, it's documentation page, explore every internal link and .
22
22
  - If you receive a lot of URLs, use multiple s to explore them , .
23
23
  - If you receive a lot of files, use multiple s to explore them , .
24
24
  - If you're given a Github URL, use [](https://repomix.com/guide/usage) command to summarize ([install it](https://repomix.com/guide/installation) if needed) and spawn multiple s to explore it , .
25
25
 
26
26
  **IMPORTANT:**
27
- - Skills are not documentation, they are practical instructions for Claude Code to use the tools, packages, plugins or APIs to achieve the tasks.
28
- - Each skill teaches Claude how to perform a specific development task, not what a tool does.
29
- - Claude Code can activate multiple skills automatically to achieve the user's request.
27
+ - Skills are not documentation, they are practical instructions for GitHub Copilot to use the tools, packages, plugins or APIs to achieve the tasks.
28
+ - Each skill teaches GitHub Copilot how to perform a specific development task, not what a tool does.
29
+ - GitHub Copilot can activate multiple skills automatically to achieve the user's request.
@@ -5,7 +5,7 @@ tools: ['search/codebase', 'search/changes', 'web/fetch', 'read/problems', 'read
5
5
  ---
6
6
 
7
7
  Think harder.
8
- Use `skill-creator` and `claude-code` skills.
8
+ Use `skill-creator` skill.
9
9
 
10
10
  ## Your mission
11
11
  Fix the agent skill based on the current `logs.txt` file (in the project root directory).
@@ -15,7 +15,7 @@ Fix the agent skill based on the current `logs.txt` file (in the project root di
15
15
 
16
16
  ## Rules of Skill Fixing:
17
17
  Base on the requirements:
18
- - If you're given nothing, use `AskUserQuestion` tool for clarifications and to research about the topic.
18
+ - If you're given nothing, ask for clarifications and to research about the topic.
19
19
  - If you're given an URL, it's documentation page, explore every internal link and .
20
20
  - If you receive a lot of URLs, use multiple s to explore them , .
21
21
  - If you receive a lot of files, use multiple s to explore them , .
@@ -5,21 +5,21 @@ tools: ['search/codebase', 'search/changes', 'web/fetch', 'read/problems']
5
5
  ---
6
6
 
7
7
  Think harder.
8
- Use `skill-creator` and `claude-code` skills.
8
+ Use `skill-creator` skill.
9
9
 
10
10
  ## Arguments
11
11
  SKILL: $1 (default: `*`)
12
12
  PROMPT: $2 (default: empty)
13
13
 
14
14
  ## Your mission
15
- Optimize an existing skill in directory.
15
+ Optimize an existing skill in directory.
16
16
  Always keep in mind that `SKILL.md` and reference files should be token consumption efficient, so that **progressive disclosure** can be leveraged at best.
17
17
  `SKILL.md` is always short and concise, straight to the point, treat it as a quick reference guide.
18
18
 
19
19
  **IMPORTANT:**
20
- - Skills are not documentation, they are practical instructions for Claude Code to use the tools, packages, plugins or APIs to achieve the tasks.
21
- - Each skill teaches Claude how to perform a specific development task, not what a tool does.
22
- - Claude Code can activate multiple skills automatically to achieve the user's request.
20
+ - Skills are not documentation, they are practical instructions for GitHub Copilot to use the tools, packages, plugins or APIs to achieve the tasks.
21
+ - Each skill teaches GitHub Copilot how to perform a specific development task, not what a tool does.
22
+ - GitHub Copilot can activate multiple skills automatically to achieve the user's request.
23
23
 
24
24
  ## Additional instructions
25
25
  <additional-instructions>$PROMPT</additional-instructions>
@@ -5,14 +5,14 @@ tools: ['search/codebase', 'search/changes', 'web/fetch', 'read/problems']
5
5
  ---
6
6
 
7
7
  Think harder.
8
- Use `skill-creator` and `claude-code` skills.
8
+ Use `skill-creator` skill.
9
9
 
10
10
  ## Arguments
11
11
  SKILL: $1 (default: `*`)
12
12
  PROMPT: $2 (default: empty)
13
13
 
14
14
  ## Your mission
15
- Propose a plan to optimize an existing skill in directory.
15
+ Propose a plan to optimize an existing skill in directory.
16
16
  When you finish, ask user to review your plan:
17
17
  - If the user approve: Write down a plan follow "Output Requirements", then ask user if they want to start implementing.
18
18
  - If the user reject: Revise the plan or ask more questions to clarify more about the user's request (ask one question at the time), then repeat the review process.
@@ -29,6 +29,6 @@ An output implementation plan must also follow the progressive disclosure struct
29
29
  - 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).
30
30
 
31
31
  **IMPORTANT:**
32
- - Skills are not documentation, they are practical instructions for Claude Code to use the tools, packages, plugins or APIs to achieve the tasks.
33
- - Each skill teaches Claude how to perform a specific development task, not what a tool does.
34
- - Claude Code can activate multiple skills automatically to achieve the user's request.
32
+ - Skills are not documentation, they are practical instructions for GitHub Copilot to use the tools, packages, plugins or APIs to achieve the tasks.
33
+ - Each skill teaches GitHub Copilot how to perform a specific development task, not what a tool does.
34
+ - GitHub Copilot can activate multiple skills automatically to achieve the user's request.
@@ -5,17 +5,17 @@ tools: ['search/codebase', 'search/changes', 'web/fetch', 'read/problems']
5
5
  ---
6
6
 
7
7
  Think harder.
8
- First: Activate `skill-creator` and `claude-code` skills.
8
+ First: Activate `skill-creator` skill.
9
9
 
10
10
  Employ `sequential-thinking` or `problem-solving` skills for complex problem-solving that requires structured analysis
11
- Finally, when creating a plan,
11
+ Finally, when creating a plan,
12
12
 
13
13
  ## Arguments
14
14
  SKILL: $1 (default: `*`)
15
15
  PROMPT: $2 (default: empty)
16
16
 
17
17
  ## Your mission
18
- Propose a plan to create a new skill in directory.
18
+ Propose a plan to create a new skill in directory.
19
19
  When you finish, ask user to review your plan:
20
20
  - If the user approve: Write down a plan follow "Output Requirements", then ask user if they want to start implementing.
21
21
  - If the user reject: Revise the plan or ask more questions to clarify more about the user's request (ask one question at the time), then repeat the review process.
@@ -39,8 +39,8 @@ An output implementation plan must also follow the progressive disclosure struct
39
39
  - 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).
40
40
 
41
41
  **IMPORTANT:**
42
- - Analyze the given task and use `AskUserQuestion` tool to ask for more details if needed.
42
+ - Analyze the given task and ask for more details if needed.
43
43
  - Ensure token consumption efficiency while maintaining high quality.
44
- - Skills are not documentation, they are practical instructions for Claude Code to use the tools, packages, plugins or APIs to achieve the tasks.
45
- - Each skill teaches Claude how to perform a specific development task, not what a tool does.
46
- - Claude Code can activate multiple skills automatically to achieve the user's request.
44
+ - Skills are not documentation, they are practical instructions for GitHub Copilot to use the tools, packages, plugins or APIs to achieve the tasks.
45
+ - Each skill teaches GitHub Copilot how to perform a specific development task, not what a tool does.
46
+ - GitHub Copilot can activate multiple skills automatically to achieve the user's request.
@@ -78,7 +78,7 @@ node screenshot.js --url https://example.com/settings --output settings.png --cl
78
78
  - Use `ai-multimodal` to analyze all screenshots and visual elements.
79
79
  - Generate a comprehensive report in Markdown format, embedding all screenshots directly in the report.
80
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` .
81
+ - Ask if user wants to preview the report with `/preview` .
82
82
 
83
83
  ## Output Requirements
84
84
  How to write reports: