@geraldmaron/construct 1.0.12 → 1.0.15

package/skills/roles/qa.test-automation.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/qa.test-automation.md. Anti-pattern guidance for the Qa.test-automation (test automation) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the qa.test-automation (test automation) domain and counter-moves to avoid them.
-Applies to: cx-test-automation.
--->
 ---
+name: roles-qa-test-automation
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the QA — Test Automation role. Use when reviewing or generating work by cx-test-automation, or when an agent is acting in the QA — Test Automation role.
 role: qa.test-automation
-applies_to: [cx-test-automation]
+applies_to:
+  - cx-test-automation
 inherits: qa
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Test Automation Overlay

package/skills/roles/qa.web-ui.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/qa.web-ui.md. Anti-pattern guidance for the Qa.web-ui (web ui) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the qa.web-ui (web ui) domain and counter-moves to avoid them.
-Applies to: cx-qa, cx-test-automation.
--->
 ---
+name: roles-qa-web-ui
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the QA — Web UI role. Use when reviewing or generating work by cx-qa, cx-test-automation, or when an agent is acting in the QA — Web UI role.
 role: qa.web-ui
-applies_to: [cx-qa, cx-test-automation]
+applies_to:
+  - cx-qa
+  - cx-test-automation
 inherits: qa
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Web UI QA Overlay

package/skills/roles/researcher.explorer.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/researcher.explorer.md. Anti-pattern guidance for the Researcher.explorer (explorer) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the researcher.explorer (explorer) domain and counter-moves to avoid them.
-Applies to: cx-explorer.
--->
 ---
+name: roles-researcher-explorer
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Researcher — Explorer role. Use when reviewing or generating work by cx-explorer, or when an agent is acting in the Researcher — Explorer role.
 role: researcher.explorer
-applies_to: [cx-explorer]
+applies_to:
+  - cx-explorer
 inherits: researcher
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Codebase Explorer Overlay

package/skills/roles/researcher.md

@@ -1,16 +1,15 @@
-<!--
-skills/roles/researcher.md. Anti-pattern guidance for the Researcher role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the researcher domain and counter-moves to avoid them.
-Applies to: cx-researcher, cx-ux-researcher, cx-explorer.
--->
 ---
+name: roles-researcher
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Researcher role. Use when reviewing or generating work by cx-researcher, cx-ux-researcher, cx-explorer, or when an agent is acting in the Researcher role.
 role: researcher
-applies_to: [cx-researcher, cx-ux-researcher, cx-explorer]
+applies_to:
+  - cx-researcher
+  - cx-ux-researcher
+  - cx-explorer
 inherits: null
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Researcher. Role guidance

package/skills/roles/researcher.ux.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/researcher.ux.md. Anti-pattern guidance for the Researcher.ux (ux) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the researcher.ux (ux) domain and counter-moves to avoid them.
-Applies to: cx-ux-researcher.
--->
 ---
+name: roles-researcher-ux
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Researcher — UX role. Use when reviewing or generating work by cx-ux-researcher, or when an agent is acting in the Researcher — UX role.
 role: researcher.ux
-applies_to: [cx-ux-researcher]
+applies_to:
+  - cx-ux-researcher
 inherits: researcher
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # UX Researcher Overlay

package/skills/roles/reviewer.devil-advocate.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/reviewer.devil-advocate.md. Anti-pattern guidance for the Reviewer.devil-advocate (devil advocate) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the reviewer.devil-advocate (devil advocate) domain and counter-moves to avoid them.
-Applies to: cx-devil-advocate.
--->
 ---
+name: roles-reviewer-devil-advocate
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Reviewer — Devil Advocate role. Use when reviewing or generating work by cx-devil-advocate, or when an agent is acting in the Reviewer — Devil Advocate role.
 role: reviewer.devil-advocate
-applies_to: [cx-devil-advocate]
+applies_to:
+  - cx-devil-advocate
 inherits: reviewer
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Devil's Advocate Overlay

package/skills/roles/reviewer.evaluator.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/reviewer.evaluator.md. Anti-pattern guidance for the Reviewer.evaluator (evaluator) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the reviewer.evaluator (evaluator) domain and counter-moves to avoid them.
-Applies to: cx-evaluator.
--->
 ---
+name: roles-reviewer-evaluator
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Reviewer — Evaluator role. Use when reviewing or generating work by cx-evaluator, or when an agent is acting in the Reviewer — Evaluator role.
 role: reviewer.evaluator
-applies_to: [cx-evaluator]
+applies_to:
+  - cx-evaluator
 inherits: reviewer
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Evaluator Overlay

