@geraldmaron/construct 1.0.4 → 1.0.6

package/skills/roles/architect.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/architect.md — Anti-pattern guidance for the Architect role.
+skills/roles/architect.md. Anti-pattern guidance for the Architect role.
 
 ## Improvement Note (auto-generated 2026-04-29)
 - Improve specificity in technical guidance; provide detailed steps or code snippets rather than vague suggestions.
@@ -14,11 +14,13 @@ Applies to: cx-architect, cx-rd-lead.
 role: architect
 applies_to: [cx-architect, cx-rd-lead]
 inherits: null
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
-# Architect — Role guidance
+# Architect. Role guidance
 
-Load this before drafting. These are the failure modes that separate strong role output from weak role output — check your draft against each.
+Load this before drafting. These are the failure modes that separate strong role output from weak role output. check your draft against each.
 
 
 ### 1. Premature tech choice
@@ -42,7 +44,7 @@ Load this before drafting. These are the failure modes that separate strong role
 **Counter-move**: label every major decision as one-way or two-way and match the evidence burden to it.
 
 ### 5. Boundary vagueness
-**Symptom**: modules, services, or teams are drawn with arrows but the contracts — inputs, outputs, failure modes — are not specified.
+**Symptom**: modules, services, or teams are drawn with arrows but the contracts. inputs, outputs, failure modes. are not specified.
 **Why it fails**: each team implements its own interpretation; the integration surfaces the gaps in production.
 **Counter-move**: every boundary has a contract. Every contract names its failure modes.
 

package/skills/roles/architect.platform.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/architect.platform.md — Anti-pattern guidance for the Architect.platform (platform) role.
+skills/roles/architect.platform.md. Anti-pattern guidance for the Architect.platform (platform) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the architect.platform (platform) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-architect.
 role: architect.platform
 applies_to: [cx-architect]
 inherits: architect
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Platform Architect Overlay
 

package/skills/roles/data-analyst.experiment.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/data-analyst.experiment.md — Anti-pattern guidance for the Data-analyst.experiment (experiment) role.
+skills/roles/data-analyst.experiment.md. Anti-pattern guidance for the Data-analyst.experiment (experiment) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the data-analyst.experiment (experiment) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-data-analyst.
 role: data-analyst.experiment
 applies_to: [cx-data-analyst]
 inherits: data-analyst
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Experiment Analyst Overlay
 

package/skills/roles/data-analyst.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/data-analyst.md — Anti-pattern guidance for the Data-analyst role.
+skills/roles/data-analyst.md. Anti-pattern guidance for the Data-analyst role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the data-analyst domain and counter-moves to avoid them.
@@ -9,27 +9,29 @@ Applies to: cx-data-analyst.
 role: data-analyst
 applies_to: [cx-data-analyst]
 inherits: null
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
-# Data Analyst — Role guidance
+# Data Analyst. Role guidance
 
-Load this before drafting. These are the failure modes that separate strong role output from weak role output — check your draft against each.
+Load this before drafting. These are the failure modes that separate strong role output from weak role output. check your draft against each.
 
 
 ### 1. Metric without definition
-**Symptom**: a metric cited without its precise definition — which events, what time window, deduplication rules, filters.
+**Symptom**: a metric cited without its precise definition. which events, what time window, deduplication rules, filters.
 **Why it fails**: two teams compute "active users" differently. Decisions rest on numbers nobody can reproduce.
 **Counter-move**: name the metric and its SQL-level or event-level definition before any number. Version the definition.
 
 ### 2. Vanity over outcome
-**Symptom**: reports lead with impressions, pageviews, clicks — activity disconnected from whether users got value.
+**Symptom**: reports lead with impressions, pageviews, clicks. activity disconnected from whether users got value.
 **Why it fails**: rewards teams for moving activity numbers while outcomes stagnate.
 **Counter-move**: tie every vanity metric to an outcome metric. Report both. Lead with the outcome.
 
 ### 3. Ignoring data quality
 **Symptom**: analysis assumes the underlying events fire correctly, are deduped, and have consistent schemas.
 **Why it fails**: real pipelines drop, duplicate, and malform events. Analysis without QA produces confident wrong numbers.
