@geraldmaron/construct 1.0.14 → 1.0.16

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 (275) hide show
  1. package/README.md +21 -2
  2. package/bin/construct +146 -83
  3. package/commands/build/feature.md +0 -6
  4. package/commands/build/fix.md +0 -6
  5. package/commands/design/access.md +0 -6
  6. package/commands/design/flow.md +0 -6
  7. package/commands/design/ui.md +0 -6
  8. package/commands/measure/experiment.md +0 -6
  9. package/commands/measure/metrics.md +0 -6
  10. package/commands/measure/results.md +0 -6
  11. package/commands/plan/api.md +0 -6
  12. package/commands/plan/challenge.md +0 -6
  13. package/commands/plan/decide.md +0 -6
  14. package/commands/plan/feature.md +0 -7
  15. package/commands/plan/requirements.md +0 -6
  16. package/commands/remember/context.md +0 -6
  17. package/commands/remember/handoff.md +0 -6
  18. package/commands/remember/runbook.md +0 -6
  19. package/commands/review/code.md +0 -6
  20. package/commands/review/quality.md +0 -6
  21. package/commands/review/security.md +0 -6
  22. package/commands/ship/ready.md +0 -6
  23. package/commands/ship/release.md +0 -6
  24. package/commands/ship/status.md +0 -6
  25. package/commands/understand/docs.md +0 -6
  26. package/commands/understand/research.md +0 -6
  27. package/commands/understand/this.md +0 -6
  28. package/commands/understand/why.md +0 -6
  29. package/commands/work/clean.md +0 -6
  30. package/commands/work/drive.md +0 -6
  31. package/commands/work/optimize-prompts.md +0 -6
  32. package/commands/work/parallel-review.md +0 -6
  33. package/db/schema/010_cx_scores.sql +51 -0
  34. package/lib/beads-client.mjs +19 -1
  35. package/lib/cli-commands.mjs +280 -146
  36. package/lib/comment-lint.mjs +5 -1
  37. package/lib/context-state.mjs +15 -3
  38. package/lib/contracts/validate.mjs +72 -18
  39. package/lib/contracts/violation-log.mjs +169 -0
  40. package/lib/document-extract/docling-client.mjs +114 -0
  41. package/lib/document-extract/docling-sidecar.py +122 -0
  42. package/lib/document-extract/whisper-client.mjs +79 -0
  43. package/lib/document-extract.mjs +73 -8
  44. package/lib/document-ingest.mjs +26 -4
  45. package/lib/embed/daemon.mjs +6 -1
  46. package/lib/flavors/loader.mjs +1 -1
  47. package/lib/handoffs/contract.mjs +2 -2
  48. package/lib/hooks/session-start.mjs +1 -1
  49. package/lib/hooks/stop-notify.mjs +7 -0
  50. package/lib/ingest/chunker.mjs +94 -0
  51. package/lib/ingest/pipeline.mjs +53 -0
  52. package/lib/ingest/store.mjs +82 -0
  53. package/lib/install/first-invocation.mjs +5 -1
  54. package/lib/intake/prepare.mjs +22 -4
  55. package/lib/integrations/intake-integrations.mjs +28 -2
  56. package/lib/knowledge/search.mjs +12 -0
  57. package/lib/mcp/server.mjs +142 -1
  58. package/lib/mcp/tools/skills.mjs +6 -3
  59. package/lib/mcp/tools/telemetry.mjs +30 -0
  60. package/lib/mcp/tools/workflow.mjs +6 -2
  61. package/lib/observation-store.mjs +14 -5
  62. package/lib/ollama-manager.mjs +32 -28
  63. package/lib/orchestration-policy.mjs +15 -0
  64. package/lib/prompt-composer.js +11 -1
  65. package/lib/roles/gateway.mjs +30 -1
  66. package/lib/runtime/uv-bootstrap.mjs +129 -0
  67. package/lib/runtime/whisper-bootstrap.mjs +102 -0
  68. package/lib/scheduler/index.mjs +24 -4
  69. package/lib/server/index.mjs +22 -1
  70. package/lib/server/insights.mjs +12 -0
  71. package/lib/server/static/index.html +1 -1
  72. package/lib/setup.mjs +54 -9
  73. package/lib/specialists/postconditions.mjs +1 -1
  74. package/lib/sync/skill-frontmatter.mjs +113 -21
  75. package/lib/tracking-surfaces.mjs +2 -0
  76. package/lib/update.mjs +31 -3
  77. package/lib/upgrade.mjs +31 -4
  78. package/lib/validators/skills.mjs +86 -54
  79. package/package.json +5 -5
  80. package/personas/construct.md +6 -7
  81. package/platforms/claude/CLAUDE.md +43 -15
  82. package/platforms/claude/settings.template.json +1 -1
  83. package/rules/common/beads-hygiene.md +3 -9
  84. package/rules/common/code-review.md +3 -6
  85. package/rules/common/coding-style.md +3 -6
  86. package/rules/common/comments.md +3 -7
  87. package/rules/common/commit-approval.md +3 -6
  88. package/rules/common/cx-agent-routing.md +3 -7
  89. package/rules/common/cx-skill-routing.md +3 -3
  90. package/rules/common/doc-ownership.md +3 -8
  91. package/rules/common/efficiency.md +3 -8
  92. package/rules/common/framing.md +3 -8
  93. package/rules/common/git-workflow.md +3 -5
  94. package/rules/common/no-fabrication.md +4 -12
  95. package/rules/common/patterns.md +3 -5
  96. package/rules/common/release-gates.md +3 -8
  97. package/rules/common/research.md +3 -8
  98. package/rules/common/review-before-change.md +3 -9
  99. package/rules/common/security.md +3 -6
  100. package/rules/common/skill-composition.md +3 -7
  101. package/rules/common/testing.md +3 -6
  102. package/rules/golang/coding-style.md +1 -5
  103. package/rules/golang/hooks.md +1 -5
  104. package/rules/golang/patterns.md +1 -5
  105. package/rules/golang/security.md +1 -5
  106. package/rules/golang/testing.md +1 -5
  107. package/rules/python/coding-style.md +1 -5
  108. package/rules/python/hooks.md +1 -5
  109. package/rules/python/patterns.md +1 -5
  110. package/rules/python/security.md +1 -5
  111. package/rules/python/testing.md +1 -5
  112. package/rules/swift/coding-style.md +1 -5
  113. package/rules/swift/hooks.md +1 -5
  114. package/rules/swift/patterns.md +1 -5
  115. package/rules/swift/security.md +1 -5
  116. package/rules/swift/testing.md +1 -5
  117. package/rules/typescript/coding-style.md +1 -5
  118. package/rules/typescript/hooks.md +1 -5
  119. package/rules/typescript/patterns.md +1 -5
  120. package/rules/typescript/security.md +1 -5
  121. package/rules/typescript/testing.md +1 -5
  122. package/rules/web/coding-style.md +3 -5
  123. package/rules/web/design-quality.md +3 -5
  124. package/rules/web/hooks.md +3 -5
  125. package/rules/web/patterns.md +3 -5
  126. package/rules/web/performance.md +3 -5
  127. package/rules/web/security.md +3 -5
  128. package/rules/web/testing.md +3 -5
  129. package/scripts/sync-specialists.mjs +20 -2
  130. package/skills/ai/agent-dev.md +4 -5
  131. package/skills/ai/llm-security.md +4 -5
  132. package/skills/ai/ml-ops.md +4 -5
  133. package/skills/ai/orchestration-workflow.md +4 -5
  134. package/skills/ai/prompt-and-eval.md +4 -5
  135. package/skills/ai/prompt-optimizer.md +4 -6
  136. package/skills/ai/rag-system.md +4 -5
  137. package/skills/architecture/api-design.md +4 -5
  138. package/skills/architecture/caching.md +4 -5
  139. package/skills/architecture/cloud-native.md +4 -5
  140. package/skills/architecture/message-queue.md +4 -5
  141. package/skills/architecture/security-arch.md +4 -5
  142. package/skills/compliance/ai-disclosure.md +4 -5
  143. package/skills/compliance/data-privacy.md +4 -5
  144. package/skills/compliance/license-audit.md +4 -5
  145. package/skills/compliance/regulatory-review.md +4 -5
  146. package/skills/development/cpp.md +4 -5
  147. package/skills/development/go.md +4 -5
  148. package/skills/development/java.md +4 -5
  149. package/skills/development/kotlin.md +4 -5
  150. package/skills/development/mobile-crossplatform.md +4 -5
  151. package/skills/development/python.md +4 -5
  152. package/skills/development/rust.md +4 -5
  153. package/skills/development/shell.md +4 -5
  154. package/skills/development/swift.md +4 -5
  155. package/skills/development/typescript.md +4 -5
  156. package/skills/devops/ci-cd.md +4 -5
  157. package/skills/devops/containerization.md +4 -5
  158. package/skills/devops/cost-optimization.md +4 -5
  159. package/skills/devops/data-engineering.md +4 -5
  160. package/skills/devops/database.md +4 -5
  161. package/skills/devops/dependency-management.md +4 -5
  162. package/skills/devops/devsecops.md +4 -5
  163. package/skills/devops/git-workflow.md +4 -5
  164. package/skills/devops/incident-response.md +4 -5
  165. package/skills/devops/monorepo.md +4 -5
  166. package/skills/devops/observability.md +4 -5
  167. package/skills/devops/performance.md +4 -5
  168. package/skills/devops/testing.md +4 -5
  169. package/skills/docs/adr-workflow.md +4 -7
  170. package/skills/docs/backlog-proposal-workflow.md +4 -3
  171. package/skills/docs/customer-profile-workflow.md +4 -3
  172. package/skills/docs/document-ingest-workflow.md +4 -3
  173. package/skills/docs/evidence-ingest-workflow.md +4 -3
  174. package/skills/docs/init-docs.md +4 -5
  175. package/skills/docs/init-project.md +4 -5
  176. package/skills/docs/prd-workflow.md +4 -7
  177. package/skills/docs/prfaq-workflow.md +4 -3
  178. package/skills/docs/product-intelligence-review.md +4 -3
  179. package/skills/docs/product-intelligence-workflow.md +4 -6
  180. package/skills/docs/product-signal-workflow.md +4 -5
  181. package/skills/docs/research-workflow.md +4 -5
  182. package/skills/docs/runbook-workflow.md +4 -5
  183. package/skills/docs/strategy-workflow.md +4 -5
  184. package/skills/exploration/dependency-graph-reading.md +4 -7
  185. package/skills/exploration/repo-map.md +4 -5
  186. package/skills/exploration/tracer-bullet-method.md +4 -7
  187. package/skills/exploration/unknown-codebase-onboarding.md +4 -7
  188. package/skills/frameworks/django.md +4 -5
  189. package/skills/frameworks/nextjs.md +4 -5
  190. package/skills/frameworks/react.md +4 -5
  191. package/skills/frameworks/spring-boot.md +4 -5
  192. package/skills/frontend-design/accessibility.md +4 -5
  193. package/skills/frontend-design/component-patterns.md +4 -5
  194. package/skills/frontend-design/engineering.md +4 -5
  195. package/skills/frontend-design/state-management.md +4 -5
  196. package/skills/frontend-design/ui-aesthetics.md +4 -5
  197. package/skills/frontend-design/ux-principles.md +4 -5
  198. package/skills/operating/change-management.md +4 -8
  199. package/skills/operating/incident-response.md +4 -8
  200. package/skills/operating/oncall-rotation.md +4 -7
  201. package/skills/operating/orchestration-reference.md +4 -10
  202. package/skills/quality-gates/review-work.md +4 -5
  203. package/skills/quality-gates/verify-change.md +4 -5
  204. package/skills/quality-gates/verify-module.md +4 -5
  205. package/skills/quality-gates/verify-quality.md +4 -5
  206. package/skills/quality-gates/verify-security.md +4 -5
  207. package/skills/roles/architect.ai-systems.md +6 -9
  208. package/skills/roles/architect.data.md +6 -9
  209. package/skills/roles/architect.enterprise.md +6 -9
  210. package/skills/roles/architect.integration.md +6 -9
  211. package/skills/roles/architect.md +7 -14
  212. package/skills/roles/architect.platform.md +6 -9
  213. package/skills/roles/data-analyst.experiment.md +6 -9
  214. package/skills/roles/data-analyst.md +6 -9
  215. package/skills/roles/data-analyst.product-intelligence.md +7 -9
  216. package/skills/roles/data-analyst.product.md +6 -9
  217. package/skills/roles/data-analyst.telemetry.md +7 -9
  218. package/skills/roles/data-engineer.pipeline.md +6 -9
  219. package/skills/roles/data-engineer.vector-retrieval.md +7 -9
  220. package/skills/roles/data-engineer.warehouse.md +6 -9
  221. package/skills/roles/debugger.md +6 -9
  222. package/skills/roles/designer.accessibility.md +6 -9
  223. package/skills/roles/designer.md +7 -9
  224. package/skills/roles/engineer.ai.md +6 -9
  225. package/skills/roles/engineer.data.md +6 -9
  226. package/skills/roles/engineer.md +9 -9
  227. package/skills/roles/engineer.platform.md +6 -9
  228. package/skills/roles/operator.docs.md +6 -9
  229. package/skills/roles/operator.md +9 -9
  230. package/skills/roles/operator.release.md +6 -9
  231. package/skills/roles/operator.sre.md +6 -9
  232. package/skills/roles/orchestrator.md +6 -9
  233. package/skills/roles/product-manager.ai-product.md +6 -9
  234. package/skills/roles/product-manager.business-strategy.md +6 -9
  235. package/skills/roles/product-manager.enterprise.md +6 -9
  236. package/skills/roles/product-manager.growth.md +7 -9
  237. package/skills/roles/product-manager.md +7 -9
  238. package/skills/roles/product-manager.platform.md +6 -9
  239. package/skills/roles/product-manager.product.md +6 -9
  240. package/skills/roles/qa.ai-eval.md +8 -9
  241. package/skills/roles/qa.api-contract.md +7 -9
  242. package/skills/roles/qa.data-pipeline.md +7 -9
  243. package/skills/roles/qa.md +7 -9
  244. package/skills/roles/qa.test-automation.md +6 -9
  245. package/skills/roles/qa.web-ui.md +7 -9
  246. package/skills/roles/researcher.explorer.md +6 -9
  247. package/skills/roles/researcher.md +8 -9
  248. package/skills/roles/researcher.ux.md +6 -9
  249. package/skills/roles/reviewer.devil-advocate.md +6 -9
  250. package/skills/roles/reviewer.evaluator.md +6 -9
  251. package/skills/roles/reviewer.md +9 -9
  252. package/skills/roles/reviewer.trace.md +6 -9
  253. package/skills/roles/security.ai.md +7 -9
  254. package/skills/roles/security.appsec.md +6 -9
  255. package/skills/roles/security.cloud.md +6 -9
  256. package/skills/roles/security.legal-compliance.md +6 -9
  257. package/skills/roles/security.md +7 -9
  258. package/skills/roles/security.privacy.md +7 -9
  259. package/skills/roles/security.supply-chain.md +7 -9
  260. package/skills/security/blue-team.md +4 -5
  261. package/skills/security/code-audit.md +4 -5
  262. package/skills/security/pentest.md +4 -5
  263. package/skills/security/red-team.md +4 -5
  264. package/skills/security/threat-intel.md +4 -5
  265. package/skills/security/vuln-research.md +4 -5
  266. package/skills/strategy/competitive-landscape.md +4 -8
  267. package/skills/strategy/market-research-methods.md +4 -8
  268. package/skills/strategy/narrative-arc.md +4 -8
  269. package/skills/strategy/pricing-positioning.md +4 -8
  270. package/skills/utility/clean-code.md +4 -5
  271. package/specialists/policy-inventory.json +14 -0
  272. package/lib/specialist-contracts-enforce.mjs +0 -172
  273. package/rules/common/agents.md +0 -28
  274. package/rules/common/development-workflow.md +0 -32
  275. package/rules/common/performance.md +0 -55
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/devops/observability.md (Observability) Use this skill when designing logging, tracing, metrics, or alerting systems.
3
-
4
- Use this skill when designing logging, tracing, metrics, or alerting systems. ## Three Pillars
5
- -->
1
+ ---
2
+ name: devops-observability
3
+ description: Use this skill when designing logging, tracing, metrics, or alerting systems.
4
+ ---
6
5
  # Observability
