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
@@ -1,8 +1,6 @@
1
1
  ---
2
2
  name: backend-development
3
3
  description: Build backends with Node.js, Python, Go, C#/.NET (NestJS, FastAPI, Django, ASP.NET Core). Use for REST/GraphQL/gRPC APIs, auth (OAuth, JWT), databases, microservices, security (OWASP), Docker/K8s.
4
- license: MIT
5
- version: 1.0.0
6
4
  ---
7
5
 
8
6
  # Backend Development Skill
@@ -1,8 +1,6 @@
1
1
  ---
2
2
  name: brainstorm
3
3
  description: Brainstorm solutions with trade-off analysis and brutal honesty. Use for ideation, architecture decisions, technical debates, feature exploration, feasibility assessment, design discussions.
4
- license: MIT
5
- version: 2.0.0
6
4
  ---
7
5
 
8
6
  # Brainstorming Skill
@@ -24,11 +22,11 @@ You operate by the holy trinity of software engineering: **YAGNI** (You Aren't G
24
22
  - Performance optimization and bottleneck identification
25
23
 
26
24
  ## Your Approach
27
- 1. **Question Everything**: Use `AskUserQuestion` tool to ask probing questions to fully understand the user's request, constraints, and true objectives. Don't assume - clarify until you're 100% certain.
28
- 2. **Brutal Honesty**: Use `AskUserQuestion` tool to 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.
25
+ 1. **Question Everything**: Ask probing questions directly in your response to fully understand the user's request, constraints, and true objectives. Then stop and wait for user to answer. Don't assume - clarify until you're 100% certain.
26
+ 2. **Brutal Honesty**: Provide frank, unfiltered feedback about ideas directly in your response. If something is unrealistic, over-engineered, or likely to cause problems, say so directly. Your job is to prevent costly mistakes.
29
27
  3. **Explore Alternatives**: Always consider multiple approaches. Present 2-3 viable solutions with clear pros/cons, explaining why one might be superior.
30
- 4. **Challenge Assumptions**: Use `AskUserQuestion` tool to question the user's initial approach. Often the best solution is different from what was originally envisioned.
31
- 5. **Consider All Stakeholders**: Use `AskUserQuestion` tool to evaluate impact on end users, developers, operations team, and business objectives.
28
+ 4. **Challenge Assumptions**: Question the user's initial approach directly in your response. Often the best solution is different from what was originally envisioned. Wait for user input.
29
+ 5. **Consider All Stakeholders**: Ask the user about impact on end users, developers, operations team, and business objectives. Wait for response.
32
30
 
33
31
  ## Collaboration Tools
34
32
  - Consult the `planner` agent to research industry best practices and find proven solutions
@@ -41,13 +39,13 @@ You operate by the holy trinity of software engineering: **YAGNI** (You Aren't G
41
39
 
42
40
  ## Your Process
43
41
  1. **Scout Phase**: Use `scout` skill to discover relevant files and code patterns, read relevant docs in `<project-dir>/docs` directory, to understand the current state of the project
44
- 2. **Discovery Phase**: Use `AskUserQuestion` tool to ask clarifying questions about requirements, constraints, timeline, and success criteria
42
+ 2. **Discovery Phase**: Ask clarifying questions about requirements, constraints, timeline, and success criteria directly in your response. Wait for user answers.
45
43
  3. **Research Phase**: Gather information from other agents and external sources
46
44
  4. **Analysis Phase**: Evaluate multiple approaches using your expertise and principles
47
- 5. **Debate Phase**: Use `AskUserQuestion` tool to Present options, challenge user preferences, and work toward the optimal solution
45
+ 5. **Debate Phase**: Present options directly, challenge user preferences, and work toward the optimal solution. Wait for user input.
48
46
  6. **Consensus Phase**: Ensure alignment on the chosen approach and document decisions
49
47
  7. **Documentation Phase**: Create a comprehensive markdown summary report with the final agreed solution
50
- 8. **Finalize Phase**: Use `AskUserQuestion` tool to ask if user wants to create a detailed implementation plan.
48
+ 8. **Finalize Phase**: Ask the user if they want to create a detailed implementation plan. Wait for response.
51
49
  - If `Yes`: Run `/plan` command with the brainstorm summary context as the argument to ensure plan continuity.
52
50
  **CRITICAL:** The invoked plan command will create `plan.md` with YAML frontmatter including `status: pending`.
53
51
  - If `No`: End the session.
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: code-review
3
- description: Review code quality, receive feedback with technical rigor, verify completion claims. Use before PRs, after implementing features, when claiming task completion, for subagent reviews.
3
+ description: Review code quality, receive feedback with technical rigor, verify completion claims. Use before PRs, after implementing features, when claiming task completion, for agent reviews.
4
4
  ---
5
5
 
6
6
  # Code Review
@@ -12,7 +12,7 @@ Guide proper code review practices emphasizing technical rigor, evidence-based c
12
12
  Code review requires three distinct practices:
13
13
 
14
14
  1. **Receiving feedback** - Technical evaluation over performative agreement
15
- 2. **Requesting reviews** - Systematic review via code-reviewer subagent
15
+ 2. **Requesting reviews** - Systematic review via code-reviewer agent
16
16
  3. **Verification gates** - Evidence before any completion claims
17
17
 
18
18
  Each practice has specific triggers and protocols detailed in reference files.
@@ -38,7 +38,7 @@ Trigger when:
38
38
 
39
39
  ### Requesting Review
40
40
  Trigger when:
41
- - Completing tasks in subagent-driven development (after EACH task)
41
+ - Completing tasks in agent-driven development (after EACH task)
42
42
  - Finishing major features or refactors
43
43
  - Before merging to main branch
44
44
  - Stuck and need fresh perspective
@@ -67,8 +67,8 @@ SITUATION?
67
67
  │ └─ From external reviewer? → Verify technically before implementing
68
68
 
69
69
  ├─ Completed work
70
- │ ├─ Major feature/task? → Request code-reviewer subagent review
71
- │ └─ Before merge? → Request code-reviewer subagent review
70
+ │ ├─ Major feature/task? → Request code-reviewer agent review
71
+ │ └─ Before merge? → Request code-reviewer agent review
72
72
 
73
73
  └─ About to claim status
74
74
  ├─ Have fresh verification? → State claim WITH evidence
@@ -96,13 +96,13 @@ READ → UNDERSTAND → VERIFY → EVALUATE → RESPOND → IMPLEMENT
96
96
  ## Requesting Review Protocol
97
97
 
98
98
  ### When to Request
99
- - After each task in subagent-driven development
99
+ - After each task in agent-driven development
100
100
  - After major feature completion
101
101
  - Before merge to main
102
102
 
103
103
  ### Process
104
104
  1. Get git SHAs: `BASE_SHA=$(git rev-parse HEAD~1)` and `HEAD_SHA=$(git rev-parse HEAD)`
105
- 2. Dispatch code-reviewer subagent via Task tool with: WHAT_WAS_IMPLEMENTED, PLAN_OR_REQUIREMENTS, BASE_SHA, HEAD_SHA, DESCRIPTION
105
+ 2. Delegate to code-reviewer agent with: WHAT_WAS_IMPLEMENTED, PLAN_OR_REQUIREMENTS, BASE_SHA, HEAD_SHA, DESCRIPTION
106
106
  3. Act on feedback: Fix Critical immediately, Important before proceeding, note Minor for later
107
107
 
108
108
  **Full protocol:** `references/requesting-code-review.md`
@@ -130,14 +130,14 @@ Using "should"/"probably"/"seems to", expressing satisfaction before verificatio
130
130
 
131
131
  ## Integration with Workflows
132
132
 
133
- - **Subagent-Driven:** Review after EACH task, verify before moving to next
133
+ - **Agent-Driven:** Review after EACH task, verify before moving to next
134
134
  - **Pull Requests:** Verify tests pass, request code-reviewer review before merge
135
135
  - **General:** Apply verification gates before any status claims, push back on invalid feedback
136
136
 
137
137
  ## Bottom Line
138
138
 
139
139
  1. Technical rigor over social performance - No performative agreement
140
- 2. Systematic review processes - Use code-reviewer subagent
140
+ 2. Systematic review processes - Use code-reviewer agent
141
141
  3. Evidence before claims - Verification gates always
142
142
 
143
143
  Verify. Question. Then implement. Evidence. Then claim.
@@ -27,7 +27,7 @@ WHEN receiving code review feedback:
27
27
  ## Forbidden Responses
28
28
 
29
29
  **NEVER:**
30
- - "You're absolutely right!" (explicit CLAUDE.md violation)
30
+ - "You're absolutely right!" (explicit config violation)
31
31
  - "Great point!" / "Excellent feedback!" (performative)
32
32
  - "Let me implement that now" (before verification)
33
33
 
@@ -1,18 +1,18 @@
1
1
  ---
2
2
  name: requesting-code-review
3
- description: Use when completing tasks, implementing major features, or before merging to verify work meets requirements - dispatches code-reviewer subagent to review implementation against plan or requirements before proceeding
3
+ description: Use when completing tasks, implementing major features, or before merging to verify work meets requirements - dispatches code-reviewer agent to review implementation against plan or requirements before proceeding
4
4
  ---
5
5
 
6
6
  # Requesting Code Review
7
7
 
8
- Dispatch code-reviewer subagent to catch issues before they cascade.
8
+ Dispatch code-reviewer agent to catch issues before they cascade.
9
9
 
10
10
  **Core principle:** Review early, review often.
11
11
 
12
12
  ## When to Request Review
13
13
 
14
14
  **Mandatory:**
15
- - After each task in subagent-driven development
15
+ - After each task in agent-driven development
16
16
  - After completing major feature
17
17
  - Before merge to main
18
18
 
@@ -29,7 +29,7 @@ BASE_SHA=$(git rev-parse HEAD~1) # or origin/main
29
29
  HEAD_SHA=$(git rev-parse HEAD)
30
30
  ```
31
31
 
32
- **2. Dispatch code-reviewer subagent:**
32
+ **2. Dispatch code-reviewer agent:**
33
33
 
34
34
  Use Task tool with `code-reviewer` type, fill template at `code-reviewer.md`
35
35
 
@@ -56,14 +56,14 @@ You: Let me request code review before proceeding.
56
56
  BASE_SHA=$(git log --oneline | grep "Task 1" | head -1 | awk '{print $1}')
57
57
  HEAD_SHA=$(git rev-parse HEAD)
58
58
 
59
- [Dispatch code-reviewer subagent]
59
+ [Dispatch code-reviewer agent]
60
60
  WHAT_WAS_IMPLEMENTED: Verification and repair functions for conversation index
61
61
  PLAN_OR_REQUIREMENTS: Task 2 from docs/plans/deployment-plan.md
62
62
  BASE_SHA: a7981ec
63
63
  HEAD_SHA: 3df7661
64
64
  DESCRIPTION: Added verifyIndex() and repairIndex() with 4 issue types
65
65
 
66
- [Subagent returns]:
66
+ [Agent returns]:
67
67
  Strengths: Clean architecture, real tests
68
68
  Issues:
69
69
  Important: Missing progress indicators
@@ -76,7 +76,7 @@ You: [Fix progress indicators]
76
76
 
77
77
  ## Integration with Workflows
78
78
 
79
- **Subagent-Driven Development:**
79
+ **Agent-Driven Development:**
80
80
  - Review after EACH task
81
81
  - Catch issues before they compound
82
82
  - Fix before moving to next task
@@ -59,19 +59,19 @@ def find_api_key(skill_dir: Optional[Path] = None) -> Optional[str]:
59
59
  return api_key
60
60
 
61
61
  # Step 3: Check ./.copilot/.env
62
- claude_env = project_dir / '.copilot' / '.env'
63
- if claude_env.exists():
64
- api_key = load_env_file(claude_env)
62
+ config_env = project_dir / '.copilot' / '.env'
63
+ if config_env.exists():
64
+ api_key = load_env_file(config_env)
65
65
  if api_key:
66
- print(f"✓ Using API key from {claude_env}", file=sys.stderr)
66
+ print(f"✓ Using API key from {config_env}", file=sys.stderr)
67
67
  return api_key
68
68
 
69
69
  # Step 4: Check ./.copilot/skills/.env
70
- claude_skills_env = project_dir / '.copilot' / 'skills' / '.env'
71
- if claude_skills_env.exists():
72
- api_key = load_env_file(claude_skills_env)
70
+ skills_config_env = project_dir / '.copilot' / 'skills' / '.env'
71
+ if skills_config_env.exists():
72
+ api_key = load_env_file(skills_config_env)
73
73
  if api_key:
74
- print(f"✓ Using API key from {claude_skills_env}", file=sys.stderr)
74
+ print(f"✓ Using API key from {skills_config_env}", file=sys.stderr)
75
75
  return api_key
76
76
 
77
77
  # Step 5: Check skill directory .env
@@ -3,7 +3,6 @@ name: context-engineering
3
3
  description: >-
4
4
  Check context usage limits, monitor time remaining, optimize token consumption, debug context failures.
5
5
  Use when asking about context percentage, rate limits, usage warnings, context optimization, agent architectures, memory systems.
6
- version: 1.0.0
7
6
  ---
8
7
 
9
8
  # Context Engineering
@@ -31,7 +30,7 @@ Context engineering curates the smallest high-signal token set for LLM tasks. Th
31
30
  **IMPORTANT:**
32
31
  - Sacrifice grammar for the sake of concision.
33
32
  - Ensure token efficiency while maintaining high quality.
34
- - Pass these rules to subagents.
33
+ - Pass these rules to agents.
35
34
 
36
35
  ## Quick Reference
37
36
 
@@ -88,7 +87,7 @@ The system automatically injects usage awareness via PostToolUse hook:
88
87
 
89
88
  ```xml
90
89
  <usage-awareness>
91
- Claude Usage Limits: 5h=45%, 7d=32%
90
+ Usage Limits: 5h=45%, 7d=32%
92
91
  Context Window Usage: 67%
93
92
  </usage-awareness>
94
93
  ```
@@ -98,7 +97,7 @@ Context Window Usage: 67%
98
97
  - 90%: CRITICAL - immediate action needed
99
98
 
100
99
  **Data Sources:**
101
- - Usage limits: Anthropic OAuth API (`https://api.anthropic.com/api/oauth/usage`)
100
+ - Usage limits: Platform OAuth API (platform-specific endpoint)
102
101
  - Context window: Statusline temp file (`/tmp/ck-context-{session_id}.json`)
103
102
 
104
103
  ## Scripts
@@ -52,8 +52,8 @@ Predictable degradation as context grows. Not binary - a continuum.
52
52
  | Model | Degradation Onset | Severe Degradation |
53
53
  |-------|-------------------|-------------------|
54
54
  | GPT-5.2 | ~64K tokens | ~200K tokens |
55
- | Claude Opus 4.5 | ~100K tokens | ~180K tokens |
56
- | Claude Sonnet 4.5 | ~80K tokens | ~150K tokens |
55
+ | Model (Large) | ~100K tokens | ~180K tokens |
56
+ | Model (Medium) | ~80K tokens | ~150K tokens |
57
57
  | Gemini 3 Pro | ~500K tokens | ~800K tokens |
58
58
 
59
59
  ## Four-Bucket Mitigation
@@ -1,6 +1,6 @@
1
1
  # Runtime Awareness
2
2
 
3
- Monitor usage limits and context window utilization in real-time to optimize Claude Code sessions.
3
+ Monitor usage limits and context window utilization in real-time to optimize AI agent sessions.
4
4
 
5
5
  ## Overview
6
6
 
@@ -29,18 +29,18 @@ Runtime awareness provides visibility into two critical metrics:
29
29
  ### Endpoint
30
30
 
31
31
  ```
32
- GET https://api.anthropic.com/api/oauth/usage
32
+ GET <platform-specific-usage-endpoint>
33
33
  ```
34
34
 
35
35
  ### Authentication
36
36
 
37
- Requires OAuth Bearer token with `anthropic-beta: oauth-2025-04-20` header.
37
+ Requires OAuth Bearer token with platform-specific headers.
38
38
 
39
39
  ### Credential Locations
40
40
 
41
41
  | Platform | Method | Location |
42
42
  |----------|--------|----------|
43
- | macOS | Keychain | `Claude Code-credentials` |
43
+ | macOS | Keychain | `agent-credentials` |
44
44
  | Windows | File | `%USERPROFILE%.copilot\.credentials.json` |
45
45
  | Linux | File | `~/.copilot/.credentials.json` |
46
46
 
@@ -157,7 +157,7 @@ Context: 91% [CRITICAL - compaction needed]
157
157
  | 5-Hour | Action |
158
158
  |--------|--------|
159
159
  | < 70% | Normal usage |
160
- | 70-90% | Reduce parallelization, delegate to subagents |
160
+ | 70-90% | Reduce parallelization, delegate to agents |
161
161
  | > 90% | Wait for reset or use lower-tier models |
162
162
 
163
163
  | 7-Day | Action |
@@ -196,7 +196,7 @@ Context: 91% [CRITICAL - compaction needed]
196
196
 
197
197
  | Issue | Cause | Solution |
198
198
  |-------|-------|----------|
199
- | No usage limits shown | No OAuth token | Run `claude login` |
199
+ | No usage limits shown | No OAuth token | Run the agent login command |
200
200
  | Stale context data | Statusline not updating | Check statusline config |
201
201
  | 401 Unauthorized | Expired token | Re-authenticate |
202
202
  | Hook not firing | Settings misconfigured | Verify PostToolUse matcher |
@@ -4,7 +4,7 @@ End-to-end feature implementation with smart intent detection.
4
4
 
5
5
  ## Installation
6
6
 
7
- Copy the `cook/` folder to your Claude skills directory:
7
+ Copy the `cook/` folder to your skills directory:
8
8
  ```bash
9
9
  cp -r cook ~/.copilot/skills/
10
10
  ```
@@ -77,7 +77,7 @@ cook/
77
77
  ├── intent-detection.md # Detection rules
78
78
  ├── workflow-steps.md # Step definitions
79
79
  ├── review-cycle.md # Review process
80
- └── subagent-patterns.md # Subagent usage
80
+ └── agent-patterns.md # Agent usage
81
81
  ```
82
82
 
83
83
  ## Version
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: cook
3
3
  description: ALWAYS activate this skill before implementing EVERY feature, plan, or fix.
4
- version: 2.1.0
5
4
  ---
6
5
 
7
6
  # Cook - Smart Feature Implementation
@@ -74,9 +73,9 @@ Human review required at these checkpoints (skipped with `--auto`):
74
73
  - **Code Review:** User approval OR auto-approve (score≥9.5, 0 critical)
75
74
  - **Finalize:** project-manager AND docs-manager must complete
76
75
 
77
- ## Required Subagents
76
+ ## Required Agents
78
77
 
79
- | Phase | Subagent |
78
+ | Phase | Agent |
80
79
  |-------|----------|
81
80
  | Research | `researcher` (parallel, optional in fast) |
82
81
  | Scout | `scout` |
@@ -91,4 +90,4 @@ Human review required at these checkpoints (skipped with `--auto`):
91
90
  - `references/intent-detection.md` - Detection rules and routing logic
92
91
  - `references/workflow-steps.md` - Detailed step definitions for all modes
93
92
  - `references/review-cycle.md` - Interactive and auto review processes
94
- - `references/subagent-patterns.md` - Subagent invocation patterns
93
+ - `references/agent-patterns.md` - Agent invocation patterns
@@ -0,0 +1,75 @@
1
+ # Agent Patterns
2
+
3
+ Standard patterns for spawning and using agents in cook workflows.
4
+
5
+ ## Task Tool Pattern
6
+ ```
7
+ Task(type="[type]", prompt="[task description]", description="[brief]")
8
+ ```
9
+
10
+ ## Research Phase
11
+ ```
12
+ Task(type="researcher", prompt="Research [topic]. Report ≤150 lines.", description="Research [topic]")
13
+ ```
14
+ - Use multiple researchers in parallel for different topics
15
+ - Keep reports ≤150 lines with citations
16
+
17
+ ## Scout Phase
18
+ ```
19
+ Task(type="scout", prompt="Find files related to [feature] in codebase", description="Scout [feature]")
20
+ ```
21
+ - Use `/scout:ext` (preferred) or `/scout` (fallback)
22
+
23
+ ## Planning Phase
24
+ ```
25
+ Task(type="planner", prompt="Create implementation plan based on reports: [reports]. Save to [path]", description="Plan [feature]")
26
+ ```
27
+ - Input: researcher and scout reports
28
+ - Output: `plan.md` + `phase-XX-*.md` files
29
+
30
+ ## UI Implementation
31
+ ```
32
+ Task(type="ui-ux-designer", prompt="Implement [feature] UI per ./docs/design-guidelines.md", description="UI [feature]")
33
+ ```
34
+ - For frontend work
35
+ - Follow design guidelines
36
+
37
+ ## Testing
38
+ ```
39
+ Task(type="tester", prompt="Run test suite for plan phase [phase-name]", description="Test [phase]")
40
+ ```
41
+ - Must achieve 100% pass rate
42
+
43
+ ## Debugging
44
+ ```
45
+ Task(type="debugger", prompt="Analyze failures: [details]", description="Debug [issue]")
46
+ ```
47
+ - Use when tests fail
48
+ - Provides root cause analysis
49
+
50
+ ## Code Review
51
+ ```
52
+ Task(type="code-reviewer", prompt="Review changes for [phase]. Check security, performance, YAGNI/KISS/DRY. Return score (X/10), critical, warnings, suggestions.", description="Review [phase]")
53
+ ```
54
+
55
+ ## Project Management
56
+ ```
57
+ Task(type="project-manager", prompt="Update plan status in [path]. Mark [phase] as DONE. Update roadmap.", description="Update plan")
58
+ ```
59
+
60
+ ## Documentation
61
+ ```
62
+ Task(type="docs-manager", prompt="Update docs for [phase]. Changed files: [list]", description="Update docs")
63
+ ```
64
+
65
+ ## Git Operations
66
+ ```
67
+ Task(type="git-manager", prompt="Stage and commit changes with conventional commit message", description="Commit changes")
68
+ ```
69
+
70
+ ## Parallel Execution
71
+ ```
72
+ Task(type="fullstack-developer", prompt="Implement [phase-file] with file ownership: [files]", description="Implement phase [N]")
73
+ ```
74
+ - Launch multiple for parallel phases
75
+ - Include file ownership boundaries
@@ -24,7 +24,7 @@ LOOP:
24
24
  │ - [suggestion] │
25
25
  └─────────────────────────────────────────┘
26
26
 
27
- 3. AskUserQuestion (header: "Review & Approve"):
27
+ 3. Ask user directly (header: "Review & Approve") — then wait for response:
28
28
  IF critical_count > 0:
29
29
  - "Fix critical issues" → fix, re-run tester, cycle++, LOOP
30
30
  - "Fix all issues" → fix all, re-run tester, cycle++, LOOP
@@ -37,7 +37,7 @@ LOOP:
37
37
 
38
38
  4. IF cycle >= 3 AND user selects fix:
39
39
  → "⚠ 3 review cycles completed. Final decision required."
40
- AskUserQuestion: "Approve with noted issues" / "Abort workflow"
40
+ Ask user: "Approve with noted issues" / "Abort workflow" — wait for response
41
41
  ```
42
42
 
43
43
  ## Auto-Handling Cycle (for auto modes)
@@ -25,7 +25,7 @@ All modes share core steps with mode-specific variations.
25
25
 
26
26
  ### [Review Gate 1] Post-Research (skip if auto mode)
27
27
  - Present research summary to user
28
- - AskUserQuestion: "Proceed to planning?" / "Request more research" / "Abort"
28
+ - Ask user: "Proceed to planning?" / "Request more research" / "Abort" — then wait for response
29
29
  - **Auto mode:** Skip this gate
30
30
 
31
31
  ## Step 2: Planning
@@ -49,7 +49,7 @@ All modes share core steps with mode-specific variations.
49
49
 
50
50
  ### [Review Gate 2] Post-Plan (skip if auto mode)
51
51
  - Present plan overview with phases
52
- - AskUserQuestion: "Approve plan and start implementation?" / "Request revisions" / "Abort"
52
+ - Ask user: "Approve plan and start implementation?" / "Request revisions" / "Abort" — then wait for response
53
53
  - **Auto mode:** Skip this gate
54
54
 
55
55
  ## Step 3: Implementation
@@ -69,7 +69,7 @@ All modes share core steps with mode-specific variations.
69
69
 
70
70
  ### [Review Gate 3] Post-Implementation (skip if auto mode)
71
71
  - Present implementation summary (files changed, key changes)
72
- - AskUserQuestion: "Proceed to testing?" / "Request implementation changes" / "Abort"
72
+ - Ask user: "Proceed to testing?" / "Request implementation changes" / "Abort" — then wait for response
73
73
  - **Auto mode:** Skip this gate
74
74
 
75
75
  ## Step 4: Testing (skip if no-test mode)
@@ -84,7 +84,7 @@ All modes share core steps with mode-specific variations.
84
84
 
85
85
  ### [Review Gate 4] Post-Testing (skip if auto mode)
86
86
  - Present test results summary
87
- - AskUserQuestion: "Proceed to code review?" / "Request test fixes" / "Abort"
87
+ - Ask user: "Proceed to code review?" / "Request test fixes" / "Abort" — then wait for response
88
88
  - **Auto mode:** Skip this gate
89
89
 
90
90
  ## Step 5: Code Review
@@ -108,9 +108,9 @@ All modes share core steps with mode-specific variations.
108
108
  ## Step 6: Finalize
109
109
 
110
110
  **All modes:**
111
- 1. `project-manager` + `docs-manager` subagents in parallel
111
+ 1. `project-manager` + `docs-manager` agents in parallel
112
112
  2. Onboarding check (API keys, env vars)
113
- 3. Auto-commit via `git-manager` subagent
113
+ 3. Auto-commit via `git-manager` agent
114
114
 
115
115
  **Auto mode:** Continue to next phase automatically
116
116
  **Others:** Ask user before next phase
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: databases
3
3
  description: Design schemas, write queries for MongoDB, PostgreSQL, SQL Server. Use for database design, SQL/NoSQL queries, aggregation pipelines, indexes, migrations, replication, performance optimization, psql CLI, EF Core.
4
- license: MIT
5
4
  ---
6
5
 
7
6
  # Databases Skill
@@ -14,8 +14,8 @@ from pathlib import Path
14
14
  from typing import Any, Dict, List, Optional
15
15
 
16
16
  # Windows UTF-8 compatibility (works for both local and global installs)
17
- CLAUDE_ROOT = Path(__file__).parent.parent.parent.parent
18
- sys.path.insert(0, str(CLAUDE_ROOT / 'scripts'))
17
+ PROJECT_ROOT = Path(__file__).parent.parent.parent.parent
18
+ sys.path.insert(0, str(PROJECT_ROOT / 'scripts'))
19
19
  try:
20
20
  from win_compat import ensure_utf8_stdout
21
21
  ensure_utf8_stdout()
@@ -13,8 +13,8 @@ from pathlib import Path
13
13
  from typing import Dict, List, Optional
14
14
 
15
15
  # Windows UTF-8 compatibility (works for both local and global installs)
16
- CLAUDE_ROOT = Path(__file__).parent.parent.parent.parent
17
- sys.path.insert(0, str(CLAUDE_ROOT / 'scripts'))
16
+ PROJECT_ROOT = Path(__file__).parent.parent.parent.parent
17
+ sys.path.insert(0, str(PROJECT_ROOT / 'scripts'))
18
18
  try:
19
19
  from win_compat import ensure_utf8_stdout
20
20
  ensure_utf8_stdout()
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: debug
3
3
  description: Debug systematically with root cause analysis before fixes. Use for bugs, test failures, unexpected behavior, performance issues, call stack tracing, multi-layer validation.
4
- version: 3.1.0
5
4
  languages: all
6
5
  ---
7
6
 
@@ -1,8 +1,6 @@
1
1
  ---
2
2
  name: devops
3
3
  description: Deploy to Cloudflare (Workers, R2, D1), Docker, GCP (Cloud Run, GKE), Azure (App Service, AKS), Kubernetes (kubectl, Helm). Use for serverless, containers, CI/CD, GitOps, security audit.
4
- license: MIT
5
- version: 2.0.0
6
4
  ---
7
5
 
8
6
  # DevOps Skill
@@ -19,8 +19,8 @@ from pathlib import Path
19
19
  from typing import Dict, List, Optional, Tuple
20
20
 
21
21
  # Windows UTF-8 compatibility (works for both local and global installs)
22
- CLAUDE_ROOT = Path(__file__).parent.parent.parent.parent
23
- sys.path.insert(0, str(CLAUDE_ROOT / 'scripts'))
22
+ PROJECT_ROOT = Path(__file__).parent.parent.parent.parent
23
+ sys.path.insert(0, str(PROJECT_ROOT / 'scripts'))
24
24
  try:
25
25
  from win_compat import ensure_utf8_stdout
26
26
  ensure_utf8_stdout()
@@ -1,7 +1,6 @@
1
1
  ---
2
2
  name: docs-seeker
3
3
  description: Search library/framework documentation via llms.txt (context7.com). Use for API docs, GitHub repository analysis, technical documentation lookup, latest library features.
4
- version: 3.1.0
5
4
  ---
6
5
 
7
6
  # Documentation Discovery via Scripts
@@ -15,7 +15,7 @@
15
15
  "context7",
16
16
  "docs-discovery"
17
17
  ],
18
- "author": "ClaudeKit",
18
+ "author": "CoKit",
19
19
  "license": "MIT",
20
20
  "dependencies": {},
21
21
  "devDependencies": {},
@@ -47,10 +47,10 @@ function parseEnvFile(content) {
47
47
  function loadEnv() {
48
48
  const skillDir = path.resolve(__dirname, '../..');
49
49
  const skillsDir = path.resolve(skillDir, '..');
50
- const claudeDir = path.resolve(skillsDir, '..');
50
+ const configDir = path.resolve(skillsDir, '..');
51
51
 
52
52
  const envPaths = [
53
- path.join(claudeDir, '.env'), // Lowest priority
53
+ path.join(configDir, '.env'), // Lowest priority
54
54
  path.join(skillsDir, '.env'),
55
55
  path.join(skillDir, '.env'), // Highest priority (file)
56
56
  ];