@geraldmaron/construct 1.0.12 → 1.0.15

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 (337) hide show
  1. package/README.md +14 -2
  2. package/bin/construct +262 -14
  3. package/bin/construct-postinstall.mjs +23 -2
  4. package/commands/build/feature.md +0 -6
  5. package/commands/build/fix.md +0 -6
  6. package/commands/design/access.md +0 -6
  7. package/commands/design/flow.md +0 -6
  8. package/commands/design/ui.md +0 -6
  9. package/commands/measure/experiment.md +0 -6
  10. package/commands/measure/metrics.md +0 -6
  11. package/commands/measure/results.md +0 -6
  12. package/commands/plan/api.md +0 -6
  13. package/commands/plan/challenge.md +0 -6
  14. package/commands/plan/decide.md +0 -6
  15. package/commands/plan/feature.md +0 -7
  16. package/commands/plan/requirements.md +0 -6
  17. package/commands/remember/context.md +0 -6
  18. package/commands/remember/handoff.md +0 -6
  19. package/commands/remember/runbook.md +0 -6
  20. package/commands/review/code.md +0 -6
  21. package/commands/review/quality.md +0 -6
  22. package/commands/review/security.md +0 -6
  23. package/commands/ship/ready.md +0 -6
  24. package/commands/ship/release.md +0 -6
  25. package/commands/ship/status.md +0 -6
  26. package/commands/understand/docs.md +0 -6
  27. package/commands/understand/research.md +0 -6
  28. package/commands/understand/this.md +0 -6
  29. package/commands/understand/why.md +0 -6
  30. package/commands/work/clean.md +0 -6
  31. package/commands/work/drive.md +0 -6
  32. package/commands/work/optimize-prompts.md +0 -6
  33. package/commands/work/parallel-review.md +0 -6
  34. package/lib/auto-docs.mjs +11 -7
  35. package/lib/beads-client.mjs +19 -1
  36. package/lib/comment-lint.mjs +5 -1
  37. package/lib/context-state.mjs +15 -3
  38. package/lib/contracts/validate.mjs +54 -10
  39. package/lib/contracts/violation-log.mjs +154 -0
  40. package/lib/dashboard-static.mjs +7 -4
  41. package/lib/doc-stamp.mjs +16 -0
  42. package/lib/docs-verify.mjs +1 -8
  43. package/lib/doctor/watchers/bd-watch.mjs +6 -2
  44. package/lib/document-extract/docling-client.mjs +114 -0
  45. package/lib/document-extract/docling-sidecar.py +122 -0
  46. package/lib/document-extract/whisper-client.mjs +79 -0
  47. package/lib/document-extract.mjs +73 -8
  48. package/lib/document-ingest.mjs +26 -4
  49. package/lib/embed/daemon.mjs +26 -1
  50. package/lib/embed/docs-lifecycle.mjs +19 -0
  51. package/lib/embed/inbox.mjs +85 -2
  52. package/lib/embed/recommendation-store.mjs +29 -0
  53. package/lib/flavors/loader.mjs +1 -1
  54. package/lib/gates-audit.mjs +18 -12
  55. package/lib/handoffs/contract.mjs +2 -2
  56. package/lib/hooks/_lib/input.mjs +52 -0
  57. package/lib/hooks/adaptive-lint.mjs +4 -0
  58. package/lib/hooks/agent-tracker.mjs +59 -15
  59. package/lib/hooks/audit-reads.mjs +83 -42
  60. package/lib/hooks/audit-trail.mjs +28 -18
  61. package/lib/hooks/bash-output-logger.mjs +8 -2
  62. package/lib/hooks/block-no-verify.mjs +4 -0
  63. package/lib/hooks/ci-status-check.mjs +4 -0
  64. package/lib/hooks/comment-lint.mjs +6 -4
  65. package/lib/hooks/config-protection.mjs +4 -0
  66. package/lib/hooks/context-watch.mjs +4 -0
  67. package/lib/hooks/context-window-recovery.mjs +4 -0
  68. package/lib/hooks/dep-audit.mjs +12 -5
  69. package/lib/hooks/doc-coupling-check.mjs +5 -1
  70. package/lib/hooks/edit-accumulator.mjs +25 -10
  71. package/lib/hooks/edit-error-recovery.mjs +4 -0
  72. package/lib/hooks/edit-guard.mjs +4 -0
  73. package/lib/hooks/guard-bash.mjs +4 -0
  74. package/lib/hooks/mcp-audit.mjs +4 -0
  75. package/lib/hooks/mcp-health-check.mjs +4 -0
  76. package/lib/hooks/model-fallback.mjs +7 -11
  77. package/lib/hooks/policy-engine.mjs +4 -0
  78. package/lib/hooks/post-merge-docs-check.mjs +4 -0
  79. package/lib/hooks/post-merge-tracking.mjs +82 -0
  80. package/lib/hooks/pre-compact.mjs +4 -0
  81. package/lib/hooks/pre-push-gate.mjs +84 -231
  82. package/lib/hooks/proactive-activation.mjs +5 -2
  83. package/lib/hooks/readme-age-check.mjs +4 -0
  84. package/lib/hooks/registry-sync.mjs +35 -20
  85. package/lib/hooks/rule-verifier.mjs +3 -0
  86. package/lib/hooks/scan-secrets.mjs +4 -0
  87. package/lib/hooks/session-optimize.mjs +4 -0
  88. package/lib/hooks/session-reflect.mjs +4 -0
  89. package/lib/hooks/session-start.mjs +49 -2
  90. package/lib/hooks/session-tracking-refresh.mjs +70 -0
  91. package/lib/hooks/stop-notify.mjs +13 -2
  92. package/lib/hooks/stop-typecheck.mjs +4 -0
  93. package/lib/hooks/test-watch.mjs +8 -4
  94. package/lib/ingest/chunker.mjs +94 -0
  95. package/lib/ingest/pipeline.mjs +53 -0
  96. package/lib/ingest/store.mjs +82 -0
  97. package/lib/init-unified.mjs +90 -23
  98. package/lib/intake/attribution.mjs +77 -0
  99. package/lib/intake/intake-config.mjs +3 -0
  100. package/lib/intake/manifest.mjs +107 -0
  101. package/lib/intake/poll-lock.mjs +136 -0
  102. package/lib/intake/prepare.mjs +42 -4
  103. package/lib/knowledge/search.mjs +12 -0
  104. package/lib/logging/rotate.mjs +394 -0
  105. package/lib/mcp/server.mjs +142 -1
  106. package/lib/mcp/tools/project.mjs +2 -2
  107. package/lib/mcp/tools/skills.mjs +6 -3
  108. package/lib/mcp/tools/telemetry.mjs +1 -1
  109. package/lib/mcp/tools/workflow.mjs +6 -2
  110. package/lib/observation-store.mjs +14 -5
  111. package/lib/ollama-manager.mjs +32 -28
  112. package/lib/opencode-config.mjs +10 -3
  113. package/lib/orchestration/routing-tables.mjs +176 -0
  114. package/lib/orchestration-policy.mjs +18 -106
  115. package/lib/parity.mjs +48 -7
  116. package/lib/profiles/lifecycle.mjs +19 -1
  117. package/lib/project-init-shared.mjs +11 -5
  118. package/lib/project-root.mjs +104 -0
  119. package/lib/prompt-composer.js +11 -1
  120. package/lib/roles/catalog.mjs +1 -1
  121. package/lib/roles/event-bus.mjs +29 -9
  122. package/lib/roles/router.mjs +8 -7
  123. package/lib/runtime/uv-bootstrap.mjs +129 -0
  124. package/lib/runtime/whisper-bootstrap.mjs +102 -0
  125. package/lib/server/index.mjs +53 -10
  126. package/lib/server/static/index.html +1 -15
  127. package/lib/specialists/postconditions.mjs +1 -1
  128. package/lib/status.mjs +1 -1
  129. package/lib/storage/backup.mjs +2 -2
  130. package/lib/sync/skill-frontmatter.mjs +113 -21
  131. package/lib/telemetry/intent-verifications.mjs +16 -3
  132. package/lib/telemetry/skill-calls.mjs +12 -3
  133. package/lib/tracking-surfaces.mjs +377 -0
  134. package/lib/validators/skills.mjs +86 -54
  135. package/lib/worker/trace.mjs +19 -2
  136. package/package.json +10 -6
  137. package/personas/construct.md +4 -7
  138. package/platforms/claude/settings.template.json +29 -28
  139. package/rules/common/beads-hygiene.md +3 -9
  140. package/rules/common/code-review.md +3 -6
  141. package/rules/common/coding-style.md +3 -6
  142. package/rules/common/comments.md +3 -7
  143. package/rules/common/commit-approval.md +3 -6
  144. package/rules/common/cx-agent-routing.md +3 -7
  145. package/rules/common/cx-skill-routing.md +3 -3
  146. package/rules/common/doc-ownership.md +3 -8
  147. package/rules/common/efficiency.md +3 -8
  148. package/rules/common/framing.md +3 -8
  149. package/rules/common/git-workflow.md +3 -5
  150. package/rules/common/no-fabrication.md +4 -12
  151. package/rules/common/patterns.md +3 -5
  152. package/rules/common/release-gates.md +3 -8
  153. package/rules/common/research.md +3 -8
  154. package/rules/common/review-before-change.md +3 -9
  155. package/rules/common/security.md +3 -6
  156. package/rules/common/skill-composition.md +3 -7
  157. package/rules/common/testing.md +3 -6
  158. package/rules/golang/coding-style.md +1 -5
  159. package/rules/golang/hooks.md +1 -5
  160. package/rules/golang/patterns.md +1 -5
  161. package/rules/golang/security.md +1 -5
  162. package/rules/golang/testing.md +1 -5
  163. package/rules/python/coding-style.md +1 -5
  164. package/rules/python/hooks.md +1 -5
  165. package/rules/python/patterns.md +1 -5
  166. package/rules/python/security.md +1 -5
  167. package/rules/python/testing.md +1 -5
  168. package/rules/swift/coding-style.md +1 -5
  169. package/rules/swift/hooks.md +1 -5
  170. package/rules/swift/patterns.md +1 -5
  171. package/rules/swift/security.md +1 -5
  172. package/rules/swift/testing.md +1 -5
  173. package/rules/typescript/coding-style.md +1 -5
  174. package/rules/typescript/hooks.md +1 -5
  175. package/rules/typescript/patterns.md +1 -5
  176. package/rules/typescript/security.md +1 -5
  177. package/rules/typescript/testing.md +1 -5
  178. package/rules/web/coding-style.md +3 -5
  179. package/rules/web/design-quality.md +3 -5
  180. package/rules/web/hooks.md +3 -5
  181. package/rules/web/patterns.md +3 -5
  182. package/rules/web/performance.md +3 -5
  183. package/rules/web/security.md +3 -5
  184. package/rules/web/testing.md +3 -5
  185. package/scripts/sync-specialists.mjs +269 -75
  186. package/skills/ai/agent-dev.md +4 -5
  187. package/skills/ai/llm-security.md +4 -5
  188. package/skills/ai/ml-ops.md +4 -5
  189. package/skills/ai/orchestration-workflow.md +4 -5
  190. package/skills/ai/prompt-and-eval.md +4 -5
  191. package/skills/ai/prompt-optimizer.md +4 -6
  192. package/skills/ai/rag-system.md +4 -5
  193. package/skills/architecture/api-design.md +4 -5
  194. package/skills/architecture/caching.md +4 -5
  195. package/skills/architecture/cloud-native.md +4 -5
  196. package/skills/architecture/message-queue.md +4 -5
  197. package/skills/architecture/security-arch.md +4 -5
  198. package/skills/compliance/ai-disclosure.md +4 -5
  199. package/skills/compliance/data-privacy.md +4 -5
  200. package/skills/compliance/license-audit.md +4 -5
  201. package/skills/compliance/regulatory-review.md +4 -5
  202. package/skills/development/cpp.md +4 -5
  203. package/skills/development/go.md +4 -5
  204. package/skills/development/java.md +4 -5
  205. package/skills/development/kotlin.md +4 -5
  206. package/skills/development/mobile-crossplatform.md +4 -5
  207. package/skills/development/python.md +4 -5
  208. package/skills/development/rust.md +4 -5
  209. package/skills/development/shell.md +4 -5
  210. package/skills/development/swift.md +4 -5
  211. package/skills/development/typescript.md +4 -5
  212. package/skills/devops/ci-cd.md +4 -5
  213. package/skills/devops/containerization.md +4 -5
  214. package/skills/devops/cost-optimization.md +4 -5
  215. package/skills/devops/data-engineering.md +4 -5
  216. package/skills/devops/database.md +4 -5
  217. package/skills/devops/dependency-management.md +4 -5
  218. package/skills/devops/devsecops.md +4 -5
  219. package/skills/devops/git-workflow.md +4 -5
  220. package/skills/devops/incident-response.md +4 -5
  221. package/skills/devops/monorepo.md +4 -5
  222. package/skills/devops/observability.md +4 -5
  223. package/skills/devops/performance.md +4 -5
  224. package/skills/devops/testing.md +4 -5
  225. package/skills/docs/adr-workflow.md +4 -7
  226. package/skills/docs/backlog-proposal-workflow.md +4 -3
  227. package/skills/docs/customer-profile-workflow.md +4 -3
  228. package/skills/docs/document-ingest-workflow.md +4 -3
  229. package/skills/docs/evidence-ingest-workflow.md +4 -3
  230. package/skills/docs/init-docs.md +4 -5
  231. package/skills/docs/init-project.md +4 -5
  232. package/skills/docs/prd-workflow.md +4 -7
  233. package/skills/docs/prfaq-workflow.md +4 -3
  234. package/skills/docs/product-intelligence-review.md +4 -3
  235. package/skills/docs/product-intelligence-workflow.md +4 -6
  236. package/skills/docs/product-signal-workflow.md +4 -5
  237. package/skills/docs/research-workflow.md +4 -5
  238. package/skills/docs/runbook-workflow.md +4 -5
  239. package/skills/docs/strategy-workflow.md +4 -5
  240. package/skills/exploration/dependency-graph-reading.md +4 -7
  241. package/skills/exploration/repo-map.md +4 -5
  242. package/skills/exploration/tracer-bullet-method.md +4 -7
  243. package/skills/exploration/unknown-codebase-onboarding.md +4 -7
  244. package/skills/frameworks/django.md +4 -5
  245. package/skills/frameworks/nextjs.md +4 -5
  246. package/skills/frameworks/react.md +4 -5
  247. package/skills/frameworks/spring-boot.md +4 -5
  248. package/skills/frontend-design/accessibility.md +4 -5
  249. package/skills/frontend-design/component-patterns.md +4 -5
  250. package/skills/frontend-design/engineering.md +4 -5
  251. package/skills/frontend-design/state-management.md +4 -5
  252. package/skills/frontend-design/ui-aesthetics.md +4 -5
  253. package/skills/frontend-design/ux-principles.md +4 -5
  254. package/skills/operating/change-management.md +4 -8
  255. package/skills/operating/incident-response.md +4 -8
  256. package/skills/operating/oncall-rotation.md +4 -7
  257. package/skills/operating/orchestration-reference.md +4 -10
  258. package/skills/quality-gates/review-work.md +4 -5
  259. package/skills/quality-gates/verify-change.md +4 -5
  260. package/skills/quality-gates/verify-module.md +4 -5
  261. package/skills/quality-gates/verify-quality.md +4 -5
  262. package/skills/quality-gates/verify-security.md +4 -5
  263. package/skills/roles/architect.ai-systems.md +6 -9
  264. package/skills/roles/architect.data.md +6 -9
  265. package/skills/roles/architect.enterprise.md +6 -9
  266. package/skills/roles/architect.integration.md +6 -9
  267. package/skills/roles/architect.md +7 -14
  268. package/skills/roles/architect.platform.md +6 -9
  269. package/skills/roles/data-analyst.experiment.md +6 -9
  270. package/skills/roles/data-analyst.md +6 -9
  271. package/skills/roles/data-analyst.product-intelligence.md +7 -9
  272. package/skills/roles/data-analyst.product.md +6 -9
  273. package/skills/roles/data-analyst.telemetry.md +7 -9
  274. package/skills/roles/data-engineer.pipeline.md +6 -9
  275. package/skills/roles/data-engineer.vector-retrieval.md +7 -9
  276. package/skills/roles/data-engineer.warehouse.md +6 -9
  277. package/skills/roles/debugger.md +6 -9
  278. package/skills/roles/designer.accessibility.md +6 -9
  279. package/skills/roles/designer.md +7 -9
  280. package/skills/roles/engineer.ai.md +6 -9
  281. package/skills/roles/engineer.data.md +6 -9
  282. package/skills/roles/engineer.md +9 -9
  283. package/skills/roles/engineer.platform.md +6 -9
  284. package/skills/roles/operator.docs.md +6 -9
  285. package/skills/roles/operator.md +9 -9
  286. package/skills/roles/operator.release.md +6 -9
  287. package/skills/roles/operator.sre.md +6 -9
  288. package/skills/roles/orchestrator.md +6 -9
  289. package/skills/roles/product-manager.ai-product.md +6 -9
  290. package/skills/roles/product-manager.business-strategy.md +6 -9
  291. package/skills/roles/product-manager.enterprise.md +6 -9
  292. package/skills/roles/product-manager.growth.md +7 -9
  293. package/skills/roles/product-manager.md +7 -9
  294. package/skills/roles/product-manager.platform.md +6 -9
  295. package/skills/roles/product-manager.product.md +6 -9
  296. package/skills/roles/qa.ai-eval.md +8 -9
  297. package/skills/roles/qa.api-contract.md +7 -9
  298. package/skills/roles/qa.data-pipeline.md +7 -9
  299. package/skills/roles/qa.md +7 -9
  300. package/skills/roles/qa.test-automation.md +6 -9
  301. package/skills/roles/qa.web-ui.md +7 -9
  302. package/skills/roles/researcher.explorer.md +6 -9
  303. package/skills/roles/researcher.md +8 -9
  304. package/skills/roles/researcher.ux.md +6 -9
  305. package/skills/roles/reviewer.devil-advocate.md +6 -9
  306. package/skills/roles/reviewer.evaluator.md +6 -9
  307. package/skills/roles/reviewer.md +9 -9
  308. package/skills/roles/reviewer.trace.md +6 -9
  309. package/skills/roles/security.ai.md +7 -9
  310. package/skills/roles/security.appsec.md +6 -9
  311. package/skills/roles/security.cloud.md +6 -9
  312. package/skills/roles/security.legal-compliance.md +6 -9
  313. package/skills/roles/security.md +7 -9
  314. package/skills/roles/security.privacy.md +7 -9
  315. package/skills/roles/security.supply-chain.md +7 -9
  316. package/skills/security/blue-team.md +4 -5
  317. package/skills/security/code-audit.md +4 -5
  318. package/skills/security/pentest.md +4 -5
  319. package/skills/security/red-team.md +4 -5
  320. package/skills/security/threat-intel.md +4 -5
  321. package/skills/security/vuln-research.md +4 -5
  322. package/skills/strategy/competitive-landscape.md +4 -8
  323. package/skills/strategy/market-research-methods.md +4 -8
  324. package/skills/strategy/narrative-arc.md +4 -8
  325. package/skills/strategy/pricing-positioning.md +4 -8
  326. package/skills/utility/clean-code.md +4 -5
  327. package/specialists/policy-inventory.json +14 -0
  328. package/specialists/registry.json +158 -13
  329. package/lib/hooks/env-check.mjs +0 -83
  330. package/lib/hooks/read-tracker.mjs +0 -61
  331. package/lib/policy/unified-gates.mjs +0 -96
  332. package/lib/server/static/assets/index-ab25c707.js +0 -70
  333. package/lib/server/static/assets/index-f0c80a2b.css +0 -1
  334. package/lib/specialist-contracts-enforce.mjs +0 -158
  335. package/rules/common/agents.md +0 -28
  336. package/rules/common/development-workflow.md +0 -32
  337. package/rules/common/performance.md +0 -55
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/docs/research-workflow.md (Research Workflow) Use when: the user asks to research a topic, investigate a question, or gather e
3
-
4
- Use when: the user asks to research a topic, investigate a question, or gather evidence for a decision. ## Steps
5
- -->
1
+ ---
2
+ name: docs-research-workflow
3
+ description: "Use when: the user asks to research a topic, investigate a question, or gather evidence for a decision."
4
+ ---
6
5
  # Research Workflow