-**Counter-move**: run sanity checks — row counts, null rates, distribution shape, schema checks — before analysis. Report data quality alongside findings.
+**Counter-move**: run sanity checks. row counts, null rates, distribution shape, schema checks. before analysis. Report data quality alongside findings.
 
 ### 4. Correlation as causation
 **Symptom**: "users who did X had higher retention" presented as a reason to make everyone do X.

package/skills/roles/data-analyst.product-intelligence.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/data-analyst.product-intelligence.md — Anti-pattern guidance for the Data-analyst.product-intelligence (product intelligence) role.
+skills/roles/data-analyst.product-intelligence.md. Anti-pattern guidance for the Data-analyst.product-intelligence (product intelligence) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the data-analyst.product-intelligence (product intelligence) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-data-analyst, cx-product-manager.
 role: data-analyst.product-intelligence
 applies_to: [cx-data-analyst, cx-product-manager]
 inherits: data-analyst
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Product Intelligence Analyst Overlay
 

package/skills/roles/data-analyst.product.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/data-analyst.product.md — Anti-pattern guidance for the Data-analyst.product (product) role.
+skills/roles/data-analyst.product.md. Anti-pattern guidance for the Data-analyst.product (product) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the data-analyst.product (product) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-data-analyst.
 role: data-analyst.product
 applies_to: [cx-data-analyst]
 inherits: data-analyst
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Product Analytics Overlay
 

package/skills/roles/data-analyst.telemetry.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/data-analyst.telemetry.md — Anti-pattern guidance for the Data-analyst.telemetry (telemetry) role.
+skills/roles/data-analyst.telemetry.md. Anti-pattern guidance for the Data-analyst.telemetry (telemetry) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the data-analyst.telemetry (telemetry) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-data-analyst, cx-sre.
 role: data-analyst.telemetry
 applies_to: [cx-data-analyst, cx-sre]
 inherits: data-analyst
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Telemetry Analyst Overlay
 

package/skills/roles/data-engineer.pipeline.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/data-engineer.pipeline.md — Anti-pattern guidance for the Data-engineer.pipeline (pipeline) role.
+skills/roles/data-engineer.pipeline.md. Anti-pattern guidance for the Data-engineer.pipeline (pipeline) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the data-engineer.pipeline (pipeline) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-data-engineer.
 role: data-engineer.pipeline
 applies_to: [cx-data-engineer]
 inherits: engineer.data
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Data Pipeline Engineer Overlay
 

package/skills/roles/data-engineer.vector-retrieval.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/data-engineer.vector-retrieval.md — Anti-pattern guidance for the Data-engineer.vector-retrieval (vector retrieval) role.
+skills/roles/data-engineer.vector-retrieval.md. Anti-pattern guidance for the Data-engineer.vector-retrieval (vector retrieval) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the data-engineer.vector-retrieval (vector retrieval) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-data-engineer, cx-ai-engineer.
 role: data-engineer.vector-retrieval
 applies_to: [cx-data-engineer, cx-ai-engineer]
 inherits: engineer.data
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Vector Retrieval Engineer Overlay
 

package/skills/roles/data-engineer.warehouse.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/data-engineer.warehouse.md — Anti-pattern guidance for the Data-engineer.warehouse (warehouse) role.
+skills/roles/data-engineer.warehouse.md. Anti-pattern guidance for the Data-engineer.warehouse (warehouse) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the data-engineer.warehouse (warehouse) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-data-engineer.
 role: data-engineer.warehouse
 applies_to: [cx-data-engineer]
 inherits: engineer.data
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Warehouse Engineer Overlay
 

