cokit-cli 1.0.5 → 1.0.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.vscode/settings.json +70 -0
- package/INIT.md +154 -0
- package/agents/git-manager.agent.md +1 -3
- package/instructions/ck-development.instructions.md +14 -0
- package/package.json +1 -1
- package/prompts/ck-bootstrap.prompt.md +8 -8
- package/prompts/ck-brainstorm.prompt.md +48 -11
- package/prompts/ck-code-auto.prompt.md +5 -4
- package/prompts/ck-code-no-test.prompt.md +3 -2
- package/prompts/ck-code-parallel.prompt.md +2 -1
- package/prompts/ck-code.prompt.md +2 -1
- package/prompts/ck-cook-auto-parallel.prompt.md +2 -1
- package/prompts/ck-cook-auto.prompt.md +5 -3
- package/prompts/ck-cook.prompt.md +7 -6
- package/prompts/ck-fix-hard.prompt.md +2 -2
- package/prompts/ck-git-merge.prompt.md +1 -1
- package/prompts/ck-plan-archive.prompt.md +8 -9
- package/prompts/ck-plan-ci.prompt.md +4 -3
- package/prompts/ck-plan-fast.prompt.md +38 -2
- package/prompts/ck-plan-hard.prompt.md +42 -6
- package/prompts/ck-plan-parallel.prompt.md +40 -7
- package/prompts/ck-plan-two.prompt.md +40 -5
- package/prompts/ck-plan-validate.prompt.md +4 -5
- package/prompts/ck-plan.prompt.md +80 -30
- package/prompts/ck-skill-add.prompt.md +5 -5
- package/prompts/ck-skill-create.prompt.md +5 -5
- package/prompts/ck-skill-fix-logs.prompt.md +2 -2
- package/prompts/ck-skill-optimize-auto.prompt.md +5 -5
- package/prompts/ck-skill-optimize.prompt.md +5 -5
- package/prompts/ck-skill-plan.prompt.md +7 -7
- package/prompts/ck-test-ui.prompt.md +1 -1
- package/prompts/ck-worktree.prompt.md +7 -7
- package/skills/ck-chrome-devtools/scripts/README.md +1 -1
- package/skills/ck-markdown-novel-viewer/scripts/server.cjs +1 -1
- package/skills/ck-payment-integration/README.md +1 -1
- package/skills/ck-repomix/references/usage-patterns.md +2 -2
- package/skills/ck-shopify/README.md +5 -5
- package/skills/ck-skill-creator/SKILL.md +12 -14
- package/templates/repo/.github/agents/brainstormer.agent.md +71 -0
- package/templates/repo/.github/agents/code-reviewer.agent.md +128 -0
- package/templates/repo/.github/agents/database-admin.agent.md +91 -0
- package/templates/repo/.github/agents/debugger.agent.md +128 -0
- package/templates/repo/.github/agents/docs-manager.agent.md +121 -0
- package/templates/repo/.github/agents/fullstack-developer.agent.md +96 -0
- package/templates/repo/.github/agents/git-manager.agent.md +390 -0
- package/templates/repo/.github/agents/mcp-manager.agent.md +93 -0
- package/templates/repo/.github/agents/planner.agent.md +94 -0
- package/templates/repo/.github/agents/project-manager.agent.md +124 -0
- package/templates/repo/.github/agents/researcher.agent.md +32 -0
- package/templates/repo/.github/agents/scout-external.agent.md +141 -0
- package/templates/repo/.github/agents/scout.agent.md +107 -0
- package/templates/repo/.github/agents/tester.agent.md +106 -0
- package/templates/repo/.github/agents/ui-ux-designer.agent.md +225 -0
- package/templates/repo/.github/collections/ck-core.collection.yml +30 -0
- package/templates/repo/.github/collections/ck-development-rules.collection.yml +18 -0
- package/templates/repo/.github/collections/ck-documentation.collection.yml +18 -0
- package/templates/repo/.github/collections/ck-git-workflow.collection.yml +18 -0
- package/templates/repo/.github/collections/ck-orchestration.collection.yml +22 -0
- package/templates/repo/.github/collections/ck-ui-design.collection.yml +18 -0
- package/templates/repo/.github/instructions/ck-development.instructions.md +14 -0
- package/templates/repo/.github/prompts/ck-bootstrap.prompt.md +8 -8
- package/templates/repo/.github/prompts/ck-brainstorm.prompt.md +48 -11
- package/templates/repo/.github/prompts/ck-code-auto.prompt.md +5 -4
- package/templates/repo/.github/prompts/ck-code-no-test.prompt.md +3 -2
- package/templates/repo/.github/prompts/ck-code-parallel.prompt.md +2 -1
- package/templates/repo/.github/prompts/ck-code.prompt.md +2 -1
- package/templates/repo/.github/prompts/ck-cook-auto-parallel.prompt.md +2 -1
- package/templates/repo/.github/prompts/ck-cook-auto.prompt.md +5 -3
- package/templates/repo/.github/prompts/ck-cook.prompt.md +7 -6
- package/templates/repo/.github/prompts/ck-fix-hard.prompt.md +2 -2
- package/templates/repo/.github/prompts/ck-git-merge.prompt.md +1 -1
- package/templates/repo/.github/prompts/ck-plan-archive.prompt.md +8 -9
- package/templates/repo/.github/prompts/ck-plan-ci.prompt.md +4 -3
- package/templates/repo/.github/prompts/ck-plan-fast.prompt.md +38 -2
- package/templates/repo/.github/prompts/ck-plan-hard.prompt.md +42 -6
- package/templates/repo/.github/prompts/ck-plan-parallel.prompt.md +40 -7
- package/templates/repo/.github/prompts/ck-plan-two.prompt.md +40 -5
- package/templates/repo/.github/prompts/ck-plan-validate.prompt.md +4 -5
- package/templates/repo/.github/prompts/ck-plan.prompt.md +80 -30
- package/templates/repo/.github/prompts/ck-skill-add.prompt.md +5 -5
- package/templates/repo/.github/prompts/ck-skill-create.prompt.md +5 -5
- package/templates/repo/.github/prompts/ck-skill-fix-logs.prompt.md +2 -2
- package/templates/repo/.github/prompts/ck-skill-optimize-auto.prompt.md +5 -5
- package/templates/repo/.github/prompts/ck-skill-optimize.prompt.md +5 -5
- package/templates/repo/.github/prompts/ck-skill-plan.prompt.md +7 -7
- package/templates/repo/.github/prompts/ck-test-ui.prompt.md +1 -1
- package/templates/repo/.github/prompts/ck-worktree.prompt.md +7 -7
- package/templates/repo/.github/skills/ck-chrome-devtools/scripts/README.md +1 -1
- package/templates/repo/.github/skills/ck-markdown-novel-viewer/scripts/server.cjs +1 -1
- package/templates/repo/.github/skills/ck-payment-integration/README.md +1 -1
- package/templates/repo/.github/skills/ck-repomix/references/usage-patterns.md +2 -2
- package/templates/repo/.github/skills/ck-shopify/README.md +5 -5
- package/templates/repo/.github/skills/ck-skill-creator/SKILL.md +12 -14
- package/templates/repo/.vscode/settings.json +66 -2
|
@@ -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
|
|
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`:**
|
|
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:**
|
|
87
|
-
**IMPORTANT:**
|
|
88
|
-
**IMPORTANT:**
|
|
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`:**
|
|
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:**
|
|
123
|
-
**IMPORTANT:**
|
|
124
|
-
**IMPORTANT:**
|
|
125
|
-
**IMPORTANT:**
|
|
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:**
|
|
41
|
-
**IMPORTANT:**
|
|
42
|
-
**IMPORTANT:**
|
|
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
|
-
|
|
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:**
|
|
117
|
-
**IMPORTANT:**
|
|
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
|
|
21
|
-
- Decide
|
|
22
|
-
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
**
|
|
29
|
-
|
|
30
|
-
|
|
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`
|
|
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,
|
|
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
|
|
35
|
-
- Each skill teaches
|
|
36
|
-
-
|
|
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`
|
|
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,
|
|
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
|
|
28
|
-
- Each skill teaches
|
|
29
|
-
-
|
|
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`
|
|
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,
|
|
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`
|
|
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
|
|
21
|
-
- Each skill teaches
|
|
22
|
-
-
|
|
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`
|
|
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
|
|
33
|
-
- Each skill teaches
|
|
34
|
-
-
|
|
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`
|
|
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
|
|
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
|
|
45
|
-
- Each skill teaches
|
|
46
|
-
-
|
|
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
|
-
-
|
|
81
|
+
- Ask if user wants to preview the report with `/preview` .
|
|
82
82
|
|
|
83
83
|
## Output Requirements
|
|
84
84
|
How to write reports:
|
|
@@ -21,7 +21,7 @@ node info --json
|
|
|
21
21
|
- `envFiles`: array of .env* files found
|
|
22
22
|
- `dirtyState`: boolean
|
|
23
23
|
|
|
24
|
-
### Step 2: Gather Info
|
|
24
|
+
### Step 2: Gather Info
|
|
25
25
|
|
|
26
26
|
**Detect branch prefix from user's description:**
|
|
27
27
|
- Keywords "fix", "bug", "error", "issue" → prefix = `fix`
|
|
@@ -32,10 +32,10 @@ node info --json
|
|
|
32
32
|
- Keywords "perf", "performance", "optimize" → prefix = `perf`
|
|
33
33
|
- Everything else → prefix = `feat`
|
|
34
34
|
|
|
35
|
-
**For MONOREPO:**
|
|
35
|
+
**For MONOREPO:** Ask user if project not specified:
|
|
36
36
|
```javascript
|
|
37
37
|
// If user said "/worktree add auth" but multiple projects exist
|
|
38
|
-
|
|
38
|
+
// Ask user with questions like:
|
|
39
39
|
questions: [{
|
|
40
40
|
header: "Project",
|
|
41
41
|
question: "Which project should the worktree be created for?",
|
|
@@ -47,7 +47,7 @@ AskUserQuestion({
|
|
|
47
47
|
|
|
48
48
|
**For env files:** Always ask which to copy:
|
|
49
49
|
```javascript
|
|
50
|
-
|
|
50
|
+
// Ask user with questions like:
|
|
51
51
|
questions: [{
|
|
52
52
|
header: "Env files",
|
|
53
53
|
question: "Which environment files should be copied to the worktree?",
|
|
@@ -97,8 +97,8 @@ node create "<SLUG>" --prefix <TYPE> --env "<FILES>"
|
|
|
97
97
|
| `MISSING_ARGS` | Missing project/feature for monorepo | Ask for both |
|
|
98
98
|
| `MISSING_FEATURE` | No feature name (standalone) | Ask for feature |
|
|
99
99
|
| `PROJECT_NOT_FOUND` | Project not in .gitmodules | Show available projects |
|
|
100
|
-
| `MULTIPLE_PROJECTS_MATCH` | Ambiguous project name |
|
|
101
|
-
| `MULTIPLE_WORKTREES_MATCH` | Ambiguous worktree for remove |
|
|
100
|
+
| `MULTIPLE_PROJECTS_MATCH` | Ambiguous project name | Ask user |
|
|
101
|
+
| `MULTIPLE_WORKTREES_MATCH` | Ambiguous worktree for remove | Ask user |
|
|
102
102
|
| `BRANCH_CHECKED_OUT` | Branch in use elsewhere | Suggest different name |
|
|
103
103
|
| `WORKTREE_EXISTS` | Path already exists | Suggest use or remove |
|
|
104
104
|
| `WORKTREE_CREATE_FAILED` | Git command failed | Show git error |
|
|
@@ -114,7 +114,7 @@ Claude: [Runs: node info --json]
|
|
|
114
114
|
[Detects prefix from "fix" keyword: fix]
|
|
115
115
|
[Converts slug: "login-validation-bug"]
|
|
116
116
|
|
|
117
|
-
Claude: [
|
|
117
|
+
Claude: [Asks user for env files]
|
|
118
118
|
"Which environment files should be copied?"
|
|
119
119
|
Options: .env.example
|
|
120
120
|
|
|
@@ -110,7 +110,7 @@ Take a screenshot with automatic compression.
|
|
|
110
110
|
node screenshot.js --output screenshot.png [--url https://example.com] [--full-page true] [--selector .element] [--max-size 5] [--no-compress]
|
|
111
111
|
```
|
|
112
112
|
|
|
113
|
-
**Automatic Compression**: Screenshots >5MB are automatically compressed using ImageMagick to ensure compatibility with Gemini API and
|
|
113
|
+
**Automatic Compression**: Screenshots >5MB are automatically compressed using ImageMagick to ensure compatibility with Gemini API and AI assistants. Install ImageMagick for this feature:
|
|
114
114
|
- macOS: `brew install imagemagick`
|
|
115
115
|
- Linux: `sudo apt-get install imagemagick`
|
|
116
116
|
|
|
@@ -289,7 +289,7 @@ async function main() {
|
|
|
289
289
|
}
|
|
290
290
|
|
|
291
291
|
// Background mode - spawn child and exit (legacy mode for manual runs)
|
|
292
|
-
// Skip if --foreground is set (for
|
|
292
|
+
// Skip if --foreground is set (for AI assistant background tasks)
|
|
293
293
|
if (args.background && !args.foreground && !args.isChild) {
|
|
294
294
|
const childArgs = ['--port', String(args.port), '--host', args.host, '--child'];
|
|
295
295
|
if (resolved.type === 'file') {
|
|
@@ -58,7 +58,7 @@ payment-integration/
|
|
|
58
58
|
|
|
59
59
|
### Activate the Skill
|
|
60
60
|
|
|
61
|
-
|
|
61
|
+
GitHub Copilot will automatically activate this skill when you mention payment integration, subscriptions, webhooks, or platform-specific terms (SePay, Polar).
|
|
62
62
|
|
|
63
63
|
### Manual Activation
|
|
64
64
|
|
|
@@ -144,9 +144,9 @@ repomix --include "$(cat staged-files.txt | tr '\n' ',')" -o .context/latest.xml
|
|
|
144
144
|
{"version": "2.0.0", "tasks": [{"label": "Package for AI", "type": "shell", "command": "repomix --include 'src/**' --remove-comments --copy"}]}
|
|
145
145
|
```
|
|
146
146
|
|
|
147
|
-
###
|
|
147
|
+
### GitHub Copilot
|
|
148
148
|
```bash
|
|
149
|
-
repomix --style markdown --copy # Then paste into
|
|
149
|
+
repomix --style markdown --copy # Then paste into GitHub Copilot
|
|
150
150
|
```
|
|
151
151
|
|
|
152
152
|
## Language-Specific Patterns
|
|
@@ -5,9 +5,9 @@ This directory contains comprehensive research and analysis of various APIs for
|
|
|
5
5
|
## Contents
|
|
6
6
|
|
|
7
7
|
### Shopify GraphQL Admin API Analysis
|
|
8
|
-
**File:** `shopify-graphql-admin-api-analysis.md`
|
|
9
|
-
**Date:** 2025-10-25
|
|
10
|
-
**Status:** Complete
|
|
8
|
+
**File:** `shopify-graphql-admin-api-analysis.md`
|
|
9
|
+
**Date:** 2025-10-25
|
|
10
|
+
**Status:** Complete
|
|
11
11
|
**Thoroughness:** Very Thorough
|
|
12
12
|
|
|
13
13
|
A comprehensive analysis of Shopify's GraphQL Admin API covering:
|
|
@@ -62,5 +62,5 @@ These documents are intended for:
|
|
|
62
62
|
|
|
63
63
|
---
|
|
64
64
|
|
|
65
|
-
**Last Updated:** 2025-10-25
|
|
66
|
-
**Maintained By:**
|
|
65
|
+
**Last Updated:** 2025-10-25
|
|
66
|
+
**Maintained By:** CoKit Contributors
|