7
6
 
8
7
  Use this skill when designing logging, tracing, metrics, or alerting systems.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/devops/performance.md (Performance Engineering) Use this skill when profiling, load testing, or optimizing application and infra
3
-
4
- Use this skill when profiling, load testing, or optimizing application and infrastructure performance. ## Performance Targets
5
- -->
1
+ ---
2
+ name: devops-performance
3
+ description: Use this skill when profiling, load testing, or optimizing application and infrastructure performance.
4
+ ---
6
5
  # Performance Engineering
7
6
 
8
7
  Use this skill when profiling, load testing, or optimizing application and infrastructure performance.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/devops/testing.md (Testing Strategy) Use this skill when planning test coverage, selecting test types, or establishin
3
-
4
- Use this skill when planning test coverage, selecting test types, or establishing testing practices. ## Test Pyramid
5
- -->
1
+ ---
2
+ name: devops-testing
3
+ description: Use this skill when planning test coverage, selecting test types, or establishing testing practices.
4
+ ---
6
5
  # Testing Strategy
7
6
 
8
7
  Use this skill when planning test coverage, selecting test types, or establishing testing practices.
@@ -1,10 +1,7 @@
1
- <!--
2
- skills/docs/adr-workflow.md: Workflow for recording an architectural decision as an ADR.
3
-
4
- Triggered when cx-architect finalizes a design or a technology choice is made. Writes a
5
- full ADR to docs/adr/ using the shipped template (user-overridable via .cx/templates/docs/adr.md)
6
- and a shorter entry to .cx/decisions/ for session context.
7
- -->
1
+ ---
2
+ name: docs-adr-workflow
3
+ description: "Use when: an architectural decision is made that affects the system structure, data model, API contracts, or technology choices."
4
+ ---
8
5
  # ADR Workflow
