tribunal-kit 9.2.4 → 9.2.5

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 (1037) hide show
  1. package/.agent/.manifest.json +78 -78
  2. package/.agent/.shared/ui-ux-pro-max/README.md +4 -4
  3. package/.agent/.tribunal/session.jsonl +15 -15
  4. package/.agent/ADRs/ADR-001-system-architecture-intelligence.md +49 -0
  5. package/.agent/ARCHITECTURE.md +63 -63
  6. package/.agent/agents/accessibility-reviewer.md +109 -109
  7. package/.agent/agents/agent-shield-auditor.md +18 -18
  8. package/.agent/agents/ai-code-reviewer.md +223 -223
  9. package/.agent/agents/anti-pattern-reviewer.md +104 -104
  10. package/.agent/agents/api-architect.md +89 -89
  11. package/.agent/agents/architecture-auditor.md +195 -0
  12. package/.agent/agents/backend-specialist.md +242 -242
  13. package/.agent/agents/cloud-engineer.md +120 -120
  14. package/.agent/agents/code-archaeologist.md +186 -186
  15. package/.agent/agents/complexity-reviewer.md +76 -76
  16. package/.agent/agents/database-architect.md +206 -206
  17. package/.agent/agents/db-latency-auditor.md +237 -237
  18. package/.agent/agents/debugger.md +215 -215
  19. package/.agent/agents/dependency-reviewer.md +124 -124
  20. package/.agent/agents/devops-engineer.md +240 -240
  21. package/.agent/agents/documentation-writer.md +228 -228
  22. package/.agent/agents/explorer-agent.md +186 -186
  23. package/.agent/agents/frontend-reviewer.md +195 -195
  24. package/.agent/agents/frontend-specialist.md +122 -122
  25. package/.agent/agents/game-developer.md +68 -68
  26. package/.agent/agents/harness-manager.md +49 -49
  27. package/.agent/agents/human-gate-negotiator.md +22 -22
  28. package/.agent/agents/interaction-reviewer.md +123 -123
  29. package/.agent/agents/kernel-scheduler.md +56 -56
  30. package/.agent/agents/logic-reviewer.md +147 -147
  31. package/.agent/agents/memory-archivist.md +37 -37
  32. package/.agent/agents/minimalist-reviewer.md +104 -104
  33. package/.agent/agents/mobile-developer.md +216 -216
  34. package/.agent/agents/mobile-reviewer.md +180 -180
  35. package/.agent/agents/orchestrator.md +268 -268
  36. package/.agent/agents/penetration-tester.md +180 -180
  37. package/.agent/agents/performance-optimizer.md +202 -202
  38. package/.agent/agents/performance-reviewer.md +180 -180
  39. package/.agent/agents/pipeline-reviewer.md +144 -144
  40. package/.agent/agents/precedence-reviewer.md +266 -266
  41. package/.agent/agents/product-manager.md +167 -167
  42. package/.agent/agents/product-owner.md +103 -103
  43. package/.agent/agents/product-reviewer.md +103 -103
  44. package/.agent/agents/project-planner.md +181 -181
  45. package/.agent/agents/qa-automation-engineer.md +244 -244
  46. package/.agent/agents/resilience-reviewer.md +108 -108
  47. package/.agent/agents/schema-reviewer.md +87 -87
  48. package/.agent/agents/security-auditor.md +204 -204
  49. package/.agent/agents/seo-specialist.md +213 -213
  50. package/.agent/agents/sql-reviewer.md +180 -180
  51. package/.agent/agents/supervisor-agent.md +202 -202
  52. package/.agent/agents/swarm-worker-contracts.md +170 -170
  53. package/.agent/agents/swarm-worker-registry.md +99 -99
  54. package/.agent/agents/system-architect.md +260 -105
  55. package/.agent/agents/test-coverage-reviewer.md +181 -181
  56. package/.agent/agents/test-engineer.md +138 -138
  57. package/.agent/agents/throughput-optimizer.md +316 -316
  58. package/.agent/agents/type-safety-reviewer.md +202 -202
  59. package/.agent/agents/ui-ux-auditor.md +80 -80
  60. package/.agent/agents/ui-visual-auditor.md +102 -102
  61. package/.agent/agents/ux-reviewer.md +109 -109
  62. package/.agent/agents/visual-reviewer.md +103 -103
  63. package/.agent/agents/vitals-reviewer.md +245 -245
  64. package/.agent/config/claude.json +18 -18
  65. package/.agent/config/plugin.json +102 -102
  66. package/.agent/config/slash-commands.json +115 -115
  67. package/.agent/config/specialist-registry.json +415 -415
  68. package/.agent/config/system-prompt.md +258 -258
  69. package/.agent/history/arch-mapper-cache.json +6712 -0
  70. package/.agent/history/architecture.idx.json +5746 -0
  71. package/.agent/mcp_config.json +32 -32
  72. package/.agent/patterns/generator.md +11 -11
  73. package/.agent/patterns/inversion.md +14 -14
  74. package/.agent/patterns/pipeline.md +11 -11
  75. package/.agent/patterns/reviewer.md +15 -15
  76. package/.agent/patterns/tool-wrapper.md +11 -11
  77. package/.agent/plans/implementation_plan.md +48 -0
  78. package/.agent/plans/task.md +35 -0
  79. package/.agent/routing_index.json +2060 -2060
  80. package/.agent/rules/GEMINI.md +437 -437
  81. package/.agent/rules/GEMINI_PLANNER.md +82 -82
  82. package/.agent/rules/kernel.md +86 -86
  83. package/.agent/scripts/_colors.js +210 -210
  84. package/.agent/scripts/_utils.js +373 -377
  85. package/.agent/scripts/architecture_mapper.js +625 -0
  86. package/.agent/scripts/ast_context_loader.js +137 -137
  87. package/.agent/scripts/auto_preview.js +203 -203
  88. package/.agent/scripts/browser_audit.js +102 -102
  89. package/.agent/scripts/bundle_analyzer.js +287 -287
  90. package/.agent/scripts/case_law_manager.js +887 -887
  91. package/.agent/scripts/checklist.js +300 -300
  92. package/.agent/scripts/cicd_validator.js +305 -305
  93. package/.agent/scripts/context_broker.js +962 -962
  94. package/.agent/scripts/context_compiler.js +1143 -1112
  95. package/.agent/scripts/contract_engine.js +402 -402
  96. package/.agent/scripts/dependency_analyzer.js +313 -313
  97. package/.agent/scripts/graph_builder.js +384 -384
  98. package/.agent/scripts/graph_visualizer.js +390 -390
  99. package/.agent/scripts/graph_zoom.js +181 -181
  100. package/.agent/scripts/guardrail_engine.js +785 -785
  101. package/.agent/scripts/harness_manager.js +60 -60
  102. package/.agent/scripts/impact_classifier.js +192 -192
  103. package/.agent/scripts/inner_loop_validator.js +472 -472
  104. package/.agent/scripts/integrity_manifest.js +484 -484
  105. package/.agent/scripts/lint_runner.js +218 -218
  106. package/.agent/scripts/marathon_harness.js +986 -986
  107. package/.agent/scripts/mcp_server.js +181 -181
  108. package/.agent/scripts/memory_archivist.js +97 -97
  109. package/.agent/scripts/memory_consolidator.js +37 -37
  110. package/.agent/scripts/memory_engine.js +782 -782
  111. package/.agent/scripts/minify_context.js +111 -111
  112. package/.agent/scripts/minimal_change_engine.js +445 -445
  113. package/.agent/scripts/mutation_runner.js +307 -305
  114. package/.agent/scripts/payload_schemas.js +164 -164
  115. package/.agent/scripts/pipeline_engine.js +906 -906
  116. package/.agent/scripts/prompt_compiler.js +272 -272
  117. package/.agent/scripts/schema_validator.js +326 -326
  118. package/.agent/scripts/security_scan.js +390 -390
  119. package/.agent/scripts/session_logger.js +115 -115
  120. package/.agent/scripts/session_manager.js +299 -299
  121. package/.agent/scripts/signal_detector.js +175 -175
  122. package/.agent/scripts/skill_evolution.js +997 -997
  123. package/.agent/scripts/skill_integrator.js +304 -304
  124. package/.agent/scripts/socratic_gate_policy.js +63 -63
  125. package/.agent/scripts/strengthen_skills.js +199 -199
  126. package/.agent/scripts/swarm_dispatcher.js +983 -979
  127. package/.agent/scripts/syscall_registry.js +105 -105
  128. package/.agent/scripts/test_runner.js +209 -209
  129. package/.agent/scripts/token_budget_broker.js +165 -165
  130. package/.agent/scripts/trace_engine.js +126 -126
  131. package/.agent/scripts/verify_all.js +276 -276
  132. package/.agent/scripts/visual_audit.js +87 -87
  133. package/.agent/skill_topic_map.json +314 -314
  134. package/.agent/skills/12-principles-of-animation/SKILL.md +51 -51
  135. package/.agent/skills/60fps-animation/SKILL.md +91 -91
  136. package/.agent/skills/accessible-animation/SKILL.md +189 -189
  137. package/.agent/skills/adapt/SKILL.md +56 -56
  138. package/.agent/skills/adr-generation/SKILL.md +57 -0
  139. package/.agent/skills/advanced-rag-pipelines/SKILL.md +94 -94
  140. package/.agent/skills/agent-organizer/SKILL.md +117 -117
  141. package/.agent/skills/agent-syscall-guidelines/SKILL.md +25 -25
  142. package/.agent/skills/agentic-patterns/SKILL.md +281 -281
  143. package/.agent/skills/agentic-workflows-2026/SKILL.md +91 -91
  144. package/.agent/skills/agentshield-security/SKILL.md +26 -26
  145. package/.agent/skills/ai-app-hardening/SKILL.md +51 -51
  146. package/.agent/skills/ai-prompt-injection-defense/SKILL.md +162 -162
  147. package/.agent/skills/animation-on-scroll/SKILL.md +196 -196
  148. package/.agent/skills/animation-systems/SKILL.md +198 -198
  149. package/.agent/skills/antfu-conventions/SKILL.md +54 -54
  150. package/.agent/skills/api-patterns/SKILL.md +218 -218
  151. package/.agent/skills/api-security-auditor/SKILL.md +155 -155
  152. package/.agent/skills/app-builder/SKILL.md +535 -535
  153. package/.agent/skills/app-builder/templates/SKILL.md +108 -108
  154. package/.agent/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  155. package/.agent/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  156. package/.agent/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  157. package/.agent/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  158. package/.agent/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  159. package/.agent/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  160. package/.agent/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  161. package/.agent/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -126
  162. package/.agent/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -127
  163. package/.agent/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -172
  164. package/.agent/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -139
  165. package/.agent/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  166. package/.agent/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -122
  167. package/.agent/skills/appflow-wireframe/SKILL.md +96 -96
  168. package/.agent/skills/apple-design/SKILL.md +89 -89
  169. package/.agent/skills/architecture/SKILL.md +188 -188
  170. package/.agent/skills/architecture-drift/SKILL.md +45 -0
  171. package/.agent/skills/audit-and-fix/SKILL.md +100 -100
  172. package/.agent/skills/authentication-best-practices/SKILL.md +157 -157
  173. package/.agent/skills/autonomous-execution/SKILL.md +76 -0
  174. package/.agent/skills/backend-security-expert/SKILL.md +73 -73
  175. package/.agent/skills/baseline-ui/SKILL.md +55 -55
  176. package/.agent/skills/bash-linux/SKILL.md +139 -139
  177. package/.agent/skills/behavioral-modes/SKILL.md +200 -200
  178. package/.agent/skills/better-colors/SKILL.md +116 -116
  179. package/.agent/skills/better-typography/SKILL.md +90 -90
  180. package/.agent/skills/better-ui/SKILL.md +130 -130
  181. package/.agent/skills/bolder/SKILL.md +49 -49
  182. package/.agent/skills/brainstorming/SKILL.md +460 -460
  183. package/.agent/skills/browser-audit/SKILL.md +102 -102
  184. package/.agent/skills/browser-native-ai/SKILL.md +72 -72
  185. package/.agent/skills/build-primitive/SKILL.md +50 -50
  186. package/.agent/skills/building-native-ui/SKILL.md +162 -162
  187. package/.agent/skills/cicd-pro/SKILL.md +412 -412
  188. package/.agent/skills/clarify/SKILL.md +55 -55
  189. package/.agent/skills/clean-code/SKILL.md +367 -367
  190. package/.agent/skills/cloud-architect/SKILL.md +409 -409
  191. package/.agent/skills/cobejs/SKILL.md +70 -70
  192. package/.agent/skills/code-review-checklist/SKILL.md +163 -163
  193. package/.agent/skills/codebase-design/SKILL.md +76 -76
  194. package/.agent/skills/colorize/SKILL.md +57 -57
  195. package/.agent/skills/compact-landing/SKILL.md +50 -50
  196. package/.agent/skills/company-logos/SKILL.md +54 -54
  197. package/.agent/skills/config-validator/SKILL.md +125 -125
  198. package/.agent/skills/containerization-pro/SKILL.md +422 -422
  199. package/.agent/skills/context-engineering-pro/SKILL.md +69 -69
  200. package/.agent/skills/create-design-md/SKILL.md +92 -92
  201. package/.agent/skills/critique/SKILL.md +79 -79
  202. package/.agent/skills/csharp-developer/SKILL.md +478 -478
  203. package/.agent/skills/data-validation-schemas/SKILL.md +297 -297
  204. package/.agent/skills/database-design/SKILL.md +219 -219
  205. package/.agent/skills/delight/SKILL.md +46 -46
  206. package/.agent/skills/deployment-procedures/SKILL.md +132 -132
  207. package/.agent/skills/design-lab/SKILL.md +42 -42
  208. package/.agent/skills/devops-engineer/SKILL.md +305 -305
  209. package/.agent/skills/devops-incident-responder/SKILL.md +103 -103
  210. package/.agent/skills/diagnosing-bugs/SKILL.md +172 -172
  211. package/.agent/skills/distill/SKILL.md +45 -45
  212. package/.agent/skills/documentation-templates/SKILL.md +251 -251
  213. package/.agent/skills/domain-modeling/SKILL.md +61 -61
  214. package/.agent/skills/duckdb-analytical-sql/SKILL.md +51 -51
  215. package/.agent/skills/edge-ai-mobile/SKILL.md +42 -42
  216. package/.agent/skills/edge-computing/SKILL.md +143 -143
  217. package/.agent/skills/emil-design-eng/SKILL.md +134 -134
  218. package/.agent/skills/error-resilience/SKILL.md +403 -403
  219. package/.agent/skills/expo-router-v4/SKILL.md +72 -72
  220. package/.agent/skills/extract-design-system/SKILL.md +120 -120
  221. package/.agent/skills/fabel-protocol/SKILL.md +282 -282
  222. package/.agent/skills/failure-mode-analysis/SKILL.md +48 -0
  223. package/.agent/skills/fixing-accessibility/SKILL.md +87 -87
  224. package/.agent/skills/fixing-metadata/SKILL.md +83 -83
  225. package/.agent/skills/fixing-motion-performance/SKILL.md +78 -78
  226. package/.agent/skills/framer-motion-expert/SKILL.md +237 -237
  227. package/.agent/skills/frontend-design/SKILL.md +103 -103
  228. package/.agent/skills/frontend-security-expert/SKILL.md +56 -56
  229. package/.agent/skills/game-design-expert/SKILL.md +92 -92
  230. package/.agent/skills/game-engineering-expert/SKILL.md +108 -108
  231. package/.agent/skills/generative-ui-expert/SKILL.md +100 -100
  232. package/.agent/skills/geo-fundamentals/SKILL.md +108 -108
  233. package/.agent/skills/git-pro/SKILL.md +401 -401
  234. package/.agent/skills/github-operations/SKILL.md +295 -295
  235. package/.agent/skills/gpt-taste/SKILL.md +50 -50
  236. package/.agent/skills/graph-engineering/SKILL.md +28 -28
  237. package/.agent/skills/gsap-core/SKILL.md +277 -277
  238. package/.agent/skills/gsap-frameworks/SKILL.md +168 -168
  239. package/.agent/skills/gsap-performance/SKILL.md +94 -94
  240. package/.agent/skills/gsap-plugins/SKILL.md +441 -441
  241. package/.agent/skills/gsap-react/SKILL.md +213 -213
  242. package/.agent/skills/gsap-scrolltrigger/SKILL.md +312 -312
  243. package/.agent/skills/gsap-timeline/SKILL.md +122 -122
  244. package/.agent/skills/gsap-utils/SKILL.md +299 -299
  245. package/.agent/skills/harden/SKILL.md +55 -55
  246. package/.agent/skills/harness-protocol/SKILL.md +48 -48
  247. package/.agent/skills/huggingface-spaces/SKILL.md +1 -1
  248. package/.agent/skills/human-gate-negotiation/SKILL.md +30 -30
  249. package/.agent/skills/i18n-localization/SKILL.md +134 -134
  250. package/.agent/skills/impeccable/SKILL.md +52 -52
  251. package/.agent/skills/improve-codebase-architecture/SKILL.md +48 -48
  252. package/.agent/skills/improve-ui/SKILL.md +70 -70
  253. package/.agent/skills/intelligent-routing/SKILL.md +204 -204
  254. package/.agent/skills/knowledge-graph/SKILL.md +71 -71
  255. package/.agent/skills/landing-page/SKILL.md +65 -65
  256. package/.agent/skills/lint-and-validate/SKILL.md +224 -224
  257. package/.agent/skills/llm-engineering/SKILL.md +360 -360
  258. package/.agent/skills/local-first/SKILL.md +138 -138
  259. package/.agent/skills/local-first-architecture/SKILL.md +62 -62
  260. package/.agent/skills/lottie-animation/SKILL.md +62 -62
  261. package/.agent/skills/marquee-loop/SKILL.md +72 -72
  262. package/.agent/skills/masked-reveal/SKILL.md +230 -230
  263. package/.agent/skills/mcp-builder/SKILL.md +105 -105
  264. package/.agent/skills/micro-interaction/SKILL.md +253 -253
  265. package/.agent/skills/mobile-design/SKILL.md +245 -245
  266. package/.agent/skills/monorepo-management/SKILL.md +295 -295
  267. package/.agent/skills/morphing-icons/SKILL.md +348 -348
  268. package/.agent/skills/motion-engineering/SKILL.md +197 -197
  269. package/.agent/skills/nextjs-react-expert/SKILL.md +218 -218
  270. package/.agent/skills/nodejs-best-practices/SKILL.md +542 -542
  271. package/.agent/skills/observability/SKILL.md +303 -303
  272. package/.agent/skills/opentelemetry-observability/SKILL.md +51 -51
  273. package/.agent/skills/page-transition-animation/SKILL.md +86 -86
  274. package/.agent/skills/parallel-agents/SKILL.md +110 -110
  275. package/.agent/skills/performance-profiling/SKILL.md +230 -230
  276. package/.agent/skills/plan-writing/SKILL.md +127 -127
  277. package/.agent/skills/platform-engineer/SKILL.md +108 -108
  278. package/.agent/skills/platform-engineering-opentofu/SKILL.md +59 -59
  279. package/.agent/skills/playwright-ai-e2e/SKILL.md +52 -52
  280. package/.agent/skills/playwright-best-practices/SKILL.md +149 -149
  281. package/.agent/skills/polish/SKILL.md +39 -39
  282. package/.agent/skills/powershell-windows/SKILL.md +122 -122
  283. package/.agent/skills/pricing-page/SKILL.md +48 -48
  284. package/.agent/skills/product-aware-heuristics/SKILL.md +390 -390
  285. package/.agent/skills/progressive-blur/SKILL.md +80 -80
  286. package/.agent/skills/project-idioms/SKILL.md +91 -91
  287. package/.agent/skills/property-based-testing/SKILL.md +50 -50
  288. package/.agent/skills/python-patterns/SKILL.md +220 -220
  289. package/.agent/skills/python-pro/SKILL.md +305 -305
  290. package/.agent/skills/quieter/SKILL.md +49 -49
  291. package/.agent/skills/react-doctor/SKILL.md +51 -51
  292. package/.agent/skills/react-specialist/SKILL.md +280 -280
  293. package/.agent/skills/readme-builder/SKILL.md +270 -270
  294. package/.agent/skills/realtime-patterns/SKILL.md +283 -283
  295. package/.agent/skills/red-team-tactics/SKILL.md +191 -191
  296. package/.agent/skills/redesign-skill/SKILL.md +46 -46
  297. package/.agent/skills/review-animations/SKILL.md +45 -45
  298. package/.agent/skills/review-animations/STANDARDS.md +87 -87
  299. package/.agent/skills/rust-pro/SKILL.md +652 -652
  300. package/.agent/skills/semantic-filesystem-navigation/SKILL.md +24 -24
  301. package/.agent/skills/seo-fundamentals/SKILL.md +139 -139
  302. package/.agent/skills/server-management/SKILL.md +178 -178
  303. package/.agent/skills/session-log-interrogation/SKILL.md +29 -29
  304. package/.agent/skills/shadcn-ui-expert/SKILL.md +196 -196
  305. package/.agent/skills/shape/SKILL.md +56 -56
  306. package/.agent/skills/skill-creator/SKILL.md +177 -177
  307. package/.agent/skills/soft-skill/SKILL.md +53 -53
  308. package/.agent/skills/sounds-on-the-web/SKILL.md +76 -76
  309. package/.agent/skills/sql-pro/SKILL.md +624 -624
  310. package/.agent/skills/subagent-driven-development/SKILL.md +32 -32
  311. package/.agent/skills/supabase-postgres-best-practices/SKILL.md +57 -57
  312. package/.agent/skills/svg-animation/SKILL.md +356 -356
  313. package/.agent/skills/swiftui-expert/SKILL.md +164 -164
  314. package/.agent/skills/swiss-design/SKILL.md +44 -44
  315. package/.agent/skills/system-design-pro/SKILL.md +188 -318
  316. package/.agent/skills/systematic-debugging/SKILL.md +129 -129
  317. package/.agent/skills/systematic-debugging/condition-based-waiting.md +120 -120
  318. package/.agent/skills/systematic-debugging/defense-in-depth.md +128 -128
  319. package/.agent/skills/systematic-debugging/root-cause-tracing.md +183 -183
  320. package/.agent/skills/tailwind-patterns/SKILL.md +583 -583
  321. package/.agent/skills/taste-skill/SKILL.md +52 -52
  322. package/.agent/skills/tdd-workflow/SKILL.md +105 -105
  323. package/.agent/skills/test-result-analyzer/SKILL.md +270 -270
  324. package/.agent/skills/testing-patterns/SKILL.md +534 -534
  325. package/.agent/skills/thermo-nuclear-code-quality-review/SKILL.md +62 -62
  326. package/.agent/skills/thinking-protocol/SKILL.md +21 -21
  327. package/.agent/skills/to-spring-or-not-to-spring/SKILL.md +43 -43
  328. package/.agent/skills/transformers-js/references/CONFIGURATION.md +1 -1
  329. package/.agent/skills/transitions-dev/SKILL.md +90 -90
  330. package/.agent/skills/trend-researcher/SKILL.md +198 -198
  331. package/.agent/skills/tribunal-instincts-memory/SKILL.md +31 -31
  332. package/.agent/skills/typescript-advanced/SKILL.md +306 -306
  333. package/.agent/skills/typeset/SKILL.md +60 -60
  334. package/.agent/skills/ui-reasoning-engine/SKILL.md +155 -155
  335. package/.agent/skills/ui-skill-packs/SKILL.md +57 -57
  336. package/.agent/skills/ui-skills-root/SKILL.md +69 -69
  337. package/.agent/skills/ui-ux-pro-max/SKILL.md +110 -110
  338. package/.agent/skills/ui-ux-researcher/SKILL.md +199 -199
  339. package/.agent/skills/vector-search-pgvector/SKILL.md +70 -70
  340. package/.agent/skills/verification-before-completion/SKILL.md +107 -107
  341. package/.agent/skills/vue-expert/SKILL.md +259 -259
  342. package/.agent/skills/vulnerability-scanner/SKILL.md +378 -378
  343. package/.agent/skills/web-accessibility-auditor/SKILL.md +179 -179
  344. package/.agent/skills/web-design-guidelines/SKILL.md +49 -49
  345. package/.agent/skills/web-quality-audit/SKILL.md +47 -47
  346. package/.agent/skills/webapp-testing/SKILL.md +128 -128
  347. package/.agent/skills/webgpu-performance/SKILL.md +88 -88
  348. package/.agent/skills/whimsy-injector/SKILL.md +305 -305
  349. package/.agent/skills/workflow-optimizer/SKILL.md +188 -188
  350. package/.agent/skills/zero-trust-passkeys/SKILL.md +82 -82
  351. package/.agent/templates/DESIGN.md +843 -843
  352. package/.agent/templates/design-tokens.json +140 -140
  353. package/.agent/templates/sdd/implementer-prompt.md +62 -62
  354. package/.agent/templates/sdd/re-review-prompt.md +36 -36
  355. package/.agent/templates/sdd/task-reviewer-prompt.md +78 -78
  356. package/.agent/workflows/acf.md +153 -153
  357. package/.agent/workflows/api-tester.md +189 -189
  358. package/.agent/workflows/assimilate.md +21 -21
  359. package/.agent/workflows/audit-live.md +53 -53
  360. package/.agent/workflows/audit.md +172 -172
  361. package/.agent/workflows/brainstorm.md +157 -157
  362. package/.agent/workflows/changelog.md +152 -152
  363. package/.agent/workflows/compare-web.md +35 -35
  364. package/.agent/workflows/context.md +102 -102
  365. package/.agent/workflows/contract.md +79 -79
  366. package/.agent/workflows/create.md +182 -182
  367. package/.agent/workflows/debug.md +201 -201
  368. package/.agent/workflows/deploy.md +215 -215
  369. package/.agent/workflows/enhance.md +165 -165
  370. package/.agent/workflows/fix-ci.md +94 -94
  371. package/.agent/workflows/fix.md +149 -149
  372. package/.agent/workflows/generate.md +216 -216
  373. package/.agent/workflows/htop.md +22 -22
  374. package/.agent/workflows/marathon.md +291 -291
  375. package/.agent/workflows/migrate.md +198 -198
  376. package/.agent/workflows/minimal.md +101 -101
  377. package/.agent/workflows/orchestrate.md +205 -205
  378. package/.agent/workflows/performance-benchmarker.md +148 -148
  379. package/.agent/workflows/pipeline.md +165 -165
  380. package/.agent/workflows/plan.md +206 -206
  381. package/.agent/workflows/preview.md +116 -116
  382. package/.agent/workflows/refactor.md +207 -207
  383. package/.agent/workflows/resume.md +20 -20
  384. package/.agent/workflows/review-ai.md +139 -139
  385. package/.agent/workflows/review.md +155 -155
  386. package/.agent/workflows/sdd.md +137 -137
  387. package/.agent/workflows/session.md +135 -135
  388. package/.agent/workflows/skill-enhancement-engine.md +84 -84
  389. package/.agent/workflows/status.md +112 -112
  390. package/.agent/workflows/strengthen-skills.md +174 -174
  391. package/.agent/workflows/super-prompt.md +146 -146
  392. package/.agent/workflows/swarm.md +218 -218
  393. package/.agent/workflows/team-mode.md +22 -22
  394. package/.agent/workflows/test.md +224 -224
  395. package/.agent/workflows/tribunal-backend.md +149 -149
  396. package/.agent/workflows/tribunal-cicd.md +109 -109
  397. package/.agent/workflows/tribunal-database.md +142 -142
  398. package/.agent/workflows/tribunal-frontend.md +157 -157
  399. package/.agent/workflows/tribunal-full.md +156 -156
  400. package/.agent/workflows/tribunal-mobile.md +142 -142
  401. package/.agent/workflows/tribunal-performance.md +149 -149
  402. package/.agent/workflows/tribunal-speed.md +222 -222
  403. package/.agent/workflows/tribunal-ui.md +97 -97
  404. package/.agent/workflows/ui-ux-pro-max.md +103 -103
  405. package/.agents/skills/12-principles-of-animation/SKILL.md +51 -51
  406. package/.agents/skills/60fps-animation/SKILL.md +91 -91
  407. package/.agents/skills/accessible-animation/SKILL.md +189 -189
  408. package/.agents/skills/adapt/SKILL.md +56 -56
  409. package/.agents/skills/adr-generation/SKILL.md +57 -0
  410. package/.agents/skills/advanced-rag-pipelines/SKILL.md +94 -94
  411. package/.agents/skills/agent-organizer/SKILL.md +117 -117
  412. package/.agents/skills/agent-syscall-guidelines/SKILL.md +25 -25
  413. package/.agents/skills/agentic-patterns/SKILL.md +281 -281
  414. package/.agents/skills/agentic-workflows-2026/SKILL.md +91 -91
  415. package/.agents/skills/agentshield-security/SKILL.md +26 -26
  416. package/.agents/skills/ai-app-hardening/SKILL.md +51 -51
  417. package/.agents/skills/ai-prompt-injection-defense/SKILL.md +162 -162
  418. package/.agents/skills/animation-on-scroll/SKILL.md +196 -196
  419. package/.agents/skills/animation-systems/SKILL.md +198 -198
  420. package/.agents/skills/antfu-conventions/SKILL.md +54 -54
  421. package/.agents/skills/api-patterns/SKILL.md +218 -218
  422. package/.agents/skills/api-security-auditor/SKILL.md +155 -155
  423. package/.agents/skills/app-builder/SKILL.md +535 -535
  424. package/.agents/skills/app-builder/templates/SKILL.md +108 -108
  425. package/.agents/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  426. package/.agents/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  427. package/.agents/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  428. package/.agents/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  429. package/.agents/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  430. package/.agents/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  431. package/.agents/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  432. package/.agents/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -126
  433. package/.agents/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -127
  434. package/.agents/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -172
  435. package/.agents/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -139
  436. package/.agents/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  437. package/.agents/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -122
  438. package/.agents/skills/appflow-wireframe/SKILL.md +96 -96
  439. package/.agents/skills/apple-design/SKILL.md +89 -89
  440. package/.agents/skills/architecture/SKILL.md +188 -188
  441. package/.agents/skills/architecture-drift/SKILL.md +45 -0
  442. package/.agents/skills/audit-and-fix/SKILL.md +100 -100
  443. package/.agents/skills/authentication-best-practices/SKILL.md +157 -157
  444. package/.agents/skills/autonomous-execution/SKILL.md +76 -0
  445. package/.agents/skills/backend-security-expert/SKILL.md +73 -73
  446. package/.agents/skills/baseline-ui/SKILL.md +55 -55
  447. package/.agents/skills/bash-linux/SKILL.md +139 -139
  448. package/.agents/skills/behavioral-modes/SKILL.md +200 -200
  449. package/.agents/skills/better-colors/SKILL.md +116 -116
  450. package/.agents/skills/better-typography/SKILL.md +90 -90
  451. package/.agents/skills/better-ui/SKILL.md +130 -130
  452. package/.agents/skills/bolder/SKILL.md +49 -49
  453. package/.agents/skills/brainstorming/SKILL.md +460 -460
  454. package/.agents/skills/browser-audit/SKILL.md +102 -102
  455. package/.agents/skills/browser-native-ai/SKILL.md +72 -72
  456. package/.agents/skills/build-primitive/SKILL.md +50 -50
  457. package/.agents/skills/building-native-ui/SKILL.md +162 -162
  458. package/.agents/skills/cicd-pro/SKILL.md +412 -412
  459. package/.agents/skills/clarify/SKILL.md +55 -55
  460. package/.agents/skills/clean-code/SKILL.md +367 -367
  461. package/.agents/skills/cloud-architect/SKILL.md +409 -409
  462. package/.agents/skills/cobejs/SKILL.md +70 -70
  463. package/.agents/skills/code-review-checklist/SKILL.md +163 -163
  464. package/.agents/skills/codebase-design/SKILL.md +76 -76
  465. package/.agents/skills/colorize/SKILL.md +57 -57
  466. package/.agents/skills/compact-landing/SKILL.md +50 -50
  467. package/.agents/skills/company-logos/SKILL.md +54 -54
  468. package/.agents/skills/config-validator/SKILL.md +125 -125
  469. package/.agents/skills/containerization-pro/SKILL.md +422 -422
  470. package/.agents/skills/context-engineering-pro/SKILL.md +69 -69
  471. package/.agents/skills/create-design-md/SKILL.md +92 -92
  472. package/.agents/skills/critique/SKILL.md +79 -79
  473. package/.agents/skills/csharp-developer/SKILL.md +478 -478
  474. package/.agents/skills/data-validation-schemas/SKILL.md +297 -297
  475. package/.agents/skills/database-design/SKILL.md +219 -219
  476. package/.agents/skills/delight/SKILL.md +46 -46
  477. package/.agents/skills/deployment-procedures/SKILL.md +132 -132
  478. package/.agents/skills/design-lab/SKILL.md +42 -42
  479. package/.agents/skills/devops-engineer/SKILL.md +305 -305
  480. package/.agents/skills/devops-incident-responder/SKILL.md +103 -103
  481. package/.agents/skills/diagnosing-bugs/SKILL.md +172 -172
  482. package/.agents/skills/distill/SKILL.md +45 -45
  483. package/.agents/skills/documentation-templates/SKILL.md +251 -251
  484. package/.agents/skills/domain-modeling/SKILL.md +61 -61
  485. package/.agents/skills/duckdb-analytical-sql/SKILL.md +51 -51
  486. package/.agents/skills/edge-ai-mobile/SKILL.md +42 -42
  487. package/.agents/skills/edge-computing/SKILL.md +143 -143
  488. package/.agents/skills/emil-design-eng/SKILL.md +134 -134
  489. package/.agents/skills/error-resilience/SKILL.md +403 -403
  490. package/.agents/skills/expo-router-v4/SKILL.md +72 -72
  491. package/.agents/skills/extract-design-system/SKILL.md +120 -120
  492. package/.agents/skills/fabel-protocol/SKILL.md +282 -282
  493. package/.agents/skills/failure-mode-analysis/SKILL.md +48 -0
  494. package/.agents/skills/fixing-accessibility/SKILL.md +87 -87
  495. package/.agents/skills/fixing-metadata/SKILL.md +83 -83
  496. package/.agents/skills/fixing-motion-performance/SKILL.md +78 -78
  497. package/.agents/skills/framer-motion-expert/SKILL.md +237 -237
  498. package/.agents/skills/frontend-design/SKILL.md +103 -103
  499. package/.agents/skills/frontend-security-expert/SKILL.md +56 -56
  500. package/.agents/skills/game-design-expert/SKILL.md +92 -92
  501. package/.agents/skills/game-engineering-expert/SKILL.md +108 -108
  502. package/.agents/skills/generative-ui-expert/SKILL.md +100 -100
  503. package/.agents/skills/geo-fundamentals/SKILL.md +108 -108
  504. package/.agents/skills/git-pro/SKILL.md +401 -401
  505. package/.agents/skills/github-operations/SKILL.md +295 -295
  506. package/.agents/skills/gpt-taste/SKILL.md +50 -50
  507. package/.agents/skills/graph-engineering/SKILL.md +28 -28
  508. package/.agents/skills/gsap-core/SKILL.md +277 -277
  509. package/.agents/skills/gsap-frameworks/SKILL.md +168 -168
  510. package/.agents/skills/gsap-performance/SKILL.md +94 -94
  511. package/.agents/skills/gsap-plugins/SKILL.md +441 -441
  512. package/.agents/skills/gsap-react/SKILL.md +213 -213
  513. package/.agents/skills/gsap-scrolltrigger/SKILL.md +312 -312
  514. package/.agents/skills/gsap-timeline/SKILL.md +122 -122
  515. package/.agents/skills/gsap-utils/SKILL.md +299 -299
  516. package/.agents/skills/harden/SKILL.md +55 -55
  517. package/.agents/skills/harness-protocol/SKILL.md +48 -48
  518. package/.agents/skills/huggingface-spaces/SKILL.md +1 -1
  519. package/.agents/skills/human-gate-negotiation/SKILL.md +30 -30
  520. package/.agents/skills/i18n-localization/SKILL.md +134 -134
  521. package/.agents/skills/impeccable/SKILL.md +52 -52
  522. package/.agents/skills/improve-codebase-architecture/SKILL.md +48 -48
  523. package/.agents/skills/improve-ui/SKILL.md +70 -70
  524. package/.agents/skills/intelligent-routing/SKILL.md +204 -204
  525. package/.agents/skills/knowledge-graph/SKILL.md +71 -71
  526. package/.agents/skills/landing-page/SKILL.md +65 -65
  527. package/.agents/skills/lint-and-validate/SKILL.md +224 -224
  528. package/.agents/skills/llm-engineering/SKILL.md +360 -360
  529. package/.agents/skills/local-first/SKILL.md +138 -138
  530. package/.agents/skills/local-first-architecture/SKILL.md +62 -62
  531. package/.agents/skills/lottie-animation/SKILL.md +62 -62
  532. package/.agents/skills/marquee-loop/SKILL.md +72 -72
  533. package/.agents/skills/masked-reveal/SKILL.md +230 -230
  534. package/.agents/skills/mcp-builder/SKILL.md +105 -105
  535. package/.agents/skills/micro-interaction/SKILL.md +253 -253
  536. package/.agents/skills/mobile-design/SKILL.md +245 -245
  537. package/.agents/skills/monorepo-management/SKILL.md +295 -295
  538. package/.agents/skills/morphing-icons/SKILL.md +348 -348
  539. package/.agents/skills/motion-engineering/SKILL.md +197 -197
  540. package/.agents/skills/nextjs-react-expert/SKILL.md +218 -218
  541. package/.agents/skills/nodejs-best-practices/SKILL.md +542 -542
  542. package/.agents/skills/observability/SKILL.md +303 -303
  543. package/.agents/skills/opentelemetry-observability/SKILL.md +51 -51
  544. package/.agents/skills/page-transition-animation/SKILL.md +86 -86
  545. package/.agents/skills/parallel-agents/SKILL.md +110 -110
  546. package/.agents/skills/performance-profiling/SKILL.md +230 -230
  547. package/.agents/skills/plan-writing/SKILL.md +127 -127
  548. package/.agents/skills/platform-engineer/SKILL.md +108 -108
  549. package/.agents/skills/platform-engineering-opentofu/SKILL.md +59 -59
  550. package/.agents/skills/playwright-ai-e2e/SKILL.md +52 -52
  551. package/.agents/skills/playwright-best-practices/SKILL.md +149 -149
  552. package/.agents/skills/polish/SKILL.md +39 -39
  553. package/.agents/skills/powershell-windows/SKILL.md +122 -122
  554. package/.agents/skills/pricing-page/SKILL.md +48 -48
  555. package/.agents/skills/product-aware-heuristics/SKILL.md +390 -390
  556. package/.agents/skills/progressive-blur/SKILL.md +80 -80
  557. package/.agents/skills/project-idioms/SKILL.md +91 -91
  558. package/.agents/skills/property-based-testing/SKILL.md +50 -50
  559. package/.agents/skills/python-patterns/SKILL.md +220 -220
  560. package/.agents/skills/python-pro/SKILL.md +305 -305
  561. package/.agents/skills/quieter/SKILL.md +49 -49
  562. package/.agents/skills/react-doctor/SKILL.md +51 -51
  563. package/.agents/skills/react-specialist/SKILL.md +280 -280
  564. package/.agents/skills/readme-builder/SKILL.md +270 -270
  565. package/.agents/skills/realtime-patterns/SKILL.md +283 -283
  566. package/.agents/skills/red-team-tactics/SKILL.md +191 -191
  567. package/.agents/skills/redesign-skill/SKILL.md +46 -46
  568. package/.agents/skills/review-animations/SKILL.md +45 -45
  569. package/.agents/skills/review-animations/STANDARDS.md +87 -87
  570. package/.agents/skills/rust-pro/SKILL.md +652 -652
  571. package/.agents/skills/semantic-filesystem-navigation/SKILL.md +24 -24
  572. package/.agents/skills/seo-fundamentals/SKILL.md +139 -139
  573. package/.agents/skills/server-management/SKILL.md +178 -178
  574. package/.agents/skills/session-log-interrogation/SKILL.md +29 -29
  575. package/.agents/skills/shadcn-ui-expert/SKILL.md +196 -196
  576. package/.agents/skills/shape/SKILL.md +56 -56
  577. package/.agents/skills/skill-creator/SKILL.md +177 -177
  578. package/.agents/skills/soft-skill/SKILL.md +53 -53
  579. package/.agents/skills/sounds-on-the-web/SKILL.md +76 -76
  580. package/.agents/skills/sql-pro/SKILL.md +624 -624
  581. package/.agents/skills/subagent-driven-development/SKILL.md +32 -32
  582. package/.agents/skills/supabase-postgres-best-practices/SKILL.md +57 -57
  583. package/.agents/skills/svg-animation/SKILL.md +356 -356
  584. package/.agents/skills/swiftui-expert/SKILL.md +164 -164
  585. package/.agents/skills/swiss-design/SKILL.md +44 -44
  586. package/.agents/skills/system-design-pro/SKILL.md +188 -318
  587. package/.agents/skills/systematic-debugging/SKILL.md +129 -129
  588. package/.agents/skills/systematic-debugging/condition-based-waiting.md +120 -120
  589. package/.agents/skills/systematic-debugging/defense-in-depth.md +128 -128
  590. package/.agents/skills/systematic-debugging/root-cause-tracing.md +183 -183
  591. package/.agents/skills/tailwind-patterns/SKILL.md +583 -583
  592. package/.agents/skills/taste-skill/SKILL.md +52 -52
  593. package/.agents/skills/tdd-workflow/SKILL.md +105 -105
  594. package/.agents/skills/test-result-analyzer/SKILL.md +270 -270
  595. package/.agents/skills/testing-patterns/SKILL.md +534 -534
  596. package/.agents/skills/thermo-nuclear-code-quality-review/SKILL.md +62 -62
  597. package/.agents/skills/thinking-protocol/SKILL.md +21 -21
  598. package/.agents/skills/to-spring-or-not-to-spring/SKILL.md +43 -43
  599. package/.agents/skills/transformers-js/references/CONFIGURATION.md +1 -1
  600. package/.agents/skills/transitions-dev/SKILL.md +90 -90
  601. package/.agents/skills/trend-researcher/SKILL.md +198 -198
  602. package/.agents/skills/tribunal-instincts-memory/SKILL.md +31 -31
  603. package/.agents/skills/typescript-advanced/SKILL.md +306 -306
  604. package/.agents/skills/typeset/SKILL.md +60 -60
  605. package/.agents/skills/ui-reasoning-engine/SKILL.md +155 -155
  606. package/.agents/skills/ui-skill-packs/SKILL.md +57 -57
  607. package/.agents/skills/ui-skills-root/SKILL.md +69 -69
  608. package/.agents/skills/ui-ux-pro-max/SKILL.md +110 -110
  609. package/.agents/skills/ui-ux-researcher/SKILL.md +199 -199
  610. package/.agents/skills/vector-search-pgvector/SKILL.md +70 -70
  611. package/.agents/skills/verification-before-completion/SKILL.md +107 -107
  612. package/.agents/skills/vue-expert/SKILL.md +259 -259
  613. package/.agents/skills/vulnerability-scanner/SKILL.md +378 -378
  614. package/.agents/skills/web-accessibility-auditor/SKILL.md +179 -179
  615. package/.agents/skills/web-design-guidelines/SKILL.md +49 -49
  616. package/.agents/skills/web-quality-audit/SKILL.md +47 -47
  617. package/.agents/skills/webapp-testing/SKILL.md +128 -128
  618. package/.agents/skills/webgpu-performance/SKILL.md +88 -88
  619. package/.agents/skills/whimsy-injector/SKILL.md +305 -305
  620. package/.agents/skills/workflow-optimizer/SKILL.md +188 -188
  621. package/.agents/skills/zero-trust-passkeys/SKILL.md +82 -82
  622. package/AGENTS.md +93 -93
  623. package/CLAUDE.md +444 -444
  624. package/CONTRIBUTING.md +134 -134
  625. package/README.md +242 -242
  626. package/SECURITY.md +58 -52
  627. package/bin/adapter-install.js +264 -264
  628. package/bin/global-store.js +48 -48
  629. package/bin/mcp-server.js +1653 -1653
  630. package/bin/proxy-server.js +122 -122
  631. package/bin/spawn-agent.js +45 -45
  632. package/bin/tk-proxy.js +34 -34
  633. package/bin/tribunal-kit.js +113 -113
  634. package/bin/wrapper.js +209 -211
  635. package/hooks/hooks-cursor.json +10 -10
  636. package/hooks/hooks.json +10 -10
  637. package/hooks/session-start.js +77 -77
  638. package/mcp_config.json +18 -18
  639. package/package.json +169 -179
  640. package/{.claude-plugin → plugins/claude}/marketplace.json +14 -14
  641. package/{.claude-plugin → plugins/claude}/plugin.json +26 -26
  642. package/{.codex-plugin → plugins/codex}/plugin.json +41 -41
  643. package/{plugin.json → plugins/core-plugin.json} +26 -26
  644. package/{.cursor-plugin → plugins/cursor}/plugin.json +26 -26
  645. package/{.devin-plugin → plugins/devin}/plugin.json +14 -14
  646. package/{gemini-extension.json → plugins/gemini/extension.json} +6 -6
  647. package/{.hermes-plugin → plugins/hermes}/__init__.py +102 -102
  648. package/{.hermes-plugin → plugins/hermes}/plugin.yaml +6 -6
  649. package/{.kimi-plugin → plugins/kimi}/plugin.json +34 -34
  650. package/{marketplace.json → plugins/marketplace.json} +14 -14
  651. package/{.opencode → plugins/opencode}/INSTALL.md +42 -42
  652. package/{.opencode → plugins/opencode}/plugins/tribunal.js +110 -110
  653. package/{.opencode → plugins/opencode}/rules.md +258 -258
  654. package/{.pi → plugins/pi}/extensions/tribunal.ts +130 -130
  655. package/scripts/apply-version.js +57 -57
  656. package/scripts/audit_skill_sdo.js +89 -89
  657. package/scripts/benchmark.js +231 -231
  658. package/scripts/build-graph.js +71 -71
  659. package/scripts/changelog.js +190 -190
  660. package/scripts/clean-pycache.js +42 -42
  661. package/scripts/context_compiler.js +1143 -1117
  662. package/scripts/fix-vbc.js +96 -96
  663. package/scripts/fix-vbc.ps1 +3 -3
  664. package/scripts/modernize_skills.js +268 -268
  665. package/scripts/package-cores.js +116 -116
  666. package/scripts/skill_enhancement_engine.js +608 -608
  667. package/scripts/stress_benchmark.js +358 -358
  668. package/scripts/sync-skills.js +61 -61
  669. package/scripts/sync-version.js +177 -177
  670. package/scripts/telemetry_gc.js +156 -156
  671. package/scripts/validate-payload.js +73 -73
  672. package/scripts/visual_audit.js +136 -136
  673. package/skills/12-principles-of-animation/SKILL.md +51 -51
  674. package/skills/60fps-animation/SKILL.md +91 -91
  675. package/skills/accessible-animation/SKILL.md +189 -189
  676. package/skills/adapt/SKILL.md +56 -56
  677. package/skills/adr-generation/SKILL.md +57 -0
  678. package/skills/advanced-rag-pipelines/SKILL.md +94 -94
  679. package/skills/agent-organizer/SKILL.md +117 -117
  680. package/skills/agent-syscall-guidelines/SKILL.md +25 -25
  681. package/skills/agentic-patterns/SKILL.md +281 -281
  682. package/skills/agentic-workflows-2026/SKILL.md +91 -91
  683. package/skills/agentshield-security/SKILL.md +26 -26
  684. package/skills/ai-app-hardening/SKILL.md +51 -51
  685. package/skills/ai-prompt-injection-defense/SKILL.md +162 -162
  686. package/skills/animation-on-scroll/SKILL.md +196 -196
  687. package/skills/animation-systems/SKILL.md +198 -198
  688. package/skills/antfu-conventions/SKILL.md +54 -54
  689. package/skills/api-patterns/SKILL.md +218 -218
  690. package/skills/api-security-auditor/SKILL.md +155 -155
  691. package/skills/app-builder/SKILL.md +535 -535
  692. package/skills/app-builder/templates/SKILL.md +108 -108
  693. package/skills/app-builder/templates/astro-static/TEMPLATE.md +76 -76
  694. package/skills/app-builder/templates/chrome-extension/TEMPLATE.md +92 -92
  695. package/skills/app-builder/templates/cli-tool/TEMPLATE.md +88 -88
  696. package/skills/app-builder/templates/electron-desktop/TEMPLATE.md +88 -88
  697. package/skills/app-builder/templates/express-api/TEMPLATE.md +83 -83
  698. package/skills/app-builder/templates/flutter-app/TEMPLATE.md +90 -90
  699. package/skills/app-builder/templates/monorepo-turborepo/TEMPLATE.md +90 -90
  700. package/skills/app-builder/templates/nextjs-fullstack/TEMPLATE.md +126 -126
  701. package/skills/app-builder/templates/nextjs-saas/TEMPLATE.md +127 -127
  702. package/skills/app-builder/templates/nextjs-static/TEMPLATE.md +172 -172
  703. package/skills/app-builder/templates/nuxt-app/TEMPLATE.md +139 -139
  704. package/skills/app-builder/templates/python-fastapi/TEMPLATE.md +83 -83
  705. package/skills/app-builder/templates/react-native-app/TEMPLATE.md +122 -122
  706. package/skills/appflow-wireframe/SKILL.md +96 -96
  707. package/skills/apple-design/SKILL.md +89 -89
  708. package/skills/architecture/SKILL.md +188 -188
  709. package/skills/architecture-drift/SKILL.md +45 -0
  710. package/skills/audit-and-fix/SKILL.md +100 -100
  711. package/skills/authentication-best-practices/SKILL.md +157 -157
  712. package/skills/autonomous-execution/SKILL.md +76 -0
  713. package/skills/backend-security-expert/SKILL.md +73 -73
  714. package/skills/baseline-ui/SKILL.md +55 -55
  715. package/skills/bash-linux/SKILL.md +139 -139
  716. package/skills/behavioral-modes/SKILL.md +200 -200
  717. package/skills/better-colors/SKILL.md +116 -116
  718. package/skills/better-typography/SKILL.md +90 -90
  719. package/skills/better-ui/SKILL.md +130 -130
  720. package/skills/bolder/SKILL.md +49 -49
  721. package/skills/brainstorming/SKILL.md +460 -460
  722. package/skills/browser-audit/SKILL.md +102 -102
  723. package/skills/browser-native-ai/SKILL.md +72 -72
  724. package/skills/build-primitive/SKILL.md +50 -50
  725. package/skills/building-native-ui/SKILL.md +162 -162
  726. package/skills/cicd-pro/SKILL.md +412 -412
  727. package/skills/clarify/SKILL.md +55 -55
  728. package/skills/clean-code/SKILL.md +367 -367
  729. package/skills/cloud-architect/SKILL.md +409 -409
  730. package/skills/cobejs/SKILL.md +70 -70
  731. package/skills/code-review-checklist/SKILL.md +163 -163
  732. package/skills/codebase-design/SKILL.md +76 -76
  733. package/skills/colorize/SKILL.md +57 -57
  734. package/skills/compact-landing/SKILL.md +50 -50
  735. package/skills/company-logos/SKILL.md +54 -54
  736. package/skills/config-validator/SKILL.md +125 -125
  737. package/skills/containerization-pro/SKILL.md +422 -422
  738. package/skills/context-engineering-pro/SKILL.md +69 -69
  739. package/skills/create-design-md/SKILL.md +92 -92
  740. package/skills/critique/SKILL.md +79 -79
  741. package/skills/csharp-developer/SKILL.md +478 -478
  742. package/skills/data-validation-schemas/SKILL.md +297 -297
  743. package/skills/database-design/SKILL.md +219 -219
  744. package/skills/delight/SKILL.md +46 -46
  745. package/skills/deployment-procedures/SKILL.md +132 -132
  746. package/skills/design-lab/SKILL.md +42 -42
  747. package/skills/devops-engineer/SKILL.md +305 -305
  748. package/skills/devops-incident-responder/SKILL.md +103 -103
  749. package/skills/diagnosing-bugs/SKILL.md +172 -172
  750. package/skills/distill/SKILL.md +45 -45
  751. package/skills/documentation-templates/SKILL.md +251 -251
  752. package/skills/domain-modeling/SKILL.md +61 -61
  753. package/skills/duckdb-analytical-sql/SKILL.md +51 -51
  754. package/skills/edge-ai-mobile/SKILL.md +42 -42
  755. package/skills/edge-computing/SKILL.md +143 -143
  756. package/skills/emil-design-eng/SKILL.md +134 -134
  757. package/skills/error-resilience/SKILL.md +403 -403
  758. package/skills/expo-router-v4/SKILL.md +72 -72
  759. package/skills/extract-design-system/SKILL.md +120 -120
  760. package/skills/fabel-protocol/SKILL.md +282 -282
  761. package/skills/failure-mode-analysis/SKILL.md +48 -0
  762. package/skills/fixing-accessibility/SKILL.md +87 -87
  763. package/skills/fixing-metadata/SKILL.md +83 -83
  764. package/skills/fixing-motion-performance/SKILL.md +78 -78
  765. package/skills/framer-motion-expert/SKILL.md +237 -237
  766. package/skills/frontend-design/SKILL.md +103 -103
  767. package/skills/frontend-security-expert/SKILL.md +56 -56
  768. package/skills/game-design-expert/SKILL.md +92 -92
  769. package/skills/game-engineering-expert/SKILL.md +108 -108
  770. package/skills/generative-ui-expert/SKILL.md +100 -100
  771. package/skills/geo-fundamentals/SKILL.md +108 -108
  772. package/skills/git-pro/SKILL.md +401 -401
  773. package/skills/github-operations/SKILL.md +295 -295
  774. package/skills/gpt-taste/SKILL.md +50 -50
  775. package/skills/graph-engineering/SKILL.md +28 -28
  776. package/skills/gsap-core/SKILL.md +277 -277
  777. package/skills/gsap-frameworks/SKILL.md +168 -168
  778. package/skills/gsap-performance/SKILL.md +94 -94
  779. package/skills/gsap-plugins/SKILL.md +441 -441
  780. package/skills/gsap-react/SKILL.md +213 -213
  781. package/skills/gsap-scrolltrigger/SKILL.md +312 -312
  782. package/skills/gsap-timeline/SKILL.md +122 -122
  783. package/skills/gsap-utils/SKILL.md +299 -299
  784. package/skills/harden/SKILL.md +55 -55
  785. package/skills/harness-protocol/SKILL.md +48 -48
  786. package/skills/huggingface-spaces/SKILL.md +1 -1
  787. package/skills/human-gate-negotiation/SKILL.md +30 -30
  788. package/skills/i18n-localization/SKILL.md +134 -134
  789. package/skills/impeccable/SKILL.md +52 -52
  790. package/skills/improve-codebase-architecture/SKILL.md +48 -48
  791. package/skills/improve-ui/SKILL.md +70 -70
  792. package/skills/intelligent-routing/SKILL.md +204 -204
  793. package/skills/knowledge-graph/SKILL.md +71 -71
  794. package/skills/landing-page/SKILL.md +65 -65
  795. package/skills/lint-and-validate/SKILL.md +224 -224
  796. package/skills/llm-engineering/SKILL.md +360 -360
  797. package/skills/local-first/SKILL.md +138 -138
  798. package/skills/local-first-architecture/SKILL.md +62 -62
  799. package/skills/lottie-animation/SKILL.md +62 -62
  800. package/skills/marquee-loop/SKILL.md +72 -72
  801. package/skills/masked-reveal/SKILL.md +230 -230
  802. package/skills/mcp-builder/SKILL.md +105 -105
  803. package/skills/micro-interaction/SKILL.md +253 -253
  804. package/skills/mobile-design/SKILL.md +245 -245
  805. package/skills/monorepo-management/SKILL.md +295 -295
  806. package/skills/morphing-icons/SKILL.md +348 -348
  807. package/skills/motion-engineering/SKILL.md +197 -197
  808. package/skills/nextjs-react-expert/SKILL.md +218 -218
  809. package/skills/nodejs-best-practices/SKILL.md +542 -542
  810. package/skills/observability/SKILL.md +303 -303
  811. package/skills/opentelemetry-observability/SKILL.md +51 -51
  812. package/skills/page-transition-animation/SKILL.md +86 -86
  813. package/skills/parallel-agents/SKILL.md +110 -110
  814. package/skills/performance-profiling/SKILL.md +230 -230
  815. package/skills/plan-writing/SKILL.md +127 -127
  816. package/skills/platform-engineer/SKILL.md +108 -108
  817. package/skills/platform-engineering-opentofu/SKILL.md +59 -59
  818. package/skills/playwright-ai-e2e/SKILL.md +52 -52
  819. package/skills/playwright-best-practices/SKILL.md +149 -149
  820. package/skills/polish/SKILL.md +39 -39
  821. package/skills/powershell-windows/SKILL.md +122 -122
  822. package/skills/pricing-page/SKILL.md +48 -48
  823. package/skills/product-aware-heuristics/SKILL.md +390 -390
  824. package/skills/progressive-blur/SKILL.md +80 -80
  825. package/skills/project-idioms/SKILL.md +91 -91
  826. package/skills/property-based-testing/SKILL.md +50 -50
  827. package/skills/python-patterns/SKILL.md +220 -220
  828. package/skills/python-pro/SKILL.md +305 -305
  829. package/skills/quieter/SKILL.md +49 -49
  830. package/skills/react-doctor/SKILL.md +51 -51
  831. package/skills/react-specialist/SKILL.md +280 -280
  832. package/skills/readme-builder/SKILL.md +270 -270
  833. package/skills/realtime-patterns/SKILL.md +283 -283
  834. package/skills/red-team-tactics/SKILL.md +191 -191
  835. package/skills/redesign-skill/SKILL.md +46 -46
  836. package/skills/review-animations/SKILL.md +45 -45
  837. package/skills/review-animations/STANDARDS.md +87 -87
  838. package/skills/rust-pro/SKILL.md +652 -652
  839. package/skills/semantic-filesystem-navigation/SKILL.md +24 -24
  840. package/skills/seo-fundamentals/SKILL.md +139 -139
  841. package/skills/server-management/SKILL.md +178 -178
  842. package/skills/session-log-interrogation/SKILL.md +29 -29
  843. package/skills/shadcn-ui-expert/SKILL.md +196 -196
  844. package/skills/shape/SKILL.md +56 -56
  845. package/skills/skill-creator/SKILL.md +177 -177
  846. package/skills/soft-skill/SKILL.md +53 -53
  847. package/skills/sounds-on-the-web/SKILL.md +76 -76
  848. package/skills/sql-pro/SKILL.md +624 -624
  849. package/skills/subagent-driven-development/SKILL.md +32 -32
  850. package/skills/supabase-postgres-best-practices/SKILL.md +57 -57
  851. package/skills/svg-animation/SKILL.md +356 -356
  852. package/skills/swiftui-expert/SKILL.md +164 -164
  853. package/skills/swiss-design/SKILL.md +44 -44
  854. package/skills/system-design-pro/SKILL.md +188 -318
  855. package/skills/systematic-debugging/SKILL.md +129 -129
  856. package/skills/systematic-debugging/condition-based-waiting.md +120 -120
  857. package/skills/systematic-debugging/defense-in-depth.md +128 -128
  858. package/skills/systematic-debugging/root-cause-tracing.md +183 -183
  859. package/skills/tailwind-patterns/SKILL.md +583 -583
  860. package/skills/taste-skill/SKILL.md +52 -52
  861. package/skills/tdd-workflow/SKILL.md +105 -105
  862. package/skills/test-result-analyzer/SKILL.md +270 -270
  863. package/skills/testing-patterns/SKILL.md +534 -534
  864. package/skills/thermo-nuclear-code-quality-review/SKILL.md +62 -62
  865. package/skills/thinking-protocol/SKILL.md +21 -21
  866. package/skills/to-spring-or-not-to-spring/SKILL.md +43 -43
  867. package/skills/transformers-js/references/CONFIGURATION.md +1 -1
  868. package/skills/transitions-dev/SKILL.md +90 -90
  869. package/skills/trend-researcher/SKILL.md +198 -198
  870. package/skills/tribunal-instincts-memory/SKILL.md +31 -31
  871. package/skills/typescript-advanced/SKILL.md +306 -306
  872. package/skills/typeset/SKILL.md +60 -60
  873. package/skills/ui-reasoning-engine/SKILL.md +155 -155
  874. package/skills/ui-skill-packs/SKILL.md +57 -57
  875. package/skills/ui-skills-root/SKILL.md +69 -69
  876. package/skills/ui-ux-pro-max/SKILL.md +110 -110
  877. package/skills/ui-ux-researcher/SKILL.md +199 -199
  878. package/skills/vector-search-pgvector/SKILL.md +70 -70
  879. package/skills/verification-before-completion/SKILL.md +107 -107
  880. package/skills/vue-expert/SKILL.md +259 -259
  881. package/skills/vulnerability-scanner/SKILL.md +378 -378
  882. package/skills/web-accessibility-auditor/SKILL.md +179 -179
  883. package/skills/web-design-guidelines/SKILL.md +49 -49
  884. package/skills/web-quality-audit/SKILL.md +47 -47
  885. package/skills/webapp-testing/SKILL.md +128 -128
  886. package/skills/webgpu-performance/SKILL.md +88 -88
  887. package/skills/whimsy-injector/SKILL.md +305 -305
  888. package/skills/workflow-optimizer/SKILL.md +188 -188
  889. package/skills/zero-trust-passkeys/SKILL.md +82 -82
  890. package/{dist → src}/browser/audit.js +229 -229
  891. package/{dist → src}/browser/case_bridge.js +189 -189
  892. package/{dist → src}/browser/cdp.js +513 -513
  893. package/{dist → src}/browser/compare.js +110 -110
  894. package/{dist → src}/browser/discovery.js +140 -140
  895. package/{dist → src}/browser/idpi.js +142 -142
  896. package/{dist → src}/browser/index.js +89 -89
  897. package/{dist → src}/browser/launcher.js +154 -154
  898. package/{dist → src}/browser/sentinel.js +202 -202
  899. package/{dist → src}/browser/synapse.js +251 -251
  900. package/{dist → src}/browser/trimmer.js +210 -210
  901. package/{dist → src}/commands/align.js +201 -201
  902. package/{dist → src}/commands/audit-web.js +112 -112
  903. package/{dist → src}/commands/browse.js +56 -56
  904. package/{dist → src}/commands/case.js +71 -73
  905. package/{dist → src}/commands/compare-web.js +61 -61
  906. package/{dist → src}/commands/compile.js +91 -91
  907. package/{dist → src}/commands/context.js +71 -71
  908. package/{dist → src}/commands/contract.js +440 -440
  909. package/{dist → src}/commands/deconstruct.js +58 -58
  910. package/{dist → src}/commands/graph.js +44 -44
  911. package/{dist → src}/commands/guardrail.js +275 -275
  912. package/{dist → src}/commands/heal.js +99 -99
  913. package/{dist → src}/commands/hook.js +28 -28
  914. package/{dist → src}/commands/init.js +393 -393
  915. package/{dist → src}/commands/learn.js +119 -117
  916. package/{dist → src}/commands/marathon.js +45 -45
  917. package/{dist → src}/commands/memory.js +508 -508
  918. package/{dist → src}/commands/minimal.js +71 -71
  919. package/{dist → src}/commands/mutate.js +30 -30
  920. package/{dist → src}/commands/native.js +264 -264
  921. package/{dist → src}/commands/optimize.js +332 -328
  922. package/{dist → src}/commands/sdd.js +265 -229
  923. package/{dist → src}/commands/status.js +66 -66
  924. package/{dist → src}/commands/sync.js +25 -25
  925. package/{dist → src}/commands/uninstall.js +54 -54
  926. package/{dist → src}/commands/update.js +37 -37
  927. package/{dist → src}/commands/validate.js +58 -58
  928. package/{dist → src}/esm/index.mjs +1 -1
  929. package/{dist → src}/mcp/server.js +8 -8
  930. package/{dist → src}/tui/banner.js +1 -1
  931. package/{dist → src}/tui/index.js +21 -21
  932. package/{dist → src}/tui/reviewer-grid.js +90 -90
  933. package/{dist → src}/tui/shimmer.js +91 -91
  934. package/{dist → src}/tui/theme.js +130 -130
  935. package/{dist → src}/tui/tree.js +93 -93
  936. package/{dist → src}/tui/wizard.js +148 -148
  937. package/{dist → src}/types.js +8 -8
  938. package/{dist → src}/utils/fs.js +102 -102
  939. package/{dist → src}/utils/hasher.js +142 -142
  940. package/{dist → src}/utils/helpers.js +53 -53
  941. package/{dist → src}/utils/logger.js +54 -54
  942. package/{dist → src}/utils/version.js +157 -157
  943. package/.agent/history/README.md +0 -53
  944. package/.agent/history/architecture-explorer.html +0 -352
  945. package/.agent/history/architecture-graph.yaml +0 -619
  946. package/.agent/history/case-law/cases/template-case.json +0 -19
  947. package/.agent/history/graph-cache.json +0 -1042
  948. package/.agent/history/integrity_manifest.json +0 -4694
  949. package/.agent/history/memory/.memory.idx +0 -7596
  950. package/.agent/history/memory/MEMORY.md +0 -512
  951. package/.agent/history/memory.db +0 -0
  952. package/.agent/history/snapshots/.opencode__plugins__tribunal.js.json +0 -12
  953. package/.agent/history/snapshots/.pi__extensions__tribunal.ts.json +0 -12
  954. package/.agent/history/snapshots/bin__adapter-install.js.json +0 -13
  955. package/.agent/history/snapshots/bin__global-store.js.json +0 -15
  956. package/.agent/history/snapshots/bin__mcp-server.js.json +0 -21
  957. package/.agent/history/snapshots/bin__proxy-server.js.json +0 -20
  958. package/.agent/history/snapshots/bin__spawn-agent.js.json +0 -12
  959. package/.agent/history/snapshots/bin__tk-proxy.js.json +0 -21
  960. package/.agent/history/snapshots/bin__tribunal-kit.js.json +0 -21
  961. package/.agent/history/snapshots/bin__wrapper.js.json +0 -14
  962. package/.agent/history/snapshots/eslint.config.js.json +0 -8
  963. package/.agent/history/snapshots/hooks__session-start.js.json +0 -11
  964. package/.agent/history/snapshots/scripts__apply-version.js.json +0 -11
  965. package/.agent/history/snapshots/scripts__audit_skill_sdo.js.json +0 -11
  966. package/.agent/history/snapshots/scripts__benchmark.js.json +0 -14
  967. package/.agent/history/snapshots/scripts__changelog.js.json +0 -12
  968. package/.agent/history/snapshots/scripts__clean-pycache.js.json +0 -11
  969. package/.agent/history/snapshots/scripts__context_compiler.js.json +0 -17
  970. package/.agent/history/snapshots/scripts__fix-vbc.js.json +0 -11
  971. package/.agent/history/snapshots/scripts__modernize_skills.js.json +0 -11
  972. package/.agent/history/snapshots/scripts__package-cores.js.json +0 -12
  973. package/.agent/history/snapshots/scripts__skill_enhancement_engine.js.json +0 -11
  974. package/.agent/history/snapshots/scripts__stress_benchmark.js.json +0 -15
  975. package/.agent/history/snapshots/scripts__sync-skills.js.json +0 -11
  976. package/.agent/history/snapshots/scripts__sync-version.js.json +0 -11
  977. package/.agent/history/snapshots/scripts__telemetry_gc.js.json +0 -11
  978. package/.agent/history/snapshots/scripts__validate-payload.js.json +0 -11
  979. package/.agent/history/snapshots/scripts__visual_audit.js.json +0 -11
  980. package/.agent/history/snapshots/test__integration__bridges.test.js.json +0 -13
  981. package/.agent/history/snapshots/test__integration__browser_cli.test.js.json +0 -12
  982. package/.agent/history/snapshots/test__integration__graceful_degradation.test.js.json +0 -12
  983. package/.agent/history/snapshots/test__integration__init.test.js.json +0 -13
  984. package/.agent/history/snapshots/test__integration__minimal_change_pipeline.test.js.json +0 -13
  985. package/.agent/history/snapshots/test__integration__parallel_tribunal.test.js.json +0 -12
  986. package/.agent/history/snapshots/test__integration__routing.test.js.json +0 -11
  987. package/.agent/history/snapshots/test__integration__swarm_dispatcher.test.js.json +0 -13
  988. package/.agent/history/snapshots/test__integration__sync_status.test.js.json +0 -13
  989. package/.agent/history/snapshots/test__integration__wave2.test.js.json +0 -13
  990. package/.agent/history/snapshots/test__integration__wrapper.test.js.json +0 -13
  991. package/.agent/history/snapshots/test__unit__align.test.js.json +0 -10
  992. package/.agent/history/snapshots/test__unit__args.test.js.json +0 -20
  993. package/.agent/history/snapshots/test__unit__ast_context_loader.test.js.json +0 -12
  994. package/.agent/history/snapshots/test__unit__audit_release.test.js.json +0 -16
  995. package/.agent/history/snapshots/test__unit__browser_case_bridge.test.js.json +0 -11
  996. package/.agent/history/snapshots/test__unit__browser_discovery.test.js.json +0 -10
  997. package/.agent/history/snapshots/test__unit__browser_idpi.test.js.json +0 -10
  998. package/.agent/history/snapshots/test__unit__browser_sentinel.test.js.json +0 -11
  999. package/.agent/history/snapshots/test__unit__browser_synapse.test.js.json +0 -10
  1000. package/.agent/history/snapshots/test__unit__browser_trimmer.test.js.json +0 -10
  1001. package/.agent/history/snapshots/test__unit__case_law_manager.test.js.json +0 -10
  1002. package/.agent/history/snapshots/test__unit__cicd_validator.test.js.json +0 -12
  1003. package/.agent/history/snapshots/test__unit__compile.test.js.json +0 -10
  1004. package/.agent/history/snapshots/test__unit__context_broker.test.js.json +0 -10
  1005. package/.agent/history/snapshots/test__unit__context_compiler.test.js.json +0 -26
  1006. package/.agent/history/snapshots/test__unit__contract_engine.test.js.json +0 -13
  1007. package/.agent/history/snapshots/test__unit__copyDir.test.js.json +0 -23
  1008. package/.agent/history/snapshots/test__unit__graph_tools.test.js.json +0 -11
  1009. package/.agent/history/snapshots/test__unit__guardrail_engine.test.js.json +0 -10
  1010. package/.agent/history/snapshots/test__unit__impact_classifier.test.js.json +0 -12
  1011. package/.agent/history/snapshots/test__unit__init.test.js.json +0 -14
  1012. package/.agent/history/snapshots/test__unit__inner_loop_validator.test.js.json +0 -10
  1013. package/.agent/history/snapshots/test__unit__integrity_manifest.test.js.json +0 -13
  1014. package/.agent/history/snapshots/test__unit__learn.test.js.json +0 -11
  1015. package/.agent/history/snapshots/test__unit__marathon.test.js.json +0 -22
  1016. package/.agent/history/snapshots/test__unit__mcp_server.test.js.json +0 -16
  1017. package/.agent/history/snapshots/test__unit__memory.test.js.json +0 -13
  1018. package/.agent/history/snapshots/test__unit__minimal_change.test.js.json +0 -10
  1019. package/.agent/history/snapshots/test__unit__native.test.js.json +0 -10
  1020. package/.agent/history/snapshots/test__unit__optimize.test.js.json +0 -13
  1021. package/.agent/history/snapshots/test__unit__path_resolution.test.js.json +0 -14
  1022. package/.agent/history/snapshots/test__unit__platform_download_audit.test.js.json +0 -11
  1023. package/.agent/history/snapshots/test__unit__production_readiness_evidence.test.js.json +0 -21
  1024. package/.agent/history/snapshots/test__unit__prompt_compiler.test.js.json +0 -10
  1025. package/.agent/history/snapshots/test__unit__sdd_integration.test.js.json +0 -12
  1026. package/.agent/history/snapshots/test__unit__selfInstall.test.js.json +0 -23
  1027. package/.agent/history/snapshots/test__unit__semver.test.js.json +0 -20
  1028. package/.agent/history/snapshots/test__unit__skill_evolution.test.js.json +0 -11
  1029. package/.agent/history/snapshots/test__unit__stress.test.js.json +0 -15
  1030. package/.agent/history/snapshots/test__unit__swarm_dispatcher.test.js.json +0 -12
  1031. package/.agent/history/snapshots/test__unit__token_budget_broker.test.js.json +0 -10
  1032. package/.agent/history/snapshots/test__unit__tui.test.js.json +0 -10
  1033. package/.agent/history/snapshots/test__unit__utils.test.js.json +0 -10
  1034. package/.agents/plugins/marketplace.json +0 -20
  1035. package/.claude/CLAUDE.md +0 -442
  1036. /package/{dist → src}/cli.js +0 -0
  1037. /package/{dist → src}/index.d.ts +0 -0
