@geraldmaron/construct 1.0.14 → 1.0.16

package/rules/web/design-quality.md

@@ -1,8 +1,6 @@
-<!--
-rules/web/design-quality.md: <one-line purpose>
-
-<2–6 line summary.>
--->
+---
+description: Construct web design quality rule. Use when writing or reviewing web code that involves design quality.
+---
 > This file extends [common/patterns.md](../common/patterns.md) with web-specific design-quality guidance.
 
 # Web Design Quality Standards

package/rules/web/hooks.md

@@ -1,8 +1,6 @@
-<!--
-rules/web/hooks.md: <one-line purpose>
-
-<2–6 line summary.>
--->
+---
+description: Prefer project-local tooling.
+---
 # Web Hooks
 
 ## Recommended PostToolUse Hooks

package/rules/web/patterns.md

@@ -1,8 +1,6 @@
-<!--
-rules/web/patterns.md: <one-line purpose>
-
-<2–6 line summary.>
--->
+---
+description: Construct web patterns rule. Use when writing or reviewing web code that involves patterns.
+---
 > This file extends [common/patterns.md](../common/patterns.md) with web-specific patterns.
 
 # Web Patterns

package/rules/web/performance.md

@@ -1,8 +1,6 @@
-<!--
-rules/web/performance.md: <one-line purpose>
-
-<2–6 line summary.>
--->
+---
+description: Construct web performance rule. Use when writing or reviewing web code that involves performance.
+---
 > This file extends [common/performance.md](../common/performance.md) with web-specific performance content.
 
 # Web Performance Rules

package/rules/web/security.md

@@ -1,8 +1,6 @@
-<!--
-rules/web/security.md: <one-line purpose>
-
-<2–6 line summary.>
--->
+---
+description: Construct web security rule. Use when writing or reviewing web code that involves security.
+---
 > This file extends [common/security.md](../common/security.md) with web-specific security content.
 
 # Web Security Rules

package/rules/web/testing.md

@@ -1,8 +1,6 @@
-<!--
-rules/web/testing.md: <one-line purpose>
-
-<2–6 line summary.>
--->
+---
+description: Construct web testing rule. Use when writing or reviewing web code that involves testing.
+---
 > This file extends [common/testing.md](../common/testing.md) with web-specific testing content.
 
 # Web Testing Rules

package/scripts/sync-specialists.mjs

@@ -950,7 +950,16 @@ function getVSCodeSettingsPaths() {
       path.join(appData, "Code - Insiders", "User", "settings.json"),
     );
   }
