cokit-cli 1.2.6 → 1.3.0

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 (471) hide show
  1. package/README.md +9 -42
  2. package/agents/brainstormer.agent.md +28 -14
  3. package/agents/code-reviewer.agent.md +101 -67
  4. package/agents/code-simplifier.agent.md +36 -41
  5. package/agents/debugger.agent.md +29 -24
  6. package/agents/docs-manager.agent.md +15 -23
  7. package/agents/fullstack-developer.agent.md +16 -6
  8. package/agents/git-manager.agent.md +0 -3
  9. package/agents/planner.agent.md +16 -34
  10. package/agents/project-manager.agent.md +24 -0
  11. package/agents/researcher.agent.md +15 -13
  12. package/agents/tester.agent.md +43 -20
  13. package/agents/ui-ux-designer.agent.md +16 -49
  14. package/docs/README.md +8 -9
  15. package/docs/Skills Orchestration Layer - Training Slides - en.pdf +0 -0
  16. package/docs/Skills Orchestration Layer - Training Slides - vi.pdf +0 -0
  17. package/docs/code-standards.md +1 -2
  18. package/docs/codebase-summary.md +35 -66
  19. package/docs/cokit-commands-usage-guide.md +27 -73
  20. package/docs/cokit-comprehensive-mapping-guide.md +9 -15
  21. package/docs/cokit-slides.md +4 -9
  22. package/docs/cokit-sync-and-maintenance-guide.md +42 -190
  23. package/docs/cokit-team-presentation.md +6 -11
  24. package/docs/copilot-processing-flow.md +3 -3
  25. package/docs/migration-guide.md +15 -15
  26. package/docs/project-overview-pdr.md +6 -7
  27. package/docs/project-roadmap.md +13 -15
  28. package/docs/skills-and-orchestration-layer-en.md +404 -0
  29. package/docs/skills-and-orchestration-layer-vi.md +404 -0
  30. package/docs/system-architecture.md +14 -20
  31. package/docs/{claudekit-porting-rules.md → upstream-porting-rules.md} +15 -16
  32. package/package.json +3 -4
  33. package/prompts/ck-ask.prompt.md +0 -1
  34. package/prompts/ck-bootstrap.prompt.md +0 -3
  35. package/prompts/ck-brainstorm.prompt.md +0 -1
  36. package/prompts/ck-cook.prompt.md +0 -1
  37. package/prompts/ck-debug.prompt.md +0 -1
  38. package/prompts/ck-deploy.prompt.md +22 -0
  39. package/prompts/ck-docs.prompt.md +0 -1
  40. package/prompts/ck-frontend.prompt.md +20 -0
  41. package/prompts/ck-help.prompt.md +0 -1
  42. package/prompts/ck-plan-fast.prompt.md +0 -3
  43. package/prompts/ck-plan-hard.prompt.md +0 -3
  44. package/prompts/ck-plan.prompt.md +0 -3
  45. package/prompts/ck-project.prompt.md +20 -0
  46. package/prompts/ck-review.prompt.md +0 -3
  47. package/prompts/ck-scout.prompt.md +0 -1
  48. package/prompts/ck-security.prompt.md +22 -0
  49. package/prompts/ck-ship.prompt.md +22 -0
  50. package/prompts/ck-test.prompt.md +0 -2
  51. package/prompts/ck-watzup.prompt.md +0 -1
  52. package/skills/agent-browser/SKILL.md +11 -8
  53. package/skills/agent-browser/references/agent-browser-vs-chrome-devtools.md +112 -0
  54. package/skills/bootstrap/SKILL.md +102 -0
  55. package/skills/bootstrap/references/shared-phases.md +59 -0
  56. package/skills/bootstrap/references/workflow-auto.md +52 -0
  57. package/skills/bootstrap/references/workflow-fast.md +50 -0
  58. package/skills/bootstrap/references/workflow-full.md +60 -0
  59. package/skills/bootstrap/references/workflow-parallel.md +59 -0
  60. package/skills/brainstorm/SKILL.md +63 -15
  61. package/skills/code-review/SKILL.md +138 -135
  62. package/skills/code-review/references/adversarial-review.md +223 -0
  63. package/skills/code-review/references/checklist-workflow.md +100 -0
  64. package/skills/code-review/references/checklists/api.md +52 -0
  65. package/skills/code-review/references/checklists/base.md +100 -0
  66. package/skills/code-review/references/checklists/web-app.md +54 -0
  67. package/skills/code-review/references/code-review-reception.md +48 -144
  68. package/skills/code-review/references/codebase-scan-workflow.md +30 -0
  69. package/skills/code-review/references/edge-case-scouting.md +119 -0
  70. package/skills/code-review/references/input-mode-resolution.md +135 -0
  71. package/skills/code-review/references/parallel-review-workflow.md +76 -0
  72. package/skills/code-review/references/requesting-code-review.md +115 -104
  73. package/skills/code-review/references/spec-compliance-review.md +43 -0
  74. package/skills/code-review/references/task-management-reviews.md +155 -0
  75. package/skills/common/README.md +2 -12
  76. package/skills/common/api_key_helper.py +7 -37
  77. package/skills/context-engineering/SKILL.md +4 -3
  78. package/skills/context-engineering/references/context-degradation.md +2 -2
  79. package/skills/context-engineering/references/runtime-awareness.md +5 -47
  80. package/skills/cook/README.md +13 -13
  81. package/skills/cook/SKILL.md +86 -58
  82. package/skills/cook/references/intent-detection.md +7 -7
  83. package/skills/cook/references/review-cycle.md +2 -2
  84. package/skills/cook/references/subagent-patterns.md +75 -0
  85. package/skills/cook/references/workflow-steps.md +75 -23
  86. package/skills/databases/SKILL.md +3 -30
  87. package/skills/databases/db-design.md +1 -1
  88. package/skills/debug/SKILL.md +47 -105
  89. package/skills/debug/references/frontend-verification.md +103 -0
  90. package/skills/debug/references/investigation-methodology.md +101 -0
  91. package/skills/debug/references/log-and-ci-analysis.md +97 -0
  92. package/skills/debug/references/performance-diagnostics.md +113 -0
  93. package/skills/debug/references/reporting-standards.md +122 -0
  94. package/skills/debug/references/task-management-debugging.md +155 -0
  95. package/skills/deploy/SKILL.md +154 -0
  96. package/skills/deploy/references/platform-config-templates.md +35 -0
  97. package/skills/deploy/references/platforms/aws.md +58 -0
  98. package/skills/deploy/references/platforms/cloudflare.md +41 -0
  99. package/skills/deploy/references/platforms/coolify.md +32 -0
  100. package/skills/deploy/references/platforms/digitalocean.md +45 -0
  101. package/skills/deploy/references/platforms/dokploy.md +29 -0
  102. package/skills/deploy/references/platforms/flyio.md +54 -0
  103. package/skills/deploy/references/platforms/gcp.md +45 -0
  104. package/skills/deploy/references/platforms/github-pages.md +56 -0
  105. package/skills/deploy/references/platforms/heroku.md +31 -0
  106. package/skills/deploy/references/platforms/netlify.md +39 -0
  107. package/skills/deploy/references/platforms/railway.md +38 -0
  108. package/skills/deploy/references/platforms/render.md +39 -0
  109. package/skills/deploy/references/platforms/tose.md +35 -0
  110. package/skills/deploy/references/platforms/vercel.md +37 -0
  111. package/skills/deploy/references/platforms/vultr.md +27 -0
  112. package/skills/devops/SKILL.md +6 -12
  113. package/skills/docs-seeker/SKILL.md +2 -1
  114. package/skills/docs-seeker/references/context7-patterns.md +4 -0
  115. package/skills/docs-seeker/scripts/fetch-docs.js +1 -2
  116. package/skills/docs-seeker/scripts/utils/env-loader.js +4 -4
  117. package/skills/docs-seeker/workflows/library-search.md +1 -0
  118. package/skills/fix/SKILL.md +141 -44
  119. package/skills/fix/references/complexity-assessment.md +21 -9
  120. package/skills/fix/references/diagnosis-protocol.md +133 -0
  121. package/skills/fix/references/mode-selection.md +27 -11
  122. package/skills/fix/references/parallel-exploration.md +35 -12
  123. package/skills/fix/references/prevention-gate.md +87 -0
  124. package/skills/fix/references/review-cycle.md +3 -3
  125. package/skills/fix/references/skill-activation-matrix.md +64 -31
  126. package/skills/fix/references/task-orchestration.md +110 -0
  127. package/skills/fix/references/workflow-deep.md +110 -47
  128. package/skills/fix/references/workflow-logs.md +46 -10
  129. package/skills/fix/references/workflow-quick.md +43 -20
  130. package/skills/fix/references/workflow-standard.md +75 -41
  131. package/skills/fix/references/workflow-test.md +49 -10
  132. package/skills/fix/references/workflow-ui.md +56 -18
  133. package/skills/frontend-design/SKILL.md +109 -77
  134. package/skills/frontend-design/references/ai-multimodal-overview.md +165 -0
  135. package/skills/frontend-design/references/anti-slop-rules.md +103 -0
  136. package/skills/frontend-design/references/asset-generation.md +284 -108
  137. package/skills/frontend-design/references/bento-motion-engine.md +142 -0
  138. package/skills/frontend-design/references/magicui-components.md +129 -0
  139. package/skills/frontend-design/references/performance-guardrails.md +169 -0
  140. package/skills/frontend-design/references/premium-design-patterns.md +93 -0
  141. package/skills/frontend-design/references/redesign-audit-checklist.md +114 -0
  142. package/skills/frontend-design/references/visual-analysis-overview.md +1 -1
  143. package/skills/frontend-design/references/workflow-3d.md +98 -0
  144. package/skills/frontend-design/references/workflow-describe.md +4 -3
  145. package/skills/frontend-design/references/workflow-immersive.md +82 -0
  146. package/skills/frontend-design/references/workflow-quick.md +10 -12
  147. package/skills/frontend-design/references/workflow-screenshot.md +9 -8
  148. package/skills/frontend-design/references/workflow-video.md +74 -0
  149. package/skills/frontend-development/SKILL.md +400 -0
  150. package/skills/frontend-development/resources/common-patterns.md +331 -0
  151. package/skills/frontend-development/resources/complete-examples.md +872 -0
  152. package/skills/frontend-development/resources/component-patterns.md +502 -0
  153. package/skills/frontend-development/resources/data-fetching.md +767 -0
  154. package/skills/frontend-development/resources/file-organization.md +502 -0
  155. package/skills/frontend-development/resources/loading-and-error-states.md +501 -0
  156. package/skills/frontend-development/resources/performance.md +406 -0
  157. package/skills/frontend-development/resources/routing-guide.md +364 -0
  158. package/skills/frontend-development/resources/styling-guide.md +428 -0
  159. package/skills/frontend-development/resources/typescript-standards.md +418 -0
  160. package/skills/git/SKILL.md +18 -4
  161. package/skills/git/references/commit-standards.md +3 -3
  162. package/skills/git/references/workflow-commit.md +3 -3
  163. package/skills/git/references/workflow-merge.md +1 -1
  164. package/skills/git/references/workflow-pr.md +1 -1
  165. package/skills/git/references/workflow-push.md +1 -1
  166. package/skills/mcp-management/README.md +18 -18
  167. package/skills/mcp-management/SKILL.md +16 -15
  168. package/skills/mcp-management/references/configuration.md +4 -4
  169. package/skills/mcp-management/references/gemini-cli-integration.md +12 -12
  170. package/skills/mcp-management/scripts/.env.example +2 -2
  171. package/skills/mcp-management/scripts/dist/mcp-client.js +1 -1
  172. package/skills/mcp-management/scripts/mcp-client.ts +1 -1
  173. package/skills/mermaidjs-v11/SKILL.md +1 -0
  174. package/skills/planning/SKILL.md +122 -91
  175. package/skills/planning/references/archive-workflow.md +53 -0
  176. package/skills/planning/references/codebase-understanding.md +1 -1
  177. package/skills/planning/references/output-standards.md +17 -13
  178. package/skills/planning/references/plan-organization.md +52 -30
  179. package/skills/planning/references/red-team-personas.md +69 -0
  180. package/skills/planning/references/red-team-workflow.md +77 -0
  181. package/skills/planning/references/scope-challenge.md +90 -0
  182. package/skills/planning/references/task-management.md +134 -0
  183. package/skills/planning/references/validate-question-framework.md +80 -0
  184. package/skills/planning/references/validate-workflow.md +65 -0
  185. package/skills/planning/references/workflow-modes.md +154 -0
  186. package/skills/problem-solving/SKILL.md +1 -0
  187. package/skills/project-management/SKILL.md +133 -0
  188. package/skills/project-management/references/documentation-triggers.md +60 -0
  189. package/skills/project-management/references/hydration-workflow.md +89 -0
  190. package/skills/project-management/references/progress-tracking.md +120 -0
  191. package/skills/project-management/references/reporting-patterns.md +94 -0
  192. package/skills/project-management/references/task-operations.md +87 -0
  193. package/skills/repomix/SKILL.md +3 -2
  194. package/skills/repomix/references/usage-patterns.md +2 -2
  195. package/skills/repomix/scripts/README.md +1 -1
  196. package/skills/repomix/scripts/repomix_batch.py +2 -2
  197. package/skills/research/SKILL.md +7 -4
  198. package/skills/scout/SKILL.md +24 -24
  199. package/skills/scout/references/external-scouting.md +17 -17
  200. package/skills/scout/references/internal-scouting.md +9 -9
  201. package/skills/scout/references/task-management-scouting.md +125 -0
  202. package/skills/security/SKILL.md +139 -0
  203. package/skills/security/references/stride-owasp-checklist.md +128 -0
  204. package/skills/sequential-thinking/README.md +3 -3
  205. package/skills/sequential-thinking/SKILL.md +2 -0
  206. package/skills/sequential-thinking/package.json +1 -1
  207. package/skills/ship/SKILL.md +116 -0
  208. package/skills/ship/references/auto-detect.md +103 -0
  209. package/skills/ship/references/pr-template.md +90 -0
  210. package/skills/ship/references/ship-workflow.md +241 -0
  211. package/skills/test/SKILL.md +111 -0
  212. package/skills/test/references/report-format.md +58 -0
  213. package/skills/test/references/test-execution-workflow.md +103 -0
  214. package/skills/test/references/ui-testing-workflow.md +65 -0
  215. package/skills/ui-styling/SKILL.md +2 -0
  216. package/skills/web-testing/SKILL.md +8 -60
  217. package/src/commands/add.js +0 -1
  218. package/src/commands/doctor.js +2 -2
  219. package/src/commands/init.js +19 -28
  220. package/src/commands/update.js +1 -1
  221. package/templates/repo/.github/agents/brainstormer.agent.md +28 -14
  222. package/templates/repo/.github/agents/code-reviewer.agent.md +101 -67
  223. package/templates/repo/.github/agents/code-simplifier.agent.md +36 -41
  224. package/templates/repo/.github/agents/debugger.agent.md +29 -24
  225. package/templates/repo/.github/agents/docs-manager.agent.md +15 -23
  226. package/templates/repo/.github/agents/fullstack-developer.agent.md +16 -6
  227. package/templates/repo/.github/agents/git-manager.agent.md +0 -3
  228. package/templates/repo/.github/agents/planner.agent.md +16 -34
  229. package/templates/repo/.github/agents/project-manager.agent.md +24 -0
  230. package/templates/repo/.github/agents/researcher.agent.md +15 -13
  231. package/templates/repo/.github/agents/tester.agent.md +43 -20
  232. package/templates/repo/.github/agents/ui-ux-designer.agent.md +16 -49
  233. package/templates/repo/.github/prompts/ck-ask.prompt.md +0 -1
  234. package/templates/repo/.github/prompts/ck-bootstrap.prompt.md +0 -3
  235. package/templates/repo/.github/prompts/ck-brainstorm.prompt.md +0 -1
  236. package/templates/repo/.github/prompts/ck-cook.prompt.md +0 -1
  237. package/templates/repo/.github/prompts/ck-debug.prompt.md +0 -1
  238. package/templates/repo/.github/prompts/ck-deploy.prompt.md +22 -0
  239. package/templates/repo/.github/prompts/ck-docs.prompt.md +0 -1
  240. package/templates/repo/.github/prompts/ck-frontend.prompt.md +20 -0
  241. package/templates/repo/.github/prompts/ck-help.prompt.md +0 -1
  242. package/templates/repo/.github/prompts/ck-plan-fast.prompt.md +0 -3
  243. package/templates/repo/.github/prompts/ck-plan-hard.prompt.md +0 -3
  244. package/templates/repo/.github/prompts/ck-plan.prompt.md +0 -3
  245. package/templates/repo/.github/prompts/ck-project.prompt.md +20 -0
  246. package/templates/repo/.github/prompts/ck-review.prompt.md +0 -3
  247. package/templates/repo/.github/prompts/ck-scout.prompt.md +0 -1
  248. package/templates/repo/.github/prompts/ck-security.prompt.md +22 -0
  249. package/templates/repo/.github/prompts/ck-ship.prompt.md +22 -0
  250. package/templates/repo/.github/prompts/ck-test.prompt.md +0 -2
  251. package/templates/repo/.github/prompts/ck-watzup.prompt.md +0 -1
  252. package/templates/repo/.github/skills/agent-browser/SKILL.md +11 -8
  253. package/templates/repo/.github/skills/agent-browser/references/agent-browser-vs-chrome-devtools.md +112 -0
  254. package/templates/repo/.github/skills/bootstrap/SKILL.md +102 -0
  255. package/templates/repo/.github/skills/bootstrap/references/shared-phases.md +59 -0
  256. package/templates/repo/.github/skills/bootstrap/references/workflow-auto.md +52 -0
  257. package/templates/repo/.github/skills/bootstrap/references/workflow-fast.md +50 -0
  258. package/templates/repo/.github/skills/bootstrap/references/workflow-full.md +60 -0
  259. package/templates/repo/.github/skills/bootstrap/references/workflow-parallel.md +59 -0
  260. package/templates/repo/.github/skills/brainstorm/SKILL.md +63 -15
  261. package/templates/repo/.github/skills/code-review/SKILL.md +138 -135
  262. package/templates/repo/.github/skills/code-review/references/adversarial-review.md +223 -0
  263. package/templates/repo/.github/skills/code-review/references/checklist-workflow.md +100 -0
  264. package/templates/repo/.github/skills/code-review/references/checklists/api.md +52 -0
  265. package/templates/repo/.github/skills/code-review/references/checklists/base.md +100 -0
  266. package/templates/repo/.github/skills/code-review/references/checklists/web-app.md +54 -0
  267. package/templates/repo/.github/skills/code-review/references/code-review-reception.md +48 -144
  268. package/templates/repo/.github/skills/code-review/references/codebase-scan-workflow.md +30 -0
  269. package/templates/repo/.github/skills/code-review/references/edge-case-scouting.md +119 -0
  270. package/templates/repo/.github/skills/code-review/references/input-mode-resolution.md +135 -0
  271. package/templates/repo/.github/skills/code-review/references/parallel-review-workflow.md +76 -0
  272. package/templates/repo/.github/skills/code-review/references/requesting-code-review.md +19 -8
  273. package/templates/repo/.github/skills/code-review/references/spec-compliance-review.md +43 -0
  274. package/templates/repo/.github/skills/code-review/references/task-management-reviews.md +155 -0
  275. package/templates/repo/.github/skills/common/README.md +2 -12
  276. package/templates/repo/.github/skills/common/api_key_helper.py +7 -37
  277. package/templates/repo/.github/skills/context-engineering/SKILL.md +4 -3
  278. package/templates/repo/.github/skills/context-engineering/references/context-degradation.md +2 -2
  279. package/templates/repo/.github/skills/context-engineering/references/runtime-awareness.md +5 -47
  280. package/templates/repo/.github/skills/cook/README.md +13 -13
  281. package/templates/repo/.github/skills/cook/SKILL.md +86 -58
  282. package/templates/repo/.github/skills/cook/references/intent-detection.md +7 -7
  283. package/templates/repo/.github/skills/cook/references/review-cycle.md +2 -2
  284. package/templates/repo/.github/skills/cook/references/subagent-patterns.md +75 -0
  285. package/templates/repo/.github/skills/cook/references/workflow-steps.md +75 -23
  286. package/templates/repo/.github/skills/databases/SKILL.md +3 -30
  287. package/templates/repo/.github/skills/databases/db-design.md +1 -1
  288. package/templates/repo/.github/skills/debug/SKILL.md +47 -105
  289. package/templates/repo/.github/skills/debug/references/frontend-verification.md +103 -0
  290. package/templates/repo/.github/skills/debug/references/investigation-methodology.md +101 -0
  291. package/templates/repo/.github/skills/debug/references/log-and-ci-analysis.md +97 -0
  292. package/templates/repo/.github/skills/debug/references/performance-diagnostics.md +113 -0
  293. package/templates/repo/.github/skills/debug/references/reporting-standards.md +122 -0
  294. package/templates/repo/.github/skills/debug/references/task-management-debugging.md +155 -0
  295. package/templates/repo/.github/skills/deploy/SKILL.md +154 -0
  296. package/templates/repo/.github/skills/deploy/references/platform-config-templates.md +35 -0
  297. package/templates/repo/.github/skills/deploy/references/platforms/aws.md +58 -0
  298. package/templates/repo/.github/skills/deploy/references/platforms/cloudflare.md +41 -0
  299. package/templates/repo/.github/skills/deploy/references/platforms/coolify.md +32 -0
  300. package/templates/repo/.github/skills/deploy/references/platforms/digitalocean.md +45 -0
  301. package/templates/repo/.github/skills/deploy/references/platforms/dokploy.md +29 -0
  302. package/templates/repo/.github/skills/deploy/references/platforms/flyio.md +54 -0
  303. package/templates/repo/.github/skills/deploy/references/platforms/gcp.md +45 -0
  304. package/templates/repo/.github/skills/deploy/references/platforms/github-pages.md +56 -0
  305. package/templates/repo/.github/skills/deploy/references/platforms/heroku.md +31 -0
  306. package/templates/repo/.github/skills/deploy/references/platforms/netlify.md +39 -0
  307. package/templates/repo/.github/skills/deploy/references/platforms/railway.md +38 -0
  308. package/templates/repo/.github/skills/deploy/references/platforms/render.md +39 -0
  309. package/templates/repo/.github/skills/deploy/references/platforms/tose.md +35 -0
  310. package/templates/repo/.github/skills/deploy/references/platforms/vercel.md +37 -0
  311. package/templates/repo/.github/skills/deploy/references/platforms/vultr.md +27 -0
  312. package/templates/repo/.github/skills/devops/SKILL.md +6 -12
  313. package/templates/repo/.github/skills/docs-seeker/SKILL.md +2 -1
  314. package/templates/repo/.github/skills/docs-seeker/references/context7-patterns.md +4 -0
  315. package/templates/repo/.github/skills/docs-seeker/scripts/fetch-docs.js +1 -2
  316. package/templates/repo/.github/skills/docs-seeker/scripts/utils/env-loader.js +4 -4
  317. package/templates/repo/.github/skills/docs-seeker/workflows/library-search.md +1 -0
  318. package/templates/repo/.github/skills/fix/SKILL.md +141 -44
  319. package/templates/repo/.github/skills/fix/references/complexity-assessment.md +21 -9
  320. package/templates/repo/.github/skills/fix/references/diagnosis-protocol.md +133 -0
  321. package/templates/repo/.github/skills/fix/references/mode-selection.md +27 -11
  322. package/templates/repo/.github/skills/fix/references/parallel-exploration.md +35 -12
  323. package/templates/repo/.github/skills/fix/references/prevention-gate.md +87 -0
  324. package/templates/repo/.github/skills/fix/references/review-cycle.md +3 -3
  325. package/templates/repo/.github/skills/fix/references/skill-activation-matrix.md +64 -31
  326. package/templates/repo/.github/skills/fix/references/task-orchestration.md +110 -0
  327. package/templates/repo/.github/skills/fix/references/workflow-deep.md +110 -47
  328. package/templates/repo/.github/skills/fix/references/workflow-logs.md +46 -10
  329. package/templates/repo/.github/skills/fix/references/workflow-quick.md +43 -20
  330. package/templates/repo/.github/skills/fix/references/workflow-standard.md +75 -41
  331. package/templates/repo/.github/skills/fix/references/workflow-test.md +49 -10
  332. package/templates/repo/.github/skills/fix/references/workflow-ui.md +56 -18
  333. package/templates/repo/.github/skills/frontend-design/SKILL.md +49 -17
  334. package/templates/repo/.github/skills/frontend-design/references/ai-multimodal-overview.md +165 -0
  335. package/templates/repo/.github/skills/frontend-design/references/anti-slop-rules.md +103 -0
  336. package/templates/repo/.github/skills/frontend-design/references/asset-generation.md +284 -108
  337. package/templates/repo/.github/skills/frontend-design/references/bento-motion-engine.md +142 -0
  338. package/templates/repo/.github/skills/frontend-design/references/magicui-components.md +129 -0
  339. package/templates/repo/.github/skills/frontend-design/references/performance-guardrails.md +169 -0
  340. package/templates/repo/.github/skills/frontend-design/references/premium-design-patterns.md +93 -0
  341. package/templates/repo/.github/skills/frontend-design/references/redesign-audit-checklist.md +114 -0
  342. package/templates/repo/.github/skills/frontend-design/references/visual-analysis-overview.md +1 -1
  343. package/templates/repo/.github/skills/frontend-design/references/workflow-3d.md +98 -0
  344. package/templates/repo/.github/skills/frontend-design/references/workflow-describe.md +4 -3
  345. package/templates/repo/.github/skills/frontend-design/references/workflow-immersive.md +82 -0
  346. package/templates/repo/.github/skills/frontend-design/references/workflow-quick.md +10 -12
  347. package/templates/repo/.github/skills/frontend-design/references/workflow-screenshot.md +9 -8
  348. package/templates/repo/.github/skills/frontend-design/references/workflow-video.md +74 -0
  349. package/templates/repo/.github/skills/frontend-development/SKILL.md +400 -0
  350. package/templates/repo/.github/skills/frontend-development/resources/common-patterns.md +331 -0
  351. package/templates/repo/.github/skills/frontend-development/resources/complete-examples.md +872 -0
  352. package/templates/repo/.github/skills/frontend-development/resources/component-patterns.md +502 -0
  353. package/templates/repo/.github/skills/frontend-development/resources/data-fetching.md +767 -0
  354. package/templates/repo/.github/skills/frontend-development/resources/file-organization.md +502 -0
  355. package/templates/repo/.github/skills/frontend-development/resources/loading-and-error-states.md +501 -0
  356. package/templates/repo/.github/skills/frontend-development/resources/performance.md +406 -0
  357. package/templates/repo/.github/skills/frontend-development/resources/routing-guide.md +364 -0
  358. package/templates/repo/.github/skills/frontend-development/resources/styling-guide.md +428 -0
  359. package/templates/repo/.github/skills/frontend-development/resources/typescript-standards.md +418 -0
  360. package/templates/repo/.github/skills/git/SKILL.md +18 -4
  361. package/templates/repo/.github/skills/git/references/commit-standards.md +3 -3
  362. package/templates/repo/.github/skills/git/references/workflow-commit.md +3 -3
  363. package/templates/repo/.github/skills/git/references/workflow-merge.md +1 -1
  364. package/templates/repo/.github/skills/git/references/workflow-pr.md +1 -1
  365. package/templates/repo/.github/skills/git/references/workflow-push.md +1 -1
  366. package/templates/repo/.github/skills/mcp-management/README.md +18 -18
  367. package/templates/repo/.github/skills/mcp-management/SKILL.md +16 -15
  368. package/templates/repo/.github/skills/mcp-management/references/configuration.md +4 -4
  369. package/templates/repo/.github/skills/mcp-management/references/gemini-cli-integration.md +12 -12
  370. package/templates/repo/.github/skills/mcp-management/scripts/.env.example +2 -2
  371. package/templates/repo/.github/skills/mcp-management/scripts/mcp-client.ts +1 -1
  372. package/templates/repo/.github/skills/mermaidjs-v11/SKILL.md +1 -0
  373. package/templates/repo/.github/skills/planning/SKILL.md +122 -91
  374. package/templates/repo/.github/skills/planning/references/archive-workflow.md +53 -0
  375. package/templates/repo/.github/skills/planning/references/codebase-understanding.md +1 -1
  376. package/templates/repo/.github/skills/planning/references/output-standards.md +17 -13
  377. package/templates/repo/.github/skills/planning/references/plan-organization.md +52 -30
  378. package/templates/repo/.github/skills/planning/references/red-team-personas.md +69 -0
  379. package/templates/repo/.github/skills/planning/references/red-team-workflow.md +77 -0
  380. package/templates/repo/.github/skills/planning/references/scope-challenge.md +90 -0
  381. package/templates/repo/.github/skills/planning/references/task-management.md +134 -0
  382. package/templates/repo/.github/skills/planning/references/validate-question-framework.md +80 -0
  383. package/templates/repo/.github/skills/planning/references/validate-workflow.md +65 -0
  384. package/templates/repo/.github/skills/planning/references/workflow-modes.md +154 -0
  385. package/templates/repo/.github/skills/problem-solving/SKILL.md +1 -0
  386. package/templates/repo/.github/skills/project-management/SKILL.md +133 -0
  387. package/templates/repo/.github/skills/project-management/references/documentation-triggers.md +60 -0
  388. package/templates/repo/.github/skills/project-management/references/hydration-workflow.md +89 -0
  389. package/templates/repo/.github/skills/project-management/references/progress-tracking.md +120 -0
  390. package/templates/repo/.github/skills/project-management/references/reporting-patterns.md +94 -0
  391. package/templates/repo/.github/skills/project-management/references/task-operations.md +87 -0
  392. package/templates/repo/.github/skills/repomix/SKILL.md +3 -2
  393. package/templates/repo/.github/skills/repomix/references/usage-patterns.md +2 -2
  394. package/templates/repo/.github/skills/repomix/scripts/README.md +1 -1
  395. package/templates/repo/.github/skills/repomix/scripts/repomix_batch.py +2 -2
  396. package/templates/repo/.github/skills/research/SKILL.md +7 -4
  397. package/templates/repo/.github/skills/scout/SKILL.md +24 -24
  398. package/templates/repo/.github/skills/scout/references/external-scouting.md +17 -17
  399. package/templates/repo/.github/skills/scout/references/internal-scouting.md +9 -9
  400. package/templates/repo/.github/skills/scout/references/task-management-scouting.md +125 -0
  401. package/templates/repo/.github/skills/security/SKILL.md +139 -0
  402. package/templates/repo/.github/skills/security/references/stride-owasp-checklist.md +128 -0
  403. package/templates/repo/.github/skills/sequential-thinking/README.md +3 -3
  404. package/templates/repo/.github/skills/sequential-thinking/SKILL.md +2 -0
  405. package/templates/repo/.github/skills/sequential-thinking/package-lock.json +3652 -0
  406. package/templates/repo/.github/skills/sequential-thinking/package.json +1 -1
  407. package/templates/repo/.github/skills/ship/SKILL.md +116 -0
  408. package/templates/repo/.github/skills/ship/references/auto-detect.md +103 -0
  409. package/templates/repo/.github/skills/ship/references/pr-template.md +90 -0
  410. package/templates/repo/.github/skills/ship/references/ship-workflow.md +241 -0
  411. package/templates/repo/.github/skills/test/SKILL.md +111 -0
  412. package/templates/repo/.github/skills/test/references/report-format.md +58 -0
  413. package/templates/repo/.github/skills/test/references/test-execution-workflow.md +103 -0
  414. package/templates/repo/.github/skills/test/references/ui-testing-workflow.md +65 -0
  415. package/templates/repo/.github/skills/ui-styling/SKILL.md +2 -0
  416. package/templates/repo/.github/skills/web-testing/SKILL.md +8 -60
  417. package/docs/guide-next-steps-speckit-cokit-implementation.md +0 -187
  418. package/prompts/ck-spec-analyze.prompt.md +0 -201
  419. package/prompts/ck-spec-checklist.prompt.md +0 -308
  420. package/prompts/ck-spec-clarify.prompt.md +0 -190
  421. package/prompts/ck-spec-constitution.prompt.md +0 -92
  422. package/prompts/ck-spec-implement.prompt.md +0 -157
  423. package/prompts/ck-spec-plan.prompt.md +0 -95
  424. package/prompts/ck-spec-specify.prompt.md +0 -261
  425. package/prompts/ck-spec-tasks.prompt.md +0 -181
  426. package/templates/repo/.github/AGENTS.md +0 -103
  427. package/templates/repo/.github/prompts/ck-spec-analyze.prompt.md +0 -201
  428. package/templates/repo/.github/prompts/ck-spec-checklist.prompt.md +0 -308
  429. package/templates/repo/.github/prompts/ck-spec-clarify.prompt.md +0 -190
  430. package/templates/repo/.github/prompts/ck-spec-constitution.prompt.md +0 -92
  431. package/templates/repo/.github/prompts/ck-spec-implement.prompt.md +0 -157
  432. package/templates/repo/.github/prompts/ck-spec-plan.prompt.md +0 -95
  433. package/templates/repo/.github/prompts/ck-spec-specify.prompt.md +0 -261
  434. package/templates/repo/.github/prompts/ck-spec-tasks.prompt.md +0 -181
  435. package/templates/repo/.github/skills/databases/stacks/bigquery.md +0 -231
  436. package/templates/repo/.github/skills/databases/stacks/d1_cloudflare.md +0 -137
  437. package/templates/repo/.github/skills/databases/stacks/mysql.md +0 -216
  438. package/templates/repo/.github/skills/databases/stacks/postgres.md +0 -235
  439. package/templates/repo/.github/skills/databases/stacks/sqlite.md +0 -244
  440. package/templates/repo/.github/skills/mcp-management/assets/tools.json +0 -3146
  441. package/templates/repo/.github/skills/mcp-management/scripts/dist/analyze-tools.js +0 -70
  442. package/templates/repo/.github/skills/mcp-management/scripts/dist/cli.js +0 -160
  443. package/templates/repo/.github/skills/mcp-management/scripts/dist/mcp-client.js +0 -183
  444. package/templates/repo/.github/skills/ui-styling/LICENSE.txt +0 -202
  445. package/templates/repo/.github/spec-kit/memory/constitution.md +0 -50
  446. package/templates/repo/.github/spec-kit/scripts/bash/check-prerequisites.sh +0 -166
  447. package/templates/repo/.github/spec-kit/scripts/bash/common.sh +0 -156
  448. package/templates/repo/.github/spec-kit/scripts/bash/create-new-feature.sh +0 -297
  449. package/templates/repo/.github/spec-kit/scripts/bash/setup-plan.sh +0 -61
  450. package/templates/repo/.github/spec-kit/scripts/bash/update-agent-context.sh +0 -799
  451. package/templates/repo/.github/spec-kit/scripts/powershell/check-prerequisites.ps1 +0 -148
  452. package/templates/repo/.github/spec-kit/scripts/powershell/common.ps1 +0 -137
  453. package/templates/repo/.github/spec-kit/scripts/powershell/create-new-feature.ps1 +0 -283
  454. package/templates/repo/.github/spec-kit/scripts/powershell/setup-plan.ps1 +0 -61
  455. package/templates/repo/.github/spec-kit/scripts/powershell/update-agent-context.ps1 +0 -448
  456. package/templates/repo/.github/spec-kit/templates/agent-file-template.md +0 -28
  457. package/templates/repo/.github/spec-kit/templates/checklist-template.md +0 -40
  458. package/templates/repo/.github/spec-kit/templates/commands/analyze.md +0 -187
  459. package/templates/repo/.github/spec-kit/templates/commands/checklist.md +0 -297
  460. package/templates/repo/.github/spec-kit/templates/commands/clarify.md +0 -184
  461. package/templates/repo/.github/spec-kit/templates/commands/constitution.md +0 -82
  462. package/templates/repo/.github/spec-kit/templates/commands/implement.md +0 -138
  463. package/templates/repo/.github/spec-kit/templates/commands/plan.md +0 -95
  464. package/templates/repo/.github/spec-kit/templates/commands/specify.md +0 -261
  465. package/templates/repo/.github/spec-kit/templates/commands/tasks.md +0 -140
  466. package/templates/repo/.github/spec-kit/templates/commands/taskstoissues.md +0 -33
  467. package/templates/repo/.github/spec-kit/templates/plan-template.md +0 -104
  468. package/templates/repo/.github/spec-kit/templates/spec-template.md +0 -115
  469. package/templates/repo/.github/spec-kit/templates/tasks-phase-template.md +0 -42
  470. package/templates/repo/.github/spec-kit/templates/tasks-template.md +0 -268
  471. package/templates/repo/.github/spec-kit/templates/vscode-settings.json +0 -14