package/skills/roles/debugger.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/debugger.md — Anti-pattern guidance for the Debugger role.
+skills/roles/debugger.md. Anti-pattern guidance for the Debugger role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the debugger domain and counter-moves to avoid them.
@@ -9,11 +9,13 @@ Applies to: cx-debugger.
 role: debugger
 applies_to: [cx-debugger]
 inherits: null
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
-# Debugger — Role guidance
+# Debugger. Role guidance
 
-Load this before drafting. These are the failure modes that separate strong role output from weak role output — check your draft against each.
+Load this before drafting. These are the failure modes that separate strong role output from weak role output. check your draft against each.
 
 
 ### 1. Fixing the symptom
@@ -63,6 +65,6 @@ Load this before drafting. These are the failure modes that separate strong role
 - [ ] Failure reproduced locally and reproduction preserved as a test
 - [ ] No speculative logs, retries, or sleeps in the fix
 - [ ] Earliest anomaly in the log is the starting point
-- [ ] Diff is narrow — fix only, no drive-bys
+- [ ] Diff is narrow. fix only, no drive-bys
 - [ ] Intermittent failures investigated, not shelved
 - [ ] Regression test added alongside the fix

package/skills/roles/designer.accessibility.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/designer.accessibility.md — Anti-pattern guidance for the Designer.accessibility (accessibility) role.
+skills/roles/designer.accessibility.md. Anti-pattern guidance for the Designer.accessibility (accessibility) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the designer.accessibility (accessibility) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-accessibility.
 role: designer.accessibility
 applies_to: [cx-accessibility]
 inherits: designer
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Accessibility Overlay
 

package/skills/roles/designer.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/designer.md — Anti-pattern guidance for the Designer role.
+skills/roles/designer.md. Anti-pattern guidance for the Designer role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the designer domain and counter-moves to avoid them.
@@ -9,15 +9,17 @@ Applies to: cx-designer, cx-accessibility.
 role: designer
 applies_to: [cx-designer, cx-accessibility]
 inherits: null
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
-# Designer — Role guidance
+# Designer. Role guidance
 
-Load this before drafting. These are the failure modes that separate strong role output from weak role output — check your draft against each.
+Load this before drafting. These are the failure modes that separate strong role output from weak role output. check your draft against each.
 
 
 ### 1. Template defaults
-**Symptom**: the design looks like an unmodified Tailwind, shadcn, or Material page — centered hero, gradient blob, uniform card grid, one accent color.
+**Symptom**: the design looks like an unmodified Tailwind, shadcn, or Material page. centered hero, gradient blob, uniform card grid, one accent color.
 **Why it fails**: nothing about the output communicates product intent. It could be any app.
 **Counter-move**: pick an explicit visual direction before designing. Commit to typography, color, and layout choices specific to the product.
 
@@ -39,12 +41,12 @@ Load this before drafting. These are the failure modes that separate strong role
 ### 5. Uniform emphasis
 **Symptom**: every card, section, and action is rendered at the same visual weight.
 **Why it fails**: the user cannot tell what matters. Attention fails; scanning fails.
-**Counter-move**: use hierarchy — scale, weight, color, spacing — to express importance. One primary action per view.
+**Counter-move**: use hierarchy. scale, weight, color, spacing. to express importance. One primary action per view.
 
 ### 6. Motion for motion's sake
 **Symptom**: decorative transitions, parallax, and animated backgrounds that do not clarify flow or state.
 **Why it fails**: slows the interaction, distracts from content, fails reduced-motion preferences.
-**Counter-move**: motion should clarify — state change, origin-destination, or loading progress. Respect `prefers-reduced-motion`.
+**Counter-move**: motion should clarify. state change, origin-destination, or loading progress. Respect `prefers-reduced-motion`.
 
 ### 7. Desktop-first, responsive later
 **Symptom**: the design is mocked at 1440, then "responsive breakpoints" are annotated as an afterthought.