package/skills/roles/reviewer.md

@@ -1,16 +1,16 @@
-<!--
-skills/roles/reviewer.md. Anti-pattern guidance for the Reviewer role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the reviewer domain and counter-moves to avoid them.
-Applies to: cx-reviewer, cx-devil-advocate, cx-evaluator, cx-trace-reviewer.
--->
 ---
+name: roles-reviewer
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Reviewer role. Use when reviewing or generating work by cx-reviewer, cx-devil-advocate, cx-evaluator, cx-trace-reviewer, or when an agent is acting in the Reviewer role.
 role: reviewer
-applies_to: [cx-reviewer, cx-devil-advocate, cx-evaluator, cx-trace-reviewer]
+applies_to:
+  - cx-reviewer
+  - cx-devil-advocate
+  - cx-evaluator
+  - cx-trace-reviewer
 inherits: null
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Reviewer. Role guidance

package/skills/roles/reviewer.trace.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/reviewer.trace.md. Anti-pattern guidance for the Reviewer.trace (trace) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the reviewer.trace (trace) domain and counter-moves to avoid them.
-Applies to: cx-trace-reviewer.
--->
 ---
+name: roles-reviewer-trace
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Reviewer — Trace role. Use when reviewing or generating work by cx-trace-reviewer, or when an agent is acting in the Reviewer — Trace role.
 role: reviewer.trace
-applies_to: [cx-trace-reviewer]
+applies_to:
+  - cx-trace-reviewer
 inherits: reviewer
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Trace Reviewer Overlay

package/skills/roles/security.ai.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/security.ai.md. Anti-pattern guidance for the Security.ai (ai) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the security.ai (ai) domain and counter-moves to avoid them.
-Applies to: cx-security, cx-ai-engineer.
--->
 ---
+name: roles-security-ai
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — AI role. Use when reviewing or generating work by cx-security, cx-ai-engineer, or when an agent is acting in the Security — AI role.
 role: security.ai
-applies_to: [cx-security, cx-ai-engineer]
+applies_to:
+  - cx-security
+  - cx-ai-engineer
 inherits: security
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # AI Security Overlay

package/skills/roles/security.appsec.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/security.appsec.md. Anti-pattern guidance for the Security.appsec (appsec) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the security.appsec (appsec) domain and counter-moves to avoid them.
-Applies to: cx-security.
--->
 ---
+name: roles-security-appsec
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Appsec role. Use when reviewing or generating work by cx-security, or when an agent is acting in the Security — Appsec role.
 role: security.appsec
-applies_to: [cx-security]
+applies_to:
+  - cx-security
 inherits: security
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # AppSec Overlay

package/skills/roles/security.cloud.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/security.cloud.md. Anti-pattern guidance for the Security.cloud (cloud) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the security.cloud (cloud) domain and counter-moves to avoid them.
-Applies to: cx-security.
--->
 ---
+name: roles-security-cloud
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Cloud role. Use when reviewing or generating work by cx-security, or when an agent is acting in the Security — Cloud role.
 role: security.cloud
-applies_to: [cx-security]
+applies_to:
+  - cx-security
 inherits: security
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Cloud Security Overlay

package/skills/roles/security.legal-compliance.md

@@ -1,16 +1,13 @@
-<!--
-skills/roles/security.legal-compliance.md. Anti-pattern guidance for the Security.legal-compliance (legal compliance) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the security.legal-compliance (legal compliance) domain and counter-moves to avoid them.
-Applies to: cx-legal-compliance.
--->
 ---
+name: roles-security-legal-compliance
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Legal Compliance role. Use when reviewing or generating work by cx-legal-compliance, or when an agent is acting in the Security — Legal Compliance role.
 role: security.legal-compliance
-applies_to: [cx-legal-compliance]
+applies_to:
+  - cx-legal-compliance
 inherits: security
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Legal & Compliance Overlay

package/skills/roles/security.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/security.md. Anti-pattern guidance for the Security role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the security domain and counter-moves to avoid them.
-Applies to: cx-security, cx-legal-compliance.
--->
 ---
+name: roles-security
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security role. Use when reviewing or generating work by cx-security, cx-legal-compliance, or when an agent is acting in the Security role.
 role: security
-applies_to: [cx-security, cx-legal-compliance]
+applies_to:
+  - cx-security
+  - cx-legal-compliance
 inherits: null
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Security. Role guidance

