@geraldmaron/construct 1.0.12 → 1.0.15

package/skills/architecture/api-design.md

@@ -1,8 +1,7 @@
-<!--
-skills/architecture/api-design.md (API Design) Use this skill when designing REST, GraphQL, or gRPC APIs.
-
-Use this skill when designing REST, GraphQL, or gRPC APIs. ## REST Design Principles
--->
+---
+name: architecture-api-design
+description: Use this skill when designing REST, GraphQL, or gRPC APIs.
+---
 # API Design
 
 Use this skill when designing REST, GraphQL, or gRPC APIs.

package/skills/architecture/caching.md

@@ -1,8 +1,7 @@
-<!--
-skills/architecture/caching.md (Caching) Use this skill when designing caching strategies for applications, APIs, or infr
-
-Use this skill when designing caching strategies for applications, APIs, or infrastructure. ## Cache Layers
--->
+---
+name: architecture-caching
+description: Use this skill when designing caching strategies for applications, APIs, or infrastructure.
+---
 # Caching
 
 Use this skill when designing caching strategies for applications, APIs, or infrastructure.

package/skills/architecture/cloud-native.md

@@ -1,8 +1,7 @@
-<!--
-skills/architecture/cloud-native.md (Cloud-Native Architecture) Use this skill when designing containerized, orchestrated, or microservice-based
-
-Use this skill when designing containerized, orchestrated, or microservice-based systems. ## Container Best Practices
--->
+---
+name: architecture-cloud-native
+description: Use this skill when designing containerized, orchestrated, or microservice-based systems.
+---
 # Cloud-Native Architecture
 
 Use this skill when designing containerized, orchestrated, or microservice-based systems.

package/skills/architecture/message-queue.md

@@ -1,8 +1,7 @@
-<!--
-skills/architecture/message-queue.md (Message Queues and Event-Driven Architecture) Use this skill when designing asynchronous communication, event-driven systems,
-
-Use this skill when designing asynchronous communication, event-driven systems, or message-based integrations. ## When to Use Message Queues
--->
+---
+name: architecture-message-queue
+description: Use this skill when designing asynchronous communication, event-driven systems, or message-based integrations.
+---
 # Message Queues and Event-Driven Architecture
 
 Use this skill when designing asynchronous communication, event-driven systems, or message-based integrations.

package/skills/architecture/security-arch.md

@@ -1,8 +1,7 @@
-<!--
-skills/architecture/security-arch.md (Security Architecture) Use this skill when designing authentication, authorization, network security, o
-
-Use this skill when designing authentication, authorization, network security, or zero-trust architectures. ## Zero Trust Principles
--->
+---
+name: architecture-security-arch
+description: Use this skill when designing authentication, authorization, network security, or zero-trust architectures.
+---
 # Security Architecture
 
 Use this skill when designing authentication, authorization, network security, or zero-trust architectures.

package/skills/compliance/ai-disclosure.md

@@ -1,8 +1,7 @@
-<!--
-skills/compliance/ai-disclosure.md (AI Disclosure) AI transparency, disclosure, and regulatory compliance.
-
-Use this skill when reviewing AI features for disclosure requirements, transparency obligations, or emerging AI regulation compliance.
--->
+---
+name: compliance-ai-disclosure
+description: Use this skill when reviewing AI features for disclosure requirements, transparency obligations, or emerging AI regulation compliance.
+---
 # AI Disclosure
 
 Use this skill when reviewing AI features for disclosure requirements, transparency obligations, or emerging AI regulation compliance.

package/skills/compliance/data-privacy.md

@@ -1,8 +1,7 @@
-<!--
-skills/compliance/data-privacy.md (Data Privacy) GDPR, CCPA, and data protection compliance patterns.
-
-Use this skill when reviewing data collection, storage, processing, or retention for privacy regulation compliance.
--->
+---
+name: compliance-data-privacy
+description: Use this skill when reviewing data collection, storage, processing, or retention for privacy regulation compliance.
+---
 # Data Privacy
 
 Use this skill when reviewing data collection, storage, processing, or retention for privacy regulation compliance.

