cokit-cli 1.2.0 → 1.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (243) hide show
  1. package/README.md +47 -36
  2. package/agents/brainstormer.agent.md +1 -1
  3. package/agents/debugger.agent.md +1 -1
  4. package/agents/docs-manager.agent.md +2 -2
  5. package/agents/git-manager.agent.md +5 -5
  6. package/agents/planner.agent.md +3 -3
  7. package/agents/researcher.agent.md +0 -1
  8. package/agents/scout.agent.md +9 -9
  9. package/agents/ui-ux-designer.agent.md +0 -1
  10. package/collections/ck-orchestration.collection.yml +2 -2
  11. package/docs/README.md +8 -8
  12. package/docs/codebase-summary.md +19 -19
  13. package/docs/cokit-commands-usage-guide.md +42 -43
  14. package/docs/cokit-comprehensive-mapping-guide.md +15 -15
  15. package/docs/cokit-slides.md +6 -6
  16. package/docs/cokit-sync-and-maintenance-guide.md +45 -45
  17. package/docs/cokit-team-presentation.md +11 -11
  18. package/docs/copilot-processing-flow.md +11 -11
  19. package/docs/guide-next-steps-speckit-cokit-implementation.md +1 -1
  20. package/docs/migration-guide.md +9 -9
  21. package/docs/project-overview-pdr.md +3 -3
  22. package/docs/project-roadmap.md +7 -7
  23. package/docs/system-architecture.md +6 -6
  24. package/package.json +1 -1
  25. package/prompts/ck-ask.prompt.md +3 -2
  26. package/prompts/ck-bootstrap.prompt.md +26 -32
  27. package/prompts/ck-brainstorm.prompt.md +4 -3
  28. package/prompts/ck-cook.prompt.md +5 -4
  29. package/prompts/ck-debug.prompt.md +4 -3
  30. package/prompts/ck-docs.prompt.md +4 -3
  31. package/prompts/ck-fix-ci.prompt.md +46 -0
  32. package/prompts/ck-fix-fast.prompt.md +44 -0
  33. package/prompts/ck-fix-hard.prompt.md +60 -0
  34. package/prompts/ck-fix-logs.prompt.md +53 -0
  35. package/prompts/ck-fix-test.prompt.md +47 -0
  36. package/prompts/ck-fix-types.prompt.md +29 -0
  37. package/prompts/ck-fix-ui.prompt.md +50 -0
  38. package/prompts/ck-fix.prompt.md +13 -15
  39. package/prompts/ck-git.prompt.md +2 -2
  40. package/prompts/ck-help.prompt.md +8 -6
  41. package/prompts/ck-journal.prompt.md +5 -3
  42. package/prompts/ck-plan-fast.prompt.md +26 -5
  43. package/prompts/ck-plan-hard.prompt.md +30 -9
  44. package/prompts/ck-plan-validate.prompt.md +209 -0
  45. package/prompts/ck-plan.prompt.md +49 -12
  46. package/prompts/ck-preview.prompt.md +16 -32
  47. package/prompts/ck-review.prompt.md +10 -11
  48. package/prompts/ck-scout.prompt.md +5 -4
  49. package/prompts/ck-simplify.prompt.md +3 -3
  50. package/prompts/ck-spec-analyze.prompt.md +9 -11
  51. package/prompts/ck-spec-checklist.prompt.md +7 -9
  52. package/prompts/ck-spec-clarify.prompt.md +8 -15
  53. package/prompts/ck-spec-constitution.prompt.md +6 -11
  54. package/prompts/ck-spec-implement.prompt.md +7 -10
  55. package/prompts/ck-spec-plan.prompt.md +5 -18
  56. package/prompts/ck-spec-specify.prompt.md +7 -17
  57. package/prompts/ck-spec-tasks.prompt.md +4 -16
  58. package/prompts/ck-test.prompt.md +5 -3
  59. package/prompts/ck-watzup.prompt.md +4 -2
  60. package/skills/INSTALLATION.md +3 -3
  61. package/skills/README.md +12 -34
  62. package/skills/agent-browser/SKILL.md +0 -1
  63. package/skills/agent_skills_spec.md +2 -2
  64. package/skills/backend-development/SKILL.md +0 -2
  65. package/skills/brainstorm/SKILL.md +7 -9
  66. package/skills/code-review/SKILL.md +9 -9
  67. package/skills/code-review/references/code-review-reception.md +1 -1
  68. package/skills/code-review/references/requesting-code-review.md +7 -7
  69. package/skills/common/api_key_helper.py +8 -8
  70. package/skills/context-engineering/SKILL.md +3 -4
  71. package/skills/context-engineering/references/context-degradation.md +2 -2
  72. package/skills/context-engineering/references/runtime-awareness.md +6 -6
  73. package/skills/cook/README.md +2 -2
  74. package/skills/cook/SKILL.md +3 -4
  75. package/skills/cook/references/agent-patterns.md +75 -0
  76. package/skills/cook/references/review-cycle.md +2 -2
  77. package/skills/cook/references/workflow-steps.md +6 -6
  78. package/skills/databases/SKILL.md +0 -1
  79. package/skills/databases/scripts/db_migrate.py +2 -2
  80. package/skills/databases/scripts/db_performance_check.py +2 -2
  81. package/skills/debug/SKILL.md +0 -1
  82. package/skills/devops/SKILL.md +0 -2
  83. package/skills/devops/scripts/docker_optimize.py +2 -2
  84. package/skills/docs-seeker/SKILL.md +0 -1
  85. package/skills/docs-seeker/package.json +1 -1
  86. package/skills/docs-seeker/scripts/utils/env-loader.js +2 -2
  87. package/skills/fix/SKILL.md +10 -11
  88. package/skills/fix/references/mode-selection.md +11 -27
  89. package/skills/fix/references/parallel-exploration.md +9 -9
  90. package/skills/fix/references/review-cycle.md +3 -3
  91. package/skills/fix/references/skill-activation-matrix.md +3 -3
  92. package/skills/fix/references/workflow-deep.md +11 -11
  93. package/skills/fix/references/workflow-quick.md +5 -5
  94. package/skills/fix/references/workflow-standard.md +12 -12
  95. package/skills/frontend-design/SKILL.md +2 -3
  96. package/skills/frontend-design/references/workflow-describe.md +1 -1
  97. package/skills/frontend-design/references/workflow-quick.md +1 -1
  98. package/skills/frontend-design/references/workflow-screenshot.md +1 -1
  99. package/skills/git/SKILL.md +2 -3
  100. package/skills/git/references/commit-standards.md +2 -2
  101. package/skills/git/references/workflow-commit.md +1 -1
  102. package/skills/git/references/workflow-merge.md +1 -1
  103. package/skills/git/references/workflow-pr.md +1 -1
  104. package/skills/git/references/workflow-push.md +1 -1
  105. package/skills/install.ps1 +5 -5
  106. package/skills/install.sh +2 -2
  107. package/skills/mcp-management/README.md +8 -8
  108. package/skills/mcp-management/SKILL.md +9 -9
  109. package/skills/mcp-management/references/gemini-cli-integration.md +2 -2
  110. package/skills/mcp-management/scripts/.env.example +2 -2
  111. package/skills/planning/SKILL.md +4 -5
  112. package/skills/planning/references/output-standards.md +1 -1
  113. package/skills/planning/references/plan-organization.md +1 -1
  114. package/skills/problem-solving/SKILL.md +1 -2
  115. package/skills/repomix/SKILL.md +2 -2
  116. package/skills/repomix/references/usage-patterns.md +2 -2
  117. package/skills/research/SKILL.md +0 -1
  118. package/skills/scout/SKILL.md +9 -10
  119. package/skills/scout/references/external-scouting.md +10 -10
  120. package/skills/scout/references/internal-scouting.md +9 -9
  121. package/skills/sequential-thinking/README.md +3 -3
  122. package/skills/sequential-thinking/SKILL.md +0 -2
  123. package/skills/sequential-thinking/package.json +1 -1
  124. package/skills/ui-styling/SKILL.md +0 -2
  125. package/skills/web-testing/SKILL.md +0 -2
  126. package/templates/repo/.github/agents/brainstormer.agent.md +1 -1
  127. package/templates/repo/.github/agents/debugger.agent.md +1 -1
  128. package/templates/repo/.github/agents/docs-manager.agent.md +2 -2
  129. package/templates/repo/.github/agents/git-manager.agent.md +5 -5
  130. package/templates/repo/.github/agents/planner.agent.md +3 -3
  131. package/templates/repo/.github/agents/researcher.agent.md +0 -1
  132. package/templates/repo/.github/agents/scout.agent.md +9 -9
  133. package/templates/repo/.github/agents/ui-ux-designer.agent.md +0 -1
  134. package/templates/repo/.github/collections/ck-orchestration.collection.yml +2 -2
  135. package/templates/repo/.github/prompts/ck-ask.prompt.md +3 -2
  136. package/templates/repo/.github/prompts/ck-bootstrap.prompt.md +26 -32
  137. package/templates/repo/.github/prompts/ck-brainstorm.prompt.md +4 -3
  138. package/templates/repo/.github/prompts/ck-cook.prompt.md +5 -4
  139. package/templates/repo/.github/prompts/ck-debug.prompt.md +4 -3
  140. package/templates/repo/.github/prompts/ck-docs.prompt.md +4 -3
  141. package/templates/repo/.github/prompts/ck-fix-ci.prompt.md +46 -0
  142. package/templates/repo/.github/prompts/ck-fix-fast.prompt.md +44 -0
  143. package/templates/repo/.github/prompts/ck-fix-hard.prompt.md +60 -0
  144. package/templates/repo/.github/prompts/ck-fix-logs.prompt.md +53 -0
  145. package/templates/repo/.github/prompts/ck-fix-test.prompt.md +47 -0
  146. package/templates/repo/.github/prompts/ck-fix-types.prompt.md +29 -0
  147. package/templates/repo/.github/prompts/ck-fix-ui.prompt.md +50 -0
  148. package/templates/repo/.github/prompts/ck-fix.prompt.md +13 -15
  149. package/templates/repo/.github/prompts/ck-git.prompt.md +2 -2
  150. package/templates/repo/.github/prompts/ck-help.prompt.md +8 -6
  151. package/templates/repo/.github/prompts/ck-journal.prompt.md +5 -3
  152. package/templates/repo/.github/prompts/ck-plan-fast.prompt.md +26 -5
  153. package/templates/repo/.github/prompts/ck-plan-hard.prompt.md +30 -9
  154. package/templates/repo/.github/prompts/ck-plan-validate.prompt.md +209 -0
  155. package/templates/repo/.github/prompts/ck-plan.prompt.md +49 -12
  156. package/templates/repo/.github/prompts/ck-preview.prompt.md +16 -32
  157. package/templates/repo/.github/prompts/ck-review.prompt.md +10 -11
  158. package/templates/repo/.github/prompts/ck-scout.prompt.md +5 -4
  159. package/templates/repo/.github/prompts/ck-simplify.prompt.md +3 -3
  160. package/templates/repo/.github/prompts/ck-spec-analyze.prompt.md +9 -11
  161. package/templates/repo/.github/prompts/ck-spec-checklist.prompt.md +7 -9
  162. package/templates/repo/.github/prompts/ck-spec-clarify.prompt.md +8 -15
  163. package/templates/repo/.github/prompts/ck-spec-constitution.prompt.md +6 -11
  164. package/templates/repo/.github/prompts/ck-spec-implement.prompt.md +7 -10
  165. package/templates/repo/.github/prompts/ck-spec-plan.prompt.md +5 -18
  166. package/templates/repo/.github/prompts/ck-spec-specify.prompt.md +7 -17
  167. package/templates/repo/.github/prompts/ck-spec-tasks.prompt.md +4 -16
  168. package/templates/repo/.github/prompts/ck-test.prompt.md +5 -3
  169. package/templates/repo/.github/prompts/ck-watzup.prompt.md +4 -2
  170. package/templates/repo/.github/skills/INSTALLATION.md +3 -3
  171. package/templates/repo/.github/skills/README.md +12 -34
  172. package/templates/repo/.github/skills/agent-browser/SKILL.md +0 -1
  173. package/templates/repo/.github/skills/agent_skills_spec.md +2 -2
  174. package/templates/repo/.github/skills/backend-development/SKILL.md +0 -2
  175. package/templates/repo/.github/skills/brainstorm/SKILL.md +7 -9
  176. package/templates/repo/.github/skills/code-review/SKILL.md +9 -9
  177. package/templates/repo/.github/skills/code-review/references/code-review-reception.md +1 -1
  178. package/templates/repo/.github/skills/code-review/references/requesting-code-review.md +7 -7
  179. package/templates/repo/.github/skills/common/api_key_helper.py +8 -8
  180. package/templates/repo/.github/skills/context-engineering/SKILL.md +3 -4
  181. package/templates/repo/.github/skills/context-engineering/references/context-degradation.md +2 -2
  182. package/templates/repo/.github/skills/context-engineering/references/runtime-awareness.md +6 -6
  183. package/templates/repo/.github/skills/cook/README.md +2 -2
  184. package/templates/repo/.github/skills/cook/SKILL.md +3 -4
  185. package/templates/repo/.github/skills/cook/references/agent-patterns.md +75 -0
  186. package/templates/repo/.github/skills/cook/references/review-cycle.md +2 -2
  187. package/templates/repo/.github/skills/cook/references/workflow-steps.md +6 -6
  188. package/templates/repo/.github/skills/databases/SKILL.md +0 -1
  189. package/templates/repo/.github/skills/databases/scripts/db_migrate.py +2 -2
  190. package/templates/repo/.github/skills/databases/scripts/db_performance_check.py +2 -2
  191. package/templates/repo/.github/skills/debug/SKILL.md +0 -1
  192. package/templates/repo/.github/skills/devops/SKILL.md +0 -2
  193. package/templates/repo/.github/skills/devops/scripts/docker_optimize.py +2 -2
  194. package/templates/repo/.github/skills/docs-seeker/SKILL.md +0 -1
  195. package/templates/repo/.github/skills/docs-seeker/package.json +1 -1
  196. package/templates/repo/.github/skills/docs-seeker/scripts/utils/env-loader.js +2 -2
  197. package/templates/repo/.github/skills/fix/SKILL.md +10 -11
  198. package/templates/repo/.github/skills/fix/references/mode-selection.md +11 -27
  199. package/templates/repo/.github/skills/fix/references/parallel-exploration.md +9 -9
  200. package/templates/repo/.github/skills/fix/references/review-cycle.md +3 -3
  201. package/templates/repo/.github/skills/fix/references/skill-activation-matrix.md +3 -3
  202. package/templates/repo/.github/skills/fix/references/workflow-deep.md +11 -11
  203. package/templates/repo/.github/skills/fix/references/workflow-quick.md +5 -5
  204. package/templates/repo/.github/skills/fix/references/workflow-standard.md +12 -12
  205. package/templates/repo/.github/skills/frontend-design/SKILL.md +2 -3
  206. package/templates/repo/.github/skills/frontend-design/references/workflow-describe.md +1 -1
  207. package/templates/repo/.github/skills/frontend-design/references/workflow-quick.md +1 -1
  208. package/templates/repo/.github/skills/frontend-design/references/workflow-screenshot.md +1 -1
  209. package/templates/repo/.github/skills/git/SKILL.md +2 -3
  210. package/templates/repo/.github/skills/git/references/commit-standards.md +2 -2
  211. package/templates/repo/.github/skills/git/references/workflow-commit.md +1 -1
  212. package/templates/repo/.github/skills/git/references/workflow-merge.md +1 -1
  213. package/templates/repo/.github/skills/git/references/workflow-pr.md +1 -1
  214. package/templates/repo/.github/skills/git/references/workflow-push.md +1 -1
  215. package/templates/repo/.github/skills/install.ps1 +5 -5
  216. package/templates/repo/.github/skills/install.sh +2 -2
  217. package/templates/repo/.github/skills/mcp-management/README.md +8 -8
  218. package/templates/repo/.github/skills/mcp-management/SKILL.md +9 -9
  219. package/templates/repo/.github/skills/mcp-management/references/gemini-cli-integration.md +2 -2
  220. package/templates/repo/.github/skills/mcp-management/scripts/.env.example +2 -2
  221. package/templates/repo/.github/skills/planning/SKILL.md +4 -5
  222. package/templates/repo/.github/skills/planning/references/output-standards.md +1 -1
  223. package/templates/repo/.github/skills/planning/references/plan-organization.md +1 -1
  224. package/templates/repo/.github/skills/problem-solving/SKILL.md +1 -2
  225. package/templates/repo/.github/skills/repomix/SKILL.md +2 -2
  226. package/templates/repo/.github/skills/repomix/references/usage-patterns.md +2 -2
  227. package/templates/repo/.github/skills/research/SKILL.md +0 -1
  228. package/templates/repo/.github/skills/scout/SKILL.md +9 -10
  229. package/templates/repo/.github/skills/scout/references/external-scouting.md +10 -10
  230. package/templates/repo/.github/skills/scout/references/internal-scouting.md +9 -9
  231. package/templates/repo/.github/skills/sequential-thinking/README.md +3 -3
  232. package/templates/repo/.github/skills/sequential-thinking/SKILL.md +0 -2
  233. package/templates/repo/.github/skills/sequential-thinking/package.json +1 -1
  234. package/templates/repo/.github/skills/ui-styling/SKILL.md +0 -2
  235. package/templates/repo/.github/skills/web-testing/SKILL.md +0 -2
  236. package/docs/cokit-instruction-guide.html +0 -3004
  237. package/docs/images/cokit-command-finder-final.png +0 -0
  238. package/docs/images/cokit-highlight-fix.png +0 -0
  239. package/docs/images/cokit-highlight-test.png +0 -0
  240. package/prompts/ck-spec-taskstoissues.prompt.md +0 -48
  241. package/skills/cook/references/subagent-patterns.md +0 -75
  242. package/templates/repo/.github/prompts/ck-spec-taskstoissues.prompt.md +0 -48
  243. package/templates/repo/.github/skills/cook/references/subagent-patterns.md +0 -75
