codeply-cli 0.5.6 → 0.6.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 (429) hide show
  1. package/LICENSE +21 -21
  2. package/THIRD_PARTY_NOTICES.md +65 -65
  3. package/bin/codeply.js +8 -3
  4. package/lib/agent.mjs +2596 -2268
  5. package/lib/ai.js +135 -27
  6. package/lib/ai.mjs +6 -6
  7. package/lib/apply-patch.js +217 -217
  8. package/lib/arity-table.json +138 -138
  9. package/lib/arity.js +70 -70
  10. package/lib/auth.mjs +6 -6
  11. package/lib/autopilot.js +84 -0
  12. package/lib/bot-mail.js +46 -0
  13. package/lib/bots.js +142 -15
  14. package/lib/brain.js +914 -0
  15. package/lib/call-assist.js +120 -0
  16. package/lib/chatgpt.js +282 -282
  17. package/lib/cloud-browser.mjs +143 -143
  18. package/lib/cloud.mjs +1396 -1320
  19. package/lib/commands.js +103 -103
  20. package/lib/computer.js +136 -0
  21. package/lib/design-library/assemble-artifact.mjs +21 -21
  22. package/lib/design-library/cleanup.mjs +45 -45
  23. package/lib/design-library/index.json +22379 -22379
  24. package/lib/design-library/make-table-data.mjs +39 -39
  25. package/lib/design-tools.mjs +173 -0
  26. package/lib/diagnostics.js +192 -192
  27. package/lib/dsh-acp.mjs +444 -0
  28. package/lib/edit-engine.js +364 -364
  29. package/lib/github-agent.mjs +326 -326
  30. package/lib/handoff.mjs +245 -0
  31. package/lib/history.js +78 -75
  32. package/lib/life-sources.js +319 -0
  33. package/lib/life-store.js +356 -0
  34. package/lib/life-triggers.js +286 -0
  35. package/lib/life.js +487 -0
  36. package/lib/mail-watch.js +3 -3
  37. package/lib/mcp.js +258 -258
  38. package/lib/native-tools.mjs +17 -5
  39. package/lib/oauth-connectors.js +76 -21
  40. package/lib/permissions.js +109 -109
  41. package/lib/plugins.js +356 -353
  42. package/lib/reach.js +67 -67
  43. package/lib/render-md.mjs +647 -617
  44. package/lib/screen.js +77 -0
  45. package/lib/server.mjs +458 -457
  46. package/lib/session-db.js +220 -220
  47. package/lib/share.js +208 -168
  48. package/lib/skills.js +4 -1
  49. package/lib/snapshot.js +146 -146
  50. package/lib/subagents.js +4 -2
  51. package/lib/telemetry.js +105 -105
  52. package/lib/terminal-hints.js +154 -154
  53. package/lib/textarea.mjs +264 -258
  54. package/lib/tools.mjs +326 -40
  55. package/lib/tui.mjs +1459 -1086
  56. package/lib/typecheck-worker.js +147 -147
  57. package/lib/web-tools.js +209 -209
  58. package/package.json +1 -1
  59. package/skills/SOURCE.md +58 -58
  60. package/skills/accessibility/SKILL.md +147 -147
  61. package/skills/agent-architecture-audit/SKILL.md +257 -257
  62. package/skills/agent-eval/SKILL.md +147 -147
  63. package/skills/agent-harness-construction/SKILL.md +74 -74
  64. package/skills/agent-introspection-debugging/SKILL.md +154 -154
  65. package/skills/agent-payment-x402/SKILL.md +225 -225
  66. package/skills/agent-self-evaluation/SKILL.md +182 -182
  67. package/skills/agent-self-evaluation/references/evaluation-criteria.md +71 -71
  68. package/skills/agent-self-evaluation/references/hook-integration.md +64 -64
  69. package/skills/agent-sort/SKILL.md +216 -216
  70. package/skills/agentic-engineering/SKILL.md +64 -64
  71. package/skills/agentic-os/SKILL.md +388 -388
  72. package/skills/ai-first-engineering/SKILL.md +52 -52
  73. package/skills/ai-regression-testing/SKILL.md +386 -386
  74. package/skills/android-clean-architecture/SKILL.md +340 -340
  75. package/skills/angular-developer/SKILL.md +155 -155
  76. package/skills/angular-developer/references/angular-animations.md +160 -160
  77. package/skills/angular-developer/references/angular-aria.md +410 -410
  78. package/skills/angular-developer/references/cli.md +86 -86
  79. package/skills/angular-developer/references/component-harnesses.md +59 -59
  80. package/skills/angular-developer/references/component-styling.md +91 -91
  81. package/skills/angular-developer/references/components.md +117 -117
  82. package/skills/angular-developer/references/creating-services.md +97 -97
  83. package/skills/angular-developer/references/data-resolvers.md +69 -69
  84. package/skills/angular-developer/references/define-routes.md +67 -67
  85. package/skills/angular-developer/references/defining-providers.md +72 -72
  86. package/skills/angular-developer/references/di-fundamentals.md +120 -120
  87. package/skills/angular-developer/references/e2e-testing.md +56 -56
  88. package/skills/angular-developer/references/effects.md +83 -83
  89. package/skills/angular-developer/references/hierarchical-injectors.md +43 -43
  90. package/skills/angular-developer/references/host-elements.md +80 -80
  91. package/skills/angular-developer/references/injection-context.md +63 -63
  92. package/skills/angular-developer/references/inputs.md +101 -101
  93. package/skills/angular-developer/references/linked-signal.md +59 -59
  94. package/skills/angular-developer/references/loading-strategies.md +61 -61
  95. package/skills/angular-developer/references/mcp.md +108 -108
  96. package/skills/angular-developer/references/navigate-to-routes.md +69 -69
  97. package/skills/angular-developer/references/outputs.md +86 -86
  98. package/skills/angular-developer/references/reactive-forms.md +122 -122
  99. package/skills/angular-developer/references/rendering-strategies.md +44 -44
  100. package/skills/angular-developer/references/resource.md +77 -77
  101. package/skills/angular-developer/references/route-animations.md +56 -56
  102. package/skills/angular-developer/references/route-guards.md +52 -52
  103. package/skills/angular-developer/references/router-lifecycle.md +45 -45
  104. package/skills/angular-developer/references/router-testing.md +87 -87
  105. package/skills/angular-developer/references/show-routes-with-outlets.md +68 -68
  106. package/skills/angular-developer/references/signal-forms.md +795 -795
  107. package/skills/angular-developer/references/signals-overview.md +94 -94
  108. package/skills/angular-developer/references/tailwind-css.md +69 -69
  109. package/skills/angular-developer/references/template-driven-forms.md +114 -114
  110. package/skills/angular-developer/references/testing-fundamentals.md +65 -65
  111. package/skills/api-connector-builder/SKILL.md +121 -121
  112. package/skills/api-design/SKILL.md +524 -524
  113. package/skills/architecture-decision-records/SKILL.md +180 -180
  114. package/skills/article-writing/SKILL.md +80 -80
  115. package/skills/automation-audit-ops/SKILL.md +143 -143
  116. package/skills/autonomous-agent-harness/SKILL.md +274 -274
  117. package/skills/autonomous-loops/SKILL.md +611 -611
  118. package/skills/backend-patterns/SKILL.md +562 -562
  119. package/skills/benchmark/SKILL.md +95 -95
  120. package/skills/benchmark-methodology/SKILL.md +191 -191
  121. package/skills/benchmark-optimization-loop/SKILL.md +71 -71
  122. package/skills/blender-motion-state-inspection/SKILL.md +165 -165
  123. package/skills/blueprint/SKILL.md +106 -106
  124. package/skills/brand-discovery/SKILL.md +145 -145
  125. package/skills/brand-discovery/references/10_purpose-why.md +40 -40
  126. package/skills/brand-discovery/references/20_positioning.md +44 -44
  127. package/skills/brand-discovery/references/30_audience-niche.md +52 -52
  128. package/skills/brand-discovery/references/40_personality-archetype.md +57 -57
  129. package/skills/brand-discovery/references/50_voice-tone.md +59 -59
  130. package/skills/brand-discovery/references/60_narrative-story.md +50 -50
  131. package/skills/brand-discovery/references/70_founder-tension.md +49 -49
  132. package/skills/brand-discovery/references/90_SYNTHESIS.md +133 -133
  133. package/skills/brand-voice/SKILL.md +98 -98
  134. package/skills/brand-voice/references/voice-profile-schema.md +55 -55
  135. package/skills/browser-qa/SKILL.md +105 -105
  136. package/skills/bun-runtime/SKILL.md +85 -85
  137. package/skills/canary-watch/SKILL.md +108 -108
  138. package/skills/carrier-relationship-management/SKILL.md +212 -212
  139. package/skills/cisco-ios-patterns/SKILL.md +164 -164
  140. package/skills/ck/SKILL.md +148 -148
  141. package/skills/claude-devfleet/SKILL.md +112 -112
  142. package/skills/click-path-audit/SKILL.md +245 -245
  143. package/skills/clickhouse-io/SKILL.md +445 -445
  144. package/skills/code-tour/SKILL.md +254 -254
  145. package/skills/codebase-onboarding/SKILL.md +234 -234
  146. package/skills/codehealth-mcp/SKILL.md +167 -167
  147. package/skills/codeply-taste/LICENSE +21 -0
  148. package/skills/codeply-taste/SKILL.md +100 -0
  149. package/skills/codeply-taste/SOURCE.md +10 -0
  150. package/skills/codeply-taste/assets/base.css +100 -0
  151. package/skills/codeply-taste/assets/base.js +37 -0
  152. package/skills/codeply-taste/library/directions.json +1078 -0
  153. package/skills/codeply-taste/library/heroes.json +894 -0
  154. package/skills/codeply-taste/library/motions.json +57 -0
  155. package/skills/codeply-taste/library/palettes.json +1485 -0
  156. package/skills/codeply-taste/library/photos.json +7240 -0
  157. package/skills/codeply-taste/library/sections.json +4136 -0
  158. package/skills/codeply-taste/library/sites.json +7274 -0
  159. package/skills/codeply-taste/library/type.json +2024 -0
  160. package/skills/codeply-taste/references/colour.md +141 -0
  161. package/skills/codeply-taste/references/copy.md +177 -0
  162. package/skills/codeply-taste/references/critique.md +171 -0
  163. package/skills/codeply-taste/references/imagery.md +377 -0
  164. package/skills/codeply-taste/references/layout.md +178 -0
  165. package/skills/codeply-taste/references/motion.md +292 -0
  166. package/skills/codeply-taste/references/research.md +306 -0
  167. package/skills/codeply-taste/references/tells.md +115 -0
  168. package/skills/codeply-taste/references/type.md +170 -0
  169. package/skills/codeply-taste/scripts/assets.mjs +865 -0
  170. package/skills/codeply-taste/scripts/draw.mjs +525 -0
  171. package/skills/codeply-taste/scripts/inspect.mjs +205 -0
  172. package/skills/codeply-taste/scripts/lib/cdp.mjs +205 -0
  173. package/skills/codeply-taste/scripts/lib/probe.mjs +569 -0
  174. package/skills/codeply-taste/scripts/lib/rules.mjs +137 -0
  175. package/skills/codeply-taste/scripts/lint.mjs +108 -0
  176. package/skills/coding-standards/SKILL.md +551 -551
  177. package/skills/competitive-platform-analysis/SKILL.md +214 -214
  178. package/skills/competitive-report-structure/SKILL.md +162 -162
  179. package/skills/compose-multiplatform-patterns/SKILL.md +300 -300
  180. package/skills/config-gc/SKILL.md +120 -120
  181. package/skills/configure-ecc/SKILL.md +385 -385
  182. package/skills/connections-optimizer/SKILL.md +190 -190
  183. package/skills/content-engine/SKILL.md +132 -132
  184. package/skills/content-hash-cache-pattern/SKILL.md +162 -162
  185. package/skills/context-budget/SKILL.md +136 -136
  186. package/skills/continuous-agent-loop/SKILL.md +46 -46
  187. package/skills/continuous-learning/SKILL.md +132 -132
  188. package/skills/continuous-learning-v2/SKILL.md +361 -361
  189. package/skills/contract-first/SKILL.md +287 -287
  190. package/skills/cost-aware-llm-pipeline/SKILL.md +184 -184
  191. package/skills/cost-tracking/SKILL.md +97 -97
  192. package/skills/council/SKILL.md +204 -204
  193. package/skills/cpp-coding-standards/SKILL.md +724 -724
  194. package/skills/cpp-testing/SKILL.md +325 -325
  195. package/skills/crosspost/SKILL.md +112 -112
  196. package/skills/csharp-testing/SKILL.md +322 -322
  197. package/skills/customer-billing-ops/SKILL.md +141 -141
  198. package/skills/customs-trade-compliance/SKILL.md +263 -263
  199. package/skills/dart-flutter-patterns/SKILL.md +564 -564
  200. package/skills/dashboard-builder/SKILL.md +109 -109
  201. package/skills/data-scraper-agent/SKILL.md +765 -765
  202. package/skills/data-throughput-accelerator/SKILL.md +74 -74
  203. package/skills/database-migrations/SKILL.md +430 -430
  204. package/skills/deep-research/SKILL.md +160 -160
  205. package/skills/defi-amm-security/SKILL.md +167 -167
  206. package/skills/delivery-gate/SKILL.md +126 -126
  207. package/skills/deployment-patterns/SKILL.md +428 -428
  208. package/skills/design-system/SKILL.md +83 -83
  209. package/skills/django-celery/SKILL.md +458 -458
  210. package/skills/django-patterns/SKILL.md +735 -735
  211. package/skills/django-security/SKILL.md +644 -644
  212. package/skills/django-tdd/SKILL.md +730 -730
  213. package/skills/django-verification/SKILL.md +470 -470
  214. package/skills/dmux-workflows/SKILL.md +192 -192
  215. package/skills/docker-patterns/SKILL.md +365 -365
  216. package/skills/documentation-lookup/SKILL.md +91 -91
  217. package/skills/dotnet-patterns/SKILL.md +322 -322
  218. package/skills/dynamic-workflow-mode/SKILL.md +124 -124
  219. package/skills/e2e-testing/SKILL.md +327 -327
  220. package/skills/ecc-guide/SKILL.md +190 -190
  221. package/skills/ecc-recipes/SKILL.md +149 -149
  222. package/skills/ecc-tools-cost-audit/SKILL.md +161 -161
  223. package/skills/email-ops/SKILL.md +122 -122
  224. package/skills/energy-procurement/SKILL.md +228 -228
  225. package/skills/enterprise-agent-ops/SKILL.md +51 -51
  226. package/skills/error-handling/SKILL.md +377 -377
  227. package/skills/eval-harness/SKILL.md +271 -271
  228. package/skills/evm-token-decimals/SKILL.md +131 -131
  229. package/skills/exa-search/SKILL.md +108 -108
  230. package/skills/fal-ai-media/SKILL.md +289 -289
  231. package/skills/fastapi-patterns/SKILL.md +514 -514
  232. package/skills/finance-billing-ops/SKILL.md +128 -128
  233. package/skills/flox-environments/SKILL.md +497 -497
  234. package/skills/flutter-dart-code-review/SKILL.md +436 -436
  235. package/skills/foundation-models-on-device/SKILL.md +243 -243
  236. package/skills/frontend-a11y/SKILL.md +446 -446
  237. package/skills/frontend-design-direction/SKILL.md +93 -93
  238. package/skills/frontend-patterns/SKILL.md +657 -657
  239. package/skills/frontend-slides/SKILL.md +185 -185
  240. package/skills/fsharp-testing/SKILL.md +281 -281
  241. package/skills/gan-style-harness/SKILL.md +279 -279
  242. package/skills/gateguard/SKILL.md +133 -133
  243. package/skills/generating-python-installer/SKILL.md +820 -820
  244. package/skills/git-workflow/SKILL.md +716 -716
  245. package/skills/github-ops/SKILL.md +145 -145
  246. package/skills/golang-patterns/SKILL.md +676 -676
  247. package/skills/golang-testing/SKILL.md +721 -721
  248. package/skills/google-workspace-ops/SKILL.md +96 -96
  249. package/skills/growth-log/SKILL.md +128 -128
  250. package/skills/healthcare-cdss-patterns/SKILL.md +246 -246
  251. package/skills/healthcare-emr-patterns/SKILL.md +160 -160
  252. package/skills/healthcare-eval-harness/SKILL.md +208 -208
  253. package/skills/healthcare-phi-compliance/SKILL.md +146 -146
  254. package/skills/hermes-imports/SKILL.md +89 -89
  255. package/skills/hexagonal-architecture/SKILL.md +277 -277
  256. package/skills/hipaa-compliance/SKILL.md +79 -79
  257. package/skills/homelab-network-readiness/SKILL.md +170 -170
  258. package/skills/homelab-network-setup/SKILL.md +130 -130
  259. package/skills/homelab-pihole-dns/SKILL.md +275 -275
  260. package/skills/homelab-vlan-segmentation/SKILL.md +312 -312
  261. package/skills/homelab-wireguard-vpn/SKILL.md +306 -306
  262. package/skills/hookify-rules/SKILL.md +128 -128
  263. package/skills/inherit-legacy-style/SKILL.md +157 -157
  264. package/skills/intent-driven-development/SKILL.md +360 -360
  265. package/skills/inventory-demand-planning/SKILL.md +247 -247
  266. package/skills/investor-materials/SKILL.md +97 -97
  267. package/skills/investor-outreach/SKILL.md +92 -92
  268. package/skills/ios-icon-gen/SKILL.md +158 -158
  269. package/skills/iterative-retrieval/SKILL.md +212 -212
  270. package/skills/ito-basket-compare/SKILL.md +64 -64
  271. package/skills/ito-compute/SKILL.md +129 -129
  272. package/skills/ito-data-atlas-agent/SKILL.md +64 -64
  273. package/skills/ito-market-intelligence/SKILL.md +61 -61
  274. package/skills/ito-trade-planner/SKILL.md +68 -68
  275. package/skills/java-coding-standards/SKILL.md +384 -384
  276. package/skills/jira-integration/SKILL.md +303 -303
  277. package/skills/jpa-patterns/SKILL.md +152 -152
  278. package/skills/knowledge-ops/SKILL.md +155 -155
  279. package/skills/kotlin-coroutines-flows/SKILL.md +285 -285
  280. package/skills/kotlin-exposed-patterns/SKILL.md +720 -720
  281. package/skills/kotlin-ktor-patterns/SKILL.md +690 -690
  282. package/skills/kotlin-patterns/SKILL.md +712 -712
  283. package/skills/kotlin-testing/SKILL.md +825 -825
  284. package/skills/kubernetes-patterns/SKILL.md +756 -756
  285. package/skills/laravel-patterns/SKILL.md +416 -416
  286. package/skills/laravel-plugin-discovery/SKILL.md +230 -230
  287. package/skills/laravel-security/SKILL.md +948 -948
  288. package/skills/laravel-tdd/SKILL.md +675 -675
  289. package/skills/laravel-verification/SKILL.md +180 -180
  290. package/skills/latency-critical-systems/SKILL.md +75 -75
  291. package/skills/lead-intelligence/SKILL.md +322 -322
  292. package/skills/liquid-glass-design/SKILL.md +279 -279
  293. package/skills/llm-trading-agent-security/SKILL.md +147 -147
  294. package/skills/logistics-exception-management/SKILL.md +222 -222
  295. package/skills/loop-design-check/SKILL.md +143 -143
  296. package/skills/mailtrap-email-integration/SKILL.md +77 -77
  297. package/skills/make-interfaces-feel-better/SKILL.md +152 -152
  298. package/skills/manim-video/SKILL.md +90 -90
  299. package/skills/market-research/SKILL.md +76 -76
  300. package/skills/marketing-campaign/SKILL.md +114 -114
  301. package/skills/mcp-server-patterns/SKILL.md +70 -70
  302. package/skills/messages-ops/SKILL.md +105 -105
  303. package/skills/ml-adoption-playbook/SKILL.md +57 -57
  304. package/skills/mle-workflow/SKILL.md +348 -348
  305. package/skills/motion-advanced/SKILL.md +596 -596
  306. package/skills/motion-foundations/SKILL.md +299 -299
  307. package/skills/motion-patterns/SKILL.md +434 -434
  308. package/skills/motion-ui/SKILL.md +576 -576
  309. package/skills/mysql-patterns/SKILL.md +413 -413
  310. package/skills/nanoclaw-repl/SKILL.md +34 -34
  311. package/skills/nestjs-patterns/SKILL.md +231 -231
  312. package/skills/netmiko-ssh-automation/SKILL.md +174 -174
  313. package/skills/network-bgp-diagnostics/SKILL.md +168 -168
  314. package/skills/network-config-validation/SKILL.md +211 -211
  315. package/skills/network-interface-health/SKILL.md +153 -153
  316. package/skills/nextjs-turbopack/SKILL.md +58 -58
  317. package/skills/nodejs-keccak256/SKILL.md +103 -103
  318. package/skills/nutrient-document-processing/SKILL.md +168 -168
  319. package/skills/nuxt4-patterns/SKILL.md +101 -101
  320. package/skills/openclaw-persona-forge/SKILL.md +289 -289
  321. package/skills/openclaw-persona-forge/references/avatar-style.md +124 -124
  322. package/skills/openclaw-persona-forge/references/boundary-rules.md +53 -53
  323. package/skills/openclaw-persona-forge/references/error-handling.md +53 -53
  324. package/skills/openclaw-persona-forge/references/identity-tension.md +48 -48
  325. package/skills/openclaw-persona-forge/references/naming-system.md +39 -39
  326. package/skills/openclaw-persona-forge/references/output-template.md +166 -166
  327. package/skills/opensource-pipeline/SKILL.md +256 -256
  328. package/skills/orch-add-feature/SKILL.md +45 -45
  329. package/skills/orch-build-mvp/SKILL.md +49 -49
  330. package/skills/orch-change-feature/SKILL.md +43 -43
  331. package/skills/orch-fix-defect/SKILL.md +43 -43
  332. package/skills/orch-pipeline/SKILL.md +121 -121
  333. package/skills/orch-refine-code/SKILL.md +44 -44
  334. package/skills/parallel-execution-optimizer/SKILL.md +74 -74
  335. package/skills/perl-patterns/SKILL.md +505 -505
  336. package/skills/perl-security/SKILL.md +504 -504
  337. package/skills/perl-testing/SKILL.md +476 -476
  338. package/skills/plan-canvas/SKILL.md +153 -153
  339. package/skills/plan-orchestrate/SKILL.md +263 -263
  340. package/skills/plankton-code-quality/SKILL.md +237 -237
  341. package/skills/postgres-patterns/SKILL.md +148 -148
  342. package/skills/prediction-market-oracle-research/SKILL.md +64 -64
  343. package/skills/prediction-market-risk-review/SKILL.md +61 -61
  344. package/skills/premium-web-design/SKILL.md +154 -154
  345. package/skills/prisma-patterns/SKILL.md +401 -401
  346. package/skills/product-capability/SKILL.md +142 -142
  347. package/skills/product-lens/SKILL.md +93 -93
  348. package/skills/production-audit/SKILL.md +207 -207
  349. package/skills/production-scheduling/SKILL.md +238 -238
  350. package/skills/project-flow-ops/SKILL.md +112 -112
  351. package/skills/prompt-optimizer/SKILL.md +398 -398
  352. package/skills/python-patterns/SKILL.md +751 -751
  353. package/skills/python-testing/SKILL.md +817 -817
  354. package/skills/pytorch-patterns/SKILL.md +397 -397
  355. package/skills/quality-nonconformance/SKILL.md +260 -260
  356. package/skills/quarkus-patterns/SKILL.md +723 -723
  357. package/skills/quarkus-security/SKILL.md +468 -468
  358. package/skills/quarkus-tdd/SKILL.md +812 -812
  359. package/skills/quarkus-verification/SKILL.md +480 -480
  360. package/skills/ralphinho-rfc-pipeline/SKILL.md +68 -68
  361. package/skills/react-native-patterns/SKILL.md +326 -326
  362. package/skills/react-patterns/SKILL.md +342 -342
  363. package/skills/react-performance/SKILL.md +575 -575
  364. package/skills/react-testing/SKILL.md +424 -424
  365. package/skills/recsys-pipeline-architect/SKILL.md +115 -115
  366. package/skills/recursive-decision-ledger/SKILL.md +81 -81
  367. package/skills/redis-patterns/SKILL.md +404 -404
  368. package/skills/regex-vs-llm-structured-text/SKILL.md +221 -221
  369. package/skills/remotion-video-creation/SKILL.md +43 -43
  370. package/skills/repo-scan/SKILL.md +79 -79
  371. package/skills/research-ops/SKILL.md +113 -113
  372. package/skills/returns-reverse-logistics/SKILL.md +240 -240
  373. package/skills/rules-distill/SKILL.md +265 -265
  374. package/skills/rust-patterns/SKILL.md +500 -500
  375. package/skills/rust-testing/SKILL.md +501 -501
  376. package/skills/safety-guard/SKILL.md +76 -76
  377. package/skills/santa-method/SKILL.md +307 -307
  378. package/skills/scientific-db-pubmed-database/SKILL.md +176 -176
  379. package/skills/scientific-db-uspto-database/SKILL.md +178 -178
  380. package/skills/scientific-pkg-gget/SKILL.md +167 -167
  381. package/skills/scientific-thinking-literature-review/SKILL.md +193 -193
  382. package/skills/scientific-thinking-scholar-evaluation/SKILL.md +161 -161
  383. package/skills/search-first/SKILL.md +183 -183
  384. package/skills/security-bounty-hunter/SKILL.md +100 -100
  385. package/skills/security-review/SKILL.md +504 -504
  386. package/skills/security-scan/SKILL.md +166 -166
  387. package/skills/seo/SKILL.md +155 -155
  388. package/skills/skill-comply/SKILL.md +59 -59
  389. package/skills/skill-scout/SKILL.md +141 -141
  390. package/skills/skill-stocktake/SKILL.md +195 -195
  391. package/skills/social-graph-ranker/SKILL.md +155 -155
  392. package/skills/social-publisher/SKILL.md +130 -130
  393. package/skills/springboot-patterns/SKILL.md +315 -315
  394. package/skills/springboot-security/SKILL.md +273 -273
  395. package/skills/springboot-tdd/SKILL.md +159 -159
  396. package/skills/springboot-verification/SKILL.md +232 -232
  397. package/skills/strategic-compact/SKILL.md +142 -142
  398. package/skills/swift-actor-persistence/SKILL.md +144 -144
  399. package/skills/swift-concurrency-6-2/SKILL.md +216 -216
  400. package/skills/swift-protocol-di-testing/SKILL.md +191 -191
  401. package/skills/swiftui-patterns/SKILL.md +259 -259
  402. package/skills/taste/SKILL.md +264 -264
  403. package/skills/taste/references/genre-taxonomy.md +87 -87
  404. package/skills/tdd-workflow/SKILL.md +583 -583
  405. package/skills/team-agent-orchestration/SKILL.md +111 -111
  406. package/skills/team-builder/SKILL.md +169 -169
  407. package/skills/terminal-ops/SKILL.md +110 -110
  408. package/skills/tinystruct-patterns/SKILL.md +279 -279
  409. package/skills/tinystruct-patterns/references/architecture.md +90 -90
  410. package/skills/tinystruct-patterns/references/data-handling.md +60 -60
  411. package/skills/tinystruct-patterns/references/database.md +99 -99
  412. package/skills/tinystruct-patterns/references/routing.md +64 -64
  413. package/skills/tinystruct-patterns/references/system-usage.md +97 -97
  414. package/skills/tinystruct-patterns/references/testing.md +72 -72
  415. package/skills/token-budget-advisor/SKILL.md +134 -134
  416. package/skills/ui-demo/SKILL.md +466 -466
  417. package/skills/ui-to-vue/SKILL.md +135 -135
  418. package/skills/uncloud/SKILL.md +344 -344
  419. package/skills/unified-memory/SKILL.md +170 -170
  420. package/skills/unified-notifications-ops/SKILL.md +188 -188
  421. package/skills/verification-loop/SKILL.md +129 -129
  422. package/skills/video-editing/SKILL.md +311 -311
  423. package/skills/videodb/SKILL.md +375 -375
  424. package/skills/visa-doc-translate/SKILL.md +117 -117
  425. package/skills/vite-patterns/SKILL.md +450 -450
  426. package/skills/vue-patterns/SKILL.md +471 -471
  427. package/skills/windows-desktop-e2e/SKILL.md +888 -888
  428. package/skills/workspace-surface-audit/SKILL.md +126 -126
  429. package/skills/x-api/SKILL.md +235 -235