package/skills/compliance/license-audit.md

@@ -1,8 +1,7 @@
-<!--
-skills/compliance/license-audit.md (License Audit) Dependency license review and open-source compliance.
-
-Use this skill when auditing dependency licenses, evaluating OSS compliance risk, or preparing license inventories for legal review.
--->
+---
+name: compliance-license-audit
+description: Use this skill when auditing dependency licenses, evaluating OSS compliance risk, or preparing license inventories for legal review.
+---
 # License Audit
 
 Use this skill when auditing dependency licenses, evaluating OSS compliance risk, or preparing license inventories for legal review.

package/skills/compliance/regulatory-review.md

@@ -1,8 +1,7 @@
-<!--
-skills/compliance/regulatory-review.md (Regulatory Review) Pre-ship compliance review checklist and process.
-
-Use this skill when conducting a compliance review before shipping features that handle user data, financial transactions, AI decisions, or regulated content.
--->
+---
+name: compliance-regulatory-review
+description: Use this skill when conducting a compliance review before shipping features that handle user data, financial transactions, AI decisions, or regulated content.
+---
 # Regulatory Review
 
 Use this skill when conducting a compliance review before shipping features that handle user data, financial transactions, AI decisions, or regulated content.

package/skills/development/cpp.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/cpp.md (C/C++ Best Practices) Use this skill when writing, reviewing, or debugging C or C++ code.
-
-Use this skill when writing, reviewing, or debugging C or C++ code. ## Project Structure
--->
+---
+name: development-cpp
+description: Use this skill when writing, reviewing, or debugging C or C++ code.
+---
 # C/C++ Best Practices
 
 Use this skill when writing, reviewing, or debugging C or C++ code.

package/skills/development/go.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/go.md (Go Best Practices) Use this skill when writing, reviewing, or debugging Go code.
-
-Use this skill when writing, reviewing, or debugging Go code. ## Project Structure
--->
+---
+name: development-go
+description: Use this skill when writing, reviewing, or debugging Go code.
+---
 # Go Best Practices
 
 Use this skill when writing, reviewing, or debugging Go code.

package/skills/development/java.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/java.md (Java Best Practices) Use this skill when writing, reviewing, or debugging Java or Kotlin code on the
-
-Use this skill when writing, reviewing, or debugging Java or Kotlin code on the JVM. ## Project Structure
--->
+---
+name: development-java
+description: Use this skill when writing, reviewing, or debugging Java or Kotlin code on the JVM.
+---
 # Java Best Practices
 
 Use this skill when writing, reviewing, or debugging Java or Kotlin code on the JVM.

package/skills/development/kotlin.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/kotlin.md (Kotlin / Android Development) | Scope | Use when |
-
-## Coroutines & Flows ### Coroutine scope discipline
--->
+---
+name: development-kotlin
+description: Patterns, anti-patterns, and reference guidance for Kotlin / Android Development. Use when the task involves kotlin / android development.
+---
 # Kotlin / Android Development
 
 ## Coroutines & Flows

package/skills/development/mobile-crossplatform.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/mobile-crossplatform.md (Mobile Cross-Platform Development) Before choosing a framework, answer:
-
-## Decision Framework: Native vs Cross-Platform Before choosing a framework, answer:
--->
+---
+name: development-mobile-crossplatform
+description: Before choosing a framework, answer:. Use when the task matches the trigger conditions described in the body.
+---
 # Mobile Cross-Platform Development
 
 ## Decision Framework: Native vs Cross-Platform

package/skills/development/python.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/python.md (Python Best Practices) Use this skill when writing, reviewing, or debugging Python code.
-
-Use this skill when writing, reviewing, or debugging Python code. ## Project Structure
--->
+---
+name: development-python
+description: Use this skill when writing, reviewing, or debugging Python code.
+---
 # Python Best Practices
 
 Use this skill when writing, reviewing, or debugging Python code.