package/skills/roles/security.privacy.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/security.privacy.md. Anti-pattern guidance for the Security.privacy (privacy) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the security.privacy (privacy) domain and counter-moves to avoid them.
-Applies to: cx-security, cx-legal-compliance.
--->
 ---
+name: roles-security-privacy
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Privacy role. Use when reviewing or generating work by cx-security, cx-legal-compliance, or when an agent is acting in the Security — Privacy role.
 role: security.privacy
-applies_to: [cx-security, cx-legal-compliance]
+applies_to:
+  - cx-security
+  - cx-legal-compliance
 inherits: security
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Privacy Security Overlay

package/skills/roles/security.supply-chain.md

@@ -1,16 +1,14 @@
-<!--
-skills/roles/security.supply-chain.md. Anti-pattern guidance for the Security.supply-chain (supply chain) role.
-
-Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
-Covers common failure modes for the security.supply-chain (supply chain) domain and counter-moves to avoid them.
-Applies to: cx-security, cx-platform-engineer.
--->
 ---
+name: roles-security-supply-chain
+description: Surfaces anti-patterns, failure modes, and counter-moves specific to the Security — Supply Chain role. Use when reviewing or generating work by cx-security, cx-platform-engineer, or when an agent is acting in the Security — Supply Chain role.
 role: security.supply-chain
-applies_to: [cx-security, cx-platform-engineer]
+applies_to:
+  - cx-security
+  - cx-platform-engineer
 inherits: security
 version: 2
-profiles: [rnd]
+profiles:
+  - rnd
 cap: 1
 ---
 # Supply Chain Security Overlay

package/skills/security/blue-team.md

@@ -1,8 +1,7 @@
-<!--
-skills/security/blue-team.md (Blue Team) Use this skill when defending systems, responding to incidents, or building dete
-
-Use this skill when defending systems, responding to incidents, or building detection and monitoring capabilities. ## Detection Engineering
--->
+---
+name: security-blue-team
+description: Use this skill when defending systems, responding to incidents, or building detection and monitoring capabilities.
+---
 # Blue Team
 
 Use this skill when defending systems, responding to incidents, or building detection and monitoring capabilities.

package/skills/security/code-audit.md

@@ -1,8 +1,7 @@
-<!--
-skills/security/code-audit.md (Code Audit) Use this skill when reviewing source code for security vulnerabilities through s
-
-Use this skill when reviewing source code for security vulnerabilities through static analysis. ## Taint Analysis
--->
+---
+name: security-code-audit
+description: Use this skill when reviewing source code for security vulnerabilities through static analysis.
+---
 # Code Audit
 
 Use this skill when reviewing source code for security vulnerabilities through static analysis.

package/skills/security/pentest.md

@@ -1,8 +1,7 @@
-<!--
-skills/security/pentest.md (Penetration Testing) Use this skill when testing web applications or APIs for security vulnerabilitie
-
-Use this skill when testing web applications or APIs for security vulnerabilities. ## OWASP Top 10 Checklist
--->
+---
+name: security-pentest
+description: Use this skill when testing web applications or APIs for security vulnerabilities.
+---
 # Penetration Testing
 
 Use this skill when testing web applications or APIs for security vulnerabilities.

package/skills/security/red-team.md

@@ -1,8 +1,7 @@
-<!--
-skills/security/red-team.md (Red Team) Use this skill when planning or executing offensive security assessments, advers
-
-Use this skill when planning or executing offensive security assessments, adversary emulation, or attack simulations. ## Reconnaissance
--->
+---
+name: security-red-team
+description: Use this skill when planning or executing offensive security assessments, adversary emulation, or attack simulations.
+---
 # Red Team
 
 Use this skill when planning or executing offensive security assessments, adversary emulation, or attack simulations.

package/skills/security/threat-intel.md

@@ -1,8 +1,7 @@
-<!--
-skills/security/threat-intel.md (Threat Intelligence) Use this skill when performing OSINT, threat modeling, or building threat intell
-
-Use this skill when performing OSINT, threat modeling, or building threat intelligence programs. ## OSINT Collection
--->
+---
+name: security-threat-intel
+description: Use this skill when performing OSINT, threat modeling, or building threat intelligence programs.
+---
 # Threat Intelligence
 
 Use this skill when performing OSINT, threat modeling, or building threat intelligence programs.

package/skills/security/vuln-research.md

@@ -1,8 +1,7 @@
-<!--
-skills/security/vuln-research.md (Vulnerability Research) Use this skill when analyzing binaries, fuzzing software, or developing exploits
-
-Use this skill when analyzing binaries, fuzzing software, or developing exploits for security research. ## Binary Analysis
--->
+---
+name: security-vuln-research
+description: Use this skill when analyzing binaries, fuzzing software, or developing exploits for security research.
+---
 # Vulnerability Research
 
 Use this skill when analyzing binaries, fuzzing software, or developing exploits for security research.

