@trieungoctam/vibekit 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (352) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +85 -0
  3. package/agents/debugger.md +158 -0
  4. package/agents/docs-manager.md +220 -0
  5. package/agents/planner.md +129 -0
  6. package/agents/researcher.md +58 -0
  7. package/agents/reviewer.md +152 -0
  8. package/agents/tester.md +126 -0
  9. package/bin/vibekit.js +18 -0
  10. package/hooks/lib/ck-config-utils.cjs +831 -0
  11. package/hooks/lib/colors.cjs +95 -0
  12. package/hooks/lib/config-counter.cjs +103 -0
  13. package/hooks/lib/context-builder.cjs +616 -0
  14. package/hooks/lib/git-info-cache.cjs +143 -0
  15. package/hooks/lib/hook-logger.cjs +92 -0
  16. package/hooks/lib/privacy-checker.cjs +297 -0
  17. package/hooks/lib/project-detector.cjs +474 -0
  18. package/hooks/lib/scout-checker.cjs +263 -0
  19. package/hooks/lib/transcript-parser.cjs +181 -0
  20. package/hooks/post-edit-simplify-reminder.cjs +156 -0
  21. package/hooks/privacy-block.cjs +166 -0
  22. package/hooks/scout-block.cjs +147 -0
  23. package/hooks/session-init.cjs +360 -0
  24. package/package.json +41 -0
  25. package/rules/development-rules.md +52 -0
  26. package/rules/documentation-management.md +121 -0
  27. package/rules/orchestration-protocol.md +43 -0
  28. package/rules/primary-workflow.md +57 -0
  29. package/rules/team-coordination-rules.md +90 -0
  30. package/skills/ai/agent-browser/SKILL.md +294 -0
  31. package/skills/ai/agent-browser/references/.gitkeep +0 -0
  32. package/skills/ai/agent-browser/references/agent-browser-vs-chrome-devtools.md +112 -0
  33. package/skills/ai/agent-browser/references/browserbase-cloud-setup.md +161 -0
  34. package/skills/ai/ai-artist/SKILL.md +122 -0
  35. package/skills/ai/ai-artist/data/awesome-prompts.csv +3592 -0
  36. package/skills/ai/ai-artist/data/lighting.csv +19 -0
  37. package/skills/ai/ai-artist/data/nano-banana-templates.csv +17 -0
  38. package/skills/ai/ai-artist/data/platforms.csv +11 -0
  39. package/skills/ai/ai-artist/data/styles.csv +26 -0
  40. package/skills/ai/ai-artist/data/techniques.csv +19 -0
  41. package/skills/ai/ai-artist/data/use-cases.csv +16 -0
  42. package/skills/ai/ai-artist/references/advanced-techniques.md +184 -0
  43. package/skills/ai/ai-artist/references/awesome-nano-banana-pro-prompts.md +8575 -0
  44. package/skills/ai/ai-artist/references/domain-code.md +66 -0
  45. package/skills/ai/ai-artist/references/domain-data.md +72 -0
  46. package/skills/ai/ai-artist/references/domain-marketing.md +66 -0
  47. package/skills/ai/ai-artist/references/domain-patterns.md +33 -0
  48. package/skills/ai/ai-artist/references/domain-writing.md +68 -0
  49. package/skills/ai/ai-artist/references/image-prompting.md +141 -0
  50. package/skills/ai/ai-artist/references/llm-prompting.md +165 -0
  51. package/skills/ai/ai-artist/references/nano-banana.md +136 -0
  52. package/skills/ai/ai-artist/references/reasoning-techniques.md +201 -0
  53. package/skills/ai/ai-artist/references/validation-workflow.md +117 -0
  54. package/skills/ai/ai-artist/scripts/core.py +197 -0
  55. package/skills/ai/ai-artist/scripts/extract_prompts.py +102 -0
  56. package/skills/ai/ai-artist/scripts/generate.py +370 -0
  57. package/skills/ai/ai-artist/scripts/search.py +147 -0
  58. package/skills/ai/ai-multimodal/.env.example +204 -0
  59. package/skills/ai/ai-multimodal/SKILL.md +110 -0
  60. package/skills/ai/ai-multimodal/references/audio-processing.md +387 -0
  61. package/skills/ai/ai-multimodal/references/image-generation.md +939 -0
  62. package/skills/ai/ai-multimodal/references/music-generation.md +311 -0
  63. package/skills/ai/ai-multimodal/references/video-analysis.md +515 -0
  64. package/skills/ai/ai-multimodal/references/video-generation.md +457 -0
  65. package/skills/ai/ai-multimodal/references/vision-understanding.md +492 -0
  66. package/skills/ai/ai-multimodal/scripts/.coverage +0 -0
  67. package/skills/ai/ai-multimodal/scripts/check_setup.py +315 -0
  68. package/skills/ai/ai-multimodal/scripts/document_converter.py +395 -0
  69. package/skills/ai/ai-multimodal/scripts/gemini_batch_process.py +1185 -0
  70. package/skills/ai/ai-multimodal/scripts/media_optimizer.py +506 -0
  71. package/skills/ai/ai-multimodal/scripts/requirements.txt +26 -0
  72. package/skills/ai/ai-multimodal/scripts/tests/.coverage +0 -0
  73. package/skills/ai/ai-multimodal/scripts/tests/requirements.txt +20 -0
  74. package/skills/ai/ai-multimodal/scripts/tests/test_document_converter.py +74 -0
  75. package/skills/ai/ai-multimodal/scripts/tests/test_gemini_batch_process.py +362 -0
  76. package/skills/ai/ai-multimodal/scripts/tests/test_media_optimizer.py +373 -0
  77. package/skills/ai/mcp-management/README.md +219 -0
  78. package/skills/ai/mcp-management/SKILL.md +210 -0
  79. package/skills/ai/mcp-management/assets/tools.json +3146 -0
  80. package/skills/ai/mcp-management/references/configuration.md +114 -0
  81. package/skills/ai/mcp-management/references/gemini-cli-integration.md +221 -0
  82. package/skills/ai/mcp-management/references/mcp-protocol.md +116 -0
  83. package/skills/ai/mcp-management/scripts/.env.example +10 -0
  84. package/skills/ai/mcp-management/scripts/cli.ts +195 -0
  85. package/skills/ai/mcp-management/scripts/dist/analyze-tools.js +70 -0
  86. package/skills/ai/mcp-management/scripts/dist/cli.js +160 -0
  87. package/skills/ai/mcp-management/scripts/dist/mcp-client.js +183 -0
  88. package/skills/ai/mcp-management/scripts/mcp-client.ts +230 -0
  89. package/skills/ai/mcp-management/scripts/package.json +20 -0
  90. package/skills/ai/mcp-management/scripts/tsconfig.json +15 -0
  91. package/skills/core/brainstorm/SKILL.md +164 -0
  92. package/skills/core/brainstorm/scripts/frame-template.html +214 -0
  93. package/skills/core/brainstorm/scripts/helper.js +88 -0
  94. package/skills/core/brainstorm/scripts/server.cjs +338 -0
  95. package/skills/core/brainstorm/scripts/start-server.sh +153 -0
  96. package/skills/core/brainstorm/scripts/stop-server.sh +55 -0
  97. package/skills/core/brainstorm/spec-document-reviewer-prompt.md +49 -0
  98. package/skills/core/brainstorm/visual-companion.md +286 -0
  99. package/skills/core/code-review/SKILL.md +147 -0
  100. package/skills/core/code-review/references/code-review-reception.md +113 -0
  101. package/skills/core/code-review/references/codebase-scan-workflow.md +29 -0
  102. package/skills/core/code-review/references/edge-case-scouting.md +119 -0
  103. package/skills/core/code-review/references/parallel-review-workflow.md +69 -0
  104. package/skills/core/code-review/references/requesting-code-review.md +116 -0
  105. package/skills/core/code-review/references/task-management-reviews.md +140 -0
  106. package/skills/core/code-review/references/verification-before-completion.md +139 -0
  107. package/skills/core/cook/README.md +86 -0
  108. package/skills/core/cook/SKILL.md +113 -0
  109. package/skills/core/cook/references/intent-detection.md +101 -0
  110. package/skills/core/cook/references/review-cycle.md +75 -0
  111. package/skills/core/cook/references/subagent-patterns.md +75 -0
  112. package/skills/core/cook/references/workflow-steps.md +172 -0
  113. package/skills/core/debug/SKILL.md +121 -0
  114. package/skills/core/debug/references/defense-in-depth.md +124 -0
  115. package/skills/core/debug/references/frontend-verification.md +103 -0
  116. package/skills/core/debug/references/investigation-methodology.md +101 -0
  117. package/skills/core/debug/references/log-and-ci-analysis.md +97 -0
  118. package/skills/core/debug/references/performance-diagnostics.md +113 -0
  119. package/skills/core/debug/references/reporting-standards.md +122 -0
  120. package/skills/core/debug/references/root-cause-tracing.md +122 -0
  121. package/skills/core/debug/references/systematic-debugging.md +102 -0
  122. package/skills/core/debug/references/task-management-debugging.md +155 -0
  123. package/skills/core/debug/references/verification.md +123 -0
  124. package/skills/core/debug/scripts/find-polluter.sh +63 -0
  125. package/skills/core/debug/scripts/find-polluter.test.md +102 -0
  126. package/skills/core/execute/SKILL.md +70 -0
  127. package/skills/core/fix/SKILL.md +111 -0
  128. package/skills/core/fix/references/complexity-assessment.md +72 -0
  129. package/skills/core/fix/references/mode-selection.md +46 -0
  130. package/skills/core/fix/references/parallel-exploration.md +100 -0
  131. package/skills/core/fix/references/review-cycle.md +77 -0
  132. package/skills/core/fix/references/skill-activation-matrix.md +78 -0
  133. package/skills/core/fix/references/task-orchestration.md +103 -0
  134. package/skills/core/fix/references/workflow-ci.md +28 -0
  135. package/skills/core/fix/references/workflow-deep.md +122 -0
  136. package/skills/core/fix/references/workflow-logs.md +72 -0
  137. package/skills/core/fix/references/workflow-quick.md +59 -0
  138. package/skills/core/fix/references/workflow-standard.md +111 -0
  139. package/skills/core/fix/references/workflow-test.md +75 -0
  140. package/skills/core/fix/references/workflow-types.md +33 -0
  141. package/skills/core/fix/references/workflow-ui.md +75 -0
  142. package/skills/core/plan/SKILL.md +145 -0
  143. package/skills/core/plan/plan-document-reviewer-prompt.md +49 -0
  144. package/skills/core/subagent-dev/SKILL.md +277 -0
  145. package/skills/core/subagent-dev/code-quality-reviewer-prompt.md +26 -0
  146. package/skills/core/subagent-dev/implementer-prompt.md +113 -0
  147. package/skills/core/subagent-dev/spec-reviewer-prompt.md +61 -0
  148. package/skills/core/tdd/SKILL.md +371 -0
  149. package/skills/core/tdd/testing-anti-patterns.md +299 -0
  150. package/skills/core/test/SKILL.md +109 -0
  151. package/skills/core/test/references/report-format.md +58 -0
  152. package/skills/core/test/references/test-execution-workflow.md +103 -0
  153. package/skills/core/test/references/ui-testing-workflow.md +65 -0
  154. package/skills/core/verify/SKILL.md +139 -0
  155. package/skills/dev/backend-dev/SKILL.md +96 -0
  156. package/skills/dev/backend-dev/references/backend-api-design.md +495 -0
  157. package/skills/dev/backend-dev/references/backend-architecture.md +454 -0
  158. package/skills/dev/backend-dev/references/backend-authentication.md +338 -0
  159. package/skills/dev/backend-dev/references/backend-code-quality.md +659 -0
  160. package/skills/dev/backend-dev/references/backend-debugging.md +904 -0
  161. package/skills/dev/backend-dev/references/backend-devops.md +494 -0
  162. package/skills/dev/backend-dev/references/backend-mindset.md +387 -0
  163. package/skills/dev/backend-dev/references/backend-performance.md +397 -0
  164. package/skills/dev/backend-dev/references/backend-security.md +290 -0
  165. package/skills/dev/backend-dev/references/backend-technologies.md +256 -0
  166. package/skills/dev/backend-dev/references/backend-testing.md +429 -0
  167. package/skills/dev/context-engineering/SKILL.md +108 -0
  168. package/skills/dev/context-engineering/references/context-compression.md +84 -0
  169. package/skills/dev/context-engineering/references/context-degradation.md +93 -0
  170. package/skills/dev/context-engineering/references/context-fundamentals.md +75 -0
  171. package/skills/dev/context-engineering/references/context-optimization.md +82 -0
  172. package/skills/dev/context-engineering/references/evaluation.md +89 -0
  173. package/skills/dev/context-engineering/references/memory-systems.md +88 -0
  174. package/skills/dev/context-engineering/references/multi-agent-patterns.md +90 -0
  175. package/skills/dev/context-engineering/references/project-development.md +97 -0
  176. package/skills/dev/context-engineering/references/runtime-awareness.md +202 -0
  177. package/skills/dev/context-engineering/references/tool-design.md +86 -0
  178. package/skills/dev/context-engineering/scripts/compression_evaluator.py +349 -0
  179. package/skills/dev/context-engineering/scripts/context_analyzer.py +317 -0
  180. package/skills/dev/context-engineering/scripts/tests/test_edge_cases.py +246 -0
  181. package/skills/dev/databases/SKILL.md +84 -0
  182. package/skills/dev/databases/analytics.md +198 -0
  183. package/skills/dev/databases/db-design.md +188 -0
  184. package/skills/dev/databases/incremental-etl.md +213 -0
  185. package/skills/dev/databases/references/mongodb-aggregation.md +447 -0
  186. package/skills/dev/databases/references/mongodb-atlas.md +465 -0
  187. package/skills/dev/databases/references/mongodb-crud.md +408 -0
  188. package/skills/dev/databases/references/mongodb-indexing.md +442 -0
  189. package/skills/dev/databases/references/postgresql-administration.md +594 -0
  190. package/skills/dev/databases/references/postgresql-performance.md +527 -0
  191. package/skills/dev/databases/references/postgresql-psql-cli.md +467 -0
  192. package/skills/dev/databases/references/postgresql-queries.md +475 -0
  193. package/skills/dev/databases/scripts/.coverage +0 -0
  194. package/skills/dev/databases/scripts/db_backup.py +502 -0
  195. package/skills/dev/databases/scripts/db_migrate.py +426 -0
  196. package/skills/dev/databases/scripts/db_performance_check.py +457 -0
  197. package/skills/dev/databases/scripts/requirements.txt +20 -0
  198. package/skills/dev/databases/scripts/tests/coverage-db.json +1 -0
  199. package/skills/dev/databases/scripts/tests/requirements.txt +4 -0
  200. package/skills/dev/databases/scripts/tests/test_db_backup.py +340 -0
  201. package/skills/dev/databases/scripts/tests/test_db_migrate.py +277 -0
  202. package/skills/dev/databases/scripts/tests/test_db_performance_check.py +370 -0
  203. package/skills/dev/databases/stacks/bigquery.md +231 -0
  204. package/skills/dev/databases/stacks/d1_cloudflare.md +137 -0
  205. package/skills/dev/databases/stacks/mysql.md +216 -0
  206. package/skills/dev/databases/stacks/postgres.md +235 -0
  207. package/skills/dev/databases/stacks/sqlite.md +244 -0
  208. package/skills/dev/databases/transactional.md +176 -0
  209. package/skills/dev/devops/.env.example +76 -0
  210. package/skills/dev/devops/SKILL.md +97 -0
  211. package/skills/dev/devops/references/browser-rendering.md +305 -0
  212. package/skills/dev/devops/references/cloudflare-d1-kv.md +123 -0
  213. package/skills/dev/devops/references/cloudflare-platform.md +271 -0
  214. package/skills/dev/devops/references/cloudflare-r2-storage.md +280 -0
  215. package/skills/dev/devops/references/cloudflare-workers-advanced.md +312 -0
  216. package/skills/dev/devops/references/cloudflare-workers-apis.md +309 -0
  217. package/skills/dev/devops/references/cloudflare-workers-basics.md +418 -0
  218. package/skills/dev/devops/references/docker-basics.md +297 -0
  219. package/skills/dev/devops/references/docker-compose.md +292 -0
  220. package/skills/dev/devops/references/gcloud-platform.md +297 -0
  221. package/skills/dev/devops/references/gcloud-services.md +304 -0
  222. package/skills/dev/devops/references/kubernetes-basics.md +99 -0
  223. package/skills/dev/devops/references/kubernetes-helm-advanced.md +75 -0
  224. package/skills/dev/devops/references/kubernetes-helm.md +81 -0
  225. package/skills/dev/devops/references/kubernetes-kubectl.md +74 -0
  226. package/skills/dev/devops/references/kubernetes-security-advanced.md +98 -0
  227. package/skills/dev/devops/references/kubernetes-security.md +95 -0
  228. package/skills/dev/devops/references/kubernetes-troubleshooting-advanced.md +74 -0
  229. package/skills/dev/devops/references/kubernetes-troubleshooting.md +49 -0
  230. package/skills/dev/devops/references/kubernetes-workflows-advanced.md +75 -0
  231. package/skills/dev/devops/references/kubernetes-workflows.md +78 -0
  232. package/skills/dev/devops/scripts/cloudflare_deploy.py +269 -0
  233. package/skills/dev/devops/scripts/docker_optimize.py +332 -0
  234. package/skills/dev/devops/scripts/requirements.txt +20 -0
  235. package/skills/dev/devops/scripts/tests/requirements.txt +3 -0
  236. package/skills/dev/devops/scripts/tests/test_cloudflare_deploy.py +285 -0
  237. package/skills/dev/devops/scripts/tests/test_docker_optimize.py +436 -0
  238. package/skills/dev/frontend-design/SKILL.md +78 -0
  239. package/skills/dev/frontend-design/references/ai-multimodal-overview.md +165 -0
  240. package/skills/dev/frontend-design/references/analysis-best-practices.md +80 -0
  241. package/skills/dev/frontend-design/references/analysis-prompts.md +141 -0
  242. package/skills/dev/frontend-design/references/analysis-techniques.md +118 -0
  243. package/skills/dev/frontend-design/references/animejs.md +396 -0
  244. package/skills/dev/frontend-design/references/asset-generation.md +337 -0
  245. package/skills/dev/frontend-design/references/design-extraction-overview.md +71 -0
  246. package/skills/dev/frontend-design/references/extraction-best-practices.md +141 -0
  247. package/skills/dev/frontend-design/references/extraction-output-templates.md +162 -0
  248. package/skills/dev/frontend-design/references/extraction-prompts.md +127 -0
  249. package/skills/dev/frontend-design/references/technical-accessibility.md +119 -0
  250. package/skills/dev/frontend-design/references/technical-best-practices.md +97 -0
  251. package/skills/dev/frontend-design/references/technical-optimization.md +44 -0
  252. package/skills/dev/frontend-design/references/technical-overview.md +90 -0
  253. package/skills/dev/frontend-design/references/technical-workflows.md +150 -0
  254. package/skills/dev/frontend-design/references/visual-analysis-overview.md +95 -0
  255. package/skills/dev/frontend-design/references/workflow-3d.md +102 -0
  256. package/skills/dev/frontend-design/references/workflow-describe.md +87 -0
  257. package/skills/dev/frontend-design/references/workflow-immersive.md +87 -0
  258. package/skills/dev/frontend-design/references/workflow-quick.md +57 -0
  259. package/skills/dev/frontend-design/references/workflow-screenshot.md +63 -0
  260. package/skills/dev/frontend-design/references/workflow-video.md +74 -0
  261. package/skills/dev/frontend-dev/SKILL.md +400 -0
  262. package/skills/dev/frontend-dev/resources/common-patterns.md +331 -0
  263. package/skills/dev/frontend-dev/resources/complete-examples.md +872 -0
  264. package/skills/dev/frontend-dev/resources/component-patterns.md +502 -0
  265. package/skills/dev/frontend-dev/resources/data-fetching.md +767 -0
  266. package/skills/dev/frontend-dev/resources/file-organization.md +502 -0
  267. package/skills/dev/frontend-dev/resources/loading-and-error-states.md +501 -0
  268. package/skills/dev/frontend-dev/resources/performance.md +406 -0
  269. package/skills/dev/frontend-dev/resources/routing-guide.md +364 -0
  270. package/skills/dev/frontend-dev/resources/styling-guide.md +428 -0
  271. package/skills/dev/frontend-dev/resources/typescript-standards.md +418 -0
  272. package/skills/dev/git/SKILL.md +114 -0
  273. package/skills/dev/git/references/branch-management.md +88 -0
  274. package/skills/dev/git/references/commit-standards.md +46 -0
  275. package/skills/dev/git/references/gh-cli-guide.md +109 -0
  276. package/skills/dev/git/references/safety-protocols.md +69 -0
  277. package/skills/dev/git/references/workflow-commit.md +58 -0
  278. package/skills/dev/git/references/workflow-merge.md +48 -0
  279. package/skills/dev/git/references/workflow-pr.md +58 -0
  280. package/skills/dev/git/references/workflow-push.md +52 -0
  281. package/skills/dev/git-worktree/SKILL.md +218 -0
  282. package/skills/utils/ask/SKILL.md +58 -0
  283. package/skills/utils/bootstrap/SKILL.md +101 -0
  284. package/skills/utils/bootstrap/references/shared-phases.md +59 -0
  285. package/skills/utils/bootstrap/references/workflow-auto.md +52 -0
  286. package/skills/utils/bootstrap/references/workflow-fast.md +50 -0
  287. package/skills/utils/bootstrap/references/workflow-full.md +60 -0
  288. package/skills/utils/bootstrap/references/workflow-parallel.md +59 -0
  289. package/skills/utils/ck-help/SKILL.md +102 -0
  290. package/skills/utils/ck-help/scripts/ck-help.py +1321 -0
  291. package/skills/utils/ck-help/scripts/commands_data.yaml +3 -0
  292. package/skills/utils/ck-help/scripts/skills_data.yaml +593 -0
  293. package/skills/utils/copywriting/SKILL.md +94 -0
  294. package/skills/utils/copywriting/references/copy-formulas.md +150 -0
  295. package/skills/utils/copywriting/references/cta-patterns.md +168 -0
  296. package/skills/utils/copywriting/references/email-copy.md +193 -0
  297. package/skills/utils/copywriting/references/headline-templates.md +140 -0
  298. package/skills/utils/copywriting/references/landing-page-copy.md +175 -0
  299. package/skills/utils/copywriting/references/power-words.md +189 -0
  300. package/skills/utils/copywriting/references/social-media-copy.md +222 -0
  301. package/skills/utils/copywriting/references/workflow-cro.md +83 -0
  302. package/skills/utils/copywriting/references/workflow-enhance.md +32 -0
  303. package/skills/utils/copywriting/references/workflow-fast.md +29 -0
  304. package/skills/utils/copywriting/references/workflow-good.md +39 -0
  305. package/skills/utils/copywriting/references/writing-styles.md +247 -0
  306. package/skills/utils/copywriting/scripts/extract-writing-styles.py +308 -0
  307. package/skills/utils/copywriting/templates/copy-brief.md +49 -0
  308. package/skills/utils/docs/SKILL.md +55 -0
  309. package/skills/utils/docs/references/init-workflow.md +32 -0
  310. package/skills/utils/docs/references/summarize-workflow.md +18 -0
  311. package/skills/utils/docs/references/update-workflow.md +59 -0
  312. package/skills/utils/journal/SKILL.md +11 -0
  313. package/skills/utils/kanban/SKILL.md +99 -0
  314. package/skills/utils/preview/SKILL.md +75 -0
  315. package/skills/utils/preview/references/generation-modes.md +95 -0
  316. package/skills/utils/preview/references/view-mode.md +42 -0
  317. package/skills/utils/repomix/SKILL.md +248 -0
  318. package/skills/utils/repomix/references/configuration.md +211 -0
  319. package/skills/utils/repomix/references/usage-patterns.md +232 -0
  320. package/skills/utils/repomix/scripts/.coverage +0 -0
  321. package/skills/utils/repomix/scripts/README.md +179 -0
  322. package/skills/utils/repomix/scripts/repomix_batch.py +455 -0
  323. package/skills/utils/repomix/scripts/repos.example.json +15 -0
  324. package/skills/utils/repomix/scripts/requirements.txt +15 -0
  325. package/skills/utils/repomix/scripts/tests/test_repomix_batch.py +531 -0
  326. package/skills/utils/research/SKILL.md +171 -0
  327. package/skills/utils/scout/SKILL.md +89 -0
  328. package/skills/utils/scout/references/external-scouting.md +140 -0
  329. package/skills/utils/scout/references/internal-scouting.md +119 -0
  330. package/skills/utils/scout/references/task-management-scouting.md +125 -0
  331. package/skills/utils/sequential-thinking/.env.example +8 -0
  332. package/skills/utils/sequential-thinking/README.md +183 -0
  333. package/skills/utils/sequential-thinking/SKILL.md +95 -0
  334. package/skills/utils/sequential-thinking/package.json +31 -0
  335. package/skills/utils/sequential-thinking/references/advanced-strategies.md +79 -0
  336. package/skills/utils/sequential-thinking/references/advanced-techniques.md +76 -0
  337. package/skills/utils/sequential-thinking/references/core-patterns.md +95 -0
  338. package/skills/utils/sequential-thinking/references/examples-api.md +88 -0
  339. package/skills/utils/sequential-thinking/references/examples-architecture.md +94 -0
  340. package/skills/utils/sequential-thinking/references/examples-debug.md +90 -0
  341. package/skills/utils/sequential-thinking/scripts/format-thought.js +159 -0
  342. package/skills/utils/sequential-thinking/scripts/process-thought.js +236 -0
  343. package/skills/utils/sequential-thinking/tests/format-thought.test.js +133 -0
  344. package/skills/utils/sequential-thinking/tests/process-thought.test.js +215 -0
  345. package/skills/utils/write-skill/SKILL.md +655 -0
  346. package/skills/utils/write-skill/anthropic-best-practices.md +1150 -0
  347. package/skills/utils/write-skill/examples/CLAUDE_MD_TESTING.md +189 -0
  348. package/skills/utils/write-skill/graphviz-conventions.dot +172 -0
  349. package/skills/utils/write-skill/persuasion-principles.md +187 -0
  350. package/skills/utils/write-skill/render-graphs.js +168 -0
  351. package/skills/utils/write-skill/testing-skills-with-subagents.md +384 -0
  352. package/src/commands/init.js +238 -0