@@ -54,7 +56,7 @@ Load this before drafting. These are the failure modes that separate strong role
 ### 8. Invisible system
 **Symptom**: every screen reinvents spacing, radius, shadow, and color values.
 **Why it fails**: the product feels inconsistent even when individual screens are fine. Engineering cannot implement cleanly.
-**Counter-move**: name the tokens — space, color, type, radius, motion — before designing. Use them.
+**Counter-move**: name the tokens. space, color, type, radius, motion. before designing. Use them.
 
 ## Self-check before shipping
 

package/skills/roles/engineer.ai.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/engineer.ai.md — Anti-pattern guidance for the Engineer.ai (ai) role.
+skills/roles/engineer.ai.md. Anti-pattern guidance for the Engineer.ai (ai) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the engineer.ai (ai) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-ai-engineer.
 role: engineer.ai
 applies_to: [cx-ai-engineer]
 inherits: engineer
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # AI Engineer Overlay
 

package/skills/roles/engineer.data.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/engineer.data.md — Anti-pattern guidance for the Engineer.data (data) role.
+skills/roles/engineer.data.md. Anti-pattern guidance for the Engineer.data (data) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the engineer.data (data) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-data-engineer.
 role: engineer.data
 applies_to: [cx-data-engineer]
 inherits: engineer
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Data Engineer Overlay
 
@@ -24,7 +26,7 @@ Additional failure modes on top of the engineer core.
 ### 2. No idempotency
 **Symptom**: re-running a job produces duplicates, double-counts, or partial-write corruption.
 **Why it fails**: every retry or backfill becomes a data cleanup event. Oncall pages multiply.
-**Counter-move**: design writes to be idempotent — upsert on natural key, or tag by run-id and replace.
+**Counter-move**: design writes to be idempotent. upsert on natural key, or tag by run-id and replace.
 
 ### 3. Silent data loss
 **Symptom**: ETL rows that fail validation get logged and dropped.

package/skills/roles/engineer.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/engineer.md — Anti-pattern guidance for the Engineer role.
+skills/roles/engineer.md. Anti-pattern guidance for the Engineer role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the engineer domain and counter-moves to avoid them.
@@ -9,11 +9,13 @@ Applies to: cx-engineer, cx-ai-engineer, cx-data-engineer, cx-platform-engineer.
 role: engineer
 applies_to: [cx-engineer, cx-ai-engineer, cx-data-engineer, cx-platform-engineer]
 inherits: null
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
-# Engineer — Role guidance
+# Engineer. Role guidance
 
-Load this before drafting. These are the failure modes that separate strong role output from weak role output — check your draft against each.
+Load this before drafting. These are the failure modes that separate strong role output from weak role output. check your draft against each.
 
 
 ### 1. Writing before reading
@@ -57,7 +59,7 @@ Load this before drafting. These are the failure modes that separate strong role
 **Counter-move**: explain the cause in one sentence before writing the fix. If you cannot, keep investigating.
 
 ### 9. Ignoring the diff
-**Symptom**: the change includes unrelated edits — formatting churn, drive-by renames, comment cleanups.
+**Symptom**: the change includes unrelated edits. formatting churn, drive-by renames, comment cleanups.
 **Why it fails**: drowns the real change in noise; reviewers cannot separate intent from accident.
 **Counter-move**: one change per commit. Keep the diff narrow. Bank the drive-bys for a separate PR.
 
@@ -68,7 +70,7 @@ Load this before drafting. These are the failure modes that separate strong role
 
 ### 11. Unbounded file reads
 **Symptom**: reading files with large `limit` values without checking size first, or offset reads that fail with "out of range".
-**Why it fails**: wastes context, and the failure reveals the file was smaller than assumed — a signal that the reading strategy was guess-driven.
+**Why it fails**: wastes context, and the failure reveals the file was smaller than assumed. a signal that the reading strategy was guess-driven.
 **Counter-move**: before any `Read` over 200 lines, probe with `Glob`, `wc -l`, or a `limit: 50` read. Then request the right range.
 
 ## Self-check before shipping