package/skills/strategy/competitive-landscape.md

@@ -1,11 +1,7 @@
-<!--
-skills/strategy/competitive-landscape.md (Competitive Landscape Analysis)
-Use when the team needs a structured read on where competitors sit, what
-customers have already decided, and where defensible whitespace exists.
-Covers Porter Five Forces, Jobs-to-be-Done framing, and competitive
-response sequencing.
--->
-
+---
+name: strategy-competitive-landscape
+description: Use when the team needs a structured read on market positioning before committing direction.
+---
 # Competitive Landscape Analysis
 
 Use when the team needs a structured read on market positioning before committing direction.

package/skills/strategy/market-research-methods.md

@@ -1,11 +1,7 @@
-<!--
-skills/strategy/market-research-methods.md (Market Research Methods)
-Use when planning customer discovery, validating product direction, or
-sizing a market. Covers qualitative and quantitative methods, JTBD
-interview technique, survey design traps, and research-to-decision
-handoff.
--->
-
+---
+name: strategy-market-research-methods
+description: Use when the team needs to validate assumptions before committing resources, or when a decision is being made on vibes rather than signal.
+---
 # Market Research Methods
 
 Use when the team needs to validate assumptions before committing resources, or when a decision is being made on vibes rather than signal.

package/skills/strategy/narrative-arc.md

@@ -1,11 +1,7 @@
-<!--
-skills/strategy/narrative-arc.md (Strategic Narrative Construction)
-Use when drafting a strategy memo, PRD positioning section, board update,
-or fundraising narrative. Covers Andy Raskin's strategic narrative
-structure, the five components of a compelling story, and common failure
-modes in executive communication.
--->
-
+---
+name: strategy-narrative-arc
+description: Use when the argument must move people, not just inform them. Strategic narrative is the difference between a document that gets read and one that changes what people do.
+---
 # Strategic Narrative Construction
 
 Use when the argument must move people, not just inform them. Strategic narrative is the difference between a document that gets read and one that changes what people do.

package/skills/strategy/pricing-positioning.md

@@ -1,11 +1,7 @@
-<!--
-skills/strategy/pricing-positioning.md (Pricing and Positioning)
-Use when setting or revisiting price, defining positioning vs. competitors,
-or preparing a go-to-market argument. Covers value-based vs. cost-plus
-pricing, willingness-to-pay research techniques, and positioning statement
-construction.
--->
-
+---
+name: strategy-pricing-positioning
+description: Use when the team needs to set price, adjust positioning, or defend either to stakeholders.
+---
 # Pricing and Positioning
 
 Use when the team needs to set price, adjust positioning, or defend either to stakeholders.

package/skills/utility/clean-code.md

@@ -1,8 +1,7 @@
-<!--
-skills/utility/clean-code.md (AI Slop Removal) Patterns and heuristics for identifying and removing AI-generated code smells. U
-
-Patterns and heuristics for identifying and removing AI-generated code smells. Use when cleaning up output from AI coding tools. ## Decision Tree
--->
+---
+name: utility-clean-code
+description: Patterns and heuristics for identifying and removing AI-generated code smells. Use when cleaning up output from AI coding tools.
+---
 # AI Slop Removal
 
 Patterns and heuristics for identifying and removing AI-generated code smells. Use when cleaning up output from AI coding tools.

package/specialists/policy-inventory.json

@@ -155,6 +155,20 @@
       "enforcement": "(persona prompt)",
       "mode": "honor-system",
       "description": "Architectural pattern guidance (module boundaries, error handling, async contracts) applied at authoring time."
+    },
+    {
+      "id": "review-before-change",
+      "source": "rules/common/review-before-change.md",
+      "enforcement": "(persona prompt)",
+      "mode": "honor-system",
+      "description": "Requires an existing-artifact audit before authoring or rewriting any durable doc, rule, template, or PRD/ADR/RFC. Extend or supersede; do not duplicate."
+    },
+    {
+      "id": "session-efficiency",
+      "source": "rules/common/efficiency.md",
+      "enforcement": "lib/read-tracker-store.mjs + session-start digest",
+      "mode": "deterministic",
+      "description": "Read discipline, probe-before-bulk-read, and tool parallelism rules. Read counts tracked per-file; the session-start efficiency digest surfaces files crossing the re-read threshold."
     }
   ]
 }