7
6
 
8
7
  Use when: the user asks to research a topic, investigate a question, or gather evidence for a decision.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/docs/runbook-workflow.md (Runbook Workflow) Use when: creating operational procedures for services, alerts, or recurring ope
3
-
4
- Use when: creating operational procedures for services, alerts, or recurring operations. ## Steps
5
- -->
1
+ ---
2
+ name: docs-runbook-workflow
3
+ description: "Use when: creating operational procedures for services, alerts, or recurring operations."
4
+ ---
6
5
  # Runbook Workflow
7
6
 
8
7
  Use when: creating operational procedures for services, alerts, or recurring operations.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/docs/strategy-workflow.md: Read, update, and reason about the product strategy.
3
- Canonical store: ~/.cx/strategy.md (user-global) or .cx/strategy.md (project-local, committed).
4
- Template: templates/docs/strategy.md.
5
- -->
1
+ ---
2
+ name: docs-strategy-workflow
3
+ description: "Use when: the user asks about product direction, strategic bets, what to prioritize, whether a signal aligns with strategy, or wants to update the strategy."
4
+ ---
6
5
  # Strategy Workflow
7
6
 
8
7
  Use when: the user asks about product direction, strategic bets, what to prioritize, whether a signal aligns with strategy, or wants to update the strategy.