package/skills/development/rust.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/rust.md (Rust Best Practices) Use this skill when writing, reviewing, or debugging Rust code.
-
-Use this skill when writing, reviewing, or debugging Rust code. ## Project Structure
--->
+---
+name: development-rust
+description: Use this skill when writing, reviewing, or debugging Rust code.
+---
 # Rust Best Practices
 
 Use this skill when writing, reviewing, or debugging Rust code.

package/skills/development/shell.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/shell.md (Shell Scripting Best Practices) Use this skill when writing, reviewing, or debugging Bash, Zsh, or POSIX shell s
-
-Use this skill when writing, reviewing, or debugging Bash, Zsh, or POSIX shell scripts. ## Script Header
--->
+---
+name: development-shell
+description: Use this skill when writing, reviewing, or debugging Bash, Zsh, or POSIX shell scripts.
+---
 # Shell Scripting Best Practices
 
 Use this skill when writing, reviewing, or debugging Bash, Zsh, or POSIX shell scripts.

package/skills/development/swift.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/swift.md (Swift / iOS Development) Swift 6 enforces data-race safety at compile time. Annotate isolation boundary e
-
-## Concurrency (Swift 6 Strict Concurrency) Swift 6 enforces data-race safety at compile time. Annotate isolation boundary explicitly:
--->
+---
+name: development-swift
+description: Swift 6 enforces data-race safety at compile time. Annotate isolation boundary explicitly:. Use when the task matches the trigger conditions described in the body.
+---
 # Swift / iOS Development
 
 ## Concurrency (Swift 6 Strict Concurrency)

package/skills/development/typescript.md

@@ -1,8 +1,7 @@
-<!--
-skills/development/typescript.md (TypeScript Best Practices) Use this skill when writing, reviewing, or debugging TypeScript or JavaScript co
-
-Use this skill when writing, reviewing, or debugging TypeScript or JavaScript code. ## Project Structure
--->
+---
+name: development-typescript
+description: Use this skill when writing, reviewing, or debugging TypeScript or JavaScript code.
+---
 # TypeScript Best Practices
 
 Use this skill when writing, reviewing, or debugging TypeScript or JavaScript code.

package/skills/devops/ci-cd.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/ci-cd.md (CI/CD) Use this skill when designing, debugging, or optimizing CI/CD pipelines.
-
-Use this skill when designing, debugging, or optimizing CI/CD pipelines. ## Pipeline Stages
--->
+---
+name: devops-ci-cd
+description: Use this skill when designing, debugging, or optimizing CI/CD pipelines.
+---
 # CI/CD
 
 Use this skill when designing, debugging, or optimizing CI/CD pipelines.

package/skills/devops/containerization.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/containerization.md (Containerization) Use this skill when writing Dockerfiles, optimizing image size, or securing cont
-
-Use this skill when writing Dockerfiles, optimizing image size, or securing container builds. ## Multi-Stage Builds
--->
+---
+name: devops-containerization
+description: Use this skill when writing Dockerfiles, optimizing image size, or securing container builds.
+---
 # Containerization
 
 Use this skill when writing Dockerfiles, optimizing image size, or securing container builds.

package/skills/devops/cost-optimization.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/cost-optimization.md (Cloud Cost Optimization) Use this skill when reducing cloud spend, right-sizing resources, or implementin
-
-Use this skill when reducing cloud spend, right-sizing resources, or implementing FinOps practices. ## Cost Visibility
--->
+---
+name: devops-cost-optimization
+description: Use this skill when reducing cloud spend, right-sizing resources, or implementing FinOps practices.
+---
 # Cloud Cost Optimization
 
 Use this skill when reducing cloud spend, right-sizing resources, or implementing FinOps practices.