@@ -1,422 +1,422 @@
1
- ---
2
- name: containerization-pro
3
- description: "Use when Production-grade containerization mastery. Multi-stage Dockerfiles for Node.js/Python/Rust/Go, image hardening (non-root, distroless, read-only FS), BuildKit layer caching, multi-platform builds (docker buildx), Docker Compose for local dev, container security scanning (Trivy/Grype), and AWS ECR workflows. Use when containerizing applications, optimizing Docker builds, or setting up container registries."
4
- version: 5.0.0
5
- last-updated: 2026-09-13
6
- skills:
7
- - devops-engineer
8
- - cicd-pro
9
- - cloud-architect
10
- tools: Read, Grep, Glob, Bash, Edit, Write
11
- scripts-binding:
12
- - .agent/scripts/lint_runner.js
13
- - .agent/scripts/verify_all.js
14
- ---
15
-
16
- # Containerization Pro — Production-Grade Docker Mastery
17
-
18
- ---
19
-
20
- ## 🛠️ Technical Architecture & Reference Recipes
21
-
22
- ---
23
-
24
- ## Hallucination Traps (Read First)
25
-
26
- - ❌ `FROM node:22` → ✅ `FROM node:22-alpine` (1GB+ vs ~150MB). Always use slim/alpine variants.
27
- - ❌ `RUN npm install` → ✅ `RUN npm ci --omit=dev` (deterministic, no devDeps, respects lockfile)
28
- - ❌ `COPY . .` without `.dockerignore` → ✅ Always create `.dockerignore` first. Copies `node_modules`, `.env`, `.git` otherwise.
29
- - ❌ Running container as root → ✅ Always create and switch to a non-root user. Root in container = root on host if container escapes.
30
- - ❌ Single-stage Dockerfile → ✅ Multi-stage builds for any compiled/built application. Final image should contain ONLY runtime artifacts.
31
- - ❌ `docker build` without `--platform` for CI → ✅ CI often runs on `amd64`; target hosts may be `arm64`. Always specify platform or use multi-platform builds.
32
-
33
- ---
34
-
35
- ## 1. The .dockerignore (Write This First)
36
-
37
- ```
38
- # .dockerignore — always create before writing Dockerfile
39
- node_modules
40
- npm-debug.log*
41
- .npm
42
- .git
43
- .gitignore
44
- .env
45
- .env.*
46
- *.md
47
- README*
48
- .github
49
- .vscode
50
- coverage
51
- .nyc_output
52
- dist # will be rebuilt in container
53
- build # will be rebuilt in container
54
- __pycache__
55
- *.pyc
56
- *.pyo
57
- .pytest_cache
58
- target # Rust build artifacts
59
- ```
60
-
61
- ---
62
-
63
- ## 2. Multi-Stage Dockerfiles
64
-
65
- ### Node.js (Production-Ready)
66
-
67
- ```dockerfile
68
- # ✅ Multi-stage — builder produces artifacts, runner is minimal
69
- FROM node:22-alpine AS base
70
- WORKDIR /app
71
-
72
- # Install deps in isolation for better caching
73
- FROM base AS deps
74
- COPY package.json package-lock.json ./
75
- RUN npm ci
76
-
77
- # Build stage
78
- FROM base AS builder
79
- COPY --from=deps /app/node_modules ./node_modules
80
- COPY . .
81
- RUN npm run build
82
-
83
- # ──── Runtime (final) stage ────
84
- FROM node:22-alpine AS runner
85
- WORKDIR /app
86
-
87
- # Security: create non-root user
88
- RUN addgroup --system --gid 1001 appgroup && \
89
- adduser --system --uid 1001 --ingroup appgroup appuser
90
-
91
- # Copy only production artifacts
92
- COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
93
- COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
94
- COPY --from=builder --chown=appuser:appgroup /app/package.json ./
95
-
96
- USER appuser
97
-
98
- ENV NODE_ENV=production
99
- ENV PORT=3000
100
- EXPOSE 3000
101
-
102
- # Health check — required for orchestration (ECS, Kubernetes)
103
- HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
104
- CMD wget --quiet --tries=1 --spider http://localhost:3000/health || exit 1
105
-
106
- CMD ["node", "dist/index.js"]
107
- ```
108
-
109
- ### Python (FastAPI)
110
-
111
- ```dockerfile
112
- FROM python:3.12-slim AS builder
113
- WORKDIR /app
114
-
115
- # Install build tools (needed for some packages, discarded in final image)
116
- RUN apt-get update && apt-get install -y --no-install-recommends gcc && \
117
- rm -rf /var/lib/apt/lists/*
118
-
119
- COPY requirements.txt .
120
- RUN pip install --user --no-cache-dir -r requirements.txt
121
-
122
- # ──── Runtime stage ────
123
- FROM python:3.12-slim AS runner
124
- WORKDIR /app
125
-
126
- # Security: non-root user
127
- RUN addgroup --system --gid 1001 appgroup && \
128
- adduser --system --uid 1001 --gid 1001 appuser
129
-
130
- # Copy installed packages from builder
131
- COPY --from=builder --chown=appuser:appgroup /root/.local /home/appuser/.local
132
- COPY --chown=appuser:appgroup . .
133
-
134
- USER appuser
135
-
136
- ENV PATH=/home/appuser/.local/bin:$PATH
137
- ENV PYTHONUNBUFFERED=1
138
-
139
- EXPOSE 8000
140
-
141
- HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
142
- CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"
143
-
144
- CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
145
- ```
146
-
147
- ### Rust (Distroless Final Image)
148
-
149
- ```dockerfile
150
- FROM rust:1.78-slim AS builder
151
- WORKDIR /app
152
-
153
- # Cache dependencies separately for fast rebuilds
154
- COPY Cargo.toml Cargo.lock ./
155
- RUN mkdir src && echo "fn main() {}" > src/main.rs
156
- RUN cargo build --release
157
- RUN rm src/main.rs
158
-
159
- # Build actual application
160
- COPY src ./src
161
- RUN touch src/main.rs && cargo build --release
162
-
163
- # ──── Distroless runtime (no shell, no package manager, minimal attack surface) ────
164
- FROM gcr.io/distroless/cc-debian12 AS runner
165
- WORKDIR /app
166
-
167
- COPY --from=builder /app/target/release/myapp ./myapp
168
-
169
- USER nonroot:nonroot
170
- EXPOSE 8080
171
-
172
- CMD ["/app/myapp"]
173
- ```
174
-
175
- ### Go
176
-
177
- ```dockerfile
178
- FROM golang:1.22-alpine AS builder
179
- WORKDIR /app
180
-
181
- COPY go.mod go.sum ./
182
- RUN go mod download
183
-
184
- COPY . .
185
- RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-w -s" -o server ./cmd/server
186
-
187
- # ──── Scratch (smallest possible image) ────
188
- FROM scratch AS runner
189
- COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
190
- COPY --from=builder /app/server /server
191
-
192
- EXPOSE 8080
193
- ENTRYPOINT ["/server"]
194
- ```
195
-
196
- ---
197
-
198
- ## 3. BuildKit Layer Caching (CI Speed)
199
-
200
- ```dockerfile
201
- # syntax=docker/dockerfile:1.6
202
- FROM node:22-alpine AS builder
203
- WORKDIR /app
204
-
205
- # Mount npm cache — persists between builds (dramatic speed improvement in CI)
206
- COPY package.json package-lock.json ./
207
- RUN --mount=type=cache,target=/root/.npm \
208
- npm ci
209
-
210
- # Mount build cache (Next.js / webpack)
211
- COPY . .
212
- RUN --mount=type=cache,target=/app/.next/cache \
213
- npm run build
214
- ```
215
-
216
- ```yaml
217
- # GitHub Actions — enable BuildKit with caching
218
- - name: Build and push Docker image
219
- uses: docker/build-push-action@v5
220
- with:
221
- context: .
222
- push: true
223
- tags: ${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}:${{ github.sha }}
224
- cache-from: type=gha # GitHub Actions cache
225
- cache-to: type=gha,mode=max # Cache all layers
226
- build-args: |
227
- BUILDKIT_INLINE_CACHE=1
228
- ```
229
-
230
- ---
231
-
232
- ## 4. Multi-Platform Builds
233
-
234
- ```bash
235
- # Build for both amd64 (x86) and arm64 (Apple Silicon, AWS Graviton)
236
- docker buildx create --name mybuilder --use
237
- docker buildx build \
238
- --platform linux/amd64,linux/arm64 \
239
- --tag myapp:latest \
240
- --push \
241
- .
242
- ```
243
-
244
- ```yaml
245
- # GitHub Actions — multi-platform
246
- - name: Set up QEMU
247
- uses: docker/setup-qemu-action@v3
248
-
249
- - name: Set up Docker Buildx
250
- uses: docker/setup-buildx-action@v3
251
-
252
- - name: Build multi-platform image
253
- uses: docker/build-push-action@v5
254
- with:
255
- platforms: linux/amd64,linux/arm64
256
- push: true
257
- tags: ${{ steps.meta.outputs.tags }}
258
- ```
259
-
260
- ---
261
-
262
- ## 5. Docker Compose (Local Development)
263
-
264
- ```yaml
265
- # docker-compose.yml
266
- services:
267
- api:
268
- build:
269
- context: .
270
- target: builder # use builder stage locally (includes devtools)
271
- dockerfile: Dockerfile
272
- ports:
273
- - '3000:3000'
274
- environment:
275
- NODE_ENV: development
276
- DATABASE_URL: postgres://postgres:postgres@db:5432/myapp_dev
277
- REDIS_URL: redis://redis:6379
278
- volumes:
279
- - .:/app # mount source for hot-reload
280
- - /app/node_modules # anonymous volume prevents host node_modules overwrite
281
- depends_on:
282
- db:
283
- condition: service_healthy
284
- redis:
285
- condition: service_started
286
- restart: unless-stopped
287
-
288
- db:
289
- image: postgres:16-alpine
290
- environment:
291
- POSTGRES_DB: myapp_dev
292
- POSTGRES_USER: postgres
293
- POSTGRES_PASSWORD: postgres
294
- volumes:
295
- - pgdata:/var/lib/postgresql/data
296
- healthcheck:
297
- test: ['CMD-SHELL', 'pg_isready -U postgres']
298
- interval: 5s
299
- timeout: 3s
300
- retries: 5
301
- ports:
302
- - '5432:5432' # expose for local DB clients
303
-
304
- redis:
305
- image: redis:7-alpine
306
- volumes:
307
- - redisdata:/data
308
- ports:
309
- - '6379:6379'
310
-
311
- volumes:
312
- pgdata:
313
- redisdata:
314
- ```
315
-
316
- ---
317
-
318
- ## 6. Container Security Scanning
319
-
320
- ```yaml
321
- # GitHub Actions — Trivy vulnerability scan
322
- - name: Run Trivy vulnerability scanner
323
- uses: aquasecurity/trivy-action@master
324
- with:
325
- image-ref: ${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}:${{ github.sha }}
326
- format: sarif
327
- output: trivy-results.sarif
328
- severity: CRITICAL,HIGH
329
- exit-code: '1' # fail pipeline on CRITICAL/HIGH vulnerabilities
330
-
331
- - name: Upload Trivy scan results to GitHub Security tab
332
- uses: github/codeql-action/upload-sarif@v3
333
- if: always()
334
- with:
335
- sarif_file: trivy-results.sarif
336
- ```
337
-
338
- ```bash
339
- # Local scanning
340
- trivy image myapp:latest
341
-
342
- # Scan Dockerfile for misconfigurations before building
343
- trivy config Dockerfile
344
- ```
345
-
346
- ---
347
-
348
- ## 7. AWS ECR Workflow
349
-
350
- ```yaml
351
- # Complete ECR push workflow
352
- jobs:
353
- build-and-push:
354
- runs-on: ubuntu-latest
355
- permissions:
356
- id-token: write
357
- contents: read
358
- outputs:
359
- image: ${{ steps.build.outputs.image }}
360
-
361
- steps:
362
- - uses: actions/checkout@v4
363
-
364
- - name: Configure AWS credentials (OIDC — no static keys)
365
- uses: aws-actions/configure-aws-credentials@v4
366
- with:
367
- role-to-assume: ${{ secrets.AWS_ROLE_ARN }}
368
- aws-region: us-east-1
369
-
370
- - name: Login to Amazon ECR
371
- id: login-ecr
372
- uses: aws-actions/amazon-ecr-login@v2
373
-
374
- - name: Set up Docker Buildx
375
- uses: docker/setup-buildx-action@v3
376
-
377
- - name: Build, tag, and push image
378
- id: build
379
- uses: docker/build-push-action@v5
380
- with:
381
- context: .
382
- push: true
383
- tags: |
384
- ${{ steps.login-ecr.outputs.registry }}/myapp:${{ github.sha }}
385
- ${{ steps.login-ecr.outputs.registry }}/myapp:latest
386
- cache-from: type=gha
387
- cache-to: type=gha,mode=max
388
-
389
- - name: Output image URI
390
- run: echo "image=${{ steps.login-ecr.outputs.registry }}/myapp:${{ github.sha }}" >> $GITHUB_OUTPUT
391
- ```
392
-
393
- ### ECR Lifecycle Policy (Cost Control)
394
-
395
- ```json
396
- {
397
- "rules": [
398
- {
399
- "rulePriority": 1,
400
- "description": "Keep last 10 production images",
401
- "selection": {
402
- "tagStatus": "tagged",
403
- "tagPrefixList": ["v"],
404
- "countType": "imageCountMoreThan",
405
- "countNumber": 10
406
- },
407
- "action": { "type": "expire" }
408
- },
409
- {
410
- "rulePriority": 2,
411
- "description": "Expire untagged images after 1 day",
412
- "selection": {
413
- "tagStatus": "untagged",
414
- "countType": "sinceImagePushed",
415
- "countUnit": "days",
416
- "countNumber": 1
417
- },
418
- "action": { "type": "expire" }
419
- }
420
- ]
421
- }
422
- ```
1
+ ---
2
+ name: containerization-pro
3
+ description: "Use when Production-grade containerization mastery. Multi-stage Dockerfiles for Node.js/Python/Rust/Go, image hardening (non-root, distroless, read-only FS), BuildKit layer caching, multi-platform builds (docker buildx), Docker Compose for local dev, container security scanning (Trivy/Grype), and AWS ECR workflows. Use when containerizing applications, optimizing Docker builds, or setting up container registries."
4
+ version: 5.0.0
5
+ last-updated: 2026-09-13
6
+ skills:
7
+ - devops-engineer
8
+ - cicd-pro
9
+ - cloud-architect
10
+ tools: Read, Grep, Glob, Bash, Edit, Write
11
+ scripts-binding:
12
+ - .agent/scripts/lint_runner.js
13
+ - .agent/scripts/verify_all.js
14
+ ---
15
+
16
+ # Containerization Pro — Production-Grade Docker Mastery
17
+
18
+ ---
19
+
20
+ ## 🛠️ Technical Architecture & Reference Recipes
21
+
22
+ ---
23
+
24
+ ## Hallucination Traps (Read First)
25
+
26
+ - ❌ `FROM node:22` → ✅ `FROM node:22-alpine` (1GB+ vs ~150MB). Always use slim/alpine variants.
27
+ - ❌ `RUN npm install` → ✅ `RUN npm ci --omit=dev` (deterministic, no devDeps, respects lockfile)
28
+ - ❌ `COPY . .` without `.dockerignore` → ✅ Always create `.dockerignore` first. Copies `node_modules`, `.env`, `.git` otherwise.
29
+ - ❌ Running container as root → ✅ Always create and switch to a non-root user. Root in container = root on host if container escapes.
30
+ - ❌ Single-stage Dockerfile → ✅ Multi-stage builds for any compiled/built application. Final image should contain ONLY runtime artifacts.
31
+ - ❌ `docker build` without `--platform` for CI → ✅ CI often runs on `amd64`; target hosts may be `arm64`. Always specify platform or use multi-platform builds.
32
+
33
+ ---
34
+
35
+ ## 1. The .dockerignore (Write This First)
36
+
37
+ ```
38
+ # .dockerignore — always create before writing Dockerfile
39
+ node_modules
40
+ npm-debug.log*
41
+ .npm
42
+ .git
43
+ .gitignore
44
+ .env
45
+ .env.*
46
+ *.md
47
+ README*
48
+ .github
49
+ .vscode
50
+ coverage
51
+ .nyc_output
52
+ dist # will be rebuilt in container
53
+ build # will be rebuilt in container
54
+ __pycache__
55
+ *.pyc
56
+ *.pyo
57
+ .pytest_cache
58
+ target # Rust build artifacts
59
+ ```
60
+
61
+ ---
62
+
63
+ ## 2. Multi-Stage Dockerfiles
64
+
65
+ ### Node.js (Production-Ready)
66
+
67
+ ```dockerfile
68
+ # ✅ Multi-stage — builder produces artifacts, runner is minimal
69
+ FROM node:22-alpine AS base
70
+ WORKDIR /app
71
+
72
+ # Install deps in isolation for better caching
73
+ FROM base AS deps
74
+ COPY package.json package-lock.json ./
75
+ RUN npm ci
76
+
77
+ # Build stage
78
+ FROM base AS builder
79
+ COPY --from=deps /app/node_modules ./node_modules
80
+ COPY . .
81
+ RUN npm run build
82
+
83
+ # ──── Runtime (final) stage ────
84
+ FROM node:22-alpine AS runner
85
+ WORKDIR /app
86
+
87
+ # Security: create non-root user
88
+ RUN addgroup --system --gid 1001 appgroup && \
89
+ adduser --system --uid 1001 --ingroup appgroup appuser
90
+
91
+ # Copy only production artifacts
92
+ COPY --from=builder --chown=appuser:appgroup /app/dist ./dist
93
+ COPY --from=builder --chown=appuser:appgroup /app/node_modules ./node_modules
94
+ COPY --from=builder --chown=appuser:appgroup /app/package.json ./
95
+
96
+ USER appuser
97
+
98
+ ENV NODE_ENV=production
99
+ ENV PORT=3000
100
+ EXPOSE 3000
101
+
102
+ # Health check — required for orchestration (ECS, Kubernetes)
103
+ HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
104
+ CMD wget --quiet --tries=1 --spider http://localhost:3000/health || exit 1
105
+
106
+ CMD ["node", "src/index.js"]
107
+ ```
108
+
109
+ ### Python (FastAPI)
110
+
111
+ ```dockerfile
112
+ FROM python:3.12-slim AS builder
113
+ WORKDIR /app
114
+
115
+ # Install build tools (needed for some packages, discarded in final image)
116
+ RUN apt-get update && apt-get install -y --no-install-recommends gcc && \
117
+ rm -rf /var/lib/apt/lists/*
118
+
119
+ COPY requirements.txt .
120
+ RUN pip install --user --no-cache-dir -r requirements.txt
121
+
122
+ # ──── Runtime stage ────
123
+ FROM python:3.12-slim AS runner
124
+ WORKDIR /app
125
+
126
+ # Security: non-root user
127
+ RUN addgroup --system --gid 1001 appgroup && \
128
+ adduser --system --uid 1001 --gid 1001 appuser
129
+
130
+ # Copy installed packages from builder
131
+ COPY --from=builder --chown=appuser:appgroup /root/.local /home/appuser/.local
132
+ COPY --chown=appuser:appgroup . .
133
+
134
+ USER appuser
135
+
136
+ ENV PATH=/home/appuser/.local/bin:$PATH
137
+ ENV PYTHONUNBUFFERED=1
138
+
139
+ EXPOSE 8000
140
+
141
+ HEALTHCHECK --interval=30s --timeout=5s --retries=3 \
142
+ CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')"
143
+
144
+ CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
145
+ ```
146
+
147
+ ### Rust (Distroless Final Image)
148
+
149
+ ```dockerfile
150
+ FROM rust:1.78-slim AS builder
151
+ WORKDIR /app
152
+
153
+ # Cache dependencies separately for fast rebuilds
154
+ COPY Cargo.toml Cargo.lock ./
155
+ RUN mkdir src && echo "fn main() {}" > src/main.rs
156
+ RUN cargo build --release
157
+ RUN rm src/main.rs
158
+
159
+ # Build actual application
160
+ COPY src ./src
161
+ RUN touch src/main.rs && cargo build --release
162
+
163
+ # ──── Distroless runtime (no shell, no package manager, minimal attack surface) ────
164
+ FROM gcr.io/distroless/cc-debian12 AS runner
165
+ WORKDIR /app
166
+
167
+ COPY --from=builder /app/target/release/myapp ./myapp
168
+
169
+ USER nonroot:nonroot
170
+ EXPOSE 8080
171
+
172
+ CMD ["/app/myapp"]
173
+ ```
174
+
175
+ ### Go
176
+
177
+ ```dockerfile
178
+ FROM golang:1.22-alpine AS builder
179
+ WORKDIR /app
180
+
181
+ COPY go.mod go.sum ./
182
+ RUN go mod download
183
+
184
+ COPY . .
185
+ RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-w -s" -o server ./cmd/server
186
+
187
+ # ──── Scratch (smallest possible image) ────
188
+ FROM scratch AS runner
189
+ COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
190
+ COPY --from=builder /app/server /server
191
+
192
+ EXPOSE 8080
193
+ ENTRYPOINT ["/server"]
194
+ ```
195
+
196
+ ---
197
+
198
+ ## 3. BuildKit Layer Caching (CI Speed)
199
+
200
+ ```dockerfile
201
+ # syntax=docker/dockerfile:1.6
202
+ FROM node:22-alpine AS builder
203
+ WORKDIR /app
204
+
205
+ # Mount npm cache — persists between builds (dramatic speed improvement in CI)
206
+ COPY package.json package-lock.json ./
207
+ RUN --mount=type=cache,target=/root/.npm \
208
+ npm ci
209
+
210
+ # Mount build cache (Next.js / webpack)
211
+ COPY . .
212
+ RUN --mount=type=cache,target=/app/.next/cache \
213
+ npm run build
214
+ ```
215
+
216
+ ```yaml
217
+ # GitHub Actions — enable BuildKit with caching
218
+ - name: Build and push Docker image
219
+ uses: docker/build-push-action@v5
220
+ with:
221
+ context: .
222
+ push: true
223
+ tags: ${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}:${{ github.sha }}
224
+ cache-from: type=gha # GitHub Actions cache
225
+ cache-to: type=gha,mode=max # Cache all layers
226
+ build-args: |
227
+ BUILDKIT_INLINE_CACHE=1
228
+ ```
229
+
230
+ ---
231
+
232
+ ## 4. Multi-Platform Builds
233
+
234
+ ```bash
235
+ # Build for both amd64 (x86) and arm64 (Apple Silicon, AWS Graviton)
236
+ docker buildx create --name mybuilder --use
237
+ docker buildx build \
238
+ --platform linux/amd64,linux/arm64 \
239
+ --tag myapp:latest \
240
+ --push \
241
+ .
242
+ ```
243
+
244
+ ```yaml
245
+ # GitHub Actions — multi-platform
246
+ - name: Set up QEMU
247
+ uses: docker/setup-qemu-action@v3
248
+
249
+ - name: Set up Docker Buildx
250
+ uses: docker/setup-buildx-action@v3
251
+
252
+ - name: Build multi-platform image
253
+ uses: docker/build-push-action@v5
254
+ with:
255
+ platforms: linux/amd64,linux/arm64
256
+ push: true
257
+ tags: ${{ steps.meta.outputs.tags }}
258
+ ```
259
+
260
+ ---
261
+
262
+ ## 5. Docker Compose (Local Development)
263
+
264
+ ```yaml
265
+ # docker-compose.yml
266
+ services:
267
+ api:
268
+ build:
269
+ context: .
270
+ target: builder # use builder stage locally (includes devtools)
271
+ dockerfile: Dockerfile
272
+ ports:
273
+ - '3000:3000'
274
+ environment:
275
+ NODE_ENV: development
276
+ DATABASE_URL: postgres://postgres:postgres@db:5432/myapp_dev
277
+ REDIS_URL: redis://redis:6379
278
+ volumes:
279
+ - .:/app # mount source for hot-reload
280
+ - /app/node_modules # anonymous volume prevents host node_modules overwrite
281
+ depends_on:
282
+ db:
283
+ condition: service_healthy
284
+ redis:
285
+ condition: service_started
286
+ restart: unless-stopped
287
+
288
+ db:
289
+ image: postgres:16-alpine
290
+ environment:
291
+ POSTGRES_DB: myapp_dev
292
+ POSTGRES_USER: postgres
293
+ POSTGRES_PASSWORD: postgres
294
+ volumes:
295
+ - pgdata:/var/lib/postgresql/data
296
+ healthcheck:
297
+ test: ['CMD-SHELL', 'pg_isready -U postgres']
298
+ interval: 5s
299
+ timeout: 3s
300
+ retries: 5
301
+ ports:
302
+ - '5432:5432' # expose for local DB clients
303
+
304
+ redis:
305
+ image: redis:7-alpine
306
+ volumes:
307
+ - redisdata:/data
308
+ ports:
309
+ - '6379:6379'
310
+
311
+ volumes:
312
+ pgdata:
313
+ redisdata:
314
+ ```
315
+
316
+ ---
317
+
318
+ ## 6. Container Security Scanning
319
+
320
+ ```yaml
321
+ # GitHub Actions — Trivy vulnerability scan
322
+ - name: Run Trivy vulnerability scanner
323
+ uses: aquasecurity/trivy-action@master
324
+ with:
325
+ image-ref: ${{ env.ECR_REGISTRY }}/${{ env.ECR_REPOSITORY }}:${{ github.sha }}
326
+ format: sarif
327
+ output: trivy-results.sarif
328
+ severity: CRITICAL,HIGH
329
+ exit-code: '1' # fail pipeline on CRITICAL/HIGH vulnerabilities
330
+
331
+ - name: Upload Trivy scan results to GitHub Security tab
332
+ uses: github/codeql-action/upload-sarif@v3
333
+ if: always()
334
+ with:
335
+ sarif_file: trivy-results.sarif
336
+ ```
337
+
338
+ ```bash
339
+ # Local scanning
340
+ trivy image myapp:latest
341
+
342
+ # Scan Dockerfile for misconfigurations before building
343
+ trivy config Dockerfile
344
+ ```
345
+
346
+ ---
347
+
348
+ ## 7. AWS ECR Workflow
349
+
350
+ ```yaml
351
+ # Complete ECR push workflow
352
+ jobs:
353
+ build-and-push:
354
+ runs-on: ubuntu-latest
355
+ permissions:
356
+ id-token: write
357
+ contents: read
358
+ outputs:
359
+ image: ${{ steps.build.outputs.image }}
360
+
361
+ steps:
362
+ - uses: actions/checkout@v4
363
+
364
+ - name: Configure AWS credentials (OIDC — no static keys)
365
+ uses: aws-actions/configure-aws-credentials@v4
366
+ with:
367
+ role-to-assume: ${{ secrets.AWS_ROLE_ARN }}
368
+ aws-region: us-east-1
369
+
370
+ - name: Login to Amazon ECR
371
+ id: login-ecr
372
+ uses: aws-actions/amazon-ecr-login@v2
373
+
374
+ - name: Set up Docker Buildx
375
+ uses: docker/setup-buildx-action@v3
376
+
377
+ - name: Build, tag, and push image
378
+ id: build
379
+ uses: docker/build-push-action@v5
380
+ with:
381
+ context: .
382
+ push: true
383
+ tags: |
384
+ ${{ steps.login-ecr.outputs.registry }}/myapp:${{ github.sha }}
385
+ ${{ steps.login-ecr.outputs.registry }}/myapp:latest
386
+ cache-from: type=gha
387
+ cache-to: type=gha,mode=max
388
+
389
+ - name: Output image URI
390
+ run: echo "image=${{ steps.login-ecr.outputs.registry }}/myapp:${{ github.sha }}" >> $GITHUB_OUTPUT
391
+ ```
392
+
393
+ ### ECR Lifecycle Policy (Cost Control)
394
+
395
+ ```json
396
+ {
397
+ "rules": [
398
+ {
399
+ "rulePriority": 1,
400
+ "description": "Keep last 10 production images",
401
+ "selection": {
402
+ "tagStatus": "tagged",
403
+ "tagPrefixList": ["v"],
404
+ "countType": "imageCountMoreThan",
405
+ "countNumber": 10
406
+ },
407
+ "action": { "type": "expire" }
408
+ },
409
+ {
410
+ "rulePriority": 2,
411
+ "description": "Expire untagged images after 1 day",
412
+ "selection": {
413
+ "tagStatus": "untagged",
414
+ "countType": "sinceImagePushed",
415
+ "countUnit": "days",
416
+ "countNumber": 1
417
+ },
418
+ "action": { "type": "expire" }
419
+ }
420
+ ]
421
+ }
422
+ ```