-  return candidates.filter(fs.existsSync);
+  // settings.json present → ready to merge. settings.json absent but the
+  // VS Code User dir exists → installed without ever opening Preferences,
+  // and global sync still needs to write the MCP block. The User dir is
+  // the installation signal; bootstrap a minimal settings.json there.
+
+  return candidates.filter((candidate) => {
+    if (fs.existsSync(candidate)) return true;
+    const userDir = path.dirname(candidate);
+    return fs.existsSync(userDir);
+  });
 }
 
 function syncVSCode(targetDir = null) {
@@ -991,7 +1000,16 @@ function syncVSCode(targetDir = null) {
   let synced = false;
   for (const settingsPath of settingsPaths) {
     try {
-      const settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+      let settings;
+      if (fs.existsSync(settingsPath)) {
+        settings = JSON.parse(fs.readFileSync(settingsPath, "utf8"));
+      } else {
+        // VS Code installed (User dir present) but never opened → seed an
+        // empty settings.json. Single object literal, no other keys, so
+        // a later launch of VS Code finds it valid and writes user prefs
+        // alongside.
+        settings = {};
+      }
       if (!settings["github.copilot.mcpServers"]) settings["github.copilot.mcpServers"] = {};
       const mcpServers = settings["github.copilot.mcpServers"];
       for (const [id, mcpDef] of Object.entries(registryMcp)) {

package/skills/ai/agent-dev.md

@@ -1,8 +1,7 @@
-<!--
-skills/ai/agent-dev.md (AI Agent Development) Use this skill when building AI agents, tool-use systems, or multi-agent workflo
-
-Use this skill when building AI agents, tool-use systems, or multi-agent workflows. ## Agent Architecture
--->
+---
+name: ai-agent-dev
+description: Use this skill when building AI agents, tool-use systems, or multi-agent workflows.
+---
 # AI Agent Development
 
 Use this skill when building AI agents, tool-use systems, or multi-agent workflows.

package/skills/ai/llm-security.md

@@ -1,8 +1,7 @@
-<!--
-skills/ai/llm-security.md (LLM Security) Use this skill when securing LLM-powered applications against prompt injection,
-
-Use this skill when securing LLM-powered applications against prompt injection, data leakage, and misuse. ## Prompt Injection
--->
+---
+name: ai-llm-security
+description: Use this skill when securing LLM-powered applications against prompt injection, data leakage, and misuse.
+---
 # LLM Security
 
 Use this skill when securing LLM-powered applications against prompt injection, data leakage, and misuse.

package/skills/ai/ml-ops.md

@@ -1,8 +1,7 @@
-<!--
-skills/ai/ml-ops.md (ML Operations (MLOps)) ```
-
-## The MLOps Lifecycle ```
--->
+---
+name: ai-ml-ops
+description: Patterns, anti-patterns, and reference guidance for ML Operations (MLOps). Use when the task involves ml operations (mlops).
+---
 # ML Operations (MLOps)
 
 ## The MLOps Lifecycle

package/skills/ai/orchestration-workflow.md

@@ -1,8 +1,7 @@
-<!--
-skills/ai/orchestration-workflow.md (Construct Orchestration Workflow) Use this skill when the request involves agent orchestration, phase transitions,
-
-Use this skill when the request involves agent orchestration, phase transitions, task keys, handoff quality, workflow state, or project alignment. ## Core Model
--->
+---
+name: ai-orchestration-workflow
+description: Use this skill when the request involves agent orchestration, phase transitions, task keys, handoff quality, workflow state, or project alignment.
+---
 # Construct Orchestration Workflow
 
 Use this skill when the request involves agent orchestration, phase transitions, task keys, handoff quality, workflow state, or project alignment.

package/skills/ai/prompt-and-eval.md

@@ -1,8 +1,7 @@
-<!--
-skills/ai/prompt-and-eval.md (Prompt Engineering and Evaluation) Use this skill when designing prompts, evaluating model performance, or optimizi
-
-Use this skill when designing prompts, evaluating model performance, or optimizing LLM behavior. ## Prompt Structure
--->
+---
+name: ai-prompt-and-eval
+description: Use this skill when designing prompts, evaluating model performance, or optimizing LLM behavior.
+---
 # Prompt Engineering and Evaluation
 
 Use this skill when designing prompts, evaluating model performance, or optimizing LLM behavior.

package/skills/ai/prompt-optimizer.md

@@ -1,9 +1,7 @@
-<!--
-skills/ai/prompt-optimizer.md: Closed-loop prompt auto-optimization guide.
-
-Uses telemetry traces and quality scores as the feedback signal, Claude as the optimizer,
-and the agent registry + construct sync as the deployment layer.
--->
+---
+name: ai-prompt-optimizer
+description: Closed-loop prompt auto-optimization guide. Use when the task matches the trigger conditions described in the body.
+---
 # Prompt Auto-Optimization Loop
 
 Construct's prompt improvement system uses telemetry traces and quality scores as the feedback signal, Claude as the optimizer, and the agent registry (`specialists/registry.json`) as the deployment layer. This is a closed loop: production data → failure analysis → improved prompt → staging → promotion.

package/skills/ai/rag-system.md

@@ -1,8 +1,7 @@
-<!--
-skills/ai/rag-system.md (RAG System Design) Use this skill when building retrieval-augmented generation pipelines, vector se
-
-Use this skill when building retrieval-augmented generation pipelines, vector search, or knowledge-grounded AI systems. ## Document Processing
--->
+---
+name: ai-rag-system
+description: Use this skill when building retrieval-augmented generation pipelines, vector search, or knowledge-grounded AI systems.
+---
 # RAG System Design
 
 Use this skill when building retrieval-augmented generation pipelines, vector search, or knowledge-grounded AI systems.

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.