9
6
 
10
7
  Use when: an architectural decision is made that affects the system structure, data model, API contracts, or technology choices.
@@ -1,6 +1,7 @@
1
- <!--
2
- skills/docs/backlog-proposal-workflow.md: Approval-gated issue tracker proposals.
3
- -->
1
+ ---
2
+ name: docs-backlog-proposal-workflow
3
+ description: "Use when: product evidence should create or update Jira, Linear, GitHub Issues, or another tracker."
4
+ ---
4
5
  # Backlog Proposal Workflow
5
6
 
6
7
  Use when: product evidence should create or update Jira, Linear, GitHub Issues, or another tracker.
@@ -1,6 +1,7 @@
1
- <!--
2
- skills/docs/customer-profile-workflow.md: Maintain durable customer/account memory for Product Intelligence.
3
- -->
1
+ ---
2
+ name: docs-customer-profile-workflow
3
+ description: "Use when: customer evidence should update durable product memory."
4
+ ---
4
5
  # Customer Profile Workflow
5
6
 
6
7
  Use when: customer evidence should update durable product memory.
@@ -1,6 +1,7 @@
1
- <!--
2
- skills/docs/document-ingest-workflow.md: Convert source documents into retrieval-ready markdown artifacts.
3
- -->
1
+ ---
2
+ name: docs-document-ingest-workflow
3
+ description: "Use when: the user points at a PDF, Word doc, spreadsheet, slide deck, export, or mixed document folder and wants a markdown version that Construct can search efficiently later."
4
+ ---
4
5
  # Document Ingest Workflow