@@ -0,0 +1,75 @@
1
+ # Helm Advanced - Templates & Hooks
2
+
3
+ ## Template Variables
4
+ ```yaml
5
+ # templates/deployment.yaml
6
+ apiVersion: apps/v1
7
+ kind: Deployment
8
+ metadata:
9
+ name: {{ include "mychart.fullname" . }}
10
+ spec:
11
+ replicas: {{ .Values.replicaCount }}
12
+ template:
13
+ spec:
14
+ containers:
15
+ - name: {{ .Chart.Name }}
16
+ image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
17
+ {{- if .Values.resources }}
18
+ resources:
19
+ {{- toYaml .Values.resources | nindent 10 }}
20
+ {{- end }}
21
+ ```
22
+
23
+ ## Helper Templates
24
+ ```yaml
25
+ # templates/_helpers.tpl
26
+ {{- define "mychart.fullname" -}}
27
+ {{- printf "%s-%s" .Release.Name .Chart.Name | trunc 63 | trimSuffix "-" }}
28
+ {{- end }}
29
+
30
+ {{- define "mychart.labels" -}}
31
+ app.kubernetes.io/name: {{ .Chart.Name }}
32
+ app.kubernetes.io/instance: {{ .Release.Name }}
33
+ {{- end }}
34
+ ```
35
+
36
+ ## Hooks
37
+ ```yaml
38
+ apiVersion: batch/v1
39
+ kind: Job
40
+ metadata:
41
+ name: "{{ .Release.Name }}-post-install"
42
+ annotations:
43
+ "helm.sh/hook": post-install
44
+ "helm.sh/hook-delete-policy": hook-succeeded
45
+ spec:
46
+ template:
47
+ spec:
48
+ containers:
49
+ - name: post-install
50
+ command: ["/bin/sh", "-c", "echo 'Done'"]
51
+ restartPolicy: Never
52
+ ```
53
+
54
+ Hook types: `pre-install`, `post-install`, `pre-upgrade`, `post-upgrade`
55
+
56
+ ## Packaging
57
+ ```bash
58
+ helm package mychart
59
+ helm repo index . --url https://charts.example.com
60
+ helm push mychart-1.0.0.tgz oci://registry.example.com/helm
61
+ helm repo add myrepo https://charts.example.com
62
+ helm install myapp myrepo/mychart
63
+ ```
64
+
65
+ ## Commands
66
+
67
+ | Command | Purpose |
68
+ |---------|---------|
69
+ | `helm create` | Create |
70
+ | `helm lint` | Validate |
71
+ | `helm template` | Render |
72
+ | `helm install` | Deploy |
73
+ | `helm upgrade` | Update |
74
+ | `helm rollback` | Revert |
75
+ | `helm uninstall` | Remove |
@@ -0,0 +1,81 @@
1
+ # Helm Package Management
2
+
3
+ ## Core Concepts
4
+
5
+ - **Chart:** Helm package with K8s resource definitions
6
+ - **Repository:** Collection of charts
7
+ - **Release:** Deployed instance of a chart
8
+ - **Values:** Configuration that parameterizes charts
9
+
10
+ ## Chart Structure
11
+
12
+ ```
13
+ mychart/
14
+ ├── Chart.yaml # Metadata
15
+ ├── values.yaml # Default values
16
+ ├── charts/ # Dependencies
17
+ ├── templates/
18
+ │ ├── deployment.yaml
19
+ │ ├── service.yaml
20
+ │ ├── _helpers.tpl # Template helpers
21
+ │ └── NOTES.txt
22
+ └── values.schema.json # Validation (optional)
23
+ ```
24
+
25
+ ## Essential Commands
26
+
27
+ ```bash
28
+ helm create mychart # Create chart
29
+ helm lint mychart # Validate
30
+ helm template myrelease ./mychart # Render locally
31
+ helm install myrelease ./mychart --dry-run --debug # Preview
32
+
33
+ helm install myrelease ./mychart
34
+ helm install myrelease ./mychart -f values-prod.yaml
35
+ helm install myrelease ./mychart --set replicaCount=3
36
+
37
+ helm upgrade myrelease ./mychart
38
+ helm rollback myrelease 1
39
+ helm list
40
+ helm uninstall myrelease
41
+ ```
42
+
43
+ ## Multi-Environment
44
+
45
+ ```bash
46
+ # Files: values.yaml, values-dev.yaml, values-prod.yaml
47
+ helm install myapp ./mychart -f values.yaml -f values-prod.yaml
48
+ helm install myapp ./mychart --set replicaCount=3 --set image.tag=v1.2.3
49
+ ```
50
+
51
+ ## values.yaml Example
52
+
53
+ ```yaml
54
+ replicaCount: 2
55
+ image:
56
+ repository: myapp
57
+ tag: "1.0.0"
58
+ pullPolicy: IfNotPresent
59
+ service:
60
+ type: ClusterIP
61
+ port: 8080
62
+ resources:
63
+ limits: { cpu: 500m, memory: 512Mi }
64
+ requests: { cpu: 250m, memory: 256Mi }
65
+ ```
66
+
67
+ ## Dependencies
68
+
69
+ ```yaml
70
+ # Chart.yaml
71
+ dependencies:
72
+ - name: postgresql
73
+ version: "12.1.0"
74
+ repository: "https://charts.bitnami.com/bitnami"
75
+ ```
76
+
77
+ ```bash
78
+ helm dependency update mychart
79
+ ```
80
+
81
+ See `kubernetes-helm-advanced.md` for templates, hooks, and packaging.
@@ -0,0 +1,74 @@
1
+ # kubectl Essential Commands
2
+
3
+ ## Cluster & Node
4
+ ```bash
5
+ kubectl cluster-info
6
+ kubectl get nodes
7
+ kubectl describe node <node-name>
8
+ kubectl top nodes
9
+ kubectl drain <node-name> --ignore-daemonsets
10
+ kubectl uncordon <node-name>
11
+ ```
12
+
13
+ ## Pod Operations
14
+ ```bash
15
+ kubectl get pods -A # All namespaces
16
+ kubectl get pods -o wide # Extended info
17
+ kubectl describe pod <pod-name>
18
+ kubectl logs <pod-name>
19
+ kubectl logs -f <pod-name> # Follow
20
+ kubectl logs --previous <pod-name> # Previous crash
21
+ kubectl exec -it <pod-name> -- /bin/bash
22
+ ```
23
+
24
+ ## Deployment
25
+ ```bash
26
+ kubectl apply -f manifest.yaml
27
+ kubectl apply -f ./manifests/
28
+ kubectl apply -f manifest.yaml --dry-run=client -o yaml # Preview
29
+ kubectl set image deployment/myapp app=myapp:v2
30
+ kubectl delete -f manifest.yaml
31
+ ```
32
+
33
+ ## Service & Network
34
+ ```bash
35
+ kubectl port-forward service/myapp 8080:8080
36
+ kubectl get svc
37
+ kubectl exec -it <pod-name> -- curl http://service:8080
38
+ kubectl exec -it <pod-name> -- nslookup kubernetes.default
39
+ ```
40
+
41
+ ## Debugging (Get → Describe → Logs)
42
+ ```bash
43
+ kubectl get pods -o wide
44
+ kubectl get events -n <ns> --sort-by='.lastTimestamp'
45
+ kubectl describe pod <pod-name>
46
+ kubectl logs <pod-name> -c <container>
47
+ ```
48
+
49
+ ## Output & Filtering
50
+ ```bash
51
+ kubectl get pods -o json
52
+ kubectl get pods -o yaml
53
+ kubectl get pods -l app=myapp,tier=frontend
54
+ kubectl get pods --field-selector=status.phase=Running
55
+ kubectl get pods -w # Watch
56
+ ```
57
+
58
+ ## Flags
59
+
60
+ | Flag | Purpose |
61
+ |------|---------|
62
+ | `-n` | Namespace |
63
+ | `-A` | All namespaces |
64
+ | `-o` | Output format |
65
+ | `-l` | Label selector |
66
+ | `-w` | Watch |
67
+
68
+ ## Aliases
69
+ ```bash
70
+ alias k='kubectl'
71
+ alias kgp='kubectl get pods'
72
+ alias kd='kubectl describe'
73
+ alias kl='kubectl logs'
74
+ ```
@@ -0,0 +1,98 @@
1
+ # Kubernetes Security Advanced
2
+
3
+ ## ClusterRole (cluster-wide)
4
+
5
+ ```yaml
6
+ apiVersion: rbac.authorization.k8s.io/v1
7
+ kind: ClusterRole
8
+ metadata:
9
+ name: secret-reader
10
+ rules:
11
+ - apiGroups: [""]
12
+ resources: ["secrets"]
13
+ verbs: ["get"]
14
+ resourceNames: ["app-credentials"] # Restrict to specific
15
+
16
+ ---
17
+ apiVersion: rbac.authorization.k8s.io/v1
18
+ kind: ClusterRoleBinding
19
+ metadata:
20
+ name: admin-binding
21
+ subjects:
22
+ - kind: User
23
+ name: admin@example.com
24
+ apiGroup: rbac.authorization.k8s.io
25
+ roleRef:
26
+ kind: ClusterRole
27
+ name: cluster-admin
28
+ apiGroup: rbac.authorization.k8s.io
29
+ ```
30
+
31
+ ## Secrets Management
32
+
33
+ ```yaml
34
+ apiVersion: v1
35
+ kind: Secret
36
+ metadata:
37
+ name: db-credentials
38
+ type: Opaque
39
+ stringData:
40
+ username: admin
41
+ password: secretpassword
42
+ ```
43
+
44
+ ### Mount as env
45
+ ```yaml
46
+ env:
47
+ - name: DB_PASSWORD
48
+ valueFrom:
49
+ secretKeyRef:
50
+ name: db-credentials
51
+ key: password
52
+ ```
53
+
54
+ ### Mount as volume
55
+ ```yaml
56
+ volumeMounts:
57
+ - name: secret-volume
58
+ mountPath: /etc/secrets
59
+ readOnly: true
60
+ volumes:
61
+ - name: secret-volume
62
+ secret:
63
+ secretName: db-credentials
64
+ ```
65
+
66
+ ## Allow DNS (Required for most apps)
67
+
68
+ ```yaml
69
+ apiVersion: networking.k8s.io/v1
70
+ kind: NetworkPolicy
71
+ metadata:
72
+ name: allow-dns
73
+ spec:
74
+ podSelector: {}
75
+ policyTypes: [Egress]
76
+ egress:
77
+ - to:
78
+ - namespaceSelector:
79
+ matchLabels:
80
+ name: kube-system
81
+ ports:
82
+ - { protocol: UDP, port: 53 }
83
+ ```
84
+
85
+ ## Security Checklist
86
+
87
+ - [ ] RBAC with least-privilege roles
88
+ - [ ] Pod Security Standards (restricted)
89
+ - [ ] Network policies (default-deny + explicit allow)
90
+ - [ ] Run containers as non-root
91
+ - [ ] Read-only root filesystem
92
+ - [ ] Drop all capabilities
93
+ - [ ] Secrets for sensitive data
94
+ - [ ] Image scanning enabled
95
+ - [ ] Private container registry
96
+ - [ ] Resource quotas and limits
97
+ - [ ] Audit logging enabled
98
+ - [ ] Regular credential rotation
@@ -0,0 +1,95 @@
1
+ # Kubernetes Security
2
+
3
+ ## RBAC (Role-Based Access Control)
4
+
5
+ ### Role (namespace-scoped)
6
+ ```yaml
7
+ apiVersion: rbac.authorization.k8s.io/v1
8
+ kind: Role
9
+ metadata:
10
+ namespace: default
11
+ name: pod-reader
12
+ rules:
13
+ - apiGroups: [""]
14
+ resources: ["pods", "pods/log"]
15
+ verbs: ["get", "list", "watch"]
16
+ ```
17
+
18
+ ### RoleBinding
19
+ ```yaml
20
+ apiVersion: rbac.authorization.k8s.io/v1
21
+ kind: RoleBinding
22
+ metadata:
23
+ name: read-pods
24
+ namespace: default
25
+ subjects:
26
+ - kind: ServiceAccount
27
+ name: my-app-sa
28
+ namespace: default
29
+ roleRef:
30
+ kind: Role
31
+ name: pod-reader
32
+ apiGroup: rbac.authorization.k8s.io
33
+ ```
34
+
35
+ ### Verify Permissions
36
+ ```bash
37
+ kubectl auth can-i get pods --as=system:serviceaccount:default:my-sa
38
+ kubectl get roles,rolebindings -n default
39
+ ```
40
+
41
+ ## Pod Security (Restricted)
42
+
43
+ ```yaml
44
+ spec:
45
+ securityContext:
46
+ runAsNonRoot: true
47
+ runAsUser: 1000
48
+ seccompProfile:
49
+ type: RuntimeDefault
50
+ containers:
51
+ - name: app
52
+ securityContext:
53
+ allowPrivilegeEscalation: false
54
+ readOnlyRootFilesystem: true
55
+ capabilities:
56
+ drop: ["ALL"]
57
+ ```
58
+
59
+ Enable on namespace:
60
+ ```bash
61
+ kubectl label namespace default \
62
+ pod-security.kubernetes.io/enforce=restricted
63
+ ```
64
+
65
+ ## Network Policies
66
+
67
+ ### Default Deny
68
+ ```yaml
69
+ apiVersion: networking.k8s.io/v1
70
+ kind: NetworkPolicy
71
+ metadata:
72
+ name: default-deny-all
73
+ spec:
74
+ podSelector: {}
75
+ policyTypes: [Ingress, Egress]
76
+ ```
77
+
78
+ ### Allow Specific
79
+ ```yaml
80
+ apiVersion: networking.k8s.io/v1
81
+ kind: NetworkPolicy
82
+ metadata:
83
+ name: allow-frontend-to-backend
84
+ spec:
85
+ podSelector:
86
+ matchLabels: { app: backend }
87
+ ingress:
88
+ - from:
89
+ - podSelector:
90
+ matchLabels: { app: frontend }
91
+ ports:
92
+ - { protocol: TCP, port: 8080 }
93
+ ```
94
+
95
+ See `kubernetes-security-advanced.md` for secrets, ClusterRoles, and checklist.
@@ -0,0 +1,74 @@
1
+ # Kubernetes Troubleshooting Advanced
2
+
3
+ ## Node Issues
4
+ ```bash
5
+ kubectl describe node <node-name> | grep -A 5 "Conditions:"
6
+ kubectl top node <node-name>
7
+ kubectl top pods -A --sort-by=memory
8
+ kubectl drain <node-name> --ignore-daemonsets
9
+ kubectl uncordon <node-name>
10
+ ```
11
+
12
+ ## CrashLoopBackOff
13
+ ```bash
14
+ kubectl logs <pod-name> --previous
15
+ kubectl describe pod <pod-name>
16
+ kubectl get pod <pod-name> -o yaml | grep -A 5 resources:
17
+ ```
18
+
19
+ ## HPA
20
+ ```yaml
21
+ apiVersion: autoscaling/v2
22
+ kind: HorizontalPodAutoscaler
23
+ spec:
24
+ scaleTargetRef:
25
+ apiVersion: apps/v1
26
+ kind: Deployment
27
+ name: myapp
28
+ minReplicas: 2
29
+ maxReplicas: 10
30
+ metrics:
31
+ - type: Resource
32
+ resource:
33
+ name: cpu
34
+ target:
35
+ type: Utilization
36
+ averageUtilization: 70
37
+ ```
38
+
39
+ ## Anti-Patterns
40
+
41
+ **Using `latest` tag:**
42
+ ```yaml
43
+ # ❌ image: myapp:latest
44
+ # ✅ image: myapp:v1.2.3
45
+ ```
46
+
47
+ **Missing resources:**
48
+ ```yaml
49
+ # ✅ Always set
50
+ resources:
51
+ requests: { memory: "256Mi", cpu: "250m" }
52
+ limits: { memory: "512Mi", cpu: "500m" }
53
+ ```
54
+
55
+ **Missing health checks:**
56
+ ```yaml
57
+ livenessProbe:
58
+ httpGet: { path: /health, port: 8080 }
59
+ readinessProbe:
60
+ httpGet: { path: /ready, port: 8080 }
61
+ ```
62
+
63
+ **Running as root:**
64
+ ```yaml
65
+ securityContext:
66
+ runAsNonRoot: true
67
+ runAsUser: 1000
68
+ ```
69
+
70
+ ## Monitoring
71
+ ```bash
72
+ helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
73
+ helm install prometheus prometheus-community/kube-prometheus-stack -n monitoring
74
+ ```
@@ -0,0 +1,49 @@
1
+ # Kubernetes Troubleshooting
2
+
3
+ ## Debugging Workflow
4
+
5
+ ```bash
6
+ # 1. Overview
7
+ kubectl get pods -o wide
8
+ kubectl get events -n <namespace> --sort-by='.lastTimestamp'
9
+
10
+ # 2. Details
11
+ kubectl describe pod <pod-name>
12
+
13
+ # 3. Logs
14
+ kubectl logs <pod-name>
15
+ kubectl logs <pod-name> --previous # Crashed instance
16
+ kubectl logs <pod-name> -c <container>
17
+ ```
18
+
19
+ ## Common Pod States
20
+
21
+ | State | Cause | Solution |
22
+ |-------|-------|----------|
23
+ | Pending | No node resources | Check node capacity |
24
+ | ContainerCreating | Image pulling | Check image URI |
25
+ | CrashLoopBackOff | Container exits | Check logs, health checks |
26
+ | ImagePullBackOff | Failed image pull | Verify credentials |
27
+ | OOMKilled (137) | Out of memory | Increase memory limit |
28
+
29
+ ## Service & Network
30
+
31
+ ```bash
32
+ kubectl exec -it <pod-name> -- nslookup kubernetes.default
33
+ kubectl exec -it <pod-name> -- curl http://myservice:8080
34
+ kubectl get endpoints <service-name>
35
+ kubectl port-forward service/myservice 8080:8080
36
+ kubectl get networkpolicies -A
37
+ ```
38
+
39
+ ## Quick Fixes
40
+
41
+ | Problem | Command |
42
+ |---------|---------|
43
+ | Pod stuck | `kubectl delete pod <name> --grace-period=0 --force` |
44
+ | High CPU | `kubectl top pods -A --sort-by=cpu` |
45
+ | High memory | `kubectl top pods -A --sort-by=memory` |
46
+ | Restart | `kubectl rollout restart deployment/<name>` |
47
+ | Rollback | `kubectl rollout undo deployment/<name>` |
48
+
49
+ See `kubernetes-troubleshooting-advanced.md` for node issues, HPA, anti-patterns.
@@ -0,0 +1,75 @@
1
+ # Kubernetes Workflows Advanced
2
+
3
+ ## CI/CD Pipeline
4
+ ```yaml
5
+ # GitHub Actions
6
+ name: Build and Deploy
7
+ on:
8
+ push:
9
+ branches: [main]
10
+
11
+ jobs:
12
+ build:
13
+ runs-on: ubuntu-latest
14
+ steps:
15
+ - uses: actions/checkout@v3
16
+ - run: docker build . -t $REGISTRY/$IMAGE:${{ github.sha }}
17
+ - run: docker push $REGISTRY/$IMAGE:${{ github.sha }}
18
+
19
+ deploy:
20
+ needs: build
21
+ steps:
22
+ - uses: actions/checkout@v3
23
+ with:
24
+ repository: myorg/gitops-repo
25
+ token: ${{ secrets.GITOPS_TOKEN }}
26
+ - run: |
27
+ sed -i 's|image:.*|image: $REGISTRY/$IMAGE:${{ github.sha }}|' k8s/deployment.yaml
28
+ git commit -am "Update image" && git push
29
+ ```
30
+
31
+ ## Kustomize
32
+
33
+ ```
34
+ kustomize/
35
+ ├── base/
36
+ │ ├── kustomization.yaml
37
+ │ └── deployment.yaml
38
+ └── overlays/
39
+ └── prod/
40
+ └── kustomization.yaml
41
+ ```
42
+
43
+ ### Base
44
+ ```yaml
45
+ apiVersion: kustomize.config.k8s.io/v1beta1
46
+ kind: Kustomization
47
+ resources:
48
+ - deployment.yaml
49
+ commonLabels:
50
+ app: myapp
51
+ ```
52
+
53
+ ### Prod Overlay
54
+ ```yaml
55
+ apiVersion: kustomize.config.k8s.io/v1beta1
56
+ kind: Kustomization
57
+ bases:
58
+ - ../../base
59
+ replicas:
60
+ - name: myapp
61
+ count: 5
62
+ ```
63
+
64
+ ```bash
65
+ kubectl apply -k overlays/prod/
66
+ ```
67
+
68
+ ## Flux CD
69
+ ```bash
70
+ flux bootstrap github \
71
+ --owner=myorg \
72
+ --repository=fleet-infra \
73
+ --branch=main \
74
+ --path=clusters/my-cluster
75
+ ```
@@ -0,0 +1,78 @@
1
+ # Kubernetes Workflows
2
+
3
+ ## GitOps Architecture
4
+
5
+ ```
6
+ Git Repository (desired state)
7
+ │ Watches
8
+
9
+ GitOps Agent (Argo CD / Flux)
10
+ │ Syncs
11
+
12
+ Kubernetes Cluster (actual state)
13
+ ```
14
+
15
+ **Benefits:** Single source of truth, auditable, automated, easy rollback
16
+
17
+ ## Argo CD Setup
18
+
19
+ ```bash
20
+ kubectl create namespace argocd
21
+ kubectl apply -n argocd -f https://raw.githubusercontent.com/argoproj/argo-cd/stable/manifests/install.yaml
22
+ kubectl port-forward svc/argocd-server -n argocd 8080:443
23
+ kubectl -n argocd get secret argocd-initial-admin-secret -o jsonpath="{.data.password}" | base64 -d
24
+ ```
25
+
26
+ ### Application Manifest
27
+ ```yaml
28
+ apiVersion: argoproj.io/v1alpha1
29
+ kind: Application
30
+ metadata:
31
+ name: myapp
32
+ namespace: argocd
33
+ spec:
34
+ project: default
35
+ source:
36
+ repoURL: https://github.com/myorg/myapp
37
+ targetRevision: HEAD
38
+ path: k8s/manifests
39
+ destination:
40
+ server: https://kubernetes.default.svc
41
+ namespace: default
42
+ syncPolicy:
43
+ automated:
44
+ prune: true
45
+ selfHeal: true
46
+ ```
47
+
48
+ ## Deployment Patterns
49
+
50
+ ### Rolling Update
51
+ ```yaml
52
+ spec:
53
+ strategy:
54
+ type: RollingUpdate
55
+ rollingUpdate:
56
+ maxSurge: 1
57
+ maxUnavailable: 0
58
+ ```
59
+
60
+ ### Blue-Green
61
+ ```yaml
62
+ # Two deployments: myapp-blue, myapp-green
63
+ # Service selector switches between versions
64
+ selector:
65
+ app: myapp
66
+ version: blue # Change to 'green' to switch
67
+ ```
68
+
69
+ ### Canary (with Istio)
70
+ ```yaml
71
+ route:
72
+ - destination: { host: myapp, subset: v1 }
73
+ weight: 90
74
+ - destination: { host: myapp, subset: v2 }
75
+ weight: 10 # 10% canary
76
+ ```
77
+
78
+ See `kubernetes-workflows-advanced.md` for CI/CD, Kustomize patterns.