@@ -1,10 +1,7 @@
1
- <!--
2
- skills/exploration/dependency-graph-reading.md (Dependency Graph Reading)
3
- Use when auditing a project's supply chain risk, evaluating upgrade paths,
4
- or assessing the risk surface of a new codebase. Covers npm/cargo/maven
5
- lockfile interpretation, transitive dependency patterns, and risk signals.
6
- -->
7
-
1
+ ---
2
+ name: exploration-dependency-graph-reading
3
+ description: Use when assessing the risk surface of a project's dependencies, planning upgrades, or evaluating a new codebase's supply chain posture.
4
+ ---
8
5
  # Dependency Graph Reading
9
6
 
10
7
  Use when assessing the risk surface of a project's dependencies, planning upgrades, or evaluating a new codebase's supply chain posture.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/exploration/repo-map.md (Repo Exploration) Codebase Mapping Playbook: Use this skill when entering an unfamiliar codebase, doing deep investigation wo
3
-
4
- Use this skill when entering an unfamiliar codebase, doing deep investigation work, or producing a `.cx/codebase-map.md` artifact for future sessions. Agents: `
5
- -->
1
+ ---
2
+ name: exploration-repo-map
3
+ description: Use this skill when entering an unfamiliar codebase, doing deep investigation work, or producing a `.cx/codebase-map.md` artifact for future sessions.
4
+ ---
6
5
  # Repo Exploration: Codebase Mapping Playbook
7
6
 
8
7
  Use this skill when entering an unfamiliar codebase, doing deep investigation work, or producing a `.cx/codebase-map.md` artifact for future sessions.
@@ -1,10 +1,7 @@
1
- <!--
2
- skills/exploration/tracer-bullet-method.md (Tracer Bullet Method)
3
- Use when starting implementation in an unfamiliar or complex system.
4
- A tracer bullet is a minimal end-to-end path through the system,
5
- real code, real infrastructure, real calls, before any deep work begins.
6
- -->
7
-
1
+ ---
2
+ name: exploration-tracer-bullet-method
3
+ description: Use when beginning implementation in a new system, new integration, or new architectural layer. A tracer bullet is not a prototype; it is the thinnest possible complete path through the real system.
4
+ ---
8
5
  # Tracer Bullet Method
9
6
 
10
7
  Use when beginning implementation in a new system, new integration, or new architectural layer. A tracer bullet is not a prototype; it is the thinnest possible complete path through the real system.
@@ -1,10 +1,7 @@
1
- <!--
2
- skills/exploration/unknown-codebase-onboarding.md (Unknown Codebase Onboarding)
3
- Use when a specialist is operating in a new or unfamiliar codebase and
4
- needs a systematic path from zero context to productive contribution.
5
- Covers first-hour, first-day, and first-week checkpoints.
6
- -->
7
-
1
+ ---
2
+ name: exploration-unknown-codebase-onboarding
3
+ description: Use when entering an unfamiliar codebase for the first time, or when the task requires understanding a system you haven't touched before.
4
+ ---
8
5
  # Unknown Codebase Onboarding
9
6
 
10
7
  Use when entering an unfamiliar codebase for the first time, or when the task requires understanding a system you haven't touched before.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/frameworks/django.md (Django) ```