package/skills/devops/data-engineering.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/data-engineering.md (Data Engineering) 1. **Idempotency**: pipelines can run multiple times without duplicating data
-
-## Core Principles 1. **Idempotency**: pipelines can run multiple times without duplicating data
--->
+---
+name: devops-data-engineering
+description: "1. **Idempotency**: pipelines can run multiple times without duplicating data 2. **Observability**: every pipeline run logs row counts, latency, and anomalies 3. **Data contracts**: producers and consumers agree on schema and SLAs 4. **Lineage**: know where every column came from and what it feeds. Use when the task matches the trigger conditions described in the body."
+---
 # Data Engineering
 
 ## Core Principles

package/skills/devops/database.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/database.md (Database Patterns) Use this skill when designing schemas, writing migrations, optimizing queries, o
-
-Use this skill when designing schemas, writing migrations, optimizing queries, or selecting databases. ## Schema Design
--->
+---
+name: devops-database
+description: Use this skill when designing schemas, writing migrations, optimizing queries, or selecting databases.
+---
 # Database Patterns
 
 Use this skill when designing schemas, writing migrations, optimizing queries, or selecting databases.

package/skills/devops/dependency-management.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/dependency-management.md (Dependency Management) Use this skill when managing package upgrades, resolving CVEs, or establishing l
-
-Use this skill when managing package upgrades, resolving CVEs, or establishing lock file and versioning policy. ## Lock File Hygiene
--->
+---
+name: devops-dependency-management
+description: Use this skill when managing package upgrades, resolving CVEs, or establishing lock file and versioning policy.
+---
 # Dependency Management
 
 Use this skill when managing package upgrades, resolving CVEs, or establishing lock file and versioning policy.

package/skills/devops/devsecops.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/devsecops.md (DevSecOps) Use this skill when integrating security into CI/CD pipelines, managing supply c
-
-Use this skill when integrating security into CI/CD pipelines, managing supply chain risk, or automating security scanning. ## Pipeline Security Stages
--->
+---
+name: devops-devsecops
+description: Use this skill when integrating security into CI/CD pipelines, managing supply chain risk, or automating security scanning.
+---
 # DevSecOps
 
 Use this skill when integrating security into CI/CD pipelines, managing supply chain risk, or automating security scanning.

package/skills/devops/git-workflow.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/git-workflow.md (Git Workflow) Use this skill when establishing branching strategies, commit conventions, or co
-
-Use this skill when establishing branching strategies, commit conventions, or code integration practices. ## Branching Strategies
--->
+---
+name: devops-git-workflow
+description: Use this skill when establishing branching strategies, commit conventions, or code integration practices.
+---
 # Git Workflow
 
 Use this skill when establishing branching strategies, commit conventions, or code integration practices.

package/skills/devops/incident-response.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/incident-response.md (Incident Response) | Sev | User impact | Response time | Example |
-
-## Severity Levels | Sev | User impact | Response time | Example |
--->
+---
+name: devops-incident-response
+description: "Define severity in your runbook and assign it early: it determines escalation and comms cadence. Use when the task matches the trigger conditions described in the body."
+---
 # Incident Response
 
 ## Severity Levels

package/skills/devops/monorepo.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/monorepo.md (Monorepo) Use this skill when selecting monorepo tooling, structuring packages, or optimiz
-
-Use this skill when selecting monorepo tooling, structuring packages, or optimizing affected-only builds. ## Tool Selection
--->
+---
+name: devops-monorepo
+description: Use this skill when selecting monorepo tooling, structuring packages, or optimizing affected-only builds.
+---
 # Monorepo
 
 Use this skill when selecting monorepo tooling, structuring packages, or optimizing affected-only builds.