@@ -1,448 +0,0 @@
1
- #!/usr/bin/env pwsh
2
- <#!
3
- .SYNOPSIS
4
- Update agent context files with information from plan.md (PowerShell version)
5
-
6
- .DESCRIPTION
7
- Mirrors the behavior of scripts/bash/update-agent-context.sh:
8
- 1. Environment Validation
9
- 2. Plan Data Extraction
10
- 3. Agent File Management (create from template or update existing)
11
- 4. Content Generation (technology stack, recent changes, timestamp)
12
- 5. Multi-Agent Support (claude, gemini, copilot, cursor-agent, qwen, opencode, codex, windsurf, kilocode, auggie, roo, codebuddy, amp, shai, q, bob, qoder)
13
-
14
- .PARAMETER AgentType
15
- Optional agent key to update a single agent. If omitted, updates all existing agent files (creating a default Claude file if none exist).
16
-
17
- .EXAMPLE
18
- ./update-agent-context.ps1 -AgentType claude
19
-
20
- .EXAMPLE
21
- ./update-agent-context.ps1 # Updates all existing agent files
22
-
23
- .NOTES
24
- Relies on common helper functions in common.ps1
25
- #>
26
- param(
27
- [Parameter(Position=0)]
28
- [ValidateSet('claude','gemini','copilot','cursor-agent','qwen','opencode','codex','windsurf','kilocode','auggie','roo','codebuddy','amp','shai','q','bob','qoder')]
29
- [string]$AgentType
30
- )
31
-
32
- $ErrorActionPreference = 'Stop'
33
-
34
- # Import common helpers
35
- $ScriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
36
- . (Join-Path $ScriptDir 'common.ps1')
37
-
38
- # Acquire environment paths
39
- $envData = Get-FeaturePathsEnv
40
- $REPO_ROOT = $envData.REPO_ROOT
41
- $CURRENT_BRANCH = $envData.CURRENT_BRANCH
42
- $HAS_GIT = $envData.HAS_GIT
43
- $IMPL_PLAN = $envData.IMPL_PLAN
44
- $NEW_PLAN = $IMPL_PLAN
45
-
46
- # Agent file paths
47
- $CLAUDE_FILE = Join-Path $REPO_ROOT 'CLAUDE.md'
48
- $GEMINI_FILE = Join-Path $REPO_ROOT 'GEMINI.md'
49
- $COPILOT_FILE = Join-Path $REPO_ROOT '.github/agents/copilot-instructions.md'
50
- $CURSOR_FILE = Join-Path $REPO_ROOT '.cursor/rules/specify-rules.mdc'
51
- $QWEN_FILE = Join-Path $REPO_ROOT 'QWEN.md'
52
- $AGENTS_FILE = Join-Path $REPO_ROOT 'AGENTS.md'
53
- $WINDSURF_FILE = Join-Path $REPO_ROOT '.windsurf/rules/specify-rules.md'
54
- $KILOCODE_FILE = Join-Path $REPO_ROOT '.kilocode/rules/specify-rules.md'
55
- $AUGGIE_FILE = Join-Path $REPO_ROOT '.augment/rules/specify-rules.md'
56
- $ROO_FILE = Join-Path $REPO_ROOT '.roo/rules/specify-rules.md'
57
- $CODEBUDDY_FILE = Join-Path $REPO_ROOT 'CODEBUDDY.md'
58
- $QODER_FILE = Join-Path $REPO_ROOT 'QODER.md'
59
- $AMP_FILE = Join-Path $REPO_ROOT 'AGENTS.md'
60
- $SHAI_FILE = Join-Path $REPO_ROOT 'SHAI.md'
61
- $Q_FILE = Join-Path $REPO_ROOT 'AGENTS.md'
62
- $BOB_FILE = Join-Path $REPO_ROOT 'AGENTS.md'
63
-
64
- $TEMPLATE_FILE = Join-Path $REPO_ROOT '.specify/templates/agent-file-template.md'
65
-
66
- # Parsed plan data placeholders
67
- $script:NEW_LANG = ''
68
- $script:NEW_FRAMEWORK = ''
69
- $script:NEW_DB = ''
70
- $script:NEW_PROJECT_TYPE = ''
71
-
72
- function Write-Info {
73
- param(
74
- [Parameter(Mandatory=$true)]
75
- [string]$Message
76
- )
77
- Write-Host "INFO: $Message"
78
- }
79
-
80
- function Write-Success {
81
- param(
82
- [Parameter(Mandatory=$true)]
83
- [string]$Message
84
- )
85
- Write-Host "$([char]0x2713) $Message"
86
- }
87
-
88
- function Write-WarningMsg {
89
- param(
90
- [Parameter(Mandatory=$true)]
91
- [string]$Message
92
- )
93
- Write-Warning $Message
94
- }
95
-
96
- function Write-Err {
97
- param(
98
- [Parameter(Mandatory=$true)]
99
- [string]$Message
100
- )
101
- Write-Host "ERROR: $Message" -ForegroundColor Red
102
- }
103
-
104
- function Validate-Environment {
105
- if (-not $CURRENT_BRANCH) {
106
- Write-Err 'Unable to determine current feature'
107
- if ($HAS_GIT) { Write-Info "Make sure you're on a feature branch" } else { Write-Info 'Set SPECIFY_FEATURE environment variable or create a feature first' }
108
- exit 1
109
- }
110
- if (-not (Test-Path $NEW_PLAN)) {
111
- Write-Err "No plan.md found at $NEW_PLAN"
112
- Write-Info 'Ensure you are working on a feature with a corresponding spec directory'
113
- if (-not $HAS_GIT) { Write-Info 'Use: $env:SPECIFY_FEATURE=your-feature-name or create a new feature first' }
114
- exit 1
115
- }
116
- if (-not (Test-Path $TEMPLATE_FILE)) {
117
- Write-Err "Template file not found at $TEMPLATE_FILE"
118
- Write-Info 'Run specify init to scaffold .specify/templates, or add agent-file-template.md there.'
119
- exit 1
120
- }
121
- }
122
-
123
- function Extract-PlanField {
124
- param(
125
- [Parameter(Mandatory=$true)]
126
- [string]$FieldPattern,
127
- [Parameter(Mandatory=$true)]
128
- [string]$PlanFile
129
- )
130
- if (-not (Test-Path $PlanFile)) { return '' }
131
- # Lines like **Language/Version**: Python 3.12
132
- $regex = "^\*\*$([Regex]::Escape($FieldPattern))\*\*: (.+)$"
133
- Get-Content -LiteralPath $PlanFile -Encoding utf8 | ForEach-Object {
134
- if ($_ -match $regex) {
135
- $val = $Matches[1].Trim()
136
- if ($val -notin @('NEEDS CLARIFICATION','N/A')) { return $val }
137
- }
138
- } | Select-Object -First 1
139
- }
140
-
141
- function Parse-PlanData {
142
- param(
143
- [Parameter(Mandatory=$true)]
144
- [string]$PlanFile
145
- )
146
- if (-not (Test-Path $PlanFile)) { Write-Err "Plan file not found: $PlanFile"; return $false }
147
- Write-Info "Parsing plan data from $PlanFile"
148
- $script:NEW_LANG = Extract-PlanField -FieldPattern 'Language/Version' -PlanFile $PlanFile
149
- $script:NEW_FRAMEWORK = Extract-PlanField -FieldPattern 'Primary Dependencies' -PlanFile $PlanFile
150
- $script:NEW_DB = Extract-PlanField -FieldPattern 'Storage' -PlanFile $PlanFile
151
- $script:NEW_PROJECT_TYPE = Extract-PlanField -FieldPattern 'Project Type' -PlanFile $PlanFile
152
-
153
- if ($NEW_LANG) { Write-Info "Found language: $NEW_LANG" } else { Write-WarningMsg 'No language information found in plan' }
154
- if ($NEW_FRAMEWORK) { Write-Info "Found framework: $NEW_FRAMEWORK" }
155
- if ($NEW_DB -and $NEW_DB -ne 'N/A') { Write-Info "Found database: $NEW_DB" }
156
- if ($NEW_PROJECT_TYPE) { Write-Info "Found project type: $NEW_PROJECT_TYPE" }
157
- return $true
158
- }
159
-
160
- function Format-TechnologyStack {
161
- param(
162
- [Parameter(Mandatory=$false)]
163
- [string]$Lang,
164
- [Parameter(Mandatory=$false)]
165
- [string]$Framework
166
- )
167
- $parts = @()
168
- if ($Lang -and $Lang -ne 'NEEDS CLARIFICATION') { $parts += $Lang }
169
- if ($Framework -and $Framework -notin @('NEEDS CLARIFICATION','N/A')) { $parts += $Framework }
170
- if (-not $parts) { return '' }
171
- return ($parts -join ' + ')
172
- }
173
-
174
- function Get-ProjectStructure {
175
- param(
176
- [Parameter(Mandatory=$false)]
177
- [string]$ProjectType
178
- )
179
- if ($ProjectType -match 'web') { return "backend/`nfrontend/`ntests/" } else { return "src/`ntests/" }
180
- }
181
-
182
- function Get-CommandsForLanguage {
183
- param(
184
- [Parameter(Mandatory=$false)]
185
- [string]$Lang
186
- )
187
- switch -Regex ($Lang) {
188
- 'Python' { return "cd src; pytest; ruff check ." }
189
- 'Rust' { return "cargo test; cargo clippy" }
190
- 'JavaScript|TypeScript' { return "npm test; npm run lint" }
191
- default { return "# Add commands for $Lang" }
192
- }
193
- }
194
-
195
- function Get-LanguageConventions {
196
- param(
197
- [Parameter(Mandatory=$false)]
198
- [string]$Lang
199
- )
200
- if ($Lang) { "${Lang}: Follow standard conventions" } else { 'General: Follow standard conventions' }
201
- }
202
-
203
- function New-AgentFile {
204
- param(
205
- [Parameter(Mandatory=$true)]
206
- [string]$TargetFile,
207
- [Parameter(Mandatory=$true)]
208
- [string]$ProjectName,
209
- [Parameter(Mandatory=$true)]
210
- [datetime]$Date
211
- )
212
- if (-not (Test-Path $TEMPLATE_FILE)) { Write-Err "Template not found at $TEMPLATE_FILE"; return $false }
213
- $temp = New-TemporaryFile
214
- Copy-Item -LiteralPath $TEMPLATE_FILE -Destination $temp -Force
215
-
216
- $projectStructure = Get-ProjectStructure -ProjectType $NEW_PROJECT_TYPE
217
- $commands = Get-CommandsForLanguage -Lang $NEW_LANG
218
- $languageConventions = Get-LanguageConventions -Lang $NEW_LANG
219
-
220
- $escaped_lang = $NEW_LANG
221
- $escaped_framework = $NEW_FRAMEWORK
222
- $escaped_branch = $CURRENT_BRANCH
223
-
224
- $content = Get-Content -LiteralPath $temp -Raw -Encoding utf8
225
- $content = $content -replace '\[PROJECT NAME\]',$ProjectName
226
- $content = $content -replace '\[DATE\]',$Date.ToString('yyyy-MM-dd')
227
-
228
- # Build the technology stack string safely
229
- $techStackForTemplate = ""
230
- if ($escaped_lang -and $escaped_framework) {
231
- $techStackForTemplate = "- $escaped_lang + $escaped_framework ($escaped_branch)"
232
- } elseif ($escaped_lang) {
233
- $techStackForTemplate = "- $escaped_lang ($escaped_branch)"
234
- } elseif ($escaped_framework) {
235
- $techStackForTemplate = "- $escaped_framework ($escaped_branch)"
236
- }
237
-
238
- $content = $content -replace '\[EXTRACTED FROM ALL PLAN.MD FILES\]',$techStackForTemplate
239
- # For project structure we manually embed (keep newlines)
240
- $escapedStructure = [Regex]::Escape($projectStructure)
241
- $content = $content -replace '\[ACTUAL STRUCTURE FROM PLANS\]',$escapedStructure
242
- # Replace escaped newlines placeholder after all replacements
243
- $content = $content -replace '\[ONLY COMMANDS FOR ACTIVE TECHNOLOGIES\]',$commands
244
- $content = $content -replace '\[LANGUAGE-SPECIFIC, ONLY FOR LANGUAGES IN USE\]',$languageConventions
245
-
246
- # Build the recent changes string safely
247
- $recentChangesForTemplate = ""
248
- if ($escaped_lang -and $escaped_framework) {
249
- $recentChangesForTemplate = "- ${escaped_branch}: Added ${escaped_lang} + ${escaped_framework}"
250
- } elseif ($escaped_lang) {
251
- $recentChangesForTemplate = "- ${escaped_branch}: Added ${escaped_lang}"
252
- } elseif ($escaped_framework) {
253
- $recentChangesForTemplate = "- ${escaped_branch}: Added ${escaped_framework}"
254
- }
255
-
256
- $content = $content -replace '\[LAST 3 FEATURES AND WHAT THEY ADDED\]',$recentChangesForTemplate
257
- # Convert literal \n sequences introduced by Escape to real newlines
258
- $content = $content -replace '\\n',[Environment]::NewLine
259
-
260
- $parent = Split-Path -Parent $TargetFile
261
- if (-not (Test-Path $parent)) { New-Item -ItemType Directory -Path $parent | Out-Null }
262
- Set-Content -LiteralPath $TargetFile -Value $content -NoNewline -Encoding utf8
263
- Remove-Item $temp -Force
264
- return $true
265
- }
266
-
267
- function Update-ExistingAgentFile {
268
- param(
269
- [Parameter(Mandatory=$true)]
270
- [string]$TargetFile,
271
- [Parameter(Mandatory=$true)]
272
- [datetime]$Date
273
- )
274
- if (-not (Test-Path $TargetFile)) { return (New-AgentFile -TargetFile $TargetFile -ProjectName (Split-Path $REPO_ROOT -Leaf) -Date $Date) }
275
-
276
- $techStack = Format-TechnologyStack -Lang $NEW_LANG -Framework $NEW_FRAMEWORK
277
- $newTechEntries = @()
278
- if ($techStack) {
279
- $escapedTechStack = [Regex]::Escape($techStack)
280
- if (-not (Select-String -Pattern $escapedTechStack -Path $TargetFile -Quiet)) {
281
- $newTechEntries += "- $techStack ($CURRENT_BRANCH)"
282
- }
283
- }
284
- if ($NEW_DB -and $NEW_DB -notin @('N/A','NEEDS CLARIFICATION')) {
285
- $escapedDB = [Regex]::Escape($NEW_DB)
286
- if (-not (Select-String -Pattern $escapedDB -Path $TargetFile -Quiet)) {
287
- $newTechEntries += "- $NEW_DB ($CURRENT_BRANCH)"
288
- }
289
- }
290
- $newChangeEntry = ''
291
- if ($techStack) { $newChangeEntry = "- ${CURRENT_BRANCH}: Added ${techStack}" }
292
- elseif ($NEW_DB -and $NEW_DB -notin @('N/A','NEEDS CLARIFICATION')) { $newChangeEntry = "- ${CURRENT_BRANCH}: Added ${NEW_DB}" }
293
-
294
- $lines = Get-Content -LiteralPath $TargetFile -Encoding utf8
295
- $output = New-Object System.Collections.Generic.List[string]
296
- $inTech = $false; $inChanges = $false; $techAdded = $false; $changeAdded = $false; $existingChanges = 0
297
-
298
- for ($i=0; $i -lt $lines.Count; $i++) {
299
- $line = $lines[$i]
300
- if ($line -eq '## Active Technologies') {
301
- $output.Add($line)
302
- $inTech = $true
303
- continue
304
- }
305
- if ($inTech -and $line -match '^##\s') {
306
- if (-not $techAdded -and $newTechEntries.Count -gt 0) { $newTechEntries | ForEach-Object { $output.Add($_) }; $techAdded = $true }
307
- $output.Add($line); $inTech = $false; continue
308
- }
309
- if ($inTech -and [string]::IsNullOrWhiteSpace($line)) {
310
- if (-not $techAdded -and $newTechEntries.Count -gt 0) { $newTechEntries | ForEach-Object { $output.Add($_) }; $techAdded = $true }
311
- $output.Add($line); continue
312
- }
313
- if ($line -eq '## Recent Changes') {
314
- $output.Add($line)
315
- if ($newChangeEntry) { $output.Add($newChangeEntry); $changeAdded = $true }
316
- $inChanges = $true
317
- continue
318
- }
319
- if ($inChanges -and $line -match '^##\s') { $output.Add($line); $inChanges = $false; continue }
320
- if ($inChanges -and $line -match '^- ') {
321
- if ($existingChanges -lt 2) { $output.Add($line); $existingChanges++ }
322
- continue
323
- }
324
- if ($line -match '\*\*Last updated\*\*: .*\d{4}-\d{2}-\d{2}') {
325
- $output.Add(($line -replace '\d{4}-\d{2}-\d{2}',$Date.ToString('yyyy-MM-dd')))
326
- continue
327
- }
328
- $output.Add($line)
329
- }
330
-
331
- # Post-loop check: if we're still in the Active Technologies section and haven't added new entries
332
- if ($inTech -and -not $techAdded -and $newTechEntries.Count -gt 0) {
333
- $newTechEntries | ForEach-Object { $output.Add($_) }
334
- }
335
-
336
- Set-Content -LiteralPath $TargetFile -Value ($output -join [Environment]::NewLine) -Encoding utf8
337
- return $true
338
- }
339
-
340
- function Update-AgentFile {
341
- param(
342
- [Parameter(Mandatory=$true)]
343
- [string]$TargetFile,
344
- [Parameter(Mandatory=$true)]
345
- [string]$AgentName
346
- )
347
- if (-not $TargetFile -or -not $AgentName) { Write-Err 'Update-AgentFile requires TargetFile and AgentName'; return $false }
348
- Write-Info "Updating $AgentName context file: $TargetFile"
349
- $projectName = Split-Path $REPO_ROOT -Leaf
350
- $date = Get-Date
351
-
352
- $dir = Split-Path -Parent $TargetFile
353
- if (-not (Test-Path $dir)) { New-Item -ItemType Directory -Path $dir | Out-Null }
354
-
355
- if (-not (Test-Path $TargetFile)) {
356
- if (New-AgentFile -TargetFile $TargetFile -ProjectName $projectName -Date $date) { Write-Success "Created new $AgentName context file" } else { Write-Err 'Failed to create new agent file'; return $false }
357
- } else {
358
- try {
359
- if (Update-ExistingAgentFile -TargetFile $TargetFile -Date $date) { Write-Success "Updated existing $AgentName context file" } else { Write-Err 'Failed to update agent file'; return $false }
360
- } catch {
361
- Write-Err "Cannot access or update existing file: $TargetFile. $_"
362
- return $false
363
- }
364
- }
365
- return $true
366
- }
367
-
368
- function Update-SpecificAgent {
369
- param(
370
- [Parameter(Mandatory=$true)]
371
- [string]$Type
372
- )
373
- switch ($Type) {
374
- 'claude' { Update-AgentFile -TargetFile $CLAUDE_FILE -AgentName 'Claude Code' }
375
- 'gemini' { Update-AgentFile -TargetFile $GEMINI_FILE -AgentName 'Gemini CLI' }
376
- 'copilot' { Update-AgentFile -TargetFile $COPILOT_FILE -AgentName 'GitHub Copilot' }
377
- 'cursor-agent' { Update-AgentFile -TargetFile $CURSOR_FILE -AgentName 'Cursor IDE' }
378
- 'qwen' { Update-AgentFile -TargetFile $QWEN_FILE -AgentName 'Qwen Code' }
379
- 'opencode' { Update-AgentFile -TargetFile $AGENTS_FILE -AgentName 'opencode' }
380
- 'codex' { Update-AgentFile -TargetFile $AGENTS_FILE -AgentName 'Codex CLI' }
381
- 'windsurf' { Update-AgentFile -TargetFile $WINDSURF_FILE -AgentName 'Windsurf' }
382
- 'kilocode' { Update-AgentFile -TargetFile $KILOCODE_FILE -AgentName 'Kilo Code' }
383
- 'auggie' { Update-AgentFile -TargetFile $AUGGIE_FILE -AgentName 'Auggie CLI' }
384
- 'roo' { Update-AgentFile -TargetFile $ROO_FILE -AgentName 'Roo Code' }
385
- 'codebuddy' { Update-AgentFile -TargetFile $CODEBUDDY_FILE -AgentName 'CodeBuddy CLI' }
386
- 'qoder' { Update-AgentFile -TargetFile $QODER_FILE -AgentName 'Qoder CLI' }
387
- 'amp' { Update-AgentFile -TargetFile $AMP_FILE -AgentName 'Amp' }
388
- 'shai' { Update-AgentFile -TargetFile $SHAI_FILE -AgentName 'SHAI' }
389
- 'q' { Update-AgentFile -TargetFile $Q_FILE -AgentName 'Amazon Q Developer CLI' }
390
- 'bob' { Update-AgentFile -TargetFile $BOB_FILE -AgentName 'IBM Bob' }
391
- default { Write-Err "Unknown agent type '$Type'"; Write-Err 'Expected: claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|q|bob|qoder'; return $false }
392
- }
393
- }
394
-
395
- function Update-AllExistingAgents {
396
- $found = $false
397
- $ok = $true
398
- if (Test-Path $CLAUDE_FILE) { if (-not (Update-AgentFile -TargetFile $CLAUDE_FILE -AgentName 'Claude Code')) { $ok = $false }; $found = $true }
399
- if (Test-Path $GEMINI_FILE) { if (-not (Update-AgentFile -TargetFile $GEMINI_FILE -AgentName 'Gemini CLI')) { $ok = $false }; $found = $true }
400
- if (Test-Path $COPILOT_FILE) { if (-not (Update-AgentFile -TargetFile $COPILOT_FILE -AgentName 'GitHub Copilot')) { $ok = $false }; $found = $true }
401
- if (Test-Path $CURSOR_FILE) { if (-not (Update-AgentFile -TargetFile $CURSOR_FILE -AgentName 'Cursor IDE')) { $ok = $false }; $found = $true }
402
- if (Test-Path $QWEN_FILE) { if (-not (Update-AgentFile -TargetFile $QWEN_FILE -AgentName 'Qwen Code')) { $ok = $false }; $found = $true }
403
- if (Test-Path $AGENTS_FILE) { if (-not (Update-AgentFile -TargetFile $AGENTS_FILE -AgentName 'Codex/opencode')) { $ok = $false }; $found = $true }
404
- if (Test-Path $WINDSURF_FILE) { if (-not (Update-AgentFile -TargetFile $WINDSURF_FILE -AgentName 'Windsurf')) { $ok = $false }; $found = $true }
405
- if (Test-Path $KILOCODE_FILE) { if (-not (Update-AgentFile -TargetFile $KILOCODE_FILE -AgentName 'Kilo Code')) { $ok = $false }; $found = $true }
406
- if (Test-Path $AUGGIE_FILE) { if (-not (Update-AgentFile -TargetFile $AUGGIE_FILE -AgentName 'Auggie CLI')) { $ok = $false }; $found = $true }
407
- if (Test-Path $ROO_FILE) { if (-not (Update-AgentFile -TargetFile $ROO_FILE -AgentName 'Roo Code')) { $ok = $false }; $found = $true }
408
- if (Test-Path $CODEBUDDY_FILE) { if (-not (Update-AgentFile -TargetFile $CODEBUDDY_FILE -AgentName 'CodeBuddy CLI')) { $ok = $false }; $found = $true }
409
- if (Test-Path $QODER_FILE) { if (-not (Update-AgentFile -TargetFile $QODER_FILE -AgentName 'Qoder CLI')) { $ok = $false }; $found = $true }
410
- if (Test-Path $SHAI_FILE) { if (-not (Update-AgentFile -TargetFile $SHAI_FILE -AgentName 'SHAI')) { $ok = $false }; $found = $true }
411
- if (Test-Path $Q_FILE) { if (-not (Update-AgentFile -TargetFile $Q_FILE -AgentName 'Amazon Q Developer CLI')) { $ok = $false }; $found = $true }
412
- if (Test-Path $BOB_FILE) { if (-not (Update-AgentFile -TargetFile $BOB_FILE -AgentName 'IBM Bob')) { $ok = $false }; $found = $true }
413
- if (-not $found) {
414
- Write-Info 'No existing agent files found, creating default Claude file...'
415
- if (-not (Update-AgentFile -TargetFile $CLAUDE_FILE -AgentName 'Claude Code')) { $ok = $false }
416
- }
417
- return $ok
418
- }
419
-
420
- function Print-Summary {
421
- Write-Host ''
422
- Write-Info 'Summary of changes:'
423
- if ($NEW_LANG) { Write-Host " - Added language: $NEW_LANG" }
424
- if ($NEW_FRAMEWORK) { Write-Host " - Added framework: $NEW_FRAMEWORK" }
425
- if ($NEW_DB -and $NEW_DB -ne 'N/A') { Write-Host " - Added database: $NEW_DB" }
426
- Write-Host ''
427
- Write-Info 'Usage: ./update-agent-context.ps1 [-AgentType claude|gemini|copilot|cursor-agent|qwen|opencode|codex|windsurf|kilocode|auggie|roo|codebuddy|amp|shai|q|bob|qoder]'
428
- }
429
-
430
- function Main {
431
- Validate-Environment
432
- Write-Info "=== Updating agent context files for feature $CURRENT_BRANCH ==="
433
- if (-not (Parse-PlanData -PlanFile $NEW_PLAN)) { Write-Err 'Failed to parse plan data'; exit 1 }
434
- $success = $true
435
- if ($AgentType) {
436
- Write-Info "Updating specific agent: $AgentType"
437
- if (-not (Update-SpecificAgent -Type $AgentType)) { $success = $false }
438
- }
439
- else {
440
- Write-Info 'No agent specified, updating all existing agent files...'
441
- if (-not (Update-AllExistingAgents)) { $success = $false }
442
- }
443
- Print-Summary
444
- if ($success) { Write-Success 'Agent context update completed successfully'; exit 0 } else { Write-Err 'Agent context update completed with errors'; exit 1 }
445
- }
446
-
447
- Main
448
-
@@ -1,28 +0,0 @@
1
- # [PROJECT NAME] Development Guidelines
2
-
3
- Auto-generated from all feature plans. Last updated: [DATE]
4
-
5
- ## Active Technologies
6
-
7
- [EXTRACTED FROM ALL PLAN.MD FILES]
8
-
9
- ## Project Structure
10
-
11
- ```text
12
- [ACTUAL STRUCTURE FROM PLANS]
13
- ```
14
-
15
- ## Commands
16
-
17
- [ONLY COMMANDS FOR ACTIVE TECHNOLOGIES]
18
-
19
- ## Code Style
20
-
21
- [LANGUAGE-SPECIFIC, ONLY FOR LANGUAGES IN USE]
22
-
23
- ## Recent Changes
24
-
25
- [LAST 3 FEATURES AND WHAT THEY ADDED]
26
-
27
- <!-- MANUAL ADDITIONS START -->
28
- <!-- MANUAL ADDITIONS END -->
@@ -1,40 +0,0 @@
1
- # [CHECKLIST TYPE] Checklist: [FEATURE NAME]
2
-
3
- **Purpose**: [Brief description of what this checklist covers]
4
- **Created**: [DATE]
5
- **Feature**: [Link to spec.md or relevant documentation]
6
-
7
- **Note**: This checklist is generated by the `/speckit.checklist` command based on feature context and requirements.
8
-
9
- <!--
10
- ============================================================================
11
- IMPORTANT: The checklist items below are SAMPLE ITEMS for illustration only.
12
-
13
- The /speckit.checklist command MUST replace these with actual items based on:
14
- - User's specific checklist request
15
- - Feature requirements from spec.md
16
- - Technical context from plan.md
17
- - Implementation details from tasks.md
18
-
19
- DO NOT keep these sample items in the generated checklist file.
20
- ============================================================================
21
- -->
22
-
23
- ## [Category 1]
24
-
25
- - [ ] CHK001 First checklist item with clear action
26
- - [ ] CHK002 Second checklist item
27
- - [ ] CHK003 Third checklist item
28
-
29
- ## [Category 2]
30
-
31
- - [ ] CHK004 Another category item
32
- - [ ] CHK005 Item with specific criteria
33
- - [ ] CHK006 Final item in this category
34
-
35
- ## Notes
36
-
37
- - Check items off as completed: `[x]`
38
- - Add comments or findings inline
39
- - Link to relevant resources or documentation
40
- - Items are numbered sequentially for easy reference