3
-
4
- ## Project Structure ```
5
- -->
1
+ ---
2
+ name: frameworks-django
3
+ description: Patterns, anti-patterns, and reference guidance for Django. Use when the task involves django.
4
+ ---
6
5
  # Django
7
6
 
8
7
  ## Project Structure
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/frameworks/nextjs.md (Next.js (App Router)) ```
3
-
4
- ## App Router Mental Model ```
5
- -->
1
+ ---
2
+ name: frameworks-nextjs
3
+ description: Patterns, anti-patterns, and reference guidance for Next.js (App Router). Use when the task involves next.js (app router).
4
+ ---
6
5
  # Next.js (App Router)
7
6
 
8
7
  ## App Router Mental Model
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/frameworks/react.md (React) By default, components are **Server Components**: they run on the server, have
3
-
4
- ## Component Design ### Server vs Client Components (React 19 / Next.js App Router)
5
- -->
1
+ ---
2
+ name: frameworks-react
3
+ description: "By default, components are **Server Components**: they run on the server, have no state, and can fetch data directly. Add `'use client'` only when you need interactivity, browser APIs, or hooks. Use when the task matches the trigger conditions described in the body."
4
+ ---
6
5
  # React
7
6
 
8
7
  ## Component Design
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/frameworks/spring-boot.md (Spring Boot) ```
3
-
4
- ## Project Structure ```
5
- -->
1
+ ---
2
+ name: frameworks-spring-boot
3
+ description: Patterns, anti-patterns, and reference guidance for Spring Boot. Use when the task involves spring boot.
4
+ ---
6
5
  # Spring Boot