package/skills/devops/observability.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/observability.md (Observability) Use this skill when designing logging, tracing, metrics, or alerting systems.
-
-Use this skill when designing logging, tracing, metrics, or alerting systems. ## Three Pillars
--->
+---
+name: devops-observability
+description: Use this skill when designing logging, tracing, metrics, or alerting systems.
+---
 # Observability
 
 Use this skill when designing logging, tracing, metrics, or alerting systems.

package/skills/devops/performance.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/performance.md (Performance Engineering) Use this skill when profiling, load testing, or optimizing application and infra
-
-Use this skill when profiling, load testing, or optimizing application and infrastructure performance. ## Performance Targets
--->
+---
+name: devops-performance
+description: Use this skill when profiling, load testing, or optimizing application and infrastructure performance.
+---
 # Performance Engineering
 
 Use this skill when profiling, load testing, or optimizing application and infrastructure performance.

package/skills/devops/testing.md

@@ -1,8 +1,7 @@
-<!--
-skills/devops/testing.md (Testing Strategy) Use this skill when planning test coverage, selecting test types, or establishin
-
-Use this skill when planning test coverage, selecting test types, or establishing testing practices. ## Test Pyramid
--->
+---
+name: devops-testing
+description: Use this skill when planning test coverage, selecting test types, or establishing testing practices.
+---
 # Testing Strategy
 
 Use this skill when planning test coverage, selecting test types, or establishing testing practices.

package/skills/docs/adr-workflow.md

@@ -1,10 +1,7 @@
-<!--
-skills/docs/adr-workflow.md: Workflow for recording an architectural decision as an ADR.
-
-Triggered when cx-architect finalizes a design or a technology choice is made. Writes a
-full ADR to docs/adr/ using the shipped template (user-overridable via .cx/templates/docs/adr.md)
-and a shorter entry to .cx/decisions/ for session context.
--->
+---
+name: docs-adr-workflow
+description: "Use when: an architectural decision is made that affects the system structure, data model, API contracts, or technology choices."
+---
 # ADR Workflow
 
 Use when: an architectural decision is made that affects the system structure, data model, API contracts, or technology choices.

package/skills/docs/backlog-proposal-workflow.md

@@ -1,6 +1,7 @@
-<!--
-skills/docs/backlog-proposal-workflow.md: Approval-gated issue tracker proposals.
--->
+---
+name: docs-backlog-proposal-workflow
+description: "Use when: product evidence should create or update Jira, Linear, GitHub Issues, or another tracker."
+---
 # Backlog Proposal Workflow
 
 Use when: product evidence should create or update Jira, Linear, GitHub Issues, or another tracker.

package/skills/docs/customer-profile-workflow.md

@@ -1,6 +1,7 @@
-<!--
-skills/docs/customer-profile-workflow.md: Maintain durable customer/account memory for Product Intelligence.
--->
+---
+name: docs-customer-profile-workflow
+description: "Use when: customer evidence should update durable product memory."
+---
 # Customer Profile Workflow
 
 Use when: customer evidence should update durable product memory.

package/skills/docs/document-ingest-workflow.md

@@ -1,6 +1,7 @@
-<!--
-skills/docs/document-ingest-workflow.md: Convert source documents into retrieval-ready markdown artifacts.
--->
+---
+name: docs-document-ingest-workflow
+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."
+---
 # Document Ingest Workflow
 
 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.

package/skills/docs/evidence-ingest-workflow.md

@@ -1,6 +1,7 @@
-<!--
-skills/docs/evidence-ingest-workflow.md: Normalize raw product evidence into Construct knowledge artifacts.
--->
+---
+name: docs-evidence-ingest-workflow
+description: "Use when: the user pastes customer notes, Slack threads, support tickets, sales notes, research snippets, RFCs, analytics summaries, or competitor signals."
+---
 # Evidence Ingest Workflow
 
 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