@@ -1,428 +1,428 @@
1
- ---
2
- name: deployment-patterns
3
- description: Deployment workflows, CI/CD pipeline patterns, Docker containerization, health checks, rollback strategies, and production readiness checklists for web applications.
4
- metadata:
5
- origin: ECC
6
- ---
7
-
8
- # Deployment Patterns
9
-
10
- Production deployment workflows and CI/CD best practices.
11
-
12
- ## When to Activate
13
-
14
- - Setting up CI/CD pipelines
15
- - Dockerizing an application
16
- - Planning deployment strategy (blue-green, canary, rolling)
17
- - Implementing health checks and readiness probes
18
- - Preparing for a production release
19
- - Configuring environment-specific settings
20
-
21
- ## Deployment Strategies
22
-
23
- ### Rolling Deployment (Default)
24
-
25
- Replace instances gradually — old and new versions run simultaneously during rollout.
26
-
27
- ```
28
- Instance 1: v1 → v2 (update first)
29
- Instance 2: v1 (still running v1)
30
- Instance 3: v1 (still running v1)
31
-
32
- Instance 1: v2
33
- Instance 2: v1 → v2 (update second)
34
- Instance 3: v1
35
-
36
- Instance 1: v2
37
- Instance 2: v2
38
- Instance 3: v1 → v2 (update last)
39
- ```
40
-
41
- **Pros:** Zero downtime, gradual rollout
42
- **Cons:** Two versions run simultaneously — requires backward-compatible changes
43
- **Use when:** Standard deployments, backward-compatible changes
44
-
45
- ### Blue-Green Deployment
46
-
47
- Run two identical environments. Switch traffic atomically.
48
-
49
- ```
50
- Blue (v1) ← traffic
51
- Green (v2) idle, running new version
52
-
53
- # After verification:
54
- Blue (v1) idle (becomes standby)
55
- Green (v2) ← traffic
56
- ```
57
-
58
- **Pros:** Instant rollback (switch back to blue), clean cutover
59
- **Cons:** Requires 2x infrastructure during deployment
60
- **Use when:** Critical services, zero-tolerance for issues
61
-
62
- ### Canary Deployment
63
-
64
- Route a small percentage of traffic to the new version first.
65
-
66
- ```
67
- v1: 95% of traffic
68
- v2: 5% of traffic (canary)
69
-
70
- # If metrics look good:
71
- v1: 50% of traffic
72
- v2: 50% of traffic
73
-
74
- # Final:
75
- v2: 100% of traffic
76
- ```
77
-
78
- **Pros:** Catches issues with real traffic before full rollout
79
- **Cons:** Requires traffic splitting infrastructure, monitoring
80
- **Use when:** High-traffic services, risky changes, feature flags
81
-
82
- ## Docker
83
-
84
- ### Multi-Stage Dockerfile (Node.js)
85
-
86
- ```dockerfile
87
- # Stage 1: Install dependencies
88
- FROM node:22-alpine AS deps
89
- WORKDIR /app
90
- COPY package.json package-lock.json ./
91
- RUN npm ci --production=false
92
-
93
- # Stage 2: Build
94
- FROM node:22-alpine AS builder
95
- WORKDIR /app
96
- COPY --from=deps /app/node_modules ./node_modules
97
- COPY . .
98
- RUN npm run build
99
- RUN npm prune --production
100
-
101
- # Stage 3: Production image
102
- FROM node:22-alpine AS runner
103
- WORKDIR /app
104
-
105
- RUN addgroup -g 1001 -S appgroup && adduser -S appuser -u 1001
106
- USER appuser
107
-
108
- COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
109
- COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
110
- COPY --from=builder --chown=appuser:appgroup /app/package.json ./
111
-
112
- ENV NODE_ENV=production
113
- EXPOSE 3000
114
-
115
- HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
116
- CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
117
-
118
- CMD ["node", "dist/server.js"]
119
- ```
120
-
121
- ### Multi-Stage Dockerfile (Go)
122
-
123
- ```dockerfile
124
- FROM golang:1.22-alpine AS builder
125
- WORKDIR /app
126
- COPY go.mod go.sum ./
127
- RUN go mod download
128
- COPY . .
129
- RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o /server ./cmd/server
130
-
131
- FROM alpine:3.19 AS runner
132
- RUN apk --no-cache add ca-certificates
133
- RUN adduser -D -u 1001 appuser
134
- USER appuser
135
-
136
- COPY --from=builder /server /server
137
-
138
- EXPOSE 8080
139
- HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:8080/health || exit 1
140
- CMD ["/server"]
141
- ```
142
-
143
- ### Multi-Stage Dockerfile (Python/Django)
144
-
145
- ```dockerfile
146
- FROM python:3.12-slim AS builder
147
- WORKDIR /app
148
- RUN pip install --no-cache-dir uv
149
- COPY requirements.txt .
150
- RUN uv pip install --system --no-cache -r requirements.txt
151
-
152
- FROM python:3.12-slim AS runner
153
- WORKDIR /app
154
-
155
- RUN useradd -r -u 1001 appuser
156
- USER appuser
157
-
158
- COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
159
- COPY --from=builder /usr/local/bin /usr/local/bin
160
- COPY . .
161
-
162
- ENV PYTHONUNBUFFERED=1
163
- EXPOSE 8000
164
-
165
- HEALTHCHECK --interval=30s --timeout=3s CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health/')" || exit 1
166
- CMD ["gunicorn", "config.wsgi:application", "--bind", "0.0.0.0:8000", "--workers", "4"]
167
- ```
168
-
169
- ### Docker Best Practices
170
-
171
- ```
172
- # GOOD practices
173
- - Use specific version tags (node:22-alpine, not node:latest)
174
- - Multi-stage builds to minimize image size
175
- - Run as non-root user
176
- - Copy dependency files first (layer caching)
177
- - Use .dockerignore to exclude node_modules, .git, tests
178
- - Add HEALTHCHECK instruction
179
- - Set resource limits in docker-compose or k8s
180
-
181
- # BAD practices
182
- - Running as root
183
- - Using :latest tags
184
- - Copying entire repo in one COPY layer
185
- - Installing dev dependencies in production image
186
- - Storing secrets in image (use env vars or secrets manager)
187
- ```
188
-
189
- ## CI/CD Pipeline
190
-
191
- ### GitHub Actions (Standard Pipeline)
192
-
193
- ```yaml
194
- name: CI/CD
195
-
196
- on:
197
- push:
198
- branches: [main]
199
- pull_request:
200
- branches: [main]
201
-
202
- jobs:
203
- test:
204
- runs-on: ubuntu-latest
205
- steps:
206
- - uses: actions/checkout@v4
207
- - uses: actions/setup-node@v4
208
- with:
209
- node-version: 22
210
- cache: npm
211
- - run: npm ci
212
- - run: npm run lint
213
- - run: npm run typecheck
214
- - run: npm test -- --coverage
215
- - uses: actions/upload-artifact@v4
216
- if: always()
217
- with:
218
- name: coverage
219
- path: coverage/
220
-
221
- build:
222
- needs: test
223
- runs-on: ubuntu-latest
224
- if: github.ref == 'refs/heads/main'
225
- steps:
226
- - uses: actions/checkout@v4
227
- - uses: docker/setup-buildx-action@v3
228
- - uses: docker/login-action@v3
229
- with:
230
- registry: ghcr.io
231
- username: ${{ github.actor }}
232
- password: ${{ secrets.GITHUB_TOKEN }}
233
- - uses: docker/build-push-action@v5
234
- with:
235
- push: true
236
- tags: ghcr.io/${{ github.repository }}:${{ github.sha }}
237
- cache-from: type=gha
238
- cache-to: type=gha,mode=max
239
-
240
- deploy:
241
- needs: build
242
- runs-on: ubuntu-latest
243
- if: github.ref == 'refs/heads/main'
244
- environment: production
245
- steps:
246
- - name: Deploy to production
247
- run: |
248
- # Platform-specific deployment command
249
- # Railway: railway up
250
- # Vercel: vercel --prod
251
- # K8s: kubectl set image deployment/app app=ghcr.io/${{ github.repository }}:${{ github.sha }}
252
- echo "Deploying ${{ github.sha }}"
253
- ```
254
-
255
- ### Pipeline Stages
256
-
257
- ```
258
- PR opened:
259
- lint → typecheck → unit tests → integration tests → preview deploy
260
-
261
- Merged to main:
262
- lint → typecheck → unit tests → integration tests → build image → deploy staging → smoke tests → deploy production
263
- ```
264
-
265
- ## Health Checks
266
-
267
- ### Health Check Endpoint
268
-
269
- ```typescript
270
- // Simple health check
271
- app.get("/health", (req, res) => {
272
- res.status(200).json({ status: "ok" });
273
- });
274
-
275
- // Detailed health check (for internal monitoring)
276
- app.get("/health/detailed", async (req, res) => {
277
- const checks = {
278
- database: await checkDatabase(),
279
- redis: await checkRedis(),
280
- externalApi: await checkExternalApi(),
281
- };
282
-
283
- const allHealthy = Object.values(checks).every(c => c.status === "ok");
284
-
285
- res.status(allHealthy ? 200 : 503).json({
286
- status: allHealthy ? "ok" : "degraded",
287
- timestamp: new Date().toISOString(),
288
- version: process.env.APP_VERSION || "unknown",
289
- uptime: process.uptime(),
290
- checks,
291
- });
292
- });
293
-
294
- async function checkDatabase(): Promise<HealthCheck> {
295
- try {
296
- await db.query("SELECT 1");
297
- return { status: "ok", latency_ms: 2 };
298
- } catch (err) {
299
- return { status: "error", message: "Database unreachable" };
300
- }
301
- }
302
- ```
303
-
304
- ### Kubernetes Probes
305
-
306
- ```yaml
307
- livenessProbe:
308
- httpGet:
309
- path: /health
310
- port: 3000
311
- initialDelaySeconds: 10
312
- periodSeconds: 30
313
- failureThreshold: 3
314
-
315
- readinessProbe:
316
- httpGet:
317
- path: /health
318
- port: 3000
319
- initialDelaySeconds: 5
320
- periodSeconds: 10
321
- failureThreshold: 2
322
-
323
- startupProbe:
324
- httpGet:
325
- path: /health
326
- port: 3000
327
- initialDelaySeconds: 0
328
- periodSeconds: 5
329
- failureThreshold: 30 # 30 * 5s = 150s max startup time
330
- ```
331
-
332
- ## Environment Configuration
333
-
334
- ### Twelve-Factor App Pattern
335
-
336
- ```bash
337
- # All config via environment variables — never in code
338
- DATABASE_URL=postgres://user:pass@host:5432/db
339
- REDIS_URL=redis://host:6379/0
340
- API_KEY=${API_KEY} # injected by secrets manager
341
- LOG_LEVEL=info
342
- PORT=3000
343
-
344
- # Environment-specific behavior
345
- NODE_ENV=production # or staging, development
346
- APP_ENV=production # explicit app environment
347
- ```
348
-
349
- ### Configuration Validation
350
-
351
- ```typescript
352
- import { z } from "zod";
353
-
354
- const envSchema = z.object({
355
- NODE_ENV: z.enum(["development", "staging", "production"]),
356
- PORT: z.coerce.number().default(3000),
357
- DATABASE_URL: z.string().url(),
358
- REDIS_URL: z.string().url(),
359
- JWT_SECRET: z.string().min(32),
360
- LOG_LEVEL: z.enum(["debug", "info", "warn", "error"]).default("info"),
361
- });
362
-
363
- // Validate at startup — fail fast if config is wrong
364
- export const env = envSchema.parse(process.env);
365
- ```
366
-
367
- ## Rollback Strategy
368
-
369
- ### Instant Rollback
370
-
371
- ```bash
372
- # Docker/Kubernetes: point to previous image
373
- kubectl rollout undo deployment/app
374
-
375
- # Vercel: promote previous deployment
376
- vercel rollback
377
-
378
- # Railway: redeploy previous commit
379
- railway up --commit <previous-sha>
380
-
381
- # Database: rollback migration (if reversible)
382
- npx prisma migrate resolve --rolled-back <migration-name>
383
- ```
384
-
385
- ### Rollback Checklist
386
-
387
- - [ ] Previous image/artifact is available and tagged
388
- - [ ] Database migrations are backward-compatible (no destructive changes)
389
- - [ ] Feature flags can disable new features without deploy
390
- - [ ] Monitoring alerts configured for error rate spikes
391
- - [ ] Rollback tested in staging before production release
392
-
393
- ## Production Readiness Checklist
394
-
395
- Before any production deployment:
396
-
397
- ### Application
398
- - [ ] All tests pass (unit, integration, E2E)
399
- - [ ] No hardcoded secrets in code or config files
400
- - [ ] Error handling covers all edge cases
401
- - [ ] Logging is structured (JSON) and does not contain PII
402
- - [ ] Health check endpoint returns meaningful status
403
-
404
- ### Infrastructure
405
- - [ ] Docker image builds reproducibly (pinned versions)
406
- - [ ] Environment variables documented and validated at startup
407
- - [ ] Resource limits set (CPU, memory)
408
- - [ ] Horizontal scaling configured (min/max instances)
409
- - [ ] SSL/TLS enabled on all endpoints
410
-
411
- ### Monitoring
412
- - [ ] Application metrics exported (request rate, latency, errors)
413
- - [ ] Alerts configured for error rate > threshold
414
- - [ ] Log aggregation set up (structured logs, searchable)
415
- - [ ] Uptime monitoring on health endpoint
416
-
417
- ### Security
418
- - [ ] Dependencies scanned for CVEs
419
- - [ ] CORS configured for allowed origins only
420
- - [ ] Rate limiting enabled on public endpoints
421
- - [ ] Authentication and authorization verified
422
- - [ ] Security headers set (CSP, HSTS, X-Frame-Options)
423
-
424
- ### Operations
425
- - [ ] Rollback plan documented and tested
426
- - [ ] Database migration tested against production-sized data
427
- - [ ] Runbook for common failure scenarios
428
- - [ ] On-call rotation and escalation path defined
1
+ ---
2
+ name: deployment-patterns
3
+ description: Deployment workflows, CI/CD pipeline patterns, Docker containerization, health checks, rollback strategies, and production readiness checklists for web applications.
4
+ metadata:
5
+ origin: ECC
6
+ ---
7
+
8
+ # Deployment Patterns
9
+
10
+ Production deployment workflows and CI/CD best practices.
11
+
12
+ ## When to Activate
13
+
14
+ - Setting up CI/CD pipelines
15
+ - Dockerizing an application
16
+ - Planning deployment strategy (blue-green, canary, rolling)
17
+ - Implementing health checks and readiness probes
18
+ - Preparing for a production release
19
+ - Configuring environment-specific settings
20
+
21
+ ## Deployment Strategies
22
+
23
+ ### Rolling Deployment (Default)
24
+
25
+ Replace instances gradually — old and new versions run simultaneously during rollout.
26
+
27
+ ```
28
+ Instance 1: v1 → v2 (update first)
29
+ Instance 2: v1 (still running v1)
30
+ Instance 3: v1 (still running v1)
31
+
32
+ Instance 1: v2
33
+ Instance 2: v1 → v2 (update second)
34
+ Instance 3: v1
35
+
36
+ Instance 1: v2
37
+ Instance 2: v2
38
+ Instance 3: v1 → v2 (update last)
39
+ ```
40
+
41
+ **Pros:** Zero downtime, gradual rollout
42
+ **Cons:** Two versions run simultaneously — requires backward-compatible changes
43
+ **Use when:** Standard deployments, backward-compatible changes
44
+
45
+ ### Blue-Green Deployment
46
+
47
+ Run two identical environments. Switch traffic atomically.
48
+
49
+ ```
50
+ Blue (v1) ← traffic
51
+ Green (v2) idle, running new version
52
+
53
+ # After verification:
54
+ Blue (v1) idle (becomes standby)
55
+ Green (v2) ← traffic
56
+ ```
57
+
58
+ **Pros:** Instant rollback (switch back to blue), clean cutover
59
+ **Cons:** Requires 2x infrastructure during deployment
60
+ **Use when:** Critical services, zero-tolerance for issues
61
+
62
+ ### Canary Deployment
63
+
64
+ Route a small percentage of traffic to the new version first.
65
+
66
+ ```
67
+ v1: 95% of traffic
68
+ v2: 5% of traffic (canary)
69
+
70
+ # If metrics look good:
71
+ v1: 50% of traffic
72
+ v2: 50% of traffic
73
+
74
+ # Final:
75
+ v2: 100% of traffic
76
+ ```
77
+
78
+ **Pros:** Catches issues with real traffic before full rollout
79
+ **Cons:** Requires traffic splitting infrastructure, monitoring
80
+ **Use when:** High-traffic services, risky changes, feature flags
81
+
82
+ ## Docker
83
+
84
+ ### Multi-Stage Dockerfile (Node.js)
85
+
86
+ ```dockerfile
87
+ # Stage 1: Install dependencies
88
+ FROM node:22-alpine AS deps
89
+ WORKDIR /app
90
+ COPY package.json package-lock.json ./
91
+ RUN npm ci --production=false
92
+
93
+ # Stage 2: Build
94
+ FROM node:22-alpine AS builder
95
+ WORKDIR /app
96
+ COPY --from=deps /app/node_modules ./node_modules
97
+ COPY . .
98
+ RUN npm run build
99
+ RUN npm prune --production
100
+
101
+ # Stage 3: Production image
102
+ FROM node:22-alpine AS runner
103
+ WORKDIR /app
104
+
105
+ RUN addgroup -g 1001 -S appgroup && adduser -S appuser -u 1001
106
+ USER appuser
107
+
108
+ COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
109
+ COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
110
+ COPY --from=builder --chown=appuser:appgroup /app/package.json ./
111
+
112
+ ENV NODE_ENV=production
113
+ EXPOSE 3000
114
+
115
+ HEALTHCHECK --interval=30s --timeout=3s --start-period=5s --retries=3 \
116
+ CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
117
+
118
+ CMD ["node", "dist/server.js"]
119
+ ```
120
+
121
+ ### Multi-Stage Dockerfile (Go)
122
+
123
+ ```dockerfile
124
+ FROM golang:1.22-alpine AS builder
125
+ WORKDIR /app
126
+ COPY go.mod go.sum ./
127
+ RUN go mod download
128
+ COPY . .
129
+ RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o /server ./cmd/server
130
+
131
+ FROM alpine:3.19 AS runner
132
+ RUN apk --no-cache add ca-certificates
133
+ RUN adduser -D -u 1001 appuser
134
+ USER appuser
135
+
136
+ COPY --from=builder /server /server
137
+
138
+ EXPOSE 8080
139
+ HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:8080/health || exit 1
140
+ CMD ["/server"]
141
+ ```
142
+
143
+ ### Multi-Stage Dockerfile (Python/Django)
144
+
145
+ ```dockerfile
146
+ FROM python:3.12-slim AS builder
147
+ WORKDIR /app
148
+ RUN pip install --no-cache-dir uv
149
+ COPY requirements.txt .
150
+ RUN uv pip install --system --no-cache -r requirements.txt
151
+
152
+ FROM python:3.12-slim AS runner
153
+ WORKDIR /app
154
+
155
+ RUN useradd -r -u 1001 appuser
156
+ USER appuser
157
+
158
+ COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
159
+ COPY --from=builder /usr/local/bin /usr/local/bin
160
+ COPY . .
161
+
162
+ ENV PYTHONUNBUFFERED=1
163
+ EXPOSE 8000
164
+
165
+ HEALTHCHECK --interval=30s --timeout=3s CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health/')" || exit 1
166
+ CMD ["gunicorn", "config.wsgi:application", "--bind", "0.0.0.0:8000", "--workers", "4"]
167
+ ```
168
+
169
+ ### Docker Best Practices
170
+
171
+ ```
172
+ # GOOD practices
173
+ - Use specific version tags (node:22-alpine, not node:latest)
174
+ - Multi-stage builds to minimize image size
175
+ - Run as non-root user
176
+ - Copy dependency files first (layer caching)
177
+ - Use .dockerignore to exclude node_modules, .git, tests
178
+ - Add HEALTHCHECK instruction
179
+ - Set resource limits in docker-compose or k8s
180
+
181
+ # BAD practices
182
+ - Running as root
183
+ - Using :latest tags
184
+ - Copying entire repo in one COPY layer
185
+ - Installing dev dependencies in production image
186
+ - Storing secrets in image (use env vars or secrets manager)
187
+ ```
188
+
189
+ ## CI/CD Pipeline
190
+
191
+ ### GitHub Actions (Standard Pipeline)
192
+
193
+ ```yaml
194
+ name: CI/CD
195
+
196
+ on:
197
+ push:
198
+ branches: [main]
199
+ pull_request:
200
+ branches: [main]
201
+
202
+ jobs:
203
+ test:
204
+ runs-on: ubuntu-latest
205
+ steps:
206
+ - uses: actions/checkout@v4
207
+ - uses: actions/setup-node@v4
208
+ with:
209
+ node-version: 22
210
+ cache: npm
211
+ - run: npm ci
212
+ - run: npm run lint
213
+ - run: npm run typecheck
214
+ - run: npm test -- --coverage
215
+ - uses: actions/upload-artifact@v4
216
+ if: always()
217
+ with:
218
+ name: coverage
219
+ path: coverage/
220
+
221
+ build:
222
+ needs: test
223
+ runs-on: ubuntu-latest
224
+ if: github.ref == 'refs/heads/main'
225
+ steps:
226
+ - uses: actions/checkout@v4
227
+ - uses: docker/setup-buildx-action@v3
228
+ - uses: docker/login-action@v3
229
+ with:
230
+ registry: ghcr.io
231
+ username: ${{ github.actor }}
232
+ password: ${{ secrets.GITHUB_TOKEN }}
233
+ - uses: docker/build-push-action@v5
234
+ with:
235
+ push: true
236
+ tags: ghcr.io/${{ github.repository }}:${{ github.sha }}
237
+ cache-from: type=gha
238
+ cache-to: type=gha,mode=max
239
+
240
+ deploy:
241
+ needs: build
242
+ runs-on: ubuntu-latest
243
+ if: github.ref == 'refs/heads/main'
244
+ environment: production
245
+ steps:
246
+ - name: Deploy to production
247
+ run: |
248
+ # Platform-specific deployment command
249
+ # Railway: railway up
250
+ # Vercel: vercel --prod
251
+ # K8s: kubectl set image deployment/app app=ghcr.io/${{ github.repository }}:${{ github.sha }}
252
+ echo "Deploying ${{ github.sha }}"
253
+ ```
254
+
255
+ ### Pipeline Stages
256
+
257
+ ```
258
+ PR opened:
259
+ lint → typecheck → unit tests → integration tests → preview deploy
260
+
261
+ Merged to main:
262
+ lint → typecheck → unit tests → integration tests → build image → deploy staging → smoke tests → deploy production
263
+ ```
264
+
265
+ ## Health Checks
266
+
267
+ ### Health Check Endpoint
268
+
269
+ ```typescript
270
+ // Simple health check
271
+ app.get("/health", (req, res) => {
272
+ res.status(200).json({ status: "ok" });
273
+ });
274
+
275
+ // Detailed health check (for internal monitoring)
276
+ app.get("/health/detailed", async (req, res) => {
277
+ const checks = {
278
+ database: await checkDatabase(),
279
+ redis: await checkRedis(),
280
+ externalApi: await checkExternalApi(),
281
+ };
282
+
283
+ const allHealthy = Object.values(checks).every(c => c.status === "ok");
284
+
285
+ res.status(allHealthy ? 200 : 503).json({
286
+ status: allHealthy ? "ok" : "degraded",
287
+ timestamp: new Date().toISOString(),
288
+ version: process.env.APP_VERSION || "unknown",
289
+ uptime: process.uptime(),
290
+ checks,
291
+ });
292
+ });
293
+
294
+ async function checkDatabase(): Promise<HealthCheck> {
295
+ try {
296
+ await db.query("SELECT 1");
297
+ return { status: "ok", latency_ms: 2 };
298
+ } catch (err) {
299
+ return { status: "error", message: "Database unreachable" };
300
+ }
301
+ }
302
+ ```
303
+
304
+ ### Kubernetes Probes
305
+
306
+ ```yaml
307
+ livenessProbe:
308
+ httpGet:
309
+ path: /health
310
+ port: 3000
311
+ initialDelaySeconds: 10
312
+ periodSeconds: 30
313
+ failureThreshold: 3
314
+
315
+ readinessProbe:
316
+ httpGet:
317
+ path: /health
318
+ port: 3000
319
+ initialDelaySeconds: 5
320
+ periodSeconds: 10
321
+ failureThreshold: 2
322
+
323
+ startupProbe:
324
+ httpGet:
325
+ path: /health
326
+ port: 3000
327
+ initialDelaySeconds: 0
328
+ periodSeconds: 5
329
+ failureThreshold: 30 # 30 * 5s = 150s max startup time
330
+ ```
331
+
332
+ ## Environment Configuration
333
+
334
+ ### Twelve-Factor App Pattern
335
+
336
+ ```bash
337
+ # All config via environment variables — never in code
338
+ DATABASE_URL=postgres://user:pass@host:5432/db
339
+ REDIS_URL=redis://host:6379/0
340
+ API_KEY=${API_KEY} # injected by secrets manager
341
+ LOG_LEVEL=info
342
+ PORT=3000
343
+
344
+ # Environment-specific behavior
345
+ NODE_ENV=production # or staging, development
346
+ APP_ENV=production # explicit app environment
347
+ ```
348
+
349
+ ### Configuration Validation
350
+
351
+ ```typescript
352
+ import { z } from "zod";
353
+
354
+ const envSchema = z.object({
355
+ NODE_ENV: z.enum(["development", "staging", "production"]),
356
+ PORT: z.coerce.number().default(3000),
357
+ DATABASE_URL: z.string().url(),
358
+ REDIS_URL: z.string().url(),
359
+ JWT_SECRET: z.string().min(32),
360
+ LOG_LEVEL: z.enum(["debug", "info", "warn", "error"]).default("info"),
361
+ });
362
+
363
+ // Validate at startup — fail fast if config is wrong
364
+ export const env = envSchema.parse(process.env);
365
+ ```
366
+
367
+ ## Rollback Strategy
368
+
369
+ ### Instant Rollback
370
+
371
+ ```bash
372
+ # Docker/Kubernetes: point to previous image
373
+ kubectl rollout undo deployment/app
374
+
375
+ # Vercel: promote previous deployment
376
+ vercel rollback
377
+
378
+ # Railway: redeploy previous commit
379
+ railway up --commit <previous-sha>
380
+
381
+ # Database: rollback migration (if reversible)
382
+ npx prisma migrate resolve --rolled-back <migration-name>
383
+ ```
384
+
385
+ ### Rollback Checklist
386
+
387
+ - [ ] Previous image/artifact is available and tagged
388
+ - [ ] Database migrations are backward-compatible (no destructive changes)
389
+ - [ ] Feature flags can disable new features without deploy
390
+ - [ ] Monitoring alerts configured for error rate spikes
391
+ - [ ] Rollback tested in staging before production release
392
+
393
+ ## Production Readiness Checklist
394
+
395
+ Before any production deployment:
396
+
397
+ ### Application
398
+ - [ ] All tests pass (unit, integration, E2E)
399
+ - [ ] No hardcoded secrets in code or config files
400
+ - [ ] Error handling covers all edge cases
401
+ - [ ] Logging is structured (JSON) and does not contain PII
402
+ - [ ] Health check endpoint returns meaningful status
403
+
404
+ ### Infrastructure
405
+ - [ ] Docker image builds reproducibly (pinned versions)
406
+ - [ ] Environment variables documented and validated at startup
407
+ - [ ] Resource limits set (CPU, memory)
408
+ - [ ] Horizontal scaling configured (min/max instances)
409
+ - [ ] SSL/TLS enabled on all endpoints
410
+
411
+ ### Monitoring
412
+ - [ ] Application metrics exported (request rate, latency, errors)
413
+ - [ ] Alerts configured for error rate > threshold
414
+ - [ ] Log aggregation set up (structured logs, searchable)
415
+ - [ ] Uptime monitoring on health endpoint
416
+
417
+ ### Security
418
+ - [ ] Dependencies scanned for CVEs
419
+ - [ ] CORS configured for allowed origins only
420
+ - [ ] Rate limiting enabled on public endpoints
421
+ - [ ] Authentication and authorization verified
422
+ - [ ] Security headers set (CSP, HSTS, X-Frame-Options)
423
+
424
+ ### Operations
425
+ - [ ] Rollback plan documented and tested
426
+ - [ ] Database migration tested against production-sized data
427
+ - [ ] Runbook for common failure scenarios
428
+ - [ ] On-call rotation and escalation path defined