@@ -84,15 +86,15 @@ Load this before drafting. These are the failure modes that separate strong role
 - [ ] No more than two consecutive thinking turns about the same decision without a tool call or input
 - [ ] Any `Read` over 200 lines was preceded by a size probe
 
-## Hard release gates (blocking, run locally — never push and pray)
+## Hard release gates (blocking, run locally. never push and pray)
 
 Run all four before declaring work done. CI is a backstop, not the primary gate. See `rules/common/release-gates.md`.
 
-- [ ] `npm test` — 0 failed
-- [ ] `node bin/construct lint:comments` — 0 errors AND 0 warnings
-- [ ] `node bin/construct docs:verify` — all checks passed, no warnings
-- [ ] `node bin/construct docs:update --check` — AUTO regions clean
-- [ ] `npm run lint:templates` — commit subjects + PR body match templates
+- [ ] `npm test`. 0 failed
+- [ ] `node bin/construct lint:comments`. 0 errors AND 0 warnings
+- [ ] `node bin/construct docs:verify`. all checks passed, no warnings
+- [ ] `node bin/construct docs:update --check`. AUTO regions clean
+- [ ] `npm run lint:templates`. commit subjects + PR body match templates
 
 Shortcut: `npm run release:check`.
 

package/skills/roles/engineer.platform.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/engineer.platform.md — Anti-pattern guidance for the Engineer.platform (platform) role.
+skills/roles/engineer.platform.md. Anti-pattern guidance for the Engineer.platform (platform) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the engineer.platform (platform) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-platform-engineer.
 role: engineer.platform
 applies_to: [cx-platform-engineer]
 inherits: engineer
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Platform Engineer Overlay
 
@@ -38,7 +40,7 @@ Additional failure modes on top of the engineer core.
 
 ### 5. Security as afterthought
 **Symptom**: CI secrets in plaintext env, broad GitHub tokens, no SBOM, no dependency audit in the pipeline.
-**Why it fails**: platform surface area compounds blast radius — one leaked token touches every repo.
+**Why it fails**: platform surface area compounds blast radius. one leaked token touches every repo.
 **Counter-move**: treat platform secrets as production secrets. Rotate, scope-minimize, and audit.
 
 ## Self-check before shipping

package/skills/roles/operator.docs.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/operator.docs.md — Anti-pattern guidance for the Operator.docs (docs) role.
+skills/roles/operator.docs.md. Anti-pattern guidance for the Operator.docs (docs) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the operator.docs (docs) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-docs-keeper.
 role: operator.docs
 applies_to: [cx-docs-keeper]
 inherits: operator
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Docs Keeper Overlay
 
@@ -18,11 +20,11 @@ Additional failure modes on top of the operator core.
 
 ### 1. Docs as write-once artifacts
 **Symptom**: a decision record or runbook is created, then never revisited as the system evolves.
-**Why it fails**: stale docs are worse than no docs — they mislead with authority.
+**Why it fails**: stale docs are worse than no docs. they mislead with authority.
 **Counter-move**: every doc has a `last-reviewed` date. Flag anything older than the agreed review cadence.
 
 ### 2. Parallel sources of truth
-**Symptom**: the same concept explained in README, wiki, CLAUDE.md, and onboarding deck — all slightly different.
+**Symptom**: the same concept explained in README, wiki, CLAUDE.md, and onboarding deck. all slightly different.
 **Why it fails**: readers find one, act on it, hit contradictions later; trust erodes.
 **Counter-move**: one canonical source per concept. Link to it from all surfaces.
 