7
6
 
8
7
  ## Project Structure
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/frontend-design/accessibility.md (Accessibility (WCAG 2.2 / Inclusive Design)) Target **WCAG 2.1 AA** as the minimum for any public-facing product. WCAG 2.2 AA
3
-
4
- ## Compliance Baseline Target **WCAG 2.1 AA** as the minimum for any public-facing product. WCAG 2.2 AA is the current standard (published October 2023) and req
5
- -->
1
+ ---
2
+ name: frontend-design-accessibility
3
+ description: Target **WCAG 2.1 AA** as the minimum for any public-facing product. WCAG 2.2 AA is the current standard (published October 2023) and required by many regulatory frameworks (EU Web Accessibility Directive, ADA, Section 508). Use when the task matches the trigger conditions described in the body.
4
+ ---
6
5
  # Accessibility (WCAG 2.2 / Inclusive Design)
7
6
 
8
7
  ## Compliance Baseline
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/frontend-design/component-patterns.md (Component Patterns) Use this skill when designing component architecture, building design systems, o
3
-
4
- Use this skill when designing component architecture, building design systems, or structuring reusable UI. ## Component Hierarchy
5
- -->
1
+ ---
2
+ name: frontend-design-component-patterns
3
+ description: Use this skill when designing component architecture, building design systems, or structuring reusable UI.
4
+ ---
6
5
  # Component Patterns