@@ -15,7 +15,7 @@ MCP is an open protocol enabling AI agents to connect to external tools and data
15
15
  - Progressive disclosure of MCP capabilities (load only what's needed)
16
16
  - Intelligent tool/prompt/resource selection based on task requirements
17
17
  - Multi-server management from single config file
18
- - Context-efficient: subagents handle MCP discovery and execution
18
+ - Context-efficient: agents handle MCP discovery and execution
19
19
  - Persistent tool catalog: automatically saves discovered tools to JSON for fast reference
20
20
 
21
21
  ## When to Use This Skill
@@ -25,7 +25,7 @@ Use this skill when:
25
25
  2. **Task-Based Tool Selection**: Analyzing which MCP tools are relevant for a specific task
26
26
  3. **Executing MCP Tools**: Calling MCP tools programmatically with proper parameter handling
27
27
  4. **MCP Integration**: Building or debugging MCP client implementations
28
- 5. **Context Management**: Avoiding context pollution by delegating MCP operations to subagents
28
+ 5. **Context Management**: Avoiding context pollution by delegating MCP operations to agents
29
29
 
30
30
  ## Core Capabilities
31
31
 
@@ -80,7 +80,7 @@ echo "Take a screenshot of https://example.com" | gemini -y -m <gemini.model>
80
80
  npx tsx scripts/cli.ts call-tool memory create_entities '{"entities":[...]}'
81
81
  ```
82
82
 
83
- **Fallback: mcp-manager Subagent**
83
+ **Fallback: mcp-manager Agent**
84
84
 
85
85
  See [references/gemini-cli-integration.md](references/gemini-cli-integration.md) for complete examples.
86
86
 
@@ -104,16 +104,16 @@ echo "Take a screenshot of https://example.com. Return JSON only per GEMINI.md i
104
104
 
105
105
  **Benefits**:
106
106
  - Automatic tool discovery
107
- - Structured JSON responses (parseable by Claude)
107
+ - Structured JSON responses (parseable by the agent)
108
108
  - GEMINI.md auto-loaded for consistent formatting
109
- - Faster than subagent orchestration
109
+ - Faster than agent orchestration
110
110
  - No natural language ambiguity
111
111
 
112
112
  See [references/gemini-cli-integration.md](references/gemini-cli-integration.md) for complete guide.
113
113
 
114
- ### Pattern 2: Subagent-Based Execution (Fallback)
114
+ ### Pattern 2: Agent-Based Execution (Fallback)
115
115
 
116
- Use `mcp-manager` agent when Gemini CLI unavailable. Subagent discovers tools, selects relevant ones, executes tasks, reports back.
116
+ Use `mcp-manager` agent when Gemini CLI unavailable. Agent discovers tools, selects relevant ones, executes tasks, reports back.
117
117
 
118
118
  **Benefit**: Main context stays clean, only relevant tool definitions loaded when needed.
119
119
 
@@ -166,7 +166,7 @@ npx tsx cli.ts list-tools # Saves to assets/tools.json
166
166
  npx tsx cli.ts call-tool memory create_entities '{"entities":[...]}'
167
167
  ```
168
168
 
169
- **Method 3: mcp-manager Subagent**
169
+ **Method 3: mcp-manager Agent**
170
170
 
171
171
  See [references/gemini-cli-integration.md](references/gemini-cli-integration.md) for complete guide.
172
172
 
@@ -193,7 +193,7 @@ See [references/mcp-protocol.md](references/mcp-protocol.md) for:
193
193
  - Use when: Need specific tool/server control
194
194
  - Execute: `npx tsx scripts/cli.ts call-tool <server> <tool> <args>`
195
195
 
196
- 3. **mcp-manager Subagent** (Fallback): Context-efficient delegation
196
+ 3. **mcp-manager Agent** (Fallback): Context-efficient delegation
197
197
  - Use when: Gemini unavailable or failed
198
198
  - Keeps main context clean
199
199
 
@@ -97,7 +97,7 @@ echo "Search for latest Next.js 15 features and summarize the top 3" | gemini -y
97
97
 
98
98
  **Multi-Tool Orchestration**:
99
99
  ```bash
100
- echo "Search for Claude AI documentation, take a screenshot of the homepage, and save both to memory" | gemini -y -m <gemini.model>
100
+ echo "Search for AI documentation, take a screenshot of the homepage, and save both to memory" | gemini -y -m <gemini.model>
101
101
  ```
102
102
 
103
103
  **Browser Automation**:
@@ -212,7 +212,7 @@ Shows detailed MCP communication logs.
212
212
  | Direct Scripts | ⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ | Specific tools |
213
213
  | mcp-manager | ⭐ | ⭐⭐ | ⭐⭐⭐ | Fallback |
214
214
 
215
- **Recommendation**: Use Gemini CLI as primary method, fallback to scripts/subagent when unavailable.
215
+ **Recommendation**: Use Gemini CLI as primary method, fallback to scripts/agent when unavailable.
216
216
 
217
217
  ## Resources
218
218
 
@@ -1,7 +1,7 @@
1
1
  # MCP Management Scripts Environment Variables
2
2
 
3
- # Path to MCP configuration file (optional, defaults to .claude/.mcp.json)
4
- MCP_CONFIG_PATH=.claude/.mcp.json
3
+ # Path to MCP configuration file (optional, defaults to .copilot/.mcp.json)
4
+ MCP_CONFIG_PATH=.copilot/.mcp.json
5
5
 
6
6
  # Logging level (optional, defaults to info)
7
7
  LOG_LEVEL=info
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: planning
3
3
  description: Plan implementations, design architectures, create technical roadmaps with detailed phases. Use for feature planning, system design, solution architecture, implementation strategy, phase documentation.
4
- license: MIT
5
4
  ---
6
5
 
7
6
  # Planning
@@ -60,11 +59,11 @@ Load: `references/output-standards.md`
60
59
 
61
60
  ## Task Integration (Optional)
62
61
 
63
- When session has `CLAUDE_CODE_TASK_LIST_ID` set (active plan):
64
- - Use TaskCreate to create tasks for each phase with clear subjects
62
+ When session has `TASK_LIST_ID` set (active plan):
63
+ - Create tasks for each phase with clear subjects
65
64
  - Set dependencies: Phase N+1 `blockedBy` Phase N
66
- - Subagents coordinate via shared task list automatically
67
- - Use TaskUpdate to mark progress (in_progress → completed)
65
+ - Agents coordinate via shared task list automatically
66
+ - Update tasks to mark progress (in_progress → completed)
68
67
 
69
68
  ### Important
70
69
  DO NOT create plans or reports in USER directory.
@@ -98,7 +98,7 @@ List affected files with:
98
98
  - Prioritize actionable info
99
99
 
100
100
  ### Unresolved Questions
101
- **IMPORTANT:** Use `AskUserQuestion` to ask users for unresolved questions at the end
101
+ **IMPORTANT:** List unresolved questions at the end of your response and ask users directly. Wait for their answers before finalizing.
102
102
  - Questions needing clarification
103
103
  - Technical decisions requiring input
104
104
  - Unknowns impacting implementation
@@ -48,7 +48,7 @@ Check the `## Plan Context` section injected by hooks:
48
48
 
49
49
  **After Creating Plan:**
50
50
  ```bash
51
- # Update session state so subagents get the new plan context:
51
+ # Update session state so agents get the new plan context:
52
52
  node $HOME/.copilot/scripts/set-active-plan.cjs {plan-dir}
53
53
  ```
54
54
 
@@ -1,7 +1,6 @@
1
1
  ---
2
- name: Problem-Solving Techniques
2
+ name: problem-solving
3
3
  description: Apply systematic problem-solving techniques when stuck. Use for complexity spirals, innovation blocks, recurring patterns, assumption constraints, simplification cascades, scale uncertainty.
4
- version: 2.0.0
5
4
  ---
6
5
 
7
6
  # Problem-Solving Techniques
@@ -5,7 +5,7 @@ description: Pack repositories into AI-friendly files with Repomix (XML, Markdow
5
5
 
6
6
  # Repomix Skill
7
7
 
8
- Repomix packs entire repositories into single, AI-friendly files. Perfect for feeding codebases to LLMs like Claude, ChatGPT, and Gemini.
8
+ Repomix packs entire repositories into single, AI-friendly files. Perfect for feeding codebases to LLMs like ChatGPT, Gemini, and others.
9
9
 
10
10
  ## When to Use
11
11
 
@@ -153,7 +153,7 @@ repomix --init # creates repomix.config.json
153
153
  Repomix automatically counts tokens for individual files, total repository, and per-format output.
154
154
 
155
155
  Typical LLM context limits:
156
- - Claude Sonnet 4.5: ~200K tokens
156
+ - Model (Medium): ~200K tokens
157
157
  - GPT-4: ~128K tokens
158
158
  - GPT-3.5: ~16K tokens
159
159
 
@@ -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
- ### Claude Code
147
+ ### AI Coding Agent
148
148
  ```bash
149
- repomix --style markdown --copy # Then paste into Claude
149
+ repomix --style markdown --copy # Then paste into the AI agent
150
150
  ```
151
151
 
152
152
  ## Language-Specific Patterns
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: research
3
3
  description: Research technical solutions, analyze architectures, gather requirements thoroughly. Use for technology evaluation, best practices research, solution design, scalability/security/maintainability analysis.
4
- license: MIT
5
4
  ---
6
5
 
7
6
  # Research
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: scout
3
- description: Fast codebase scouting using parallel agents. Use for file discovery, task context gathering, quick searches across directories. Supports internal (Explore) and external (Gemini/OpenCode) agents.
4
- version: 1.0.0
3
+ description: Fast codebase scouting using parallel agents. Use for file discovery, task context gathering, quick searches across directories. Supports internal and external search agents.
5
4
  ---
6
5
 
7
6
  # Scout
@@ -9,7 +8,7 @@ version: 1.0.0
9
8
  Fast, token-efficient codebase scouting using parallel agents to find files needed for tasks.
10
9
 
11
10
  ## Arguments
12
- - Default: Scout using built-in Explore subagents in parallel (`./references/internal-scouting.md`)
11
+ - Default: Scout using built-in search agents in parallel (`./references/internal-scouting.md`)
13
12
  - `ext`: Scout using external Gemini/OpenCode CLI tools in parallel (`./references/external-scouting.md`)
14
13
 
15
14
  ## When to Use
@@ -37,7 +36,7 @@ Read from `$HOME/.copilot/.ck.json`:
37
36
  ### 1. Analyze Task
38
37
  - Parse user prompt for search targets
39
38
  - Identify key directories, patterns, file types, lines of code
40
- - Determine optimal SCALE value of subagents to spawn
39
+ - Determine optimal SCALE value of agents to spawn
41
40
 
42
41
  ### 2. Divide and Conquer
43
42
  - Split codebase into logical segments per agent
@@ -46,14 +45,14 @@ Read from `$HOME/.copilot/.ck.json`:
46
45
 
47
46
  ### 3. Spawn Parallel Agents
48
47
  Load appropriate reference based on decision tree:
49
- - **Internal (Default):** `references/internal-scouting.md` (Explore subagents)
48
+ - **Internal (Default):** `references/internal-scouting.md` (search agents)
50
49
  - **External:** `references/external-scouting.md` (Gemini/OpenCode)
51
50
 
52
51
  **Notes:**
53
- - Prompt detailed instructions for each subagent with exact directories or files it should read
54
- - Remember that each subagent has less than 200K tokens of context window
55
- - Amount of subagents to-be-spawned depends on the current system resources available and amount of files to be scanned
56
- - Each subagent must return a detailed summary report to a main agent
52
+ - Prompt detailed instructions for each agent with exact directories or files it should read
53
+ - Remember that each agent has less than 200K tokens of context window
54
+ - Amount of agents to-be-spawned depends on the current system resources available and amount of files to be scanned
55
+ - Each agent must return a detailed summary report to a main agent
57
56
 
58
57
  ### 4. Collect Results
59
58
  - Timeout: 3 minutes per agent (skip non-responders)
@@ -75,5 +74,5 @@ Load appropriate reference based on decision tree:
75
74
 
76
75
  ## References
77
76
 
78
- - `references/internal-scouting.md` - Using Explore subagents
77
+ - `references/internal-scouting.md` - Using search agents
79
78
  - `references/external-scouting.md` - Using Gemini/OpenCode CLI
@@ -57,16 +57,16 @@ which opencode
57
57
 
58
58
  If not installed, ask user:
59
59
  1. **Yes** - Provide installation instructions (may need manual auth steps)
60
- 2. **No** - Fall back to Explore subagents (`internal-scouting.md`)
60
+ 2. **No** - Fall back to Explore agents (`internal-scouting.md`)
61
61
 
62
62
  ## Spawning Parallel Bash Agents
63
63
 
64
- Use `Task` tool with `subagent_type: "Bash"` to spawn parallel agents:
64
+ Use `Task` tool with `type: "Bash"` to spawn parallel agents:
65
65
 
66
66
  ```
67
- Task 1: subagent_type="Bash", prompt="Run: gemini -y -m gemini-3.0-flash '[prompt1]'"
68
- Task 2: subagent_type="Bash", prompt="Run: gemini -y -m gemini-3.0-flash '[prompt2]'"
69
- Task 3: subagent_type="Bash", prompt="Run: gemini -y -m gemini-3.0-flash '[prompt3]'"
67
+ Task 1: type="Bash", prompt="Run: gemini -y -m gemini-3.0-flash '[prompt1]'"
68
+ Task 2: type="Bash", prompt="Run: gemini -y -m gemini-3.0-flash '[prompt2]'"
69
+ Task 3: type="Bash", prompt="Run: gemini -y -m gemini-3.0-flash '[prompt3]'"
70
70
  ```
71
71
 
72
72
  Spawn all in single message for parallel execution.
@@ -112,15 +112,15 @@ lines_per_chunk = ceil(total_lines / chunks)
112
112
 
113
113
  **Small files (<500 lines each):**
114
114
  ```
115
- Task 1: subagent_type="Bash", prompt="cat file1.ts file2.ts"
116
- Task 2: subagent_type="Bash", prompt="cat file3.ts file4.ts"
115
+ Task 1: type="Bash", prompt="cat file1.ts file2.ts"
116
+ Task 2: type="Bash", prompt="cat file3.ts file4.ts"
117
117
  ```
118
118
 
119
119
  **Large file (>500 lines) - use sed for ranges:**
120
120
  ```
121
- Task 1: subagent_type="Bash", prompt="sed -n '1,500p' large-file.ts"
122
- Task 2: subagent_type="Bash", prompt="sed -n '501,1000p' large-file.ts"
123
- Task 3: subagent_type="Bash", prompt="sed -n '1001,1500p' large-file.ts"
121
+ Task 1: type="Bash", prompt="sed -n '1,500p' large-file.ts"
122
+ Task 2: type="Bash", prompt="sed -n '501,1000p' large-file.ts"
123
+ Task 3: type="Bash", prompt="sed -n '1001,1500p' large-file.ts"
124
124
  ```
125
125
 
126
126
  ### Chunking Decision Tree
@@ -1,15 +1,15 @@
1
- # Internal Scouting with Explore Subagents
1
+ # Internal Scouting with Explore Agents
2
2
 
3
- Use Explore subagents when SCALE >= 6 or external tools unavailable.
3
+ Use Explore agents when SCALE >= 6 or external tools unavailable.
4
4
 
5
5
  ## How It Works
6
6
 
7
- Spawn multiple `Explore` subagents via `Task` tool to search codebase in parallel.
7
+ Spawn multiple `Explore` agents via `Task` tool to search codebase in parallel.
8
8
 
9
9
  ## Task Tool Configuration
10
10
 
11
11
  ```
12
- subagent_type: "Explore"
12
+ type: "Explore"
13
13
  ```
14
14
 
15
15
  ## Prompt Template
@@ -90,15 +90,15 @@ lines_per_chunk = ceil(total_lines / chunks)
90
90
 
91
91
  **Small files (<500 lines each):**
92
92
  ```
93
- Task 1: subagent_type="Bash", prompt="cat file1.ts file2.ts"
94
- Task 2: subagent_type="Bash", prompt="cat file3.ts file4.ts"
93
+ Task 1: type="Bash", prompt="cat file1.ts file2.ts"
94
+ Task 2: type="Bash", prompt="cat file3.ts file4.ts"
95
95
  ```
96
96
 
97
97
  **Large file (>500 lines) - use sed for ranges:**
98
98
  ```
99
- Task 1: subagent_type="Bash", prompt="sed -n '1,500p' large-file.ts"
100
- Task 2: subagent_type="Bash", prompt="sed -n '501,1000p' large-file.ts"
101
- Task 3: subagent_type="Bash", prompt="sed -n '1001,1500p' large-file.ts"
99
+ Task 1: type="Bash", prompt="sed -n '1,500p' large-file.ts"
100
+ Task 2: type="Bash", prompt="sed -n '501,1000p' large-file.ts"
101
+ Task 3: type="Bash", prompt="sed -n '1001,1500p' large-file.ts"
102
102
  ```
103
103
 
104
104
  ### Chunking Decision Tree
@@ -4,7 +4,7 @@ Structured, reflective problem-solving methodology converted from the sequential
4
4
 
5
5
  ## Overview
6
6
 
7
- This skill teaches Claude to apply systematic sequential thinking methodology for complex problem-solving, without relying on external MCP tools. It enables:
7
+ This skill teaches the AI agent to apply systematic sequential thinking methodology for complex problem-solving, without relying on external MCP tools. It enables:
8
8
  - Breaking down complex problems into manageable thought sequences
9
9
  - Dynamic adjustment of thought count as understanding evolves
10
10
  - Revision of previous thoughts when new insights emerge
@@ -91,7 +91,7 @@ Thought 2/5: [Further analysis]
91
91
 
92
92
  **Implicit Mode**: Apply methodology internally without cluttering output
93
93
 
94
- ## When Claude Should Use This Skill
94
+ ## When the Agent Should Use This Skill
95
95
 
96
96
  Automatically activated for:
97
97
  - Complex problem decomposition
@@ -176,7 +176,7 @@ Scripts are **optional tooling** - the methodology can be applied without them.
176
176
 
177
177
  Converted from: https://github.com/modelcontextprotocol/servers/tree/main/src/sequentialthinking
178
178
 
179
- Original MCP server by Anthropic (MIT License).
179
+ Original MCP server (MIT License).
180
180
  Skill conversion:
181
181
  - Extracts methodology as instructions
182
182
  - Adds executable scripts for deterministic validation
@@ -1,8 +1,6 @@
1
1
  ---
2
2
  name: sequential-thinking
3
3
  description: Apply step-by-step analysis for complex problems with revision capability. Use for multi-step reasoning, hypothesis verification, adaptive planning, problem decomposition, course correction.
4
- version: 1.0.0
5
- license: MIT
6
4
  ---
7
5
 
8
6
  # Sequential Thinking
@@ -13,7 +13,7 @@
13
13
  "problem-solving",
14
14
  "agent-skill"
15
15
  ],
16
- "author": "Converted from Anthropic MCP Server",
16
+ "author": "Converted from MCP Server",
17
17
  "license": "MIT",
18
18
  "devDependencies": {
19
19
  "jest": "^29.7.0"
@@ -1,8 +1,6 @@
1
1
  ---
2
2
  name: ui-styling
3
3
  description: Style UIs with shadcn/ui components (Radix UI + Tailwind CSS). Use for accessible components, themes, dark mode, responsive layouts, design systems, color customization.
4
- license: MIT
5
- version: 1.0.0
6
4
  ---
7
5
 
8
6
  # UI Styling Skill
@@ -1,8 +1,6 @@
1
1
  ---
2
2
  name: web-testing
3
3
  description: Web testing with Playwright, Vitest, k6. E2E/unit/integration/load/security/visual/a11y testing. Use for test automation, flakiness, Core Web Vitals, mobile gestures, cross-browser.
4
- license: Apache-2.0
5
- version: 3.0.0
6
4
  ---
7
5
 
8
6
  # Web Testing Skill
@@ -37,7 +37,7 @@ You operate by the holy trinity of software engineering: **YAGNI** (You Aren't G
37
37
  ## Collaboration Tools
38
38
  - Consult the `planner` agent to research industry best practices and find proven solutions
39
39
  - Engage the `docs-manager` agent to understand existing project implementation and constraints
40
- - Use `WebSearch` tool to find efficient approaches and learn from others' experiences
40
+ - Search the web to find efficient approaches and learn from others' experiences
41
41
 
42
42
  ## Workflow Phases
43
43
  1. **Discovery Phase**: Ask clarifying questions about requirements, constraints, timeline, and success criteria
@@ -37,7 +37,7 @@ When investigating issues, you will:
37
37
  - Examine application logs and error traces
38
38
  - Capture system metrics and performance data
39
39
  - Read `./docs/codebase-summary.md` if exists and up-to-date (less than 2 days old)
40
- - Use Glob/Grep tools to search the codebase for files needed to complete the task
40
+ - Search the codebase for files needed to complete the task
41
41
  - When given a Github repository URL, use `repomix --remote <github-repo-url>` to generate codebase summary:
42
42
  ```bash
43
43
  # usage: repomix --remote <github-repo-url>
@@ -21,7 +21,7 @@ You establish and maintain implementation standards including:
21
21
 
22
22
  ### 2. Documentation Analysis & Maintenance
23
23
  You systematically:
24
- - Read and analyze all existing documentation files in `./docs` directory using Glob and Read tools
24
+ - Read and analyze all existing documentation files in `./docs` directory
25
25
  - Identify gaps, inconsistencies, or outdated information
26
26
  - Cross-reference documentation with actual codebase implementation
27
27
  - Ensure documentation reflects the current state of the system
@@ -57,7 +57,7 @@ You organize documentation to:
57
57
  ### Documentation Review Process
58
58
  1. Scan the entire `./docs` directory structure
59
59
  2. Generate/update `./docs/codebase-summary.md` with comprehensive codebase summary
60
- 3. Use Glob/Grep tools OR Gemini CLI for large files
60
+ 3. Search for content in files OR use Gemini CLI for large files
61
61
  4. Categorize documentation by type (API, guides, requirements, architecture)
62
62
  5. Check for completeness, accuracy, and clarity
63
63
  6. Verify all links, references, and code examples
@@ -296,10 +296,10 @@ Keep output concise (<1k chars). No explanations of what you did.
296
296
  ## Token Optimization Strategy
297
297
 
298
298
  **Delegation rationale:**
299
- - Gemini Flash 2.5: $0.075/$0.30 per 1M tokens
300
- - Haiku 4.5: $1/$5 per 1M tokens
301
- - For 100-line diffs, Gemini = **13x cheaper** for analysis
302
- - Haiku focuses on orchestration, Gemini does heavy lifting
299
+ - Worker model (e.g. Gemini Flash 2.5): $0.075/$0.30 per 1M tokens
300
+ - Orchestrator model: $1/$5 per 1M tokens
301
+ - For 100-line diffs, worker model = **13x cheaper** for analysis
302
+ - Orchestrator focuses on routing, worker model does heavy lifting
303
303
 
304
304
  **Efficiency rules:**
305
305
  1. **Compound commands only** - use `&&` to chain operations
@@ -314,7 +314,7 @@ Keep output concise (<1k chars). No explanations of what you did.
314
314
  - 3 tools @ 5K tokens = $0.015 per commit
315
315
  - **81% cost reduction** × 1000 commits/month = $63 saved
316
316
 
317
- ## Critical Instructions for Haiku
317
+ ## Critical Instructions for Orchestrator
318
318
 
319
319
  Your role: **EXECUTE, not EXPLORE**
320
320
 
@@ -19,9 +19,9 @@ You operate by **YAGNI** (You Aren't Gonna Need It), **KISS** (Keep It Simple, S
19
19
 
20
20
  When Read fails with "exceeds maximum allowed tokens":
21
21
  1. **Gemini CLI** (2M context): `echo "[question] in [path]" | gemini -y -m gemini-2.5-flash`
22
- 2. **Chunked Read**: Use `offset` and `limit` params to read in portions
23
- 3. **Grep**: Search specific content with `Grep pattern="[term]" path="[path]"`
24
- 4. **Targeted Search**: Use Glob and Grep for specific patterns
22
+ 2. Read file in portions using offset and limit parameters
23
+ 3. Search for specific content in files
24
+ 4. Search for specific file and content patterns
25
25
 
26
26
  ## Core Mental Models (The "How to Think" Toolkit)
27
27
 
@@ -24,7 +24,6 @@ You excel at:
24
24
  - Recognizing technology trends and adoption patterns
25
25
  - Evaluating trade-offs between different technical solutions
26
26
  - Using `docs-seeker` skills to find relevant documentation
27
- - Using `document-skills` skills to read and analyze documents
28
27
  **IMPORTANT**: You **DO NOT** start the implementation yourself but respond with the summary and the file path of comprehensive plan.
29
28
 
30
29
  ## Report Output
@@ -9,7 +9,7 @@ You are an elite Codebase Scout, a specialized agent designed to rapidly locate
9
9
 
10
10
  ## Your Core Mission
11
11
 
12
- When given a search task, you will use Glob, Grep, and Read tools to efficiently search the codebase and synthesize findings into a comprehensive file list for the user.
12
+ When given a search task, you will use search and file reading capabilities to efficiently search the codebase and synthesize findings into a comprehensive file list for the user.
13
13
  Requirements: **Ensure token efficiency while maintaining high quality.**
14
14
 
15
15
  ## Operational Protocol
@@ -38,8 +38,8 @@ Example prompt structure:
38
38
  "Search the [directories] for files related to [functionality]. Look for [specific patterns like API routes, schema definitions, utility functions]. Return only the file paths that are directly relevant. Be concise and fast - you have 3 minutes."
39
39
 
40
40
  ### 4. Execute Parallel Searches
41
- - Use Glob tool with multiple patterns
42
- - Use Grep for content-based searches
41
+ - Search with multiple file patterns
42
+ - Search file contents for specific patterns
43
43
  - Read key files to understand structure
44
44
  - Complete searches within 3-minute target
45
45
 
@@ -50,7 +50,7 @@ Example prompt structure:
50
50
 
51
51
  ## Search Tools
52
52
 
53
- Use Glob, Grep, and Read tools for efficient codebase exploration.
53
+ Use search and file reading for efficient codebase exploration.
54
54
 
55
55
  ## Example Execution Flow
56
56
 
@@ -79,19 +79,19 @@ Use Glob, Grep, and Read tools for efficient codebase exploration.
79
79
 
80
80
  - If results are sparse: Expand search scope or try different keywords
81
81
  - If results are overwhelming: Categorize and prioritize by relevance
82
- - If Read fails on large files: Use chunked reading or Grep for specific content
82
+ - If Read fails on large files: Use chunked reading or content search for specific content
83
83
 
84
84
  ## Handling Large Files (>25K tokens)
85
85
 
86
86
  When Read fails with "exceeds maximum allowed tokens":
87
87
  1. **Gemini CLI** (2M context): `echo "[question] in [path]" | gemini -y -m gemini-2.5-flash`
88
- 2. **Chunked Read**: Use `offset` and `limit` params to read in portions
89
- 3. **Grep**: Search specific content with `Grep pattern="[term]" path="[path]"`
88
+ 2. Read file in portions using offset and limit parameters
89
+ 3. Search for specific content in files
90
90
 
91
91
  ## Success Criteria
92
92
 
93
93
  You succeed when:
94
- 1. You execute searches efficiently using Glob, Grep, and Read tools
94
+ 1. You execute searches efficiently using search and file reading capabilities
95
95
  2. You synthesize results into a clear, actionable file list
96
96
  3. The user can immediately proceed with their task using the files you found
97
97
  4. You complete the entire operation in under 5 minutes
@@ -104,4 +104,4 @@ Save reports to `plans/reports/` directory with naming pattern `{type}-{date}-{s
104
104
  - Sacrifice grammar for the sake of concision when writing reports.
105
105
  - In reports, list any unresolved questions at the end, if any.
106
106
 
107
- **Remember:** You are a fast, focused searcher. Your power lies in efficiently using Glob, Grep, and Read tools to quickly locate relevant files.
107
+ **Remember:** You are a fast, focused searcher. Your power lies in efficiently searching and reading files to quickly locate relevant content.
@@ -54,5 +54,4 @@ Activate relevant skills based on task:
54
54
  ## Collaboration
55
55
 
56
56
  - Delegate research to `researcher` agents for comprehensive insights
57
- - Coordinate with `project-manager` for progress updates
58
57
  - Follow rules in `./docs/development-rules.md`
@@ -1,7 +1,7 @@
1
1
  id: ck-orchestration
2
2
  name: CK Orchestration Protocol
3
- description: Workflow orchestration patterns for managing subagents, task delegation, and multi-phase implementations.
4
- tags: [orchestration, workflow, subagents, planning]
3
+ description: Workflow orchestration patterns for managing agents, task delegation, and multi-phase implementations.
4
+ tags: [orchestration, workflow, agents, planning]
5
5
  items:
6
6
  - path: agents/planner.agent.md
7
7
  kind: agent
@@ -62,5 +62,6 @@ This command focuses on architectural consultation and strategic guidance. Do no
62
62
 
63
63
  | Command | Description |
64
64
  |---------|-------------|
65
- | `/ck.brainstorm` | Explore ideas |
66
- | `/ck.plan` | Create plan |
65
+ | `/ck-brainstorm` | Explore ideas |
66
+ | `/ck-plan` | Create plan |
67
+ | `/ck-spec-specify` | Write detailed feature spec |