5
6
 
6
7
  Use when: the user points at a PDF, Word doc, spreadsheet, slide deck, export, or mixed document folder and wants a markdown version that Construct can search efficiently later.
@@ -1,6 +1,7 @@
1
- <!--
2
- skills/docs/evidence-ingest-workflow.md: Normalize raw product evidence into Construct knowledge artifacts.
3
- -->
1
+ ---
2
+ name: docs-evidence-ingest-workflow
3
+ description: "Use when: the user pastes customer notes, Slack threads, support tickets, sales notes, research snippets, RFCs, analytics summaries, or competitor signals."
4
+ ---
4
5
  # Evidence Ingest Workflow
5
6
 
6
7
  Use when: the user pastes customer notes, Slack threads, support tickets, sales notes, research snippets, RFCs, analytics summaries, or competitor signals.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/docs/init-docs.md (Skill: init-docs) Initialize Project Documentation Structure: `init docs`, `create docs structure`, `set up documentation`, `docs scaffold`, `documentation init`
3
-
4
- ## Trigger keywords `init docs`, `create docs structure`, `set up documentation`, `docs scaffold`, `documentation init`
5
- -->
1
+ ---
2
+ name: docs-init-docs
3
+ description: "`init docs`, `create docs structure`, `set up documentation`, `docs scaffold`, `documentation init`. Use when the task matches the trigger conditions described in the body."
4
+ ---
6
5
  # Skill: init-docs: Initialize Project Documentation Structure