package/skills/roles/operator.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/operator.md — Anti-pattern guidance for the Operator role.
+skills/roles/operator.md. Anti-pattern guidance for the Operator role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the operator domain and counter-moves to avoid them.
@@ -9,11 +9,13 @@ Applies to: cx-sre, cx-operations, cx-release-manager, cx-docs-keeper.
 role: operator
 applies_to: [cx-sre, cx-operations, cx-release-manager, cx-docs-keeper]
 inherits: null
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
-# Operator — Role guidance
+# Operator. Role guidance
 
-Load this before producing operator output — SRE, ops, release, and durable-knowledge work.
+Load this before producing operator output. SRE, ops, release, and durable-knowledge work.
 
 
 ### 1. Runbook by incantation

package/skills/roles/operator.release.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/operator.release.md — Anti-pattern guidance for the Operator.release (release) role.
+skills/roles/operator.release.md. Anti-pattern guidance for the Operator.release (release) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the operator.release (release) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-release-manager.
 role: operator.release
 applies_to: [cx-release-manager]
 inherits: operator
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Release Manager Overlay
 

package/skills/roles/operator.sre.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/operator.sre.md — Anti-pattern guidance for the Operator.sre (sre) role.
+skills/roles/operator.sre.md. Anti-pattern guidance for the Operator.sre (sre) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the operator.sre (sre) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-sre.
 role: operator.sre
 applies_to: [cx-sre]
 inherits: operator
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # SRE Overlay
 
@@ -24,7 +26,7 @@ Additional failure modes on top of the operator core.
 ### 2. SLOs without error budgets
 **Symptom**: publishing an SLO (e.g., 99.9% availability) with no policy for what happens when it's breached.
 **Why it fails**: the SLO becomes decorative; feature work continues to burn reliability.
-**Counter-move**: define the error budget policy up front — what freezes, who's notified, when it resumes.
+**Counter-move**: define the error budget policy up front. what freezes, who's notified, when it resumes.
 
 ### 3. Dashboards of everything
 **Symptom**: 40-panel dashboards covering every metric the team could expose.

package/skills/roles/orchestrator.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/orchestrator.md — Anti-pattern guidance for the Orchestrator role.
+skills/roles/orchestrator.md. Anti-pattern guidance for the Orchestrator role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the orchestrator domain and counter-moves to avoid them.
@@ -9,9 +9,11 @@ Applies to: cx-orchestrator.
 role: orchestrator
 applies_to: [cx-orchestrator]
 inherits: null
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
-# Orchestrator — Role guidance
+# Orchestrator. Role guidance
 
 Use this as a fast dispatch checklist before producing orchestration output.
 

package/skills/roles/product-manager.ai-product.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/product-manager.ai-product.md — Anti-pattern guidance for the Product-manager.ai-product (ai product) role.
+skills/roles/product-manager.ai-product.md. Anti-pattern guidance for the Product-manager.ai-product (ai product) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the product-manager.ai-product (ai product) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-product-manager.
 role: product-manager.ai-product
 applies_to: [cx-product-manager]
 inherits: product-manager
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # AI Product PM Overlay
 

package/skills/roles/product-manager.business-strategy.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/product-manager.business-strategy.md — Anti-pattern guidance for the Product-manager.business-strategy (business strategy) role.
+skills/roles/product-manager.business-strategy.md. Anti-pattern guidance for the Product-manager.business-strategy (business strategy) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the product-manager.business-strategy (business strategy) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-business-strategist.
 role: product-manager.business-strategy
 applies_to: [cx-business-strategist]
 inherits: product-manager
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Business Strategy Overlay
 

package/skills/roles/product-manager.enterprise.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/product-manager.enterprise.md — Anti-pattern guidance for the Product-manager.enterprise (enterprise) role.
+skills/roles/product-manager.enterprise.md. Anti-pattern guidance for the Product-manager.enterprise (enterprise) role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the product-manager.enterprise (enterprise) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-product-manager.
 role: product-manager.enterprise
 applies_to: [cx-product-manager]
 inherits: product-manager
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Enterprise PM Overlay