7
6
 
8
7
  Use this skill when designing component architecture, building design systems, or structuring reusable UI.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/frontend-design/engineering.md (Frontend Engineering) Use this skill when working on build tooling, bundling, rendering strategies, or
3
-
4
- Use this skill when working on build tooling, bundling, rendering strategies, or frontend infrastructure. ## Build Tools
5
- -->
1
+ ---
2
+ name: frontend-design-engineering
3
+ description: Use this skill when working on build tooling, bundling, rendering strategies, or frontend infrastructure.
4
+ ---
6
5
  # Frontend Engineering
7
6
 
8
7
  Use this skill when working on build tooling, bundling, rendering strategies, or frontend infrastructure.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/frontend-design/state-management.md (Frontend State Management) Use this skill when choosing state management tools, structuring application sta
3
-
4
- Use this skill when choosing state management tools, structuring application state, or debugging state issues. ## State Categories
5
- -->
1
+ ---
2
+ name: frontend-design-state-management
3
+ description: Use this skill when choosing state management tools, structuring application state, or debugging state issues.
4
+ ---
6
5
  # Frontend State Management
7
6
 
8
7
  Use this skill when choosing state management tools, structuring application state, or debugging state issues.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/frontend-design/ui-aesthetics.md (UI Aesthetics) Use this skill when making visual design decisions: color, typography, layout, s
3
-
4
- Use this skill when making visual design decisions: color, typography, layout, spacing, and visual hierarchy. ## Color
5
- -->
1
+ ---
2
+ name: frontend-design-ui-aesthetics
3
+ description: "Use this skill when making visual design decisions: color, typography, layout, spacing, and visual hierarchy."
4
+ ---
6
5
  # UI Aesthetics
7
6
 
8
7
  Use this skill when making visual design decisions: color, typography, layout, spacing, and visual hierarchy.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/frontend-design/ux-principles.md (UX Principles) Use this skill when designing user flows, evaluating usability, or planning info
3
-
4
- Use this skill when designing user flows, evaluating usability, or planning information architecture. ## Core Heuristics
5
- -->
1
+ ---
2
+ name: frontend-design-ux-principles
3
+ description: Use this skill when designing user flows, evaluating usability, or planning information architecture.
4
+ ---
6
5
  # UX Principles
7
6
 
8
7
  Use this skill when designing user flows, evaluating usability, or planning information architecture.
@@ -1,11 +1,7 @@
1
- <!--
2
- skills/operating/change-management.md (Change Management)
3
- Use when categorizing a technical or organizational change, designing
4
- a rollout plan, or determining what approval gates are appropriate.
5
- Covers the Type 1 / Type 2 door framework, irreversibility analysis,
6
- and rollback planning.
7
- -->
8
-
1
+ ---
2
+ name: operating-change-management
3
+ description: Use when a change needs to be categorized by reversibility, when designing rollout gates, or when the team is uncertain how much approval process a change warrants.
4
+ ---
9
5
  # Change Management
10
6
 
11
7
  Use when a change needs to be categorized by reversibility, when designing rollout gates, or when the team is uncertain how much approval process a change warrants.
@@ -1,11 +1,7 @@
1
- <!--
2
- skills/operating/incident-response.md (Incident Response)
3
- Use when a production issue is active, when drafting incident process,
4
- or when running a postmortem. Covers severity tiers, war-room roles,
5
- communication cadence, blameless postmortem structure, and MTTR
6
- discipline.
7
- -->
8
-
1
+ ---
2
+ name: operating-incident-response
3
+ description: Use when an issue is active in production, when building incident process from scratch, or when reviewing postmortems for quality.
4
+ ---
9
5
  # Incident Response
10
6
 
11
7
  Use when an issue is active in production, when building incident process from scratch, or when reviewing postmortems for quality.
@@ -1,10 +1,7 @@
1
- <!--
2
- skills/operating/oncall-rotation.md (On-Call Rotation)
3
- Use when designing an on-call schedule, reviewing runbook quality, or
4
- handling escalation protocols. Covers handoff structure, runbook quality
5
- bar, escalation chains, and on-call health indicators.
6
- -->
7
-
1
+ ---
2
+ name: operating-oncall-rotation
3
+ description: Use when setting up on-call, reviewing its health, or handling an escalation during a rotation.
4
+ ---
8
5
  # On-Call Rotation