7
6
 
8
7
  ## Trigger keywords
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/docs/init-project.md (Project Initialization) Use when: starting work on a new project or joining an existing one without doc
3
-
4
- Use when: starting work on a new project or joining an existing one without doc structure. ## Command
5
- -->
1
+ ---
2
+ name: docs-init-project
3
+ description: "Use when: starting work on a new project or joining an existing one without doc structure."
4
+ ---
6
5
  # Project Initialization
7
6
 
8
7
  Use when: starting work on a new project or joining an existing one without doc structure.
@@ -1,10 +1,7 @@
1
- <!--
2
- skills/docs/prd-workflow.md: Workflow for producing a PRD and connecting it to workflow task packets.
3
-
4
- Guides cx-product-manager through requirements gathering, user research, and writing a PRD
5
- to docs/prd/. Once approved, the PRD feeds /plan feature to create bead packets in
6
- .cx/workflow.json: closing the loop from discovery to execution.
7
- -->
1
+ ---
2
+ name: docs-prd-workflow
3
+ description: "Use when: the user asks to create a PRD, platform spec, business case, RFC, or requirements document."
4
+ ---
8
5
  # PRD Workflow
9
6
 
10
7
  Use when: the user asks to create a PRD, platform spec, business case, RFC, or requirements document.