@@ -1,8 +1,7 @@
-<!--
-skills/docs/init-docs.md (Skill: init-docs) Initialize Project Documentation Structure: `init docs`, `create docs structure`, `set up documentation`, `docs scaffold`, `documentation init`
-
-## Trigger keywords `init docs`, `create docs structure`, `set up documentation`, `docs scaffold`, `documentation init`
--->
+---
+name: docs-init-docs
+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."
+---
 # Skill: init-docs: Initialize Project Documentation Structure
 
 ## Trigger keywords

package/skills/docs/init-project.md

@@ -1,8 +1,7 @@
-<!--
-skills/docs/init-project.md (Project Initialization) Use when: starting work on a new project or joining an existing one without doc
-
-Use when: starting work on a new project or joining an existing one without doc structure. ## Command
--->
+---
+name: docs-init-project
+description: "Use when: starting work on a new project or joining an existing one without doc structure."
+---
 # Project Initialization
 
 Use when: starting work on a new project or joining an existing one without doc structure.

package/skills/docs/prd-workflow.md

@@ -1,10 +1,7 @@
-<!--
-skills/docs/prd-workflow.md: Workflow for producing a PRD and connecting it to workflow task packets.
-
-Guides cx-product-manager through requirements gathering, user research, and writing a PRD
-to docs/prd/. Once approved, the PRD feeds /plan feature to create bead packets in
-.cx/workflow.json: closing the loop from discovery to execution.
--->
+---
+name: docs-prd-workflow
+description: "Use when: the user asks to create a PRD, platform spec, business case, RFC, or requirements document."
+---
 # PRD Workflow
 
 Use when: the user asks to create a PRD, platform spec, business case, RFC, or requirements document.

package/skills/docs/prfaq-workflow.md

@@ -1,6 +1,7 @@
-<!--
-skills/docs/prfaq-workflow.md: Working-backwards PRFAQ generation from PRDs or evidence.
--->
+---
+name: docs-prfaq-workflow
+description: "Use when: the user asks for a PRFAQ, working-backwards doc, launch narrative, or FAQ grounded in product evidence."
+---
 # PRFAQ Workflow
 
 Use when: the user asks for a PRFAQ, working-backwards doc, launch narrative, or FAQ grounded in product evidence.

package/skills/docs/product-intelligence-review.md

@@ -1,6 +1,7 @@
-<!--
-skills/docs/product-intelligence-review.md: Evaluate Product Intelligence artifacts before they become docs of record.
--->
+---
+name: docs-product-intelligence-review
+description: "Use when: reviewing PRDs, Meta PRDs, PRFAQs, evidence briefs, signal briefs, customer profiles, or backlog proposals."
+---
 # Product Intelligence Review
 
 Use when: reviewing PRDs, Meta PRDs, PRFAQs, evidence briefs, signal briefs, customer profiles, or backlog proposals.

package/skills/docs/product-intelligence-workflow.md

@@ -1,9 +1,7 @@
-<!--
-skills/docs/product-intelligence-workflow.md: Native Construct workflow for product evidence, synthesis, and product docs.
-
-Use this to move from raw product evidence to PRDs, Meta PRDs, PRFAQs, signal briefs,
-customer profiles, and backlog proposals without creating a separate sidecar system.
--->
+---
+name: docs-product-intelligence-workflow
+description: "Use when: the request involves customer evidence, PM synthesis, product requirements, PRDs, PRFAQs, customer profiles, product signals, or backlog proposals."
+---
 # Product Intelligence Workflow
 
 Use when: the request involves customer evidence, PM synthesis, product requirements, PRDs, PRFAQs, customer profiles, product signals, or backlog proposals.

package/skills/docs/product-signal-workflow.md

@@ -1,8 +1,7 @@
-<!--
-skills/docs/product-signal-workflow.md: Synthesize product signals from evidence into the right artifact.
-Confidence rubric, contradiction resolution, artifact decision tree, and storage are all defined here.
-Follow rules/common/research.md for source-handling policy.
--->
+---
+name: docs-product-signal-workflow
+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."
+---
 # Product Signal Workflow
 
 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.