9
6
 
10
7
  Use when setting up on-call, reviewing its health, or handling an escalation during a rotation.
@@ -1,13 +1,7 @@
1
- <!--
2
- skills/operating/orchestration-reference.md: detailed orchestration reference loaded on demand.
3
-
4
- Holds the execution contract, handoff template, intent and work-category
5
- classification, parallel dispatch, horizontal routing, and efficiency
6
- discipline. Called via get_skill("operating/orchestration-reference") by
7
- specialists and personas when they need the full context; short essentials
8
- stay in sharedGuidance so they load every turn.
9
- -->
10
-
1
+ ---
2
+ name: operating-orchestration-reference
3
+ description: detailed orchestration reference loaded on demand. Use when the task matches the trigger conditions described in the body.
4
+ ---
11
5
  # Orchestration Reference
12
6
 
13
7
  Loaded on demand via `get_skill("operating/orchestration-reference")`.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/quality-gates/review-work.md (Parallel Adversarial Review) Use this methodology when a change needs rigorous pre-merge validation. Five ind
3
-
4
- Use this methodology when a change needs rigorous pre-merge validation. Five independent review roles run concurrently. All must pass. ## When to use
5
- -->
1
+ ---
2
+ name: quality-gates-review-work
3
+ description: Use this methodology when a change needs rigorous pre-merge validation. Five independent review roles run concurrently. All must pass.
4
+ ---
6
5
  # Parallel Adversarial Review
7
6
 
8
7
  Use this methodology when a change needs rigorous pre-merge validation. Five independent review roles run concurrently. All must pass.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/quality-gates/verify-change.md (Verify Change) Use this skill to analyze the impact of code changes and verify documentation an
3
-
4
- Use this skill to analyze the impact of code changes and verify documentation and tests are in sync. ## Change Inventory
5
- -->
1
+ ---
2
+ name: quality-gates-verify-change
3
+ description: Use this skill to analyze the impact of code changes and verify documentation and tests are in sync.
4
+ ---
6
5
  # Verify Change
7
6
 
8
7
  Use this skill to analyze the impact of code changes and verify documentation and tests are in sync.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/quality-gates/verify-module.md (Verify Module) Use this skill to check that a module or package is structurally complete and re
3
-
4
- Use this skill to check that a module or package is structurally complete and ready for use. ## Exports
5
- -->
1
+ ---
2
+ name: quality-gates-verify-module
3
+ description: Use this skill to check that a module or package is structurally complete and ready for use.
4
+ ---
6
5
  # Verify Module
7
6
 
8
7
  Use this skill to check that a module or package is structurally complete and ready for use.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/quality-gates/verify-quality.md (Verify Quality) Use this skill to check code quality, complexity, and maintainability after chan
3
-
4
- Use this skill to check code quality, complexity, and maintainability after changes. ## Complexity
5
- -->
1
+ ---
2
+ name: quality-gates-verify-quality
3
+ description: Use this skill to check code quality, complexity, and maintainability after changes.
4
+ ---
6
5
  # Verify Quality
7
6
 
8
7
  Use this skill to check code quality, complexity, and maintainability after changes.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/quality-gates/verify-security.md (Verify Security) Use this skill to scan code for security vulnerabilities before commits or relea
3
-
4
- Use this skill to scan code for security vulnerabilities before commits or releases. ## Scan Scope
5
- -->
1
+ ---
2
+ name: quality-gates-verify-security
3
+ description: Use this skill to scan code for security vulnerabilities before commits or releases.
4
+ ---
6
5
  # Verify Security
7
6
 
8
7
  Use this skill to scan code for security vulnerabilities before commits or releases.
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/architect.ai-systems.md. Anti-pattern guidance for the Architect.ai-systems (ai systems) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the architect.ai-systems (ai systems) domain and counter-moves to avoid them.
6
- Applies to: cx-architect.
7
- -->
8
1
  ---
2
+ name: roles-architect-ai-systems
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Architect — AI Systems role. Use when reviewing or generating work by cx-architect, or when an agent is acting in the Architect — AI Systems role.
9
4
  role: architect.ai-systems
10
- applies_to: [cx-architect]
5
+ applies_to:
6
+ - cx-architect
11
7
  inherits: architect
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # AI Systems Architect Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/architect.data.md. Anti-pattern guidance for the Architect.data (data) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the architect.data (data) domain and counter-moves to avoid them.
6
- Applies to: cx-architect.
7
- -->
8
1
  ---
2
+ name: roles-architect-data
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Architect — Data role. Use when reviewing or generating work by cx-architect, or when an agent is acting in the Architect — Data role.
9
4
  role: architect.data
10
- applies_to: [cx-architect]
5
+ applies_to:
6
+ - cx-architect
11
7
  inherits: architect
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Data Architect Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/architect.enterprise.md. Anti-pattern guidance for the Architect.enterprise (enterprise) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the architect.enterprise (enterprise) domain and counter-moves to avoid them.
6
- Applies to: cx-architect.
7
- -->
8
1
  ---
2
+ name: roles-architect-enterprise
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Architect — Enterprise role. Use when reviewing or generating work by cx-architect, or when an agent is acting in the Architect — Enterprise role.
9
4
  role: architect.enterprise
10
- applies_to: [cx-architect]
5
+ applies_to:
6
+ - cx-architect
11
7
  inherits: architect
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Enterprise Architect Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/architect.integration.md. Anti-pattern guidance for the Architect.integration (integration) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the architect.integration (integration) domain and counter-moves to avoid them.
6
- Applies to: cx-architect.
7
- -->
8
1
  ---
