cokit-cli 1.0.9 → 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 (888) hide show
  1. package/LICENSE +32 -32
  2. package/README.FLOW.md +237 -237
  3. package/README.md +142 -92
  4. package/agents/brainstormer.agent.md +71 -71
  5. package/agents/code-reviewer.agent.md +136 -136
  6. package/agents/code-simplifier.agent.md +43 -0
  7. package/agents/debugger.agent.md +128 -128
  8. package/agents/docs-manager.agent.md +121 -121
  9. package/agents/fullstack-developer.agent.md +52 -0
  10. package/agents/git-manager.agent.md +390 -390
  11. package/agents/planner.agent.md +94 -94
  12. package/agents/researcher.agent.md +31 -32
  13. package/agents/scout.agent.md +107 -107
  14. package/agents/tester.agent.md +117 -117
  15. package/agents/ui-ux-designer.agent.md +57 -0
  16. package/bin/cokit.js +4 -4
  17. package/collections/ck-core.collection.yml +28 -28
  18. package/collections/ck-development-rules.collection.yml +18 -18
  19. package/collections/ck-documentation.collection.yml +14 -14
  20. package/collections/ck-git-workflow.collection.yml +12 -12
  21. package/collections/ck-orchestration.collection.yml +16 -16
  22. package/docs/README.md +75 -108
  23. package/docs/code-standards.md +68 -0
  24. package/docs/codebase-summary.md +263 -0
  25. package/docs/cokit-commands-usage-guide.md +138 -0
  26. package/docs/cokit-comprehensive-mapping-guide.md +361 -374
  27. package/docs/cokit-slides.md +212 -222
  28. package/docs/cokit-sync-and-maintenance-guide.md +414 -0
  29. package/docs/cokit-team-presentation.md +356 -378
  30. package/docs/copilot-processing-flow.md +215 -212
  31. package/docs/guide-next-steps-speckit-cokit-implementation.md +187 -0
  32. package/docs/migration-guide.md +133 -133
  33. package/docs/project-overview-pdr.md +45 -0
  34. package/docs/project-roadmap.md +308 -280
  35. package/docs/system-architecture.md +81 -0
  36. package/instructions/ck-backend.instructions.md +48 -48
  37. package/instructions/ck-development.instructions.md +54 -54
  38. package/instructions/ck-frontend.instructions.md +44 -44
  39. package/instructions/ck-research.instructions.md +167 -167
  40. package/instructions/ck-testing.instructions.md +36 -36
  41. package/package.json +71 -42
  42. package/prompts/ck-ask.prompt.md +67 -57
  43. package/prompts/ck-bootstrap.prompt.md +141 -136
  44. package/prompts/ck-brainstorm.prompt.md +87 -105
  45. package/prompts/ck-cook.prompt.md +96 -97
  46. package/prompts/ck-debug.prompt.md +115 -14
  47. package/prompts/ck-docs.prompt.md +102 -51
  48. package/prompts/ck-fix-ci.prompt.md +46 -0
  49. package/prompts/ck-fix-fast.prompt.md +44 -0
  50. package/prompts/ck-fix-hard.prompt.md +60 -0
  51. package/prompts/ck-fix-logs.prompt.md +53 -0
  52. package/prompts/ck-fix-test.prompt.md +47 -0
  53. package/prompts/ck-fix-types.prompt.md +29 -0
  54. package/prompts/ck-fix-ui.prompt.md +50 -0
  55. package/prompts/ck-fix.prompt.md +50 -44
  56. package/prompts/ck-git.prompt.md +104 -79
  57. package/{templates/repo/.github/prompts/ck-ck-help.prompt.md → prompts/ck-help.prompt.md} +142 -112
  58. package/prompts/ck-journal.prompt.md +19 -0
  59. package/prompts/ck-plan-fast.prompt.md +106 -0
  60. package/prompts/ck-plan-hard.prompt.md +133 -0
  61. package/prompts/ck-plan-validate.prompt.md +209 -0
  62. package/prompts/ck-plan.prompt.md +75 -80
  63. package/prompts/ck-preview.prompt.md +77 -0
  64. package/{templates/repo/.github/prompts/ck-review-codebase.prompt.md → prompts/ck-review.prompt.md} +58 -44
  65. package/prompts/ck-scout.prompt.md +85 -25
  66. package/prompts/ck-simplify.prompt.md +46 -0
  67. package/prompts/ck-spec-analyze.prompt.md +201 -0
  68. package/prompts/ck-spec-checklist.prompt.md +308 -0
  69. package/prompts/ck-spec-clarify.prompt.md +190 -0
  70. package/prompts/ck-spec-constitution.prompt.md +92 -0
  71. package/prompts/ck-spec-implement.prompt.md +157 -0
  72. package/prompts/ck-spec-plan.prompt.md +95 -0
  73. package/prompts/ck-spec-specify.prompt.md +260 -0
  74. package/prompts/ck-spec-tasks.prompt.md +181 -0
  75. package/prompts/ck-test.prompt.md +21 -10
  76. package/prompts/ck-watzup.prompt.md +21 -0
  77. package/skills/INSTALLATION.md +311 -0
  78. package/skills/README.md +112 -0
  79. package/skills/THIRD_PARTY_NOTICES.md +405 -0
  80. package/skills/agent-browser/SKILL.md +291 -0
  81. package/skills/agent-browser/references/.gitkeep +0 -0
  82. package/skills/agent-browser/references/browserbase-cloud-setup.md +161 -0
  83. package/skills/agent_skills_spec.md +55 -0
  84. package/skills/{ck-backend-development → backend-development}/SKILL.md +94 -96
  85. package/skills/{ck-backend-development → backend-development}/references/backend-api-design.md +697 -495
  86. package/{templates/repo/.github/skills/ck-backend-development → skills/backend-development}/references/backend-architecture.md +454 -454
  87. package/skills/{ck-backend-development → backend-development}/references/backend-authentication.md +433 -338
  88. package/skills/{ck-backend-development → backend-development}/references/backend-code-quality.md +659 -659
  89. package/{templates/repo/.github/skills/ck-backend-development → skills/backend-development}/references/backend-debugging.md +904 -904
  90. package/{templates/repo/.github/skills/ck-backend-development → skills/backend-development}/references/backend-devops.md +494 -494
  91. package/{templates/repo/.github/skills/ck-backend-development → skills/backend-development}/references/backend-mindset.md +387 -387
  92. package/skills/{ck-backend-development → backend-development}/references/backend-performance.md +397 -397
  93. package/{templates/repo/.github/skills/ck-backend-development → skills/backend-development}/references/backend-security.md +340 -290
  94. package/{templates/repo/.github/skills/ck-backend-development → skills/backend-development}/references/backend-technologies.md +300 -290
  95. package/{templates/repo/.github/skills/ck-backend-development → skills/backend-development}/references/backend-testing.md +484 -561
  96. package/skills/brainstorm/SKILL.md +74 -0
  97. package/skills/{ck-code-review → code-review}/SKILL.md +143 -143
  98. package/skills/{ck-code-review → code-review}/references/code-review-reception.md +1 -1
  99. package/skills/{ck-code-review → code-review}/references/requesting-code-review.md +7 -7
  100. package/skills/common/README.md +120 -0
  101. package/skills/common/api_key_helper.py +411 -0
  102. package/skills/common/api_key_rotator.py +248 -0
  103. package/skills/context-engineering/SKILL.md +106 -0
  104. package/skills/context-engineering/references/context-compression.md +84 -0
  105. package/skills/context-engineering/references/context-degradation.md +93 -0
  106. package/skills/context-engineering/references/context-fundamentals.md +75 -0
  107. package/skills/context-engineering/references/context-optimization.md +82 -0
  108. package/skills/context-engineering/references/evaluation.md +89 -0
  109. package/skills/context-engineering/references/memory-systems.md +88 -0
  110. package/skills/context-engineering/references/multi-agent-patterns.md +90 -0
  111. package/skills/context-engineering/references/project-development.md +97 -0
  112. package/skills/context-engineering/references/runtime-awareness.md +202 -0
  113. package/skills/context-engineering/references/tool-design.md +86 -0
  114. package/skills/context-engineering/scripts/compression_evaluator.py +349 -0
  115. package/skills/context-engineering/scripts/context_analyzer.py +317 -0
  116. package/skills/cook/README.md +86 -0
  117. package/skills/cook/SKILL.md +93 -0
  118. package/skills/cook/references/agent-patterns.md +75 -0
  119. package/skills/cook/references/intent-detection.md +101 -0
  120. package/skills/cook/references/review-cycle.md +75 -0
  121. package/skills/cook/references/workflow-steps.md +140 -0
  122. package/skills/databases/SKILL.md +111 -0
  123. package/skills/databases/analytics.md +198 -0
  124. package/skills/databases/db-design.md +188 -0
  125. package/skills/databases/incremental-etl.md +213 -0
  126. package/skills/databases/references/mongodb-aggregation.md +447 -0
  127. package/skills/databases/references/mongodb-atlas.md +465 -0
  128. package/skills/databases/references/mongodb-crud.md +408 -0
  129. package/skills/databases/references/mongodb-indexing.md +442 -0
  130. package/skills/databases/references/postgresql-administration.md +594 -0
  131. package/skills/databases/references/postgresql-performance.md +527 -0
  132. package/skills/databases/references/postgresql-psql-cli.md +467 -0
  133. package/skills/databases/references/postgresql-queries.md +475 -0
  134. package/skills/databases/scripts/db_backup.py +502 -0
  135. package/skills/databases/scripts/db_migrate.py +426 -0
  136. package/skills/databases/scripts/db_performance_check.py +457 -0
  137. package/skills/databases/scripts/requirements.txt +20 -0
  138. package/skills/databases/stacks/bigquery.md +231 -0
  139. package/skills/databases/stacks/d1_cloudflare.md +137 -0
  140. package/skills/databases/stacks/mysql.md +216 -0
  141. package/skills/databases/stacks/postgres.md +235 -0
  142. package/skills/databases/stacks/sqlite.md +244 -0
  143. package/skills/databases/transactional.md +176 -0
  144. package/{templates/repo/.github/skills/ck-debugging → skills/debug}/SKILL.md +83 -82
  145. package/{templates/repo/.github/skills/ck-debugging → skills/debug}/references/defense-in-depth.md +124 -124
  146. package/skills/{ck-debugging → debug}/references/root-cause-tracing.md +122 -122
  147. package/{templates/repo/.github/skills/ck-debugging → skills/debug}/references/systematic-debugging.md +102 -102
  148. package/skills/{ck-debugging → debug}/references/verification.md +123 -123
  149. package/{templates/repo/.github/skills/ck-debugging → skills/debug}/scripts/find-polluter.sh +63 -63
  150. package/{templates/repo/.github/skills/ck-debugging → skills/debug}/scripts/find-polluter.test.md +102 -102
  151. package/skills/devops/.env.example +76 -0
  152. package/skills/devops/SKILL.md +102 -0
  153. package/skills/devops/references/browser-rendering.md +305 -0
  154. package/skills/devops/references/cloudflare-d1-kv.md +123 -0
  155. package/skills/devops/references/cloudflare-platform.md +271 -0
  156. package/skills/devops/references/cloudflare-r2-storage.md +280 -0
  157. package/skills/devops/references/cloudflare-workers-advanced.md +312 -0
  158. package/skills/devops/references/cloudflare-workers-apis.md +309 -0
  159. package/skills/devops/references/cloudflare-workers-basics.md +418 -0
  160. package/skills/devops/references/docker-basics.md +297 -0
  161. package/skills/devops/references/docker-compose.md +292 -0
  162. package/skills/devops/references/gcloud-platform.md +297 -0
  163. package/skills/devops/references/gcloud-services.md +304 -0
  164. package/skills/devops/references/kubernetes-basics.md +99 -0
  165. package/skills/devops/references/kubernetes-helm-advanced.md +75 -0
  166. package/skills/devops/references/kubernetes-helm.md +81 -0
  167. package/skills/devops/references/kubernetes-kubectl.md +74 -0
  168. package/skills/devops/references/kubernetes-security-advanced.md +98 -0
  169. package/skills/devops/references/kubernetes-security.md +95 -0
  170. package/skills/devops/references/kubernetes-troubleshooting-advanced.md +74 -0
  171. package/skills/devops/references/kubernetes-troubleshooting.md +49 -0
  172. package/skills/devops/references/kubernetes-workflows-advanced.md +75 -0
  173. package/skills/devops/references/kubernetes-workflows.md +78 -0
  174. package/skills/devops/scripts/cloudflare_deploy.py +269 -0
  175. package/skills/devops/scripts/docker_optimize.py +332 -0
  176. package/skills/devops/scripts/requirements.txt +20 -0
  177. package/skills/docs-seeker/.env.example +15 -0
  178. package/skills/docs-seeker/SKILL.md +96 -0
  179. package/skills/docs-seeker/package.json +25 -0
  180. package/skills/docs-seeker/references/advanced.md +79 -0
  181. package/skills/docs-seeker/references/context7-patterns.md +64 -0
  182. package/skills/docs-seeker/references/errors.md +68 -0
  183. package/skills/docs-seeker/scripts/analyze-llms-txt.js +211 -0
  184. package/skills/docs-seeker/scripts/detect-topic.js +172 -0
  185. package/skills/docs-seeker/scripts/fetch-docs.js +214 -0
  186. package/skills/docs-seeker/scripts/utils/env-loader.js +94 -0
  187. package/skills/docs-seeker/workflows/library-search.md +86 -0
  188. package/skills/docs-seeker/workflows/repo-analysis.md +91 -0
  189. package/skills/docs-seeker/workflows/topic-search.md +77 -0
  190. package/skills/fix/SKILL.md +100 -0
  191. package/skills/fix/references/complexity-assessment.md +61 -0
  192. package/skills/fix/references/mode-selection.md +30 -0
  193. package/skills/fix/references/parallel-exploration.md +77 -0
  194. package/skills/fix/references/review-cycle.md +77 -0
  195. package/skills/fix/references/skill-activation-matrix.md +65 -0
  196. package/skills/fix/references/workflow-ci.md +28 -0
  197. package/skills/fix/references/workflow-deep.md +91 -0
  198. package/skills/fix/references/workflow-logs.md +36 -0
  199. package/skills/fix/references/workflow-quick.md +59 -0
  200. package/skills/fix/references/workflow-standard.md +86 -0
  201. package/skills/fix/references/workflow-test.md +36 -0
  202. package/skills/fix/references/workflow-types.md +33 -0
  203. package/skills/fix/references/workflow-ui.md +34 -0
  204. package/skills/frontend-design/SKILL.md +74 -0
  205. package/skills/frontend-design/references/analysis-best-practices.md +80 -0
  206. package/skills/frontend-design/references/analysis-prompts.md +141 -0
  207. package/skills/frontend-design/references/analysis-techniques.md +118 -0
  208. package/skills/frontend-design/references/animejs.md +396 -0
  209. package/skills/frontend-design/references/asset-generation.md +161 -0
  210. package/skills/frontend-design/references/design-extraction-overview.md +71 -0
  211. package/skills/frontend-design/references/extraction-best-practices.md +141 -0
  212. package/skills/frontend-design/references/extraction-output-templates.md +162 -0
  213. package/skills/frontend-design/references/extraction-prompts.md +127 -0
  214. package/skills/frontend-design/references/technical-accessibility.md +119 -0
  215. package/skills/frontend-design/references/technical-best-practices.md +97 -0
  216. package/skills/frontend-design/references/technical-optimization.md +44 -0
  217. package/skills/frontend-design/references/technical-overview.md +90 -0
  218. package/skills/frontend-design/references/technical-workflows.md +150 -0
  219. package/skills/frontend-design/references/visual-analysis-overview.md +95 -0
  220. package/skills/frontend-design/references/workflow-describe.md +86 -0
  221. package/skills/frontend-design/references/workflow-quick.md +54 -0
  222. package/skills/frontend-design/references/workflow-screenshot.md +62 -0
  223. package/skills/git/SKILL.md +99 -0
  224. package/skills/git/references/branch-management.md +88 -0
  225. package/skills/git/references/commit-standards.md +46 -0
  226. package/skills/git/references/gh-cli-guide.md +109 -0
  227. package/skills/git/references/safety-protocols.md +69 -0
  228. package/skills/git/references/workflow-commit.md +58 -0
  229. package/skills/git/references/workflow-merge.md +48 -0
  230. package/skills/git/references/workflow-pr.md +58 -0
  231. package/skills/git/references/workflow-push.md +52 -0
  232. package/skills/install.ps1 +1247 -0
  233. package/skills/install.sh +1300 -0
  234. package/skills/mcp-management/README.md +219 -0
  235. package/skills/mcp-management/SKILL.md +209 -0
  236. package/skills/mcp-management/assets/tools.json +3146 -0
  237. package/skills/mcp-management/references/configuration.md +114 -0
  238. package/skills/mcp-management/references/gemini-cli-integration.md +221 -0
  239. package/skills/mcp-management/references/mcp-protocol.md +116 -0
  240. package/skills/mcp-management/scripts/.env.example +10 -0
  241. package/skills/mcp-management/scripts/cli.ts +195 -0
  242. package/skills/mcp-management/scripts/dist/analyze-tools.js +70 -0
  243. package/skills/mcp-management/scripts/dist/cli.js +160 -0
  244. package/skills/mcp-management/scripts/dist/mcp-client.js +183 -0
  245. package/skills/mcp-management/scripts/mcp-client.ts +230 -0
  246. package/skills/mcp-management/scripts/package.json +20 -0
  247. package/skills/mcp-management/scripts/tsconfig.json +15 -0
  248. package/skills/mermaidjs-v11/SKILL.md +115 -0
  249. package/skills/mermaidjs-v11/references/cli-usage.md +228 -0
  250. package/skills/mermaidjs-v11/references/configuration.md +232 -0
  251. package/skills/mermaidjs-v11/references/diagram-types.md +315 -0
  252. package/skills/mermaidjs-v11/references/examples.md +344 -0
  253. package/skills/mermaidjs-v11/references/integration.md +310 -0
  254. package/skills/{ck-planning → planning}/SKILL.md +131 -112
  255. package/{templates/repo/.github/skills/ck-planning → skills/planning}/references/codebase-understanding.md +62 -62
  256. package/skills/{ck-planning → planning}/references/output-standards.md +141 -127
  257. package/{templates/repo/.github/skills/ck-planning → skills/planning}/references/plan-organization.md +160 -150
  258. package/skills/{ck-planning → planning}/references/research-phase.md +49 -49
  259. package/{templates/repo/.github/skills/ck-planning → skills/planning}/references/solution-design.md +63 -63
  260. package/skills/{ck-problem-solving → problem-solving}/SKILL.md +95 -95
  261. package/{templates/repo/.github/skills/ck-problem-solving → skills/problem-solving}/references/attribution.md +69 -69
  262. package/skills/{ck-problem-solving → problem-solving}/references/collision-zone-thinking.md +79 -79
  263. package/{templates/repo/.github/skills/ck-problem-solving → skills/problem-solving}/references/inversion-exercise.md +91 -91
  264. package/skills/{ck-problem-solving → problem-solving}/references/meta-pattern-recognition.md +87 -87
  265. package/skills/{ck-problem-solving → problem-solving}/references/scale-game.md +95 -95
  266. package/skills/{ck-problem-solving → problem-solving}/references/simplification-cascades.md +80 -80
  267. package/{templates/repo/.github/skills/ck-problem-solving → skills/problem-solving}/references/when-stuck.md +72 -72
  268. package/skills/repomix/SKILL.md +247 -0
  269. package/skills/repomix/references/configuration.md +211 -0
  270. package/skills/repomix/references/usage-patterns.md +232 -0
  271. package/skills/repomix/scripts/README.md +179 -0
  272. package/skills/repomix/scripts/repomix_batch.py +455 -0
  273. package/skills/repomix/scripts/repos.example.json +15 -0
  274. package/skills/repomix/scripts/requirements.txt +15 -0
  275. package/skills/research/SKILL.md +169 -0
  276. package/skills/scout/SKILL.md +78 -0
  277. package/skills/scout/references/external-scouting.md +140 -0
  278. package/skills/scout/references/internal-scouting.md +119 -0
  279. package/skills/{ck-sequential-thinking → sequential-thinking}/.env.example +8 -8
  280. package/skills/{ck-sequential-thinking → sequential-thinking}/README.md +183 -183
  281. package/{templates/repo/.github/skills/ck-sequential-thinking → skills/sequential-thinking}/SKILL.md +92 -92
  282. package/skills/{ck-sequential-thinking → sequential-thinking}/package.json +31 -31
  283. package/{templates/repo/.github/skills/ck-sequential-thinking → skills/sequential-thinking}/references/advanced-strategies.md +79 -79
  284. package/{templates/repo/.github/skills/ck-sequential-thinking → skills/sequential-thinking}/references/advanced-techniques.md +76 -76
  285. package/{templates/repo/.github/skills/ck-sequential-thinking → skills/sequential-thinking}/references/core-patterns.md +95 -95
  286. package/skills/{ck-sequential-thinking → sequential-thinking}/references/examples-api.md +88 -88
  287. package/skills/{ck-sequential-thinking → sequential-thinking}/references/examples-architecture.md +94 -94
  288. package/skills/{ck-sequential-thinking → sequential-thinking}/references/examples-debug.md +90 -90
  289. package/skills/{ck-sequential-thinking → sequential-thinking}/scripts/format-thought.js +159 -159
  290. package/{templates/repo/.github/skills/ck-sequential-thinking → skills/sequential-thinking}/scripts/process-thought.js +236 -236
  291. package/skills/ui-styling/LICENSE.txt +202 -0
  292. package/skills/ui-styling/SKILL.md +319 -0
  293. package/skills/ui-styling/canvas-fonts/ArsenalSC-OFL.txt +93 -0
  294. package/skills/ui-styling/canvas-fonts/ArsenalSC-Regular.ttf +0 -0
  295. package/skills/ui-styling/canvas-fonts/BigShoulders-Bold.ttf +0 -0
  296. package/skills/ui-styling/canvas-fonts/BigShoulders-OFL.txt +93 -0
  297. package/skills/ui-styling/canvas-fonts/BigShoulders-Regular.ttf +0 -0
  298. package/skills/ui-styling/canvas-fonts/Boldonse-OFL.txt +93 -0
  299. package/skills/ui-styling/canvas-fonts/Boldonse-Regular.ttf +0 -0
  300. package/skills/ui-styling/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
  301. package/skills/ui-styling/canvas-fonts/BricolageGrotesque-OFL.txt +93 -0
  302. package/skills/ui-styling/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
  303. package/skills/ui-styling/canvas-fonts/CrimsonPro-Bold.ttf +0 -0
  304. package/skills/ui-styling/canvas-fonts/CrimsonPro-Italic.ttf +0 -0
  305. package/skills/ui-styling/canvas-fonts/CrimsonPro-OFL.txt +93 -0
  306. package/skills/ui-styling/canvas-fonts/CrimsonPro-Regular.ttf +0 -0
  307. package/skills/ui-styling/canvas-fonts/DMMono-OFL.txt +93 -0
  308. package/skills/ui-styling/canvas-fonts/DMMono-Regular.ttf +0 -0
  309. package/skills/ui-styling/canvas-fonts/EricaOne-OFL.txt +94 -0
  310. package/skills/ui-styling/canvas-fonts/EricaOne-Regular.ttf +0 -0
  311. package/skills/ui-styling/canvas-fonts/GeistMono-Bold.ttf +0 -0
  312. package/skills/ui-styling/canvas-fonts/GeistMono-OFL.txt +93 -0
  313. package/skills/ui-styling/canvas-fonts/GeistMono-Regular.ttf +0 -0
  314. package/skills/ui-styling/canvas-fonts/Gloock-OFL.txt +93 -0
  315. package/skills/ui-styling/canvas-fonts/Gloock-Regular.ttf +0 -0
  316. package/skills/ui-styling/canvas-fonts/IBMPlexMono-Bold.ttf +0 -0
  317. package/skills/ui-styling/canvas-fonts/IBMPlexMono-OFL.txt +93 -0
  318. package/skills/ui-styling/canvas-fonts/IBMPlexMono-Regular.ttf +0 -0
  319. package/skills/ui-styling/canvas-fonts/IBMPlexSerif-Bold.ttf +0 -0
  320. package/skills/ui-styling/canvas-fonts/IBMPlexSerif-BoldItalic.ttf +0 -0
  321. package/skills/ui-styling/canvas-fonts/IBMPlexSerif-Italic.ttf +0 -0
  322. package/skills/ui-styling/canvas-fonts/IBMPlexSerif-Regular.ttf +0 -0
  323. package/skills/ui-styling/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
  324. package/skills/ui-styling/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
  325. package/skills/ui-styling/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
  326. package/skills/ui-styling/canvas-fonts/InstrumentSans-OFL.txt +93 -0
  327. package/skills/ui-styling/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
  328. package/skills/ui-styling/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
  329. package/skills/ui-styling/canvas-fonts/InstrumentSerif-Regular.ttf +0 -0
  330. package/skills/ui-styling/canvas-fonts/Italiana-OFL.txt +93 -0
  331. package/skills/ui-styling/canvas-fonts/Italiana-Regular.ttf +0 -0
  332. package/skills/ui-styling/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
  333. package/skills/ui-styling/canvas-fonts/JetBrainsMono-OFL.txt +93 -0
  334. package/skills/ui-styling/canvas-fonts/JetBrainsMono-Regular.ttf +0 -0
  335. package/skills/ui-styling/canvas-fonts/Jura-Light.ttf +0 -0
  336. package/skills/ui-styling/canvas-fonts/Jura-Medium.ttf +0 -0
  337. package/skills/ui-styling/canvas-fonts/Jura-OFL.txt +93 -0
  338. package/skills/ui-styling/canvas-fonts/LibreBaskerville-OFL.txt +93 -0
  339. package/skills/ui-styling/canvas-fonts/LibreBaskerville-Regular.ttf +0 -0
  340. package/skills/ui-styling/canvas-fonts/Lora-Bold.ttf +0 -0
  341. package/skills/ui-styling/canvas-fonts/Lora-BoldItalic.ttf +0 -0
  342. package/skills/ui-styling/canvas-fonts/Lora-Italic.ttf +0 -0
  343. package/skills/ui-styling/canvas-fonts/Lora-OFL.txt +93 -0
  344. package/skills/ui-styling/canvas-fonts/Lora-Regular.ttf +0 -0
  345. package/skills/ui-styling/canvas-fonts/NationalPark-Bold.ttf +0 -0
  346. package/skills/ui-styling/canvas-fonts/NationalPark-OFL.txt +93 -0
  347. package/skills/ui-styling/canvas-fonts/NationalPark-Regular.ttf +0 -0
  348. package/skills/ui-styling/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -0
  349. package/skills/ui-styling/canvas-fonts/NothingYouCouldDo-Regular.ttf +0 -0
  350. package/skills/ui-styling/canvas-fonts/Outfit-Bold.ttf +0 -0
  351. package/skills/ui-styling/canvas-fonts/Outfit-OFL.txt +93 -0
  352. package/skills/ui-styling/canvas-fonts/Outfit-Regular.ttf +0 -0
  353. package/skills/ui-styling/canvas-fonts/PixelifySans-Medium.ttf +0 -0
  354. package/skills/ui-styling/canvas-fonts/PixelifySans-OFL.txt +93 -0
  355. package/skills/ui-styling/canvas-fonts/PoiretOne-OFL.txt +93 -0
  356. package/skills/ui-styling/canvas-fonts/PoiretOne-Regular.ttf +0 -0
  357. package/skills/ui-styling/canvas-fonts/RedHatMono-Bold.ttf +0 -0
  358. package/skills/ui-styling/canvas-fonts/RedHatMono-OFL.txt +93 -0
  359. package/skills/ui-styling/canvas-fonts/RedHatMono-Regular.ttf +0 -0
  360. package/skills/ui-styling/canvas-fonts/Silkscreen-OFL.txt +93 -0
  361. package/skills/ui-styling/canvas-fonts/Silkscreen-Regular.ttf +0 -0
  362. package/skills/ui-styling/canvas-fonts/SmoochSans-Medium.ttf +0 -0
  363. package/skills/ui-styling/canvas-fonts/SmoochSans-OFL.txt +93 -0
  364. package/skills/ui-styling/canvas-fonts/Tektur-Medium.ttf +0 -0
  365. package/skills/ui-styling/canvas-fonts/Tektur-OFL.txt +93 -0
  366. package/skills/ui-styling/canvas-fonts/Tektur-Regular.ttf +0 -0
  367. package/skills/ui-styling/canvas-fonts/WorkSans-Bold.ttf +0 -0
  368. package/skills/ui-styling/canvas-fonts/WorkSans-BoldItalic.ttf +0 -0
  369. package/skills/ui-styling/canvas-fonts/WorkSans-Italic.ttf +0 -0
  370. package/skills/ui-styling/canvas-fonts/WorkSans-OFL.txt +93 -0
  371. package/skills/ui-styling/canvas-fonts/WorkSans-Regular.ttf +0 -0
  372. package/skills/ui-styling/canvas-fonts/YoungSerif-OFL.txt +93 -0
  373. package/skills/ui-styling/canvas-fonts/YoungSerif-Regular.ttf +0 -0
  374. package/skills/ui-styling/references/canvas-design-system.md +320 -0
  375. package/skills/ui-styling/references/shadcn-accessibility.md +471 -0
  376. package/skills/ui-styling/references/shadcn-components.md +424 -0
  377. package/skills/ui-styling/references/shadcn-theming.md +373 -0
  378. package/skills/ui-styling/references/tailwind-customization.md +483 -0
  379. package/skills/ui-styling/references/tailwind-responsive.md +382 -0
  380. package/skills/ui-styling/references/tailwind-utilities.md +455 -0
  381. package/skills/ui-styling/scripts/requirements.txt +17 -0
  382. package/skills/ui-styling/scripts/shadcn_add.py +292 -0
  383. package/skills/ui-styling/scripts/tailwind_config_gen.py +456 -0
  384. package/skills/web-testing/SKILL.md +94 -0
  385. package/skills/web-testing/references/accessibility-testing.md +84 -0
  386. package/skills/web-testing/references/api-testing.md +78 -0
  387. package/skills/web-testing/references/ci-cd-testing-workflows.md +121 -0
  388. package/skills/web-testing/references/component-testing.md +94 -0
  389. package/skills/web-testing/references/contract-testing.md +146 -0
  390. package/skills/web-testing/references/cross-browser-checklist.md +72 -0
  391. package/skills/web-testing/references/database-testing.md +139 -0
  392. package/skills/web-testing/references/e2e-testing-playwright.md +119 -0
  393. package/skills/web-testing/references/functional-testing-checklist.md +88 -0
  394. package/skills/web-testing/references/interactive-testing-patterns.md +89 -0
  395. package/skills/web-testing/references/load-testing-k6.md +93 -0
  396. package/skills/web-testing/references/mobile-gesture-testing.md +85 -0
  397. package/skills/web-testing/references/performance-core-web-vitals.md +124 -0
  398. package/skills/web-testing/references/playwright-component-testing.md +115 -0
  399. package/skills/web-testing/references/pre-release-checklist.md +75 -0
  400. package/skills/web-testing/references/security-checklists.md +81 -0
  401. package/skills/web-testing/references/security-testing-overview.md +92 -0
  402. package/skills/web-testing/references/shadow-dom-testing.md +70 -0
  403. package/skills/web-testing/references/test-data-management.md +131 -0
  404. package/skills/web-testing/references/test-flakiness-mitigation.md +86 -0
  405. package/skills/web-testing/references/testing-pyramid-strategy.md +76 -0
  406. package/skills/web-testing/references/unit-integration-testing.md +138 -0
  407. package/skills/web-testing/references/visual-regression.md +92 -0
  408. package/skills/web-testing/references/vulnerability-payloads.md +93 -0
  409. package/skills/web-testing/scripts/analyze-test-results.js +280 -0
  410. package/skills/web-testing/scripts/init-playwright.js +233 -0
  411. package/src/commands/add.js +93 -93
  412. package/src/commands/doctor.js +117 -117
  413. package/src/commands/init.js +183 -183
  414. package/src/commands/list.js +91 -91
  415. package/src/commands/update.js +22 -22
  416. package/src/index.js +35 -35
  417. package/src/utils/colors.js +14 -14
  418. package/src/utils/copy.js +122 -122
  419. package/src/utils/paths.js +66 -66
  420. package/src/utils/update-checker.js +126 -126
  421. package/templates/repo/.github/AGENTS.md +103 -55
  422. package/templates/repo/.github/agents/brainstormer.agent.md +71 -71
  423. package/templates/repo/.github/agents/code-reviewer.agent.md +136 -136
  424. package/templates/repo/.github/agents/code-simplifier.agent.md +43 -0
  425. package/templates/repo/.github/agents/debugger.agent.md +128 -128
  426. package/templates/repo/.github/agents/docs-manager.agent.md +121 -121
  427. package/templates/repo/.github/agents/fullstack-developer.agent.md +52 -0
  428. package/templates/repo/.github/agents/git-manager.agent.md +390 -390
  429. package/templates/repo/.github/agents/planner.agent.md +94 -94
  430. package/templates/repo/.github/agents/researcher.agent.md +31 -32
  431. package/templates/repo/.github/agents/scout.agent.md +107 -107
  432. package/templates/repo/.github/agents/tester.agent.md +117 -117
  433. package/templates/repo/.github/agents/ui-ux-designer.agent.md +57 -0
  434. package/templates/repo/.github/collections/ck-core.collection.yml +28 -28
  435. package/templates/repo/.github/collections/ck-development-rules.collection.yml +18 -18
  436. package/templates/repo/.github/collections/ck-documentation.collection.yml +14 -14
  437. package/templates/repo/.github/collections/ck-git-workflow.collection.yml +12 -12
  438. package/templates/repo/.github/collections/ck-orchestration.collection.yml +16 -16
  439. package/templates/repo/.github/instructions/ck-backend.instructions.md +48 -48
  440. package/templates/repo/.github/instructions/ck-development.instructions.md +54 -54
  441. package/templates/repo/.github/instructions/ck-frontend.instructions.md +44 -44
  442. package/templates/repo/.github/instructions/ck-research.instructions.md +167 -167
  443. package/templates/repo/.github/instructions/ck-testing.instructions.md +36 -36
  444. package/templates/repo/.github/prompts/ck-ask.prompt.md +67 -57
  445. package/templates/repo/.github/prompts/ck-bootstrap.prompt.md +141 -136
  446. package/templates/repo/.github/prompts/ck-brainstorm.prompt.md +87 -105
  447. package/templates/repo/.github/prompts/ck-cook.prompt.md +96 -97
  448. package/templates/repo/.github/prompts/ck-debug.prompt.md +115 -14
  449. package/templates/repo/.github/prompts/ck-docs.prompt.md +102 -51
  450. package/templates/repo/.github/prompts/ck-fix-ci.prompt.md +46 -0
  451. package/templates/repo/.github/prompts/ck-fix-fast.prompt.md +44 -0
  452. package/templates/repo/.github/prompts/ck-fix-hard.prompt.md +60 -0
  453. package/templates/repo/.github/prompts/ck-fix-logs.prompt.md +53 -0
  454. package/templates/repo/.github/prompts/ck-fix-test.prompt.md +47 -0
  455. package/templates/repo/.github/prompts/ck-fix-types.prompt.md +29 -0
  456. package/templates/repo/.github/prompts/ck-fix-ui.prompt.md +50 -0
  457. package/templates/repo/.github/prompts/ck-fix.prompt.md +50 -44
  458. package/templates/repo/.github/prompts/ck-git.prompt.md +104 -79
  459. package/{prompts/ck-ck-help.prompt.md → templates/repo/.github/prompts/ck-help.prompt.md} +142 -112
  460. package/templates/repo/.github/prompts/ck-journal.prompt.md +19 -0
  461. package/templates/repo/.github/prompts/ck-plan-fast.prompt.md +106 -0
  462. package/templates/repo/.github/prompts/ck-plan-hard.prompt.md +133 -0
  463. package/templates/repo/.github/prompts/ck-plan-validate.prompt.md +209 -0
  464. package/templates/repo/.github/prompts/ck-plan.prompt.md +75 -80
  465. package/templates/repo/.github/prompts/ck-preview.prompt.md +77 -0
  466. package/{prompts/ck-review-codebase.prompt.md → templates/repo/.github/prompts/ck-review.prompt.md} +58 -44
  467. package/templates/repo/.github/prompts/ck-scout.prompt.md +85 -25
  468. package/templates/repo/.github/prompts/ck-simplify.prompt.md +46 -0
  469. package/templates/repo/.github/prompts/ck-spec-analyze.prompt.md +201 -0
  470. package/templates/repo/.github/prompts/ck-spec-checklist.prompt.md +308 -0
  471. package/templates/repo/.github/prompts/ck-spec-clarify.prompt.md +190 -0
  472. package/templates/repo/.github/prompts/ck-spec-constitution.prompt.md +92 -0
  473. package/templates/repo/.github/prompts/ck-spec-implement.prompt.md +157 -0
  474. package/templates/repo/.github/prompts/ck-spec-plan.prompt.md +95 -0
  475. package/templates/repo/.github/prompts/ck-spec-specify.prompt.md +260 -0
  476. package/templates/repo/.github/prompts/ck-spec-tasks.prompt.md +181 -0
  477. package/templates/repo/.github/prompts/ck-test.prompt.md +21 -10
  478. package/templates/repo/.github/prompts/ck-watzup.prompt.md +21 -0
  479. package/templates/repo/.github/skills/INSTALLATION.md +311 -0
  480. package/templates/repo/.github/skills/README.md +112 -0
  481. package/templates/repo/.github/skills/THIRD_PARTY_NOTICES.md +405 -0
  482. package/templates/repo/.github/skills/agent-browser/SKILL.md +291 -0
  483. package/templates/repo/.github/skills/agent-browser/references/.gitkeep +0 -0
  484. package/templates/repo/.github/skills/agent-browser/references/browserbase-cloud-setup.md +161 -0
  485. package/templates/repo/.github/skills/agent_skills_spec.md +55 -0
  486. package/templates/repo/.github/skills/{ck-backend-development → backend-development}/SKILL.md +94 -96
  487. package/templates/repo/.github/skills/{ck-backend-development → backend-development}/references/backend-api-design.md +697 -495
  488. package/{skills/ck-backend-development → templates/repo/.github/skills/backend-development}/references/backend-architecture.md +454 -454
  489. package/templates/repo/.github/skills/{ck-backend-development → backend-development}/references/backend-authentication.md +433 -338
  490. package/templates/repo/.github/skills/{ck-backend-development → backend-development}/references/backend-code-quality.md +659 -659
  491. package/{skills/ck-backend-development → templates/repo/.github/skills/backend-development}/references/backend-debugging.md +904 -904
  492. package/{skills/ck-backend-development → templates/repo/.github/skills/backend-development}/references/backend-devops.md +494 -494
  493. package/{skills/ck-backend-development → templates/repo/.github/skills/backend-development}/references/backend-mindset.md +387 -387
  494. package/templates/repo/.github/skills/{ck-backend-development → backend-development}/references/backend-performance.md +397 -397
  495. package/{skills/ck-backend-development → templates/repo/.github/skills/backend-development}/references/backend-security.md +340 -290
  496. package/{skills/ck-backend-development → templates/repo/.github/skills/backend-development}/references/backend-technologies.md +300 -290
  497. package/{skills/ck-backend-development → templates/repo/.github/skills/backend-development}/references/backend-testing.md +484 -561
  498. package/templates/repo/.github/skills/brainstorm/SKILL.md +74 -0
  499. package/templates/repo/.github/skills/{ck-code-review → code-review}/SKILL.md +143 -143
  500. package/templates/repo/.github/skills/{ck-code-review → code-review}/references/code-review-reception.md +208 -208
  501. package/templates/repo/.github/skills/{ck-code-review → code-review}/references/requesting-code-review.md +104 -104
  502. package/templates/repo/.github/skills/{ck-code-review → code-review}/references/verification-before-completion.md +138 -138
  503. package/templates/repo/.github/skills/common/README.md +120 -0
  504. package/templates/repo/.github/skills/common/api_key_helper.py +411 -0
  505. package/templates/repo/.github/skills/common/api_key_rotator.py +248 -0
  506. package/templates/repo/.github/skills/context-engineering/SKILL.md +106 -0
  507. package/templates/repo/.github/skills/context-engineering/references/context-compression.md +84 -0
  508. package/templates/repo/.github/skills/context-engineering/references/context-degradation.md +93 -0
  509. package/templates/repo/.github/skills/context-engineering/references/context-fundamentals.md +75 -0
  510. package/templates/repo/.github/skills/context-engineering/references/context-optimization.md +82 -0
  511. package/templates/repo/.github/skills/context-engineering/references/evaluation.md +89 -0
  512. package/templates/repo/.github/skills/context-engineering/references/memory-systems.md +88 -0
  513. package/templates/repo/.github/skills/context-engineering/references/multi-agent-patterns.md +90 -0
  514. package/templates/repo/.github/skills/context-engineering/references/project-development.md +97 -0
  515. package/templates/repo/.github/skills/context-engineering/references/runtime-awareness.md +202 -0
  516. package/templates/repo/.github/skills/context-engineering/references/tool-design.md +86 -0
  517. package/templates/repo/.github/skills/context-engineering/scripts/compression_evaluator.py +349 -0
  518. package/templates/repo/.github/skills/context-engineering/scripts/context_analyzer.py +317 -0
  519. package/templates/repo/.github/skills/cook/README.md +86 -0
  520. package/templates/repo/.github/skills/cook/SKILL.md +93 -0
  521. package/templates/repo/.github/skills/cook/references/agent-patterns.md +75 -0
  522. package/templates/repo/.github/skills/cook/references/intent-detection.md +101 -0
  523. package/templates/repo/.github/skills/cook/references/review-cycle.md +75 -0
  524. package/templates/repo/.github/skills/cook/references/workflow-steps.md +140 -0
  525. package/templates/repo/.github/skills/databases/SKILL.md +111 -0
  526. package/templates/repo/.github/skills/databases/analytics.md +198 -0
  527. package/templates/repo/.github/skills/databases/db-design.md +188 -0
  528. package/templates/repo/.github/skills/databases/incremental-etl.md +213 -0
  529. package/templates/repo/.github/skills/databases/references/mongodb-aggregation.md +447 -0
  530. package/templates/repo/.github/skills/databases/references/mongodb-atlas.md +465 -0
  531. package/templates/repo/.github/skills/databases/references/mongodb-crud.md +408 -0
  532. package/templates/repo/.github/skills/databases/references/mongodb-indexing.md +442 -0
  533. package/templates/repo/.github/skills/databases/references/postgresql-administration.md +594 -0
  534. package/templates/repo/.github/skills/databases/references/postgresql-performance.md +527 -0
  535. package/templates/repo/.github/skills/databases/references/postgresql-psql-cli.md +467 -0
  536. package/templates/repo/.github/skills/databases/references/postgresql-queries.md +475 -0
  537. package/templates/repo/.github/skills/databases/scripts/db_backup.py +502 -0
  538. package/templates/repo/.github/skills/databases/scripts/db_migrate.py +426 -0
  539. package/templates/repo/.github/skills/databases/scripts/db_performance_check.py +457 -0
  540. package/templates/repo/.github/skills/databases/scripts/requirements.txt +20 -0
  541. package/templates/repo/.github/skills/databases/stacks/bigquery.md +231 -0
  542. package/templates/repo/.github/skills/databases/stacks/d1_cloudflare.md +137 -0
  543. package/templates/repo/.github/skills/databases/stacks/mysql.md +216 -0
  544. package/templates/repo/.github/skills/databases/stacks/postgres.md +235 -0
  545. package/templates/repo/.github/skills/databases/stacks/sqlite.md +244 -0
  546. package/templates/repo/.github/skills/databases/transactional.md +176 -0
  547. package/{skills/ck-debugging → templates/repo/.github/skills/debug}/SKILL.md +83 -82
  548. package/{skills/ck-debugging → templates/repo/.github/skills/debug}/references/defense-in-depth.md +124 -124
  549. package/templates/repo/.github/skills/{ck-debugging → debug}/references/root-cause-tracing.md +122 -122
  550. package/{skills/ck-debugging → templates/repo/.github/skills/debug}/references/systematic-debugging.md +102 -102
  551. package/templates/repo/.github/skills/{ck-debugging → debug}/references/verification.md +123 -123
  552. package/{skills/ck-debugging → templates/repo/.github/skills/debug}/scripts/find-polluter.sh +63 -63
  553. package/{skills/ck-debugging → templates/repo/.github/skills/debug}/scripts/find-polluter.test.md +102 -102
  554. package/templates/repo/.github/skills/devops/.env.example +76 -0
  555. package/templates/repo/.github/skills/devops/SKILL.md +102 -0
  556. package/templates/repo/.github/skills/devops/references/browser-rendering.md +305 -0
  557. package/templates/repo/.github/skills/devops/references/cloudflare-d1-kv.md +123 -0
  558. package/templates/repo/.github/skills/devops/references/cloudflare-platform.md +271 -0
  559. package/templates/repo/.github/skills/devops/references/cloudflare-r2-storage.md +280 -0
  560. package/templates/repo/.github/skills/devops/references/cloudflare-workers-advanced.md +312 -0
  561. package/templates/repo/.github/skills/devops/references/cloudflare-workers-apis.md +309 -0
  562. package/templates/repo/.github/skills/devops/references/cloudflare-workers-basics.md +418 -0
  563. package/templates/repo/.github/skills/devops/references/docker-basics.md +297 -0
  564. package/templates/repo/.github/skills/devops/references/docker-compose.md +292 -0
  565. package/templates/repo/.github/skills/devops/references/gcloud-platform.md +297 -0
  566. package/templates/repo/.github/skills/devops/references/gcloud-services.md +304 -0
  567. package/templates/repo/.github/skills/devops/references/kubernetes-basics.md +99 -0
  568. package/templates/repo/.github/skills/devops/references/kubernetes-helm-advanced.md +75 -0
  569. package/templates/repo/.github/skills/devops/references/kubernetes-helm.md +81 -0
  570. package/templates/repo/.github/skills/devops/references/kubernetes-kubectl.md +74 -0
  571. package/templates/repo/.github/skills/devops/references/kubernetes-security-advanced.md +98 -0
  572. package/templates/repo/.github/skills/devops/references/kubernetes-security.md +95 -0
  573. package/templates/repo/.github/skills/devops/references/kubernetes-troubleshooting-advanced.md +74 -0
  574. package/templates/repo/.github/skills/devops/references/kubernetes-troubleshooting.md +49 -0
  575. package/templates/repo/.github/skills/devops/references/kubernetes-workflows-advanced.md +75 -0
  576. package/templates/repo/.github/skills/devops/references/kubernetes-workflows.md +78 -0
  577. package/templates/repo/.github/skills/devops/scripts/cloudflare_deploy.py +269 -0
  578. package/templates/repo/.github/skills/devops/scripts/docker_optimize.py +332 -0
  579. package/templates/repo/.github/skills/devops/scripts/requirements.txt +20 -0
  580. package/templates/repo/.github/skills/docs-seeker/.env.example +15 -0
  581. package/templates/repo/.github/skills/docs-seeker/SKILL.md +96 -0
  582. package/templates/repo/.github/skills/docs-seeker/package.json +25 -0
  583. package/templates/repo/.github/skills/docs-seeker/references/advanced.md +79 -0
  584. package/templates/repo/.github/skills/docs-seeker/references/context7-patterns.md +64 -0
  585. package/templates/repo/.github/skills/docs-seeker/references/errors.md +68 -0
  586. package/templates/repo/.github/skills/docs-seeker/scripts/analyze-llms-txt.js +211 -0
  587. package/templates/repo/.github/skills/docs-seeker/scripts/detect-topic.js +172 -0
  588. package/templates/repo/.github/skills/docs-seeker/scripts/fetch-docs.js +214 -0
  589. package/templates/repo/.github/skills/docs-seeker/scripts/utils/env-loader.js +94 -0
  590. package/templates/repo/.github/skills/docs-seeker/workflows/library-search.md +86 -0
  591. package/templates/repo/.github/skills/docs-seeker/workflows/repo-analysis.md +91 -0
  592. package/templates/repo/.github/skills/docs-seeker/workflows/topic-search.md +77 -0
  593. package/templates/repo/.github/skills/fix/SKILL.md +100 -0
  594. package/templates/repo/.github/skills/fix/references/complexity-assessment.md +61 -0
  595. package/templates/repo/.github/skills/fix/references/mode-selection.md +30 -0
  596. package/templates/repo/.github/skills/fix/references/parallel-exploration.md +77 -0
  597. package/templates/repo/.github/skills/fix/references/review-cycle.md +77 -0
  598. package/templates/repo/.github/skills/fix/references/skill-activation-matrix.md +65 -0
  599. package/templates/repo/.github/skills/fix/references/workflow-ci.md +28 -0
  600. package/templates/repo/.github/skills/fix/references/workflow-deep.md +91 -0
  601. package/templates/repo/.github/skills/fix/references/workflow-logs.md +36 -0
  602. package/templates/repo/.github/skills/fix/references/workflow-quick.md +59 -0
  603. package/templates/repo/.github/skills/fix/references/workflow-standard.md +86 -0
  604. package/templates/repo/.github/skills/fix/references/workflow-test.md +36 -0
  605. package/templates/repo/.github/skills/fix/references/workflow-types.md +33 -0
  606. package/templates/repo/.github/skills/fix/references/workflow-ui.md +34 -0
  607. package/templates/repo/.github/skills/frontend-design/SKILL.md +74 -0
  608. package/templates/repo/.github/skills/frontend-design/references/analysis-best-practices.md +80 -0
  609. package/templates/repo/.github/skills/frontend-design/references/analysis-prompts.md +141 -0
  610. package/templates/repo/.github/skills/frontend-design/references/analysis-techniques.md +118 -0
  611. package/templates/repo/.github/skills/frontend-design/references/animejs.md +396 -0
  612. package/templates/repo/.github/skills/frontend-design/references/asset-generation.md +161 -0
  613. package/templates/repo/.github/skills/frontend-design/references/design-extraction-overview.md +71 -0
  614. package/templates/repo/.github/skills/frontend-design/references/extraction-best-practices.md +141 -0
  615. package/templates/repo/.github/skills/frontend-design/references/extraction-output-templates.md +162 -0
  616. package/templates/repo/.github/skills/frontend-design/references/extraction-prompts.md +127 -0
  617. package/templates/repo/.github/skills/frontend-design/references/technical-accessibility.md +119 -0
  618. package/templates/repo/.github/skills/frontend-design/references/technical-best-practices.md +97 -0
  619. package/templates/repo/.github/skills/frontend-design/references/technical-optimization.md +44 -0
  620. package/templates/repo/.github/skills/frontend-design/references/technical-overview.md +90 -0
  621. package/templates/repo/.github/skills/frontend-design/references/technical-workflows.md +150 -0
  622. package/templates/repo/.github/skills/frontend-design/references/visual-analysis-overview.md +95 -0
  623. package/templates/repo/.github/skills/frontend-design/references/workflow-describe.md +86 -0
  624. package/templates/repo/.github/skills/frontend-design/references/workflow-quick.md +54 -0
  625. package/templates/repo/.github/skills/frontend-design/references/workflow-screenshot.md +62 -0
  626. package/templates/repo/.github/skills/git/SKILL.md +99 -0
  627. package/templates/repo/.github/skills/git/references/branch-management.md +88 -0
  628. package/templates/repo/.github/skills/git/references/commit-standards.md +46 -0
  629. package/templates/repo/.github/skills/git/references/gh-cli-guide.md +109 -0
  630. package/templates/repo/.github/skills/git/references/safety-protocols.md +69 -0
  631. package/templates/repo/.github/skills/git/references/workflow-commit.md +58 -0
  632. package/templates/repo/.github/skills/git/references/workflow-merge.md +48 -0
  633. package/templates/repo/.github/skills/git/references/workflow-pr.md +58 -0
  634. package/templates/repo/.github/skills/git/references/workflow-push.md +52 -0
  635. package/templates/repo/.github/skills/install.ps1 +1247 -0
  636. package/templates/repo/.github/skills/install.sh +1300 -0
  637. package/templates/repo/.github/skills/mcp-management/README.md +219 -0
  638. package/templates/repo/.github/skills/mcp-management/SKILL.md +209 -0
  639. package/templates/repo/.github/skills/mcp-management/assets/tools.json +3146 -0
  640. package/templates/repo/.github/skills/mcp-management/references/configuration.md +114 -0
  641. package/templates/repo/.github/skills/mcp-management/references/gemini-cli-integration.md +221 -0
  642. package/templates/repo/.github/skills/mcp-management/references/mcp-protocol.md +116 -0
  643. package/templates/repo/.github/skills/mcp-management/scripts/.env.example +10 -0
  644. package/templates/repo/.github/skills/mcp-management/scripts/cli.ts +195 -0
  645. package/templates/repo/.github/skills/mcp-management/scripts/dist/analyze-tools.js +70 -0
  646. package/templates/repo/.github/skills/mcp-management/scripts/dist/cli.js +160 -0
  647. package/templates/repo/.github/skills/mcp-management/scripts/dist/mcp-client.js +183 -0
  648. package/templates/repo/.github/skills/mcp-management/scripts/mcp-client.ts +230 -0
  649. package/templates/repo/.github/skills/mcp-management/scripts/package.json +20 -0
  650. package/templates/repo/.github/skills/mcp-management/scripts/tsconfig.json +15 -0
  651. package/templates/repo/.github/skills/mermaidjs-v11/SKILL.md +115 -0
  652. package/templates/repo/.github/skills/mermaidjs-v11/references/cli-usage.md +228 -0
  653. package/templates/repo/.github/skills/mermaidjs-v11/references/configuration.md +232 -0
  654. package/templates/repo/.github/skills/mermaidjs-v11/references/diagram-types.md +315 -0
  655. package/templates/repo/.github/skills/mermaidjs-v11/references/examples.md +344 -0
  656. package/templates/repo/.github/skills/mermaidjs-v11/references/integration.md +310 -0
  657. package/templates/repo/.github/skills/{ck-planning → planning}/SKILL.md +131 -112
  658. package/{skills/ck-planning → templates/repo/.github/skills/planning}/references/codebase-understanding.md +62 -62
  659. package/templates/repo/.github/skills/{ck-planning → planning}/references/output-standards.md +141 -127
  660. package/{skills/ck-planning → templates/repo/.github/skills/planning}/references/plan-organization.md +160 -150
  661. package/templates/repo/.github/skills/{ck-planning → planning}/references/research-phase.md +49 -49
  662. package/{skills/ck-planning → templates/repo/.github/skills/planning}/references/solution-design.md +63 -63
  663. package/templates/repo/.github/skills/{ck-problem-solving → problem-solving}/SKILL.md +95 -95
  664. package/{skills/ck-problem-solving → templates/repo/.github/skills/problem-solving}/references/attribution.md +69 -69
  665. package/templates/repo/.github/skills/{ck-problem-solving → problem-solving}/references/collision-zone-thinking.md +79 -79
  666. package/{skills/ck-problem-solving → templates/repo/.github/skills/problem-solving}/references/inversion-exercise.md +91 -91
  667. package/templates/repo/.github/skills/{ck-problem-solving → problem-solving}/references/meta-pattern-recognition.md +87 -87
  668. package/templates/repo/.github/skills/{ck-problem-solving → problem-solving}/references/scale-game.md +95 -95
  669. package/templates/repo/.github/skills/{ck-problem-solving → problem-solving}/references/simplification-cascades.md +80 -80
  670. package/{skills/ck-problem-solving → templates/repo/.github/skills/problem-solving}/references/when-stuck.md +72 -72
  671. package/templates/repo/.github/skills/repomix/SKILL.md +247 -0
  672. package/templates/repo/.github/skills/repomix/references/configuration.md +211 -0
  673. package/templates/repo/.github/skills/repomix/references/usage-patterns.md +232 -0
  674. package/templates/repo/.github/skills/repomix/scripts/README.md +179 -0
  675. package/templates/repo/.github/skills/repomix/scripts/repomix_batch.py +455 -0
  676. package/templates/repo/.github/skills/repomix/scripts/repos.example.json +15 -0
  677. package/templates/repo/.github/skills/repomix/scripts/requirements.txt +15 -0
  678. package/templates/repo/.github/skills/research/SKILL.md +169 -0
  679. package/templates/repo/.github/skills/scout/SKILL.md +78 -0
  680. package/templates/repo/.github/skills/scout/references/external-scouting.md +140 -0
  681. package/templates/repo/.github/skills/scout/references/internal-scouting.md +119 -0
  682. package/templates/repo/.github/skills/{ck-sequential-thinking → sequential-thinking}/.env.example +8 -8
  683. package/templates/repo/.github/skills/{ck-sequential-thinking → sequential-thinking}/README.md +183 -183
  684. package/{skills/ck-sequential-thinking → templates/repo/.github/skills/sequential-thinking}/SKILL.md +92 -92
  685. package/templates/repo/.github/skills/{ck-sequential-thinking → sequential-thinking}/package.json +31 -31
  686. package/{skills/ck-sequential-thinking → templates/repo/.github/skills/sequential-thinking}/references/advanced-strategies.md +79 -79
  687. package/{skills/ck-sequential-thinking → templates/repo/.github/skills/sequential-thinking}/references/advanced-techniques.md +76 -76
  688. package/{skills/ck-sequential-thinking → templates/repo/.github/skills/sequential-thinking}/references/core-patterns.md +95 -95
  689. package/templates/repo/.github/skills/{ck-sequential-thinking → sequential-thinking}/references/examples-api.md +88 -88
  690. package/templates/repo/.github/skills/{ck-sequential-thinking → sequential-thinking}/references/examples-architecture.md +94 -94
  691. package/templates/repo/.github/skills/{ck-sequential-thinking → sequential-thinking}/references/examples-debug.md +90 -90
  692. package/templates/repo/.github/skills/{ck-sequential-thinking → sequential-thinking}/scripts/format-thought.js +159 -159
  693. package/{skills/ck-sequential-thinking → templates/repo/.github/skills/sequential-thinking}/scripts/process-thought.js +236 -236
  694. package/templates/repo/.github/skills/ui-styling/LICENSE.txt +202 -0
  695. package/templates/repo/.github/skills/ui-styling/SKILL.md +319 -0
  696. package/templates/repo/.github/skills/ui-styling/canvas-fonts/ArsenalSC-OFL.txt +93 -0
  697. package/templates/repo/.github/skills/ui-styling/canvas-fonts/ArsenalSC-Regular.ttf +0 -0
  698. package/templates/repo/.github/skills/ui-styling/canvas-fonts/BigShoulders-Bold.ttf +0 -0
  699. package/templates/repo/.github/skills/ui-styling/canvas-fonts/BigShoulders-OFL.txt +93 -0
  700. package/templates/repo/.github/skills/ui-styling/canvas-fonts/BigShoulders-Regular.ttf +0 -0
  701. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Boldonse-OFL.txt +93 -0
  702. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Boldonse-Regular.ttf +0 -0
  703. package/templates/repo/.github/skills/ui-styling/canvas-fonts/BricolageGrotesque-Bold.ttf +0 -0
  704. package/templates/repo/.github/skills/ui-styling/canvas-fonts/BricolageGrotesque-OFL.txt +93 -0
  705. package/templates/repo/.github/skills/ui-styling/canvas-fonts/BricolageGrotesque-Regular.ttf +0 -0
  706. package/templates/repo/.github/skills/ui-styling/canvas-fonts/CrimsonPro-Bold.ttf +0 -0
  707. package/templates/repo/.github/skills/ui-styling/canvas-fonts/CrimsonPro-Italic.ttf +0 -0
  708. package/templates/repo/.github/skills/ui-styling/canvas-fonts/CrimsonPro-OFL.txt +93 -0
  709. package/templates/repo/.github/skills/ui-styling/canvas-fonts/CrimsonPro-Regular.ttf +0 -0
  710. package/templates/repo/.github/skills/ui-styling/canvas-fonts/DMMono-OFL.txt +93 -0
  711. package/templates/repo/.github/skills/ui-styling/canvas-fonts/DMMono-Regular.ttf +0 -0
  712. package/templates/repo/.github/skills/ui-styling/canvas-fonts/EricaOne-OFL.txt +94 -0
  713. package/templates/repo/.github/skills/ui-styling/canvas-fonts/EricaOne-Regular.ttf +0 -0
  714. package/templates/repo/.github/skills/ui-styling/canvas-fonts/GeistMono-Bold.ttf +0 -0
  715. package/templates/repo/.github/skills/ui-styling/canvas-fonts/GeistMono-OFL.txt +93 -0
  716. package/templates/repo/.github/skills/ui-styling/canvas-fonts/GeistMono-Regular.ttf +0 -0
  717. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Gloock-OFL.txt +93 -0
  718. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Gloock-Regular.ttf +0 -0
  719. package/templates/repo/.github/skills/ui-styling/canvas-fonts/IBMPlexMono-Bold.ttf +0 -0
  720. package/templates/repo/.github/skills/ui-styling/canvas-fonts/IBMPlexMono-OFL.txt +93 -0
  721. package/templates/repo/.github/skills/ui-styling/canvas-fonts/IBMPlexMono-Regular.ttf +0 -0
  722. package/templates/repo/.github/skills/ui-styling/canvas-fonts/IBMPlexSerif-Bold.ttf +0 -0
  723. package/templates/repo/.github/skills/ui-styling/canvas-fonts/IBMPlexSerif-BoldItalic.ttf +0 -0
  724. package/templates/repo/.github/skills/ui-styling/canvas-fonts/IBMPlexSerif-Italic.ttf +0 -0
  725. package/templates/repo/.github/skills/ui-styling/canvas-fonts/IBMPlexSerif-Regular.ttf +0 -0
  726. package/templates/repo/.github/skills/ui-styling/canvas-fonts/InstrumentSans-Bold.ttf +0 -0
  727. package/templates/repo/.github/skills/ui-styling/canvas-fonts/InstrumentSans-BoldItalic.ttf +0 -0
  728. package/templates/repo/.github/skills/ui-styling/canvas-fonts/InstrumentSans-Italic.ttf +0 -0
  729. package/templates/repo/.github/skills/ui-styling/canvas-fonts/InstrumentSans-OFL.txt +93 -0
  730. package/templates/repo/.github/skills/ui-styling/canvas-fonts/InstrumentSans-Regular.ttf +0 -0
  731. package/templates/repo/.github/skills/ui-styling/canvas-fonts/InstrumentSerif-Italic.ttf +0 -0
  732. package/templates/repo/.github/skills/ui-styling/canvas-fonts/InstrumentSerif-Regular.ttf +0 -0
  733. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Italiana-OFL.txt +93 -0
  734. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Italiana-Regular.ttf +0 -0
  735. package/templates/repo/.github/skills/ui-styling/canvas-fonts/JetBrainsMono-Bold.ttf +0 -0
  736. package/templates/repo/.github/skills/ui-styling/canvas-fonts/JetBrainsMono-OFL.txt +93 -0
  737. package/templates/repo/.github/skills/ui-styling/canvas-fonts/JetBrainsMono-Regular.ttf +0 -0
  738. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Jura-Light.ttf +0 -0
  739. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Jura-Medium.ttf +0 -0
  740. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Jura-OFL.txt +93 -0
  741. package/templates/repo/.github/skills/ui-styling/canvas-fonts/LibreBaskerville-OFL.txt +93 -0
  742. package/templates/repo/.github/skills/ui-styling/canvas-fonts/LibreBaskerville-Regular.ttf +0 -0
  743. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Lora-Bold.ttf +0 -0
  744. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Lora-BoldItalic.ttf +0 -0
  745. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Lora-Italic.ttf +0 -0
  746. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Lora-OFL.txt +93 -0
  747. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Lora-Regular.ttf +0 -0
  748. package/templates/repo/.github/skills/ui-styling/canvas-fonts/NationalPark-Bold.ttf +0 -0
  749. package/templates/repo/.github/skills/ui-styling/canvas-fonts/NationalPark-OFL.txt +93 -0
  750. package/templates/repo/.github/skills/ui-styling/canvas-fonts/NationalPark-Regular.ttf +0 -0
  751. package/templates/repo/.github/skills/ui-styling/canvas-fonts/NothingYouCouldDo-OFL.txt +93 -0
  752. package/templates/repo/.github/skills/ui-styling/canvas-fonts/NothingYouCouldDo-Regular.ttf +0 -0
  753. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Outfit-Bold.ttf +0 -0
  754. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Outfit-OFL.txt +93 -0
  755. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Outfit-Regular.ttf +0 -0
  756. package/templates/repo/.github/skills/ui-styling/canvas-fonts/PixelifySans-Medium.ttf +0 -0
  757. package/templates/repo/.github/skills/ui-styling/canvas-fonts/PixelifySans-OFL.txt +93 -0
  758. package/templates/repo/.github/skills/ui-styling/canvas-fonts/PoiretOne-OFL.txt +93 -0
  759. package/templates/repo/.github/skills/ui-styling/canvas-fonts/PoiretOne-Regular.ttf +0 -0
  760. package/templates/repo/.github/skills/ui-styling/canvas-fonts/RedHatMono-Bold.ttf +0 -0
  761. package/templates/repo/.github/skills/ui-styling/canvas-fonts/RedHatMono-OFL.txt +93 -0
  762. package/templates/repo/.github/skills/ui-styling/canvas-fonts/RedHatMono-Regular.ttf +0 -0
  763. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Silkscreen-OFL.txt +93 -0
  764. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Silkscreen-Regular.ttf +0 -0
  765. package/templates/repo/.github/skills/ui-styling/canvas-fonts/SmoochSans-Medium.ttf +0 -0
  766. package/templates/repo/.github/skills/ui-styling/canvas-fonts/SmoochSans-OFL.txt +93 -0
  767. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Tektur-Medium.ttf +0 -0
  768. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Tektur-OFL.txt +93 -0
  769. package/templates/repo/.github/skills/ui-styling/canvas-fonts/Tektur-Regular.ttf +0 -0
  770. package/templates/repo/.github/skills/ui-styling/canvas-fonts/WorkSans-Bold.ttf +0 -0
  771. package/templates/repo/.github/skills/ui-styling/canvas-fonts/WorkSans-BoldItalic.ttf +0 -0
  772. package/templates/repo/.github/skills/ui-styling/canvas-fonts/WorkSans-Italic.ttf +0 -0
  773. package/templates/repo/.github/skills/ui-styling/canvas-fonts/WorkSans-OFL.txt +93 -0
  774. package/templates/repo/.github/skills/ui-styling/canvas-fonts/WorkSans-Regular.ttf +0 -0
  775. package/templates/repo/.github/skills/ui-styling/canvas-fonts/YoungSerif-OFL.txt +93 -0
  776. package/templates/repo/.github/skills/ui-styling/canvas-fonts/YoungSerif-Regular.ttf +0 -0
  777. package/templates/repo/.github/skills/ui-styling/references/canvas-design-system.md +320 -0
  778. package/templates/repo/.github/skills/ui-styling/references/shadcn-accessibility.md +471 -0
  779. package/templates/repo/.github/skills/ui-styling/references/shadcn-components.md +424 -0
  780. package/templates/repo/.github/skills/ui-styling/references/shadcn-theming.md +373 -0
  781. package/templates/repo/.github/skills/ui-styling/references/tailwind-customization.md +483 -0
  782. package/templates/repo/.github/skills/ui-styling/references/tailwind-responsive.md +382 -0
  783. package/templates/repo/.github/skills/ui-styling/references/tailwind-utilities.md +455 -0
  784. package/templates/repo/.github/skills/ui-styling/scripts/requirements.txt +17 -0
  785. package/templates/repo/.github/skills/ui-styling/scripts/shadcn_add.py +292 -0
  786. package/templates/repo/.github/skills/ui-styling/scripts/tailwind_config_gen.py +456 -0
  787. package/templates/repo/.github/skills/web-testing/SKILL.md +94 -0
  788. package/templates/repo/.github/skills/web-testing/references/accessibility-testing.md +84 -0
  789. package/templates/repo/.github/skills/web-testing/references/api-testing.md +78 -0
  790. package/templates/repo/.github/skills/web-testing/references/ci-cd-testing-workflows.md +121 -0
  791. package/templates/repo/.github/skills/web-testing/references/component-testing.md +94 -0
  792. package/templates/repo/.github/skills/web-testing/references/contract-testing.md +146 -0
  793. package/templates/repo/.github/skills/web-testing/references/cross-browser-checklist.md +72 -0
  794. package/templates/repo/.github/skills/web-testing/references/database-testing.md +139 -0
  795. package/templates/repo/.github/skills/web-testing/references/e2e-testing-playwright.md +119 -0
  796. package/templates/repo/.github/skills/web-testing/references/functional-testing-checklist.md +88 -0
  797. package/templates/repo/.github/skills/web-testing/references/interactive-testing-patterns.md +89 -0
  798. package/templates/repo/.github/skills/web-testing/references/load-testing-k6.md +93 -0
  799. package/templates/repo/.github/skills/web-testing/references/mobile-gesture-testing.md +85 -0
  800. package/templates/repo/.github/skills/web-testing/references/performance-core-web-vitals.md +124 -0
  801. package/templates/repo/.github/skills/web-testing/references/playwright-component-testing.md +115 -0
  802. package/templates/repo/.github/skills/web-testing/references/pre-release-checklist.md +75 -0
  803. package/templates/repo/.github/skills/web-testing/references/security-checklists.md +81 -0
  804. package/templates/repo/.github/skills/web-testing/references/security-testing-overview.md +92 -0
  805. package/templates/repo/.github/skills/web-testing/references/shadow-dom-testing.md +70 -0
  806. package/templates/repo/.github/skills/web-testing/references/test-data-management.md +131 -0
  807. package/templates/repo/.github/skills/web-testing/references/test-flakiness-mitigation.md +86 -0
  808. package/templates/repo/.github/skills/web-testing/references/testing-pyramid-strategy.md +76 -0
  809. package/templates/repo/.github/skills/web-testing/references/unit-integration-testing.md +138 -0
  810. package/templates/repo/.github/skills/web-testing/references/visual-regression.md +92 -0
  811. package/templates/repo/.github/skills/web-testing/references/vulnerability-payloads.md +93 -0
  812. package/templates/repo/.github/skills/web-testing/scripts/analyze-test-results.js +280 -0
  813. package/templates/repo/.github/skills/web-testing/scripts/init-playwright.js +233 -0
  814. package/templates/repo/.github/spec-kit/memory/constitution.md +50 -0
  815. package/templates/repo/.github/spec-kit/scripts/bash/check-prerequisites.sh +166 -0
  816. package/templates/repo/.github/spec-kit/scripts/bash/common.sh +156 -0
  817. package/templates/repo/.github/spec-kit/scripts/bash/create-new-feature.sh +297 -0
  818. package/templates/repo/.github/spec-kit/scripts/bash/setup-plan.sh +61 -0
  819. package/templates/repo/.github/spec-kit/scripts/bash/update-agent-context.sh +799 -0
  820. package/templates/repo/.github/spec-kit/scripts/powershell/check-prerequisites.ps1 +148 -0
  821. package/templates/repo/.github/spec-kit/scripts/powershell/common.ps1 +137 -0
  822. package/templates/repo/.github/spec-kit/scripts/powershell/create-new-feature.ps1 +283 -0
  823. package/templates/repo/.github/spec-kit/scripts/powershell/setup-plan.ps1 +61 -0
  824. package/templates/repo/.github/spec-kit/scripts/powershell/update-agent-context.ps1 +448 -0
  825. package/templates/repo/.github/spec-kit/templates/agent-file-template.md +28 -0
  826. package/templates/repo/.github/spec-kit/templates/checklist-template.md +40 -0
  827. package/templates/repo/.github/spec-kit/templates/commands/analyze.md +187 -0
  828. package/templates/repo/.github/spec-kit/templates/commands/checklist.md +297 -0
  829. package/templates/repo/.github/spec-kit/templates/commands/clarify.md +184 -0
  830. package/templates/repo/.github/spec-kit/templates/commands/constitution.md +82 -0
  831. package/templates/repo/.github/spec-kit/templates/commands/implement.md +138 -0
  832. package/templates/repo/.github/spec-kit/templates/commands/plan.md +95 -0
  833. package/templates/repo/.github/spec-kit/templates/commands/specify.md +261 -0
  834. package/templates/repo/.github/spec-kit/templates/commands/tasks.md +140 -0
  835. package/templates/repo/.github/spec-kit/templates/commands/taskstoissues.md +33 -0
  836. package/templates/repo/.github/spec-kit/templates/plan-template.md +104 -0
  837. package/templates/repo/.github/spec-kit/templates/spec-template.md +115 -0
  838. package/templates/repo/.github/spec-kit/templates/tasks-phase-template.md +42 -0
  839. package/templates/repo/.github/spec-kit/templates/tasks-template.md +268 -0
  840. package/templates/repo/.github/spec-kit/templates/vscode-settings.json +14 -0
  841. package/templates/repo/.vscode/settings.json +70 -70
  842. package/.vscode/settings.json +0 -70
  843. package/AGENTS.md +0 -103
  844. package/FAQ.md +0 -101
  845. package/INIT.md +0 -154
  846. package/QUICK-START.md +0 -37
  847. package/changelogs/1.0.8.md +0 -77
  848. package/changelogs/1.0.9.md +0 -173
  849. package/plans/reports/docs-manager-260120-0854-documentation-update.md +0 -323
  850. package/prompts/ck-code.prompt.md +0 -178
  851. package/repomix-output.xml +0 -40725
  852. package/rules/README.agents.md +0 -55
  853. package/rules/README.collections.md +0 -78
  854. package/rules/README.copilot-instructions.md +0 -66
  855. package/rules/README.instructions.md +0 -73
  856. package/rules/README.md +0 -39
  857. package/rules/README.prompts.md +0 -76
  858. package/rules/README.skills.md +0 -71
  859. package/skills/ck-frontend-development/SKILL.md +0 -399
  860. package/skills/ck-frontend-development/resources/common-patterns.md +0 -331
  861. package/skills/ck-frontend-development/resources/complete-examples.md +0 -872
  862. package/skills/ck-frontend-development/resources/component-patterns.md +0 -502
  863. package/skills/ck-frontend-development/resources/data-fetching.md +0 -767
  864. package/skills/ck-frontend-development/resources/file-organization.md +0 -502
  865. package/skills/ck-frontend-development/resources/loading-and-error-states.md +0 -501
  866. package/skills/ck-frontend-development/resources/performance.md +0 -406
  867. package/skills/ck-frontend-development/resources/routing-guide.md +0 -364
  868. package/skills/ck-frontend-development/resources/styling-guide.md +0 -428
  869. package/skills/ck-frontend-development/resources/typescript-standards.md +0 -418
  870. package/skills/ck-sequential-thinking/tests/format-thought.test.js +0 -133
  871. package/skills/ck-sequential-thinking/tests/process-thought.test.js +0 -215
  872. package/templates/repo/.github/.cokit-version +0 -4
  873. package/templates/repo/.github/copilot-instructions.md +0 -45
  874. package/templates/repo/.github/prompts/ck-code.prompt.md +0 -178
  875. package/templates/repo/.github/skills/ck-frontend-development/SKILL.md +0 -399
  876. package/templates/repo/.github/skills/ck-frontend-development/resources/common-patterns.md +0 -331
  877. package/templates/repo/.github/skills/ck-frontend-development/resources/complete-examples.md +0 -872
  878. package/templates/repo/.github/skills/ck-frontend-development/resources/component-patterns.md +0 -502
  879. package/templates/repo/.github/skills/ck-frontend-development/resources/data-fetching.md +0 -767
  880. package/templates/repo/.github/skills/ck-frontend-development/resources/file-organization.md +0 -502
  881. package/templates/repo/.github/skills/ck-frontend-development/resources/loading-and-error-states.md +0 -501
  882. package/templates/repo/.github/skills/ck-frontend-development/resources/performance.md +0 -406
  883. package/templates/repo/.github/skills/ck-frontend-development/resources/routing-guide.md +0 -364
  884. package/templates/repo/.github/skills/ck-frontend-development/resources/styling-guide.md +0 -428
  885. package/templates/repo/.github/skills/ck-frontend-development/resources/typescript-standards.md +0 -418
  886. package/templates/repo/.github/skills/ck-sequential-thinking/tests/format-thought.test.js +0 -133
  887. package/templates/repo/.github/skills/ck-sequential-thinking/tests/process-thought.test.js +0 -215
  888. /package/skills/{ck-code-review → code-review}/references/verification-before-completion.md +0 -0