@@ -1,6 +1,7 @@
1
- <!--
2
- skills/docs/prfaq-workflow.md: Working-backwards PRFAQ generation from PRDs or evidence.
3
- -->
1
+ ---
2
+ name: docs-prfaq-workflow
3
+ description: "Use when: the user asks for a PRFAQ, working-backwards doc, launch narrative, or FAQ grounded in product evidence."
4
+ ---
4
5
  # PRFAQ Workflow
5
6
 
6
7
  Use when: the user asks for a PRFAQ, working-backwards doc, launch narrative, or FAQ grounded in product evidence.
@@ -1,6 +1,7 @@
1
- <!--
2
- skills/docs/product-intelligence-review.md: Evaluate Product Intelligence artifacts before they become docs of record.
3
- -->
1
+ ---
2
+ name: docs-product-intelligence-review
3
+ description: "Use when: reviewing PRDs, Meta PRDs, PRFAQs, evidence briefs, signal briefs, customer profiles, or backlog proposals."
4
+ ---
4
5
  # Product Intelligence Review
5
6
 
6
7
  Use when: reviewing PRDs, Meta PRDs, PRFAQs, evidence briefs, signal briefs, customer profiles, or backlog proposals.
@@ -1,9 +1,7 @@
1
- <!--
2
- skills/docs/product-intelligence-workflow.md: Native Construct workflow for product evidence, synthesis, and product docs.
3
-
4
- Use this to move from raw product evidence to PRDs, Meta PRDs, PRFAQs, signal briefs,
5
- customer profiles, and backlog proposals without creating a separate sidecar system.
6
- -->
1
+ ---
2
+ name: docs-product-intelligence-workflow
3
+ description: "Use when: the request involves customer evidence, PM synthesis, product requirements, PRDs, PRFAQs, customer profiles, product signals, or backlog proposals."
4
+ ---
7
5
  # Product Intelligence Workflow
8
6
 
9
7
  Use when: the request involves customer evidence, PM synthesis, product requirements, PRDs, PRFAQs, customer profiles, product signals, or backlog proposals.
@@ -1,8 +1,7 @@
1
- <!--
2
- skills/docs/product-signal-workflow.md: Synthesize product signals from evidence into the right artifact.
3
- Confidence rubric, contradiction resolution, artifact decision tree, and storage are all defined here.
4
- Follow rules/common/research.md for source-handling policy.
5
- -->
1
+ ---
2
+ name: docs-product-signal-workflow
3
+ description: "Use when: the user asks what customers are asking for, what themes are emerging, whether evidence is strong enough, or what should become a PRD."
4
+ ---
6
5
  # Product Signal Workflow
7
6
 
8
7
  Use when: the user asks what customers are asking for, what themes are emerging, whether evidence is strong enough, or what should become a PRD.
@@ -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