@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.
- package/README.md +21 -2
- package/bin/construct +146 -83
- package/commands/build/feature.md +0 -6
- package/commands/build/fix.md +0 -6
- package/commands/design/access.md +0 -6
- package/commands/design/flow.md +0 -6
- package/commands/design/ui.md +0 -6
- package/commands/measure/experiment.md +0 -6
- package/commands/measure/metrics.md +0 -6
- package/commands/measure/results.md +0 -6
- package/commands/plan/api.md +0 -6
- package/commands/plan/challenge.md +0 -6
- package/commands/plan/decide.md +0 -6
- package/commands/plan/feature.md +0 -7
- package/commands/plan/requirements.md +0 -6
- package/commands/remember/context.md +0 -6
- package/commands/remember/handoff.md +0 -6
- package/commands/remember/runbook.md +0 -6
- package/commands/review/code.md +0 -6
- package/commands/review/quality.md +0 -6
- package/commands/review/security.md +0 -6
- package/commands/ship/ready.md +0 -6
- package/commands/ship/release.md +0 -6
- package/commands/ship/status.md +0 -6
- package/commands/understand/docs.md +0 -6
- package/commands/understand/research.md +0 -6
- package/commands/understand/this.md +0 -6
- package/commands/understand/why.md +0 -6
- package/commands/work/clean.md +0 -6
- package/commands/work/drive.md +0 -6
- package/commands/work/optimize-prompts.md +0 -6
- package/commands/work/parallel-review.md +0 -6
- package/db/schema/010_cx_scores.sql +51 -0
- package/lib/beads-client.mjs +19 -1
- package/lib/cli-commands.mjs +280 -146
- package/lib/comment-lint.mjs +5 -1
- package/lib/context-state.mjs +15 -3
- package/lib/contracts/validate.mjs +72 -18
- package/lib/contracts/violation-log.mjs +169 -0
- package/lib/document-extract/docling-client.mjs +114 -0
- package/lib/document-extract/docling-sidecar.py +122 -0
- package/lib/document-extract/whisper-client.mjs +79 -0
- package/lib/document-extract.mjs +73 -8
- package/lib/document-ingest.mjs +26 -4
- package/lib/embed/daemon.mjs +6 -1
- package/lib/flavors/loader.mjs +1 -1
- package/lib/handoffs/contract.mjs +2 -2
- package/lib/hooks/session-start.mjs +1 -1
- package/lib/hooks/stop-notify.mjs +7 -0
- package/lib/ingest/chunker.mjs +94 -0
- package/lib/ingest/pipeline.mjs +53 -0
- package/lib/ingest/store.mjs +82 -0
- package/lib/install/first-invocation.mjs +5 -1
- package/lib/intake/prepare.mjs +22 -4
- package/lib/integrations/intake-integrations.mjs +28 -2
- package/lib/knowledge/search.mjs +12 -0
- package/lib/mcp/server.mjs +142 -1
- package/lib/mcp/tools/skills.mjs +6 -3
- package/lib/mcp/tools/telemetry.mjs +30 -0
- package/lib/mcp/tools/workflow.mjs +6 -2
- package/lib/observation-store.mjs +14 -5
- package/lib/ollama-manager.mjs +32 -28
- package/lib/orchestration-policy.mjs +15 -0
- package/lib/prompt-composer.js +11 -1
- package/lib/roles/gateway.mjs +30 -1
- package/lib/runtime/uv-bootstrap.mjs +129 -0
- package/lib/runtime/whisper-bootstrap.mjs +102 -0
- package/lib/scheduler/index.mjs +24 -4
- package/lib/server/index.mjs +22 -1
- package/lib/server/insights.mjs +12 -0
- package/lib/server/static/index.html +1 -1
- package/lib/setup.mjs +54 -9
- package/lib/specialists/postconditions.mjs +1 -1
- package/lib/sync/skill-frontmatter.mjs +113 -21
- package/lib/tracking-surfaces.mjs +2 -0
- package/lib/update.mjs +31 -3
- package/lib/upgrade.mjs +31 -4
- package/lib/validators/skills.mjs +86 -54
- package/package.json +5 -5
- package/personas/construct.md +6 -7
- package/platforms/claude/CLAUDE.md +43 -15
- package/platforms/claude/settings.template.json +1 -1
- package/rules/common/beads-hygiene.md +3 -9
- package/rules/common/code-review.md +3 -6
- package/rules/common/coding-style.md +3 -6
- package/rules/common/comments.md +3 -7
- package/rules/common/commit-approval.md +3 -6
- package/rules/common/cx-agent-routing.md +3 -7
- package/rules/common/cx-skill-routing.md +3 -3
- package/rules/common/doc-ownership.md +3 -8
- package/rules/common/efficiency.md +3 -8
- package/rules/common/framing.md +3 -8
- package/rules/common/git-workflow.md +3 -5
- package/rules/common/no-fabrication.md +4 -12
- package/rules/common/patterns.md +3 -5
- package/rules/common/release-gates.md +3 -8
- package/rules/common/research.md +3 -8
- package/rules/common/review-before-change.md +3 -9
- package/rules/common/security.md +3 -6
- package/rules/common/skill-composition.md +3 -7
- package/rules/common/testing.md +3 -6
- package/rules/golang/coding-style.md +1 -5
- package/rules/golang/hooks.md +1 -5
- package/rules/golang/patterns.md +1 -5
- package/rules/golang/security.md +1 -5
- package/rules/golang/testing.md +1 -5
- package/rules/python/coding-style.md +1 -5
- package/rules/python/hooks.md +1 -5
- package/rules/python/patterns.md +1 -5
- package/rules/python/security.md +1 -5
- package/rules/python/testing.md +1 -5
- package/rules/swift/coding-style.md +1 -5
- package/rules/swift/hooks.md +1 -5
- package/rules/swift/patterns.md +1 -5
- package/rules/swift/security.md +1 -5
- package/rules/swift/testing.md +1 -5
- package/rules/typescript/coding-style.md +1 -5
- package/rules/typescript/hooks.md +1 -5
- package/rules/typescript/patterns.md +1 -5
- package/rules/typescript/security.md +1 -5
- package/rules/typescript/testing.md +1 -5
- package/rules/web/coding-style.md +3 -5
- package/rules/web/design-quality.md +3 -5
- package/rules/web/hooks.md +3 -5
- package/rules/web/patterns.md +3 -5
- package/rules/web/performance.md +3 -5
- package/rules/web/security.md +3 -5
- package/rules/web/testing.md +3 -5
- package/scripts/sync-specialists.mjs +20 -2
- package/skills/ai/agent-dev.md +4 -5
- package/skills/ai/llm-security.md +4 -5
- package/skills/ai/ml-ops.md +4 -5
- package/skills/ai/orchestration-workflow.md +4 -5
- package/skills/ai/prompt-and-eval.md +4 -5
- package/skills/ai/prompt-optimizer.md +4 -6
- package/skills/ai/rag-system.md +4 -5
- package/skills/architecture/api-design.md +4 -5
- package/skills/architecture/caching.md +4 -5
- package/skills/architecture/cloud-native.md +4 -5
- package/skills/architecture/message-queue.md +4 -5
- package/skills/architecture/security-arch.md +4 -5
- package/skills/compliance/ai-disclosure.md +4 -5
- package/skills/compliance/data-privacy.md +4 -5
- package/skills/compliance/license-audit.md +4 -5
- package/skills/compliance/regulatory-review.md +4 -5
- package/skills/development/cpp.md +4 -5
- package/skills/development/go.md +4 -5
- package/skills/development/java.md +4 -5
- package/skills/development/kotlin.md +4 -5
- package/skills/development/mobile-crossplatform.md +4 -5
- package/skills/development/python.md +4 -5
- package/skills/development/rust.md +4 -5
- package/skills/development/shell.md +4 -5
- package/skills/development/swift.md +4 -5
- package/skills/development/typescript.md +4 -5
- package/skills/devops/ci-cd.md +4 -5
- package/skills/devops/containerization.md +4 -5
- package/skills/devops/cost-optimization.md +4 -5
- package/skills/devops/data-engineering.md +4 -5
- package/skills/devops/database.md +4 -5
- package/skills/devops/dependency-management.md +4 -5
- package/skills/devops/devsecops.md +4 -5
- package/skills/devops/git-workflow.md +4 -5
- package/skills/devops/incident-response.md +4 -5
- package/skills/devops/monorepo.md +4 -5
- package/skills/devops/observability.md +4 -5
- package/skills/devops/performance.md +4 -5
- package/skills/devops/testing.md +4 -5
- package/skills/docs/adr-workflow.md +4 -7
- package/skills/docs/backlog-proposal-workflow.md +4 -3
- package/skills/docs/customer-profile-workflow.md +4 -3
- package/skills/docs/document-ingest-workflow.md +4 -3
- package/skills/docs/evidence-ingest-workflow.md +4 -3
- package/skills/docs/init-docs.md +4 -5
- package/skills/docs/init-project.md +4 -5
- package/skills/docs/prd-workflow.md +4 -7
- package/skills/docs/prfaq-workflow.md +4 -3
- package/skills/docs/product-intelligence-review.md +4 -3
- package/skills/docs/product-intelligence-workflow.md +4 -6
- package/skills/docs/product-signal-workflow.md +4 -5
- package/skills/docs/research-workflow.md +4 -5
- package/skills/docs/runbook-workflow.md +4 -5
- package/skills/docs/strategy-workflow.md +4 -5
- package/skills/exploration/dependency-graph-reading.md +4 -7
- package/skills/exploration/repo-map.md +4 -5
- package/skills/exploration/tracer-bullet-method.md +4 -7
- package/skills/exploration/unknown-codebase-onboarding.md +4 -7
- package/skills/frameworks/django.md +4 -5
- package/skills/frameworks/nextjs.md +4 -5
- package/skills/frameworks/react.md +4 -5
- package/skills/frameworks/spring-boot.md +4 -5
- package/skills/frontend-design/accessibility.md +4 -5
- package/skills/frontend-design/component-patterns.md +4 -5
- package/skills/frontend-design/engineering.md +4 -5
- package/skills/frontend-design/state-management.md +4 -5
- package/skills/frontend-design/ui-aesthetics.md +4 -5
- package/skills/frontend-design/ux-principles.md +4 -5
- package/skills/operating/change-management.md +4 -8
- package/skills/operating/incident-response.md +4 -8
- package/skills/operating/oncall-rotation.md +4 -7
- package/skills/operating/orchestration-reference.md +4 -10
- package/skills/quality-gates/review-work.md +4 -5
- package/skills/quality-gates/verify-change.md +4 -5
- package/skills/quality-gates/verify-module.md +4 -5
- package/skills/quality-gates/verify-quality.md +4 -5
- package/skills/quality-gates/verify-security.md +4 -5
- package/skills/roles/architect.ai-systems.md +6 -9
- package/skills/roles/architect.data.md +6 -9
- package/skills/roles/architect.enterprise.md +6 -9
- package/skills/roles/architect.integration.md +6 -9
- package/skills/roles/architect.md +7 -14
- package/skills/roles/architect.platform.md +6 -9
- package/skills/roles/data-analyst.experiment.md +6 -9
- package/skills/roles/data-analyst.md +6 -9
- package/skills/roles/data-analyst.product-intelligence.md +7 -9
- package/skills/roles/data-analyst.product.md +6 -9
- package/skills/roles/data-analyst.telemetry.md +7 -9
- package/skills/roles/data-engineer.pipeline.md +6 -9
- package/skills/roles/data-engineer.vector-retrieval.md +7 -9
- package/skills/roles/data-engineer.warehouse.md +6 -9
- package/skills/roles/debugger.md +6 -9
- package/skills/roles/designer.accessibility.md +6 -9
- package/skills/roles/designer.md +7 -9
- package/skills/roles/engineer.ai.md +6 -9
- package/skills/roles/engineer.data.md +6 -9
- package/skills/roles/engineer.md +9 -9
- package/skills/roles/engineer.platform.md +6 -9
- package/skills/roles/operator.docs.md +6 -9
- package/skills/roles/operator.md +9 -9
- package/skills/roles/operator.release.md +6 -9
- package/skills/roles/operator.sre.md +6 -9
- package/skills/roles/orchestrator.md +6 -9
- package/skills/roles/product-manager.ai-product.md +6 -9
- package/skills/roles/product-manager.business-strategy.md +6 -9
- package/skills/roles/product-manager.enterprise.md +6 -9
- package/skills/roles/product-manager.growth.md +7 -9
- package/skills/roles/product-manager.md +7 -9
- package/skills/roles/product-manager.platform.md +6 -9
- package/skills/roles/product-manager.product.md +6 -9
- package/skills/roles/qa.ai-eval.md +8 -9
- package/skills/roles/qa.api-contract.md +7 -9
- package/skills/roles/qa.data-pipeline.md +7 -9
- package/skills/roles/qa.md +7 -9
- package/skills/roles/qa.test-automation.md +6 -9
- package/skills/roles/qa.web-ui.md +7 -9
- package/skills/roles/researcher.explorer.md +6 -9
- package/skills/roles/researcher.md +8 -9
- package/skills/roles/researcher.ux.md +6 -9
- package/skills/roles/reviewer.devil-advocate.md +6 -9
- package/skills/roles/reviewer.evaluator.md +6 -9
- package/skills/roles/reviewer.md +9 -9
- package/skills/roles/reviewer.trace.md +6 -9
- package/skills/roles/security.ai.md +7 -9
- package/skills/roles/security.appsec.md +6 -9
- package/skills/roles/security.cloud.md +6 -9
- package/skills/roles/security.legal-compliance.md +6 -9
- package/skills/roles/security.md +7 -9
- package/skills/roles/security.privacy.md +7 -9
- package/skills/roles/security.supply-chain.md +7 -9
- package/skills/security/blue-team.md +4 -5
- package/skills/security/code-audit.md +4 -5
- package/skills/security/pentest.md +4 -5
- package/skills/security/red-team.md +4 -5
- package/skills/security/threat-intel.md +4 -5
- package/skills/security/vuln-research.md +4 -5
- package/skills/strategy/competitive-landscape.md +4 -8
- package/skills/strategy/market-research-methods.md +4 -8
- package/skills/strategy/narrative-arc.md +4 -8
- package/skills/strategy/pricing-positioning.md +4 -8
- package/skills/utility/clean-code.md +4 -5
- package/specialists/policy-inventory.json +14 -0
- package/lib/specialist-contracts-enforce.mjs +0 -172
- package/rules/common/agents.md +0 -28
- package/rules/common/development-workflow.md +0 -32
- package/rules/common/performance.md +0 -55
|
@@ -1,8 +1,7 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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.
|
package/skills/devops/testing.md
CHANGED
|
@@ -1,8 +1,7 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
package/skills/docs/init-docs.md
CHANGED
|
@@ -1,8 +1,7 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
Use when
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
Use when
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
Use when
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
Use when
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
Use when
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
Use when
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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
|
-
|
|
3
|
-
|
|
4
|
-
|
|
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:
|
|
5
|
+
applies_to:
|
|
6
|
+
- cx-architect
|
|
11
7
|
inherits: architect
|
|
12
8
|
version: 2
|
|
13
|
-
profiles:
|
|
9
|
+
profiles:
|
|
10
|
+
- rnd
|
|
14
11
|
cap: 1
|
|
15
12
|
---
|
|
16
13
|
# AI Systems Architect Overlay
|