@@ -1,494 +1,494 @@
1
- # Backend DevOps Practices
2
-
3
- CI/CD pipelines, containerization, deployment strategies, and monitoring (2025).
4
-
5
- ## Deployment Strategies
6
-
7
- ### Blue-Green Deployment
8
-
9
- **Concept:** Two identical environments (Blue = current, Green = new)
10
-
11
- ```
12
- Production Traffic → Blue (v1.0)
13
- Green (v2.0) ← Deploy & Test
14
-
15
- Switch:
16
- Production Traffic → Green (v2.0)
17
- Blue (v1.0) ← Instant rollback available
18
- ```
19
-
20
- **Pros:**
21
- - Zero downtime
22
- - Instant rollback
23
- - Full environment testing before switch
24
-
25
- **Cons:**
26
- - Requires double infrastructure
27
- - Database migrations complex
28
-
29
- ### Canary Deployment
30
-
31
- **Concept:** Gradual rollout (1% → 5% → 25% → 100%)
32
-
33
- ```bash
34
- # Kubernetes canary deployment
35
- kubectl set image deployment/api api=myapp:v2
36
- kubectl rollout pause deployment/api # Pause at initial replicas
37
-
38
- # Monitor metrics, then continue
39
- kubectl rollout resume deployment/api
40
- ```
41
-
42
- **Pros:**
43
- - Risk mitigation
44
- - Early issue detection
45
- - Real user feedback
46
-
47
- **Cons:**
48
- - Requires monitoring
49
- - Longer deployment time
50
-
51
- ### Feature Flags (Progressive Delivery)
52
-
53
- **Impact:** 90% fewer deployment failures when combined with canary
54
-
55
- ```typescript
56
- import { LaunchDarkly } from 'launchdarkly-node-server-sdk';
57
-
58
- const client = LaunchDarkly.init(process.env.LD_SDK_KEY);
59
-
60
- // Check feature flag
61
- const showNewCheckout = await client.variation('new-checkout', user, false);
62
-
63
- if (showNewCheckout) {
64
- return newCheckoutFlow(req, res);
65
- } else {
66
- return oldCheckoutFlow(req, res);
67
- }
68
- ```
69
-
70
- **Use Cases:**
71
- - Gradual feature rollout
72
- - A/B testing
73
- - Kill switch for problematic features
74
- - Decouple deployment from release
75
-
76
- ## Containerization with Docker
77
-
78
- ### Multi-Stage Builds (Optimize Image Size)
79
-
80
- ```dockerfile
81
- # Build stage
82
- FROM node:20-alpine AS builder
83
- WORKDIR /app
84
- COPY package*.json ./
85
- RUN npm ci --only=production
86
- COPY . .
87
- RUN npm run build
88
-
89
- # Production stage
90
- FROM node:20-alpine
91
- WORKDIR /app
92
-
93
- # Copy only necessary files
94
- COPY --from=builder /app/dist ./dist
95
- COPY --from=builder /app/node_modules ./node_modules
96
- COPY package.json ./
97
-
98
- # Security: Run as non-root
99
- RUN addgroup -g 1001 -S nodejs && \
100
- adduser -S nodejs -u 1001
101
- USER nodejs
102
-
103
- EXPOSE 3000
104
- CMD ["node", "dist/main.js"]
105
- ```
106
-
107
- **Benefits:**
108
- - Smaller image size (50-90% reduction)
109
- - Faster deployments
110
- - Reduced attack surface
111
-
112
- ### Docker Compose (Local Development)
113
-
114
- ```yaml
115
- version: '3.8'
116
-
117
- services:
118
- api:
119
- build: .
120
- ports:
121
- - "3000:3000"
122
- environment:
123
- - DATABASE_URL=postgresql://postgres:password@db:5432/myapp
124
- - REDIS_URL=redis://redis:6379
125
- depends_on:
126
- - db
127
- - redis
128
-
129
- db:
130
- image: postgres:15-alpine
131
- environment:
132
- - POSTGRES_PASSWORD=password
133
- - POSTGRES_DB=myapp
134
- volumes:
135
- - postgres-data:/var/lib/postgresql/data
136
-
137
- redis:
138
- image: redis:7-alpine
139
- ports:
140
- - "6379:6379"
141
-
142
- volumes:
143
- postgres-data:
144
- ```
145
-
146
- ## Kubernetes Orchestration
147
-
148
- ### Deployment Manifest
149
-
150
- ```yaml
151
- apiVersion: apps/v1
152
- kind: Deployment
153
- metadata:
154
- name: api-deployment
155
- spec:
156
- replicas: 3
157
- selector:
158
- matchLabels:
159
- app: api
160
- template:
161
- metadata:
162
- labels:
163
- app: api
164
- spec:
165
- containers:
166
- - name: api
167
- image: myregistry/api:v1.0.0
168
- ports:
169
- - containerPort: 3000
170
- env:
171
- - name: DATABASE_URL
172
- valueFrom:
173
- secretKeyRef:
174
- name: db-secret
175
- key: url
176
- resources:
177
- requests:
178
- memory: "256Mi"
179
- cpu: "250m"
180
- limits:
181
- memory: "512Mi"
182
- cpu: "500m"
183
- livenessProbe:
184
- httpGet:
185
- path: /health
186
- port: 3000
187
- initialDelaySeconds: 30
188
- periodSeconds: 10
189
- readinessProbe:
190
- httpGet:
191
- path: /ready
192
- port: 3000
193
- initialDelaySeconds: 5
194
- periodSeconds: 5
195
- ```
196
-
197
- ### Horizontal Pod Autoscaling
198
-
199
- ```yaml
200
- apiVersion: autoscaling/v2
201
- kind: HorizontalPodAutoscaler
202
- metadata:
203
- name: api-hpa
204
- spec:
205
- scaleTargetRef:
206
- apiVersion: apps/v1
207
- kind: Deployment
208
- name: api-deployment
209
- minReplicas: 3
210
- maxReplicas: 10
211
- metrics:
212
- - type: Resource
213
- resource:
214
- name: cpu
215
- target:
216
- type: Utilization
217
- averageUtilization: 70
218
- ```
219
-
220
- ## CI/CD Pipelines
221
-
222
- ### GitHub Actions (Modern, Integrated)
223
-
224
- ```yaml
225
- name: CI/CD Pipeline
226
-
227
- on:
228
- push:
229
- branches: [main]
230
- pull_request:
231
- branches: [main]
232
-
233
- jobs:
234
- test:
235
- runs-on: ubuntu-latest
236
- steps:
237
- - uses: actions/checkout@v3
238
-
239
- - name: Setup Node.js
240
- uses: actions/setup-node@v3
241
- with:
242
- node-version: '20'
243
- cache: 'npm'
244
-
245
- - name: Install dependencies
246
- run: npm ci
247
-
248
- - name: Run linter
249
- run: npm run lint
250
-
251
- - name: Run tests
252
- run: npm run test:ci
253
-
254
- - name: Upload coverage
255
- uses: codecov/codecov-action@v3
256
-
257
- security:
258
- runs-on: ubuntu-latest
259
- steps:
260
- - uses: actions/checkout@v3
261
-
262
- - name: Run Snyk scan
263
- uses: snyk/actions/node@master
264
- env:
265
- SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
266
-
267
- - name: Container scan
268
- run: |
269
- docker build -t myapp:${{ github.sha }} .
270
- docker scan myapp:${{ github.sha }}
271
-
272
- deploy:
273
- needs: [test, security]
274
- runs-on: ubuntu-latest
275
- if: github.ref == 'refs/heads/main'
276
- steps:
277
- - uses: actions/checkout@v3
278
-
279
- - name: Build and push Docker image
280
- run: |
281
- echo ${{ secrets.GITHUB_TOKEN }} | docker login ghcr.io -u ${{ github.actor }} --password-stdin
282
- docker build -t ghcr.io/${{ github.repository }}:${{ github.sha }} .
283
- docker push ghcr.io/${{ github.repository }}:${{ github.sha }}
284
-
285
- - name: Deploy to Kubernetes
286
- run: |
287
- kubectl set image deployment/api api=ghcr.io/${{ github.repository }}:${{ github.sha }}
288
- kubectl rollout status deployment/api
289
- ```
290
-
291
- ## Monitoring & Observability
292
-
293
- ### Three Pillars of Observability
294
-
295
- **1. Metrics (Prometheus + Grafana)**
296
-
297
- ```typescript
298
- import { Counter, Histogram, register } from 'prom-client';
299
-
300
- // Request counter
301
- const httpRequestTotal = new Counter({
302
- name: 'http_requests_total',
303
- help: 'Total HTTP requests',
304
- labelNames: ['method', 'route', 'status'],
305
- });
306
-
307
- // Response time histogram
308
- const httpRequestDuration = new Histogram({
309
- name: 'http_request_duration_seconds',
310
- help: 'HTTP request duration',
311
- labelNames: ['method', 'route'],
312
- buckets: [0.1, 0.5, 1, 2, 5],
313
- });
314
-
315
- // Middleware to track metrics
316
- app.use((req, res, next) => {
317
- const start = Date.now();
318
-
319
- res.on('finish', () => {
320
- const duration = (Date.now() - start) / 1000;
321
- httpRequestTotal.inc({ method: req.method, route: req.route?.path, status: res.statusCode });
322
- httpRequestDuration.observe({ method: req.method, route: req.route?.path }, duration);
323
- });
324
-
325
- next();
326
- });
327
-
328
- // Metrics endpoint
329
- app.get('/metrics', async (req, res) => {
330
- res.set('Content-Type', register.contentType);
331
- res.end(await register.metrics());
332
- });
333
- ```
334
-
335
- **2. Logs (ELK Stack - Elasticsearch, Logstash, Kibana)**
336
-
337
- ```typescript
338
- import winston from 'winston';
339
- import { ElasticsearchTransport } from 'winston-elasticsearch';
340
-
341
- const logger = winston.createLogger({
342
- level: 'info',
343
- format: winston.format.json(),
344
- transports: [
345
- new winston.transports.Console(),
346
- new ElasticsearchTransport({
347
- level: 'info',
348
- clientOpts: { node: 'http://localhost:9200' },
349
- index: 'logs',
350
- }),
351
- ],
352
- });
353
-
354
- // Structured logging
355
- logger.info('User created', {
356
- userId: user.id,
357
- email: user.email,
358
- ipAddress: req.ip,
359
- userAgent: req.headers['user-agent'],
360
- });
361
- ```
362
-
363
- **3. Traces (Jaeger/OpenTelemetry)**
364
-
365
- ```typescript
366
- import { NodeSDK } from '@opentelemetry/sdk-node';
367
- import { JaegerExporter } from '@opentelemetry/exporter-jaeger';
368
-
369
- const sdk = new NodeSDK({
370
- traceExporter: new JaegerExporter({
371
- endpoint: 'http://localhost:14268/api/traces',
372
- }),
373
- serviceName: 'api-service',
374
- });
375
-
376
- sdk.start();
377
-
378
- // Traces automatically captured for HTTP requests, database queries, etc.
379
- ```
380
-
381
- ### Health Checks
382
-
383
- ```typescript
384
- // Liveness probe - Is the app running?
385
- app.get('/health/liveness', (req, res) => {
386
- res.status(200).json({ status: 'ok', timestamp: Date.now() });
387
- });
388
-
389
- // Readiness probe - Is the app ready to serve traffic?
390
- app.get('/health/readiness', async (req, res) => {
391
- const checks = {
392
- database: await checkDatabase(),
393
- redis: await checkRedis(),
394
- externalAPI: await checkExternalAPI(),
395
- };
396
-
397
- const isReady = Object.values(checks).every(Boolean);
398
- res.status(isReady ? 200 : 503).json({
399
- status: isReady ? 'ready' : 'not ready',
400
- checks,
401
- });
402
- });
403
-
404
- async function checkDatabase() {
405
- try {
406
- await db.query('SELECT 1');
407
- return true;
408
- } catch {
409
- return false;
410
- }
411
- }
412
- ```
413
-
414
- ## Secrets Management
415
-
416
- ### HashiCorp Vault
417
-
418
- ```bash
419
- # Store secret
420
- vault kv put secret/myapp/db password=super-secret
421
-
422
- # Retrieve secret
423
- vault kv get -field=password secret/myapp/db
424
- ```
425
-
426
- ### Kubernetes Secrets
427
-
428
- ```yaml
429
- apiVersion: v1
430
- kind: Secret
431
- metadata:
432
- name: db-secret
433
- type: Opaque
434
- stringData:
435
- url: postgresql://user:pass@host:5432/db
436
- ---
437
- # Reference in deployment
438
- env:
439
- - name: DATABASE_URL
440
- valueFrom:
441
- secretKeyRef:
442
- name: db-secret
443
- key: url
444
- ```
445
-
446
- ## Infrastructure as Code (Terraform)
447
-
448
- ```hcl
449
- # main.tf
450
- resource "aws_db_instance" "main" {
451
- identifier = "myapp-db"
452
- engine = "postgres"
453
- engine_version = "15.3"
454
- instance_class = "db.t3.micro"
455
- allocated_storage = 20
456
- username = "admin"
457
- password = var.db_password
458
-
459
- backup_retention_period = 7
460
- skip_final_snapshot = false
461
- }
462
-
463
- resource "aws_elasticache_cluster" "redis" {
464
- cluster_id = "myapp-redis"
465
- engine = "redis"
466
- node_type = "cache.t3.micro"
467
- num_cache_nodes = 1
468
- parameter_group_name = "default.redis7"
469
- }
470
- ```
471
-
472
- ## DevOps Checklist
473
-
474
- - [ ] CI/CD pipeline configured (GitHub Actions/GitLab CI/Jenkins)
475
- - [ ] Docker multi-stage builds implemented
476
- - [ ] Kubernetes deployment manifests created
477
- - [ ] Blue-green or canary deployment strategy
478
- - [ ] Feature flags configured (LaunchDarkly/Unleash)
479
- - [ ] Health checks (liveness + readiness probes)
480
- - [ ] Monitoring: Prometheus + Grafana
481
- - [ ] Logging: ELK Stack or similar
482
- - [ ] Distributed tracing: Jaeger/OpenTelemetry
483
- - [ ] Secrets management (Vault/AWS Secrets Manager)
484
- - [ ] Infrastructure as Code (Terraform/CloudFormation)
485
- - [ ] Autoscaling configured
486
- - [ ] Backup and disaster recovery plan
487
-
488
- ## Resources
489
-
490
- - **Kubernetes:** https://kubernetes.io/docs/
491
- - **Docker:** https://docs.docker.com/
492
- - **Prometheus:** https://prometheus.io/docs/
493
- - **OpenTelemetry:** https://opentelemetry.io/docs/
494
- - **Terraform:** https://www.terraform.io/docs/
1
+ # Backend DevOps Practices
2
+
3
+ CI/CD pipelines, containerization, deployment strategies, and monitoring (2025).
4
+
5
+ ## Deployment Strategies
6
+
7
+ ### Blue-Green Deployment
8
+
9
+ **Concept:** Two identical environments (Blue = current, Green = new)
10
+
11
+ ```
12
+ Production Traffic → Blue (v1.0)
13
+ Green (v2.0) ← Deploy & Test
14
+
15
+ Switch:
16
+ Production Traffic → Green (v2.0)
17
+ Blue (v1.0) ← Instant rollback available
18
+ ```
19
+
20
+ **Pros:**
21
+ - Zero downtime
22
+ - Instant rollback
23
+ - Full environment testing before switch
24
+
25
+ **Cons:**
26
+ - Requires double infrastructure
27
+ - Database migrations complex
28
+
29
+ ### Canary Deployment
30
+
31
+ **Concept:** Gradual rollout (1% → 5% → 25% → 100%)
32
+
33
+ ```bash
34
+ # Kubernetes canary deployment
35
+ kubectl set image deployment/api api=myapp:v2
36
+ kubectl rollout pause deployment/api # Pause at initial replicas
37
+
38
+ # Monitor metrics, then continue
39
+ kubectl rollout resume deployment/api
40
+ ```
41
+
42
+ **Pros:**
43
+ - Risk mitigation
44
+ - Early issue detection
45
+ - Real user feedback
46
+
47
+ **Cons:**
48
+ - Requires monitoring
49
+ - Longer deployment time
50
+
51
+ ### Feature Flags (Progressive Delivery)
52
+
53
+ **Impact:** 90% fewer deployment failures when combined with canary
54
+
55
+ ```typescript
56
+ import { LaunchDarkly } from 'launchdarkly-node-server-sdk';
57
+
58
+ const client = LaunchDarkly.init(process.env.LD_SDK_KEY);
59
+
60
+ // Check feature flag
61
+ const showNewCheckout = await client.variation('new-checkout', user, false);
62
+
63
+ if (showNewCheckout) {
64
+ return newCheckoutFlow(req, res);
65
+ } else {
66
+ return oldCheckoutFlow(req, res);
67
+ }
68
+ ```
69
+
70
+ **Use Cases:**
71
+ - Gradual feature rollout
72
+ - A/B testing
73
+ - Kill switch for problematic features
74
+ - Decouple deployment from release
75
+
76
+ ## Containerization with Docker
77
+
78
+ ### Multi-Stage Builds (Optimize Image Size)
79
+
80
+ ```dockerfile
81
+ # Build stage
82
+ FROM node:20-alpine AS builder
83
+ WORKDIR /app
84
+ COPY package*.json ./
85
+ RUN npm ci --only=production
86
+ COPY . .
87
+ RUN npm run build
88
+
89
+ # Production stage
90
+ FROM node:20-alpine
91
+ WORKDIR /app
92
+
93
+ # Copy only necessary files
94
+ COPY --from=builder /app/dist ./dist
95
+ COPY --from=builder /app/node_modules ./node_modules
96
+ COPY package.json ./
97
+
98
+ # Security: Run as non-root
99
+ RUN addgroup -g 1001 -S nodejs && \
100
+ adduser -S nodejs -u 1001
101
+ USER nodejs
102
+
103
+ EXPOSE 3000
104
+ CMD ["node", "dist/main.js"]
105
+ ```
106
+
107
+ **Benefits:**
108
+ - Smaller image size (50-90% reduction)
109
+ - Faster deployments
110
+ - Reduced attack surface
111
+
112
+ ### Docker Compose (Local Development)
113
+
114
+ ```yaml
115
+ version: '3.8'
116
+
117
+ services:
118
+ api:
119
+ build: .
120
+ ports:
121
+ - "3000:3000"
122
+ environment:
123
+ - DATABASE_URL=postgresql://postgres:password@db:5432/myapp
124
+ - REDIS_URL=redis://redis:6379
125
+ depends_on:
126
+ - db
127
+ - redis
128
+
129
+ db:
130
+ image: postgres:15-alpine
131
+ environment:
132
+ - POSTGRES_PASSWORD=password
133
+ - POSTGRES_DB=myapp
134
+ volumes:
135
+ - postgres-data:/var/lib/postgresql/data
136
+
137
+ redis:
138
+ image: redis:7-alpine
139
+ ports:
140
+ - "6379:6379"
141
+
142
+ volumes:
143
+ postgres-data:
144
+ ```
145
+
146
+ ## Kubernetes Orchestration
147
+
148
+ ### Deployment Manifest
149
+
150
+ ```yaml
151
+ apiVersion: apps/v1
152
+ kind: Deployment
153
+ metadata:
154
+ name: api-deployment
155
+ spec:
156
+ replicas: 3
157
+ selector:
158
+ matchLabels:
159
+ app: api
160
+ template:
161
+ metadata:
162
+ labels:
163
+ app: api
164
+ spec:
165
+ containers:
166
+ - name: api
167
+ image: myregistry/api:v1.0.0
168
+ ports:
169
+ - containerPort: 3000
170
+ env:
171
+ - name: DATABASE_URL
172
+ valueFrom:
173
+ secretKeyRef:
174
+ name: db-secret
175
+ key: url
176
+ resources:
177
+ requests:
178
+ memory: "256Mi"
179
+ cpu: "250m"
180
+ limits:
181
+ memory: "512Mi"
182
+ cpu: "500m"
183
+ livenessProbe:
184
+ httpGet:
185
+ path: /health
186
+ port: 3000
187
+ initialDelaySeconds: 30
188
+ periodSeconds: 10
189
+ readinessProbe:
190
+ httpGet:
191
+ path: /ready
192
+ port: 3000
193
+ initialDelaySeconds: 5
194
+ periodSeconds: 5
195
+ ```
196
+
197
+ ### Horizontal Pod Autoscaling
198
+
199
+ ```yaml
200
+ apiVersion: autoscaling/v2
201
+ kind: HorizontalPodAutoscaler
202
+ metadata:
203
+ name: api-hpa
204
+ spec:
205
+ scaleTargetRef:
206
+ apiVersion: apps/v1
207
+ kind: Deployment
208
+ name: api-deployment
209
+ minReplicas: 3
210
+ maxReplicas: 10
211
+ metrics:
212
+ - type: Resource
213
+ resource:
214
+ name: cpu
215
+ target:
216
+ type: Utilization
217
+ averageUtilization: 70
218
+ ```
219
+
220
+ ## CI/CD Pipelines
221
+
222
+ ### GitHub Actions (Modern, Integrated)
223
+
224
+ ```yaml
225
+ name: CI/CD Pipeline
226
+
227
+ on:
228
+ push:
229
+ branches: [main]
230
+ pull_request:
231
+ branches: [main]
232
+
233
+ jobs:
234
+ test:
235
+ runs-on: ubuntu-latest
236
+ steps:
237
+ - uses: actions/checkout@v3
238
+
239
+ - name: Setup Node.js
240
+ uses: actions/setup-node@v3
241
+ with:
242
+ node-version: '20'
243
+ cache: 'npm'
244
+
245
+ - name: Install dependencies
246
+ run: npm ci
247
+
248
+ - name: Run linter
249
+ run: npm run lint
250
+
251
+ - name: Run tests
252
+ run: npm run test:ci
253
+
254
+ - name: Upload coverage
255
+ uses: codecov/codecov-action@v3
256
+
257
+ security:
258
+ runs-on: ubuntu-latest
259
+ steps:
260
+ - uses: actions/checkout@v3
261
+
262
+ - name: Run Snyk scan
263
+ uses: snyk/actions/node@master
264
+ env:
265
+ SNYK_TOKEN: ${{ secrets.SNYK_TOKEN }}
266
+
267
+ - name: Container scan
268
+ run: |
269
+ docker build -t myapp:${{ github.sha }} .
270
+ docker scan myapp:${{ github.sha }}
271
+
272
+ deploy:
273
+ needs: [test, security]
274
+ runs-on: ubuntu-latest
275
+ if: github.ref == 'refs/heads/main'
276
+ steps:
277
+ - uses: actions/checkout@v3
278
+
279
+ - name: Build and push Docker image
280
+ run: |
281
+ echo ${{ secrets.GITHUB_TOKEN }} | docker login ghcr.io -u ${{ github.actor }} --password-stdin
282
+ docker build -t ghcr.io/${{ github.repository }}:${{ github.sha }} .
283
+ docker push ghcr.io/${{ github.repository }}:${{ github.sha }}
284
+
285
+ - name: Deploy to Kubernetes
286
+ run: |
287
+ kubectl set image deployment/api api=ghcr.io/${{ github.repository }}:${{ github.sha }}
288
+ kubectl rollout status deployment/api
289
+ ```
290
+
291
+ ## Monitoring & Observability
292
+
293
+ ### Three Pillars of Observability
294
+
295
+ **1. Metrics (Prometheus + Grafana)**
296
+
297
+ ```typescript
298
+ import { Counter, Histogram, register } from 'prom-client';
299
+
300
+ // Request counter
301
+ const httpRequestTotal = new Counter({
302
+ name: 'http_requests_total',
303
+ help: 'Total HTTP requests',
304
+ labelNames: ['method', 'route', 'status'],
305
+ });
306
+
307
+ // Response time histogram
308
+ const httpRequestDuration = new Histogram({
309
+ name: 'http_request_duration_seconds',
310
+ help: 'HTTP request duration',
311
+ labelNames: ['method', 'route'],
312
+ buckets: [0.1, 0.5, 1, 2, 5],
313
+ });
314
+
315
+ // Middleware to track metrics
316
+ app.use((req, res, next) => {
317
+ const start = Date.now();
318
+
319
+ res.on('finish', () => {
320
+ const duration = (Date.now() - start) / 1000;
321
+ httpRequestTotal.inc({ method: req.method, route: req.route?.path, status: res.statusCode });
322
+ httpRequestDuration.observe({ method: req.method, route: req.route?.path }, duration);
323
+ });
324
+
325
+ next();
326
+ });
327
+
328
+ // Metrics endpoint
329
+ app.get('/metrics', async (req, res) => {
330
+ res.set('Content-Type', register.contentType);
331
+ res.end(await register.metrics());
332
+ });
333
+ ```
334
+
335
+ **2. Logs (ELK Stack - Elasticsearch, Logstash, Kibana)**
336
+
337
+ ```typescript
338
+ import winston from 'winston';
339
+ import { ElasticsearchTransport } from 'winston-elasticsearch';
340
+
341
+ const logger = winston.createLogger({
342
+ level: 'info',
343
+ format: winston.format.json(),
344
+ transports: [
345
+ new winston.transports.Console(),
346
+ new ElasticsearchTransport({
347
+ level: 'info',
348
+ clientOpts: { node: 'http://localhost:9200' },
349
+ index: 'logs',
350
+ }),
351
+ ],
352
+ });
353
+
354
+ // Structured logging
355
+ logger.info('User created', {
356
+ userId: user.id,
357
+ email: user.email,
358
+ ipAddress: req.ip,
359
+ userAgent: req.headers['user-agent'],
360
+ });
361
+ ```
362
+
363
+ **3. Traces (Jaeger/OpenTelemetry)**
364
+
365
+ ```typescript
366
+ import { NodeSDK } from '@opentelemetry/sdk-node';
367
+ import { JaegerExporter } from '@opentelemetry/exporter-jaeger';
368
+
369
+ const sdk = new NodeSDK({
370
+ traceExporter: new JaegerExporter({
371
+ endpoint: 'http://localhost:14268/api/traces',
372
+ }),
373
+ serviceName: 'api-service',
374
+ });
375
+
376
+ sdk.start();
377
+
378
+ // Traces automatically captured for HTTP requests, database queries, etc.
379
+ ```
380
+
381
+ ### Health Checks
382
+
383
+ ```typescript
384
+ // Liveness probe - Is the app running?
385
+ app.get('/health/liveness', (req, res) => {
386
+ res.status(200).json({ status: 'ok', timestamp: Date.now() });
387
+ });
388
+
389
+ // Readiness probe - Is the app ready to serve traffic?
390
+ app.get('/health/readiness', async (req, res) => {
391
+ const checks = {
392
+ database: await checkDatabase(),
393
+ redis: await checkRedis(),
394
+ externalAPI: await checkExternalAPI(),
395
+ };
396
+
397
+ const isReady = Object.values(checks).every(Boolean);
398
+ res.status(isReady ? 200 : 503).json({
399
+ status: isReady ? 'ready' : 'not ready',
400
+ checks,
401
+ });
402
+ });
403
+
404
+ async function checkDatabase() {
405
+ try {
406
+ await db.query('SELECT 1');
407
+ return true;
408
+ } catch {
409
+ return false;
410
+ }
411
+ }
412
+ ```
413
+
414
+ ## Secrets Management
415
+
416
+ ### HashiCorp Vault
417
+
418
+ ```bash
419
+ # Store secret
420
+ vault kv put secret/myapp/db password=super-secret
421
+
422
+ # Retrieve secret
423
+ vault kv get -field=password secret/myapp/db
424
+ ```
425
+
426
+ ### Kubernetes Secrets
427
+
428
+ ```yaml
429
+ apiVersion: v1
430
+ kind: Secret
431
+ metadata:
432
+ name: db-secret
433
+ type: Opaque
434
+ stringData:
435
+ url: postgresql://user:pass@host:5432/db
436
+ ---
437
+ # Reference in deployment
438
+ env:
439
+ - name: DATABASE_URL
440
+ valueFrom:
441
+ secretKeyRef:
442
+ name: db-secret
443
+ key: url
444
+ ```
445
+
446
+ ## Infrastructure as Code (Terraform)
447
+
448
+ ```hcl
449
+ # main.tf
450
+ resource "aws_db_instance" "main" {
451
+ identifier = "myapp-db"
452
+ engine = "postgres"
453
+ engine_version = "15.3"
454
+ instance_class = "db.t3.micro"
455
+ allocated_storage = 20
456
+ username = "admin"
457
+ password = var.db_password
458
+
459
+ backup_retention_period = 7
460
+ skip_final_snapshot = false
461
+ }
462
+
463
+ resource "aws_elasticache_cluster" "redis" {
464
+ cluster_id = "myapp-redis"
465
+ engine = "redis"
466
+ node_type = "cache.t3.micro"
467
+ num_cache_nodes = 1
468
+ parameter_group_name = "default.redis7"
469
+ }
470
+ ```
471
+
472
+ ## DevOps Checklist
473
+
474
+ - [ ] CI/CD pipeline configured (GitHub Actions/GitLab CI/Jenkins)
475
+ - [ ] Docker multi-stage builds implemented
476
+ - [ ] Kubernetes deployment manifests created
477
+ - [ ] Blue-green or canary deployment strategy
478
+ - [ ] Feature flags configured (LaunchDarkly/Unleash)
479
+ - [ ] Health checks (liveness + readiness probes)
480
+ - [ ] Monitoring: Prometheus + Grafana
481
+ - [ ] Logging: ELK Stack or similar
482
+ - [ ] Distributed tracing: Jaeger/OpenTelemetry
483
+ - [ ] Secrets management (Vault/AWS Secrets Manager)
484
+ - [ ] Infrastructure as Code (Terraform/CloudFormation)
485
+ - [ ] Autoscaling configured
486
+ - [ ] Backup and disaster recovery plan
487
+
488
+ ## Resources
489
+
490
+ - **Kubernetes:** https://kubernetes.io/docs/
491
+ - **Docker:** https://docs.docker.com/
492
+ - **Prometheus:** https://prometheus.io/docs/
493
+ - **OpenTelemetry:** https://opentelemetry.io/docs/
494
+ - **Terraform:** https://www.terraform.io/docs/