2
+ name: roles-architect-integration
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Architect — Integration role. Use when reviewing or generating work by cx-architect, or when an agent is acting in the Architect — Integration role.
9
4
  role: architect.integration
10
- applies_to: [cx-architect]
5
+ applies_to:
6
+ - cx-architect
11
7
  inherits: architect
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Integration Architect Overlay
@@ -1,21 +1,14 @@
1
- <!--
2
- skills/roles/architect.md. Anti-pattern guidance for the Architect role.
3
-
4
- ## Improvement Note (auto-generated 2026-04-29)
5
- - Improve specificity in technical guidance; provide detailed steps or code snippets rather than vague suggestions.
6
- - Ensure that responses directly address the user's request; avoid unrelated topics or general advice that doesn't pertain to the task.
7
- - Incorporate thorough explanations for any proposed solutions or changes to clarify their importance and methodology.
8
-
9
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
10
- Covers common failure modes for the architect domain and counter-moves to avoid them.
11
- Applies to: cx-architect, cx-rd-lead.
12
- -->
13
1
  ---
2
+ name: roles-architect
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Architect role. Use when reviewing or generating work by cx-architect, cx-rd-lead, or when an agent is acting in the Architect role.
14
4
  role: architect
15
- applies_to: [cx-architect, cx-rd-lead]
5
+ applies_to:
6
+ - cx-architect
7
+ - cx-rd-lead
16
8
  inherits: null
17
9
  version: 2
18
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
19
12
  cap: 1
20
13
  ---
21
14
  # Architect. Role guidance
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/architect.platform.md. Anti-pattern guidance for the Architect.platform (platform) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the architect.platform (platform) domain and counter-moves to avoid them.
6
- Applies to: cx-architect.
7
- -->
8
1
  ---
2
+ name: roles-architect-platform
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Architect — Platform role. Use when reviewing or generating work by cx-architect, or when an agent is acting in the Architect — Platform role.
9
4
  role: architect.platform
10
- applies_to: [cx-architect]
5
+ applies_to:
6
+ - cx-architect
11
7
  inherits: architect
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Platform Architect Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/data-analyst.experiment.md. Anti-pattern guidance for the Data-analyst.experiment (experiment) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the data-analyst.experiment (experiment) domain and counter-moves to avoid them.
6
- Applies to: cx-data-analyst.
7
- -->
8
1
  ---
2
+ name: roles-data-analyst-experiment
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Data Analyst — Experiment role. Use when reviewing or generating work by cx-data-analyst, or when an agent is acting in the Data Analyst — Experiment role.
9
4
  role: data-analyst.experiment
10
- applies_to: [cx-data-analyst]
5
+ applies_to:
6
+ - cx-data-analyst
11
7
  inherits: data-analyst
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Experiment Analyst Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/data-analyst.md. Anti-pattern guidance for the Data-analyst role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the data-analyst domain and counter-moves to avoid them.
6
- Applies to: cx-data-analyst.
7
- -->
8
1
  ---
2
+ name: roles-data-analyst
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Data Analyst role. Use when reviewing or generating work by cx-data-analyst, or when an agent is acting in the Data Analyst role.
9
4
  role: data-analyst
10
- applies_to: [cx-data-analyst]
5
+ applies_to:
6
+ - cx-data-analyst
11
7
  inherits: null
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Data Analyst. Role guidance
@@ -1,16 +1,14 @@
1
- <!--
2
- skills/roles/data-analyst.product-intelligence.md. Anti-pattern guidance for the Data-analyst.product-intelligence (product intelligence) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the data-analyst.product-intelligence (product intelligence) domain and counter-moves to avoid them.
6
- Applies to: cx-data-analyst, cx-product-manager.
7
- -->
8
1
  ---
2
+ name: roles-data-analyst-product-intelligence
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Data Analyst — Product Intelligence role. Use when reviewing or generating work by cx-data-analyst, cx-product-manager, or when an agent is acting in the Data Analyst — Product Intelligence role.
9
4
  role: data-analyst.product-intelligence
10
- applies_to: [cx-data-analyst, cx-product-manager]
5
+ applies_to:
6
+ - cx-data-analyst
7
+ - cx-product-manager
11
8
  inherits: data-analyst
12
9
  version: 2
13
- profiles: [rnd]
10
+ profiles:
11
+ - rnd
14
12
  cap: 1
15
13
  ---
16
14
  # Product Intelligence Analyst Overlay
@@ -1,16 +1,13 @@
1
- <!--
2
- skills/roles/data-analyst.product.md. Anti-pattern guidance for the Data-analyst.product (product) role.
3
-
4
- Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
- Covers common failure modes for the data-analyst.product (product) domain and counter-moves to avoid them.
6
- Applies to: cx-data-analyst.
7
- -->
8
1
  ---
2
+ name: roles-data-analyst-product
3
+ description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Data Analyst — Product role. Use when reviewing or generating work by cx-data-analyst, or when an agent is acting in the Data Analyst — Product role.
9
4
  role: data-analyst.product
10
- applies_to: [cx-data-analyst]
5
+ applies_to:
6
+ - cx-data-analyst
11
7
  inherits: data-analyst
12
8
  version: 2
13
- profiles: [rnd]
9
+ profiles:
10
+ - rnd
14
11
  cap: 1
15
12
  ---
16
13
  # Product Analytics Overlay