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.
- 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
|
@@ -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**:
|
|
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.
|
|
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.
|
|
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.
|
|
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,
|
|
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
|
|
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**:
|
|
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,
|
|
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,
|
|
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
|
-
|
|
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
|
-
|
|
33
|
-
|
|
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
|
-
|
|
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:**
|
|
56
|
-
**IMPORTANT:**
|
|
57
|
-
**IMPORTANT:**
|
|
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
|
-
|
|
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
|
|
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:
|