@geraldmaron/construct 1.0.4 → 1.0.5

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
 

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

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

package/skills/roles/product-manager.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/product-manager.md — Anti-pattern guidance for the Product-manager role.
+skills/roles/product-manager.md. Anti-pattern guidance for the Product-manager role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the product-manager domain and counter-moves to avoid them.
@@ -9,11 +9,13 @@ Applies to: cx-product-manager, cx-business-strategist.
 role: product-manager
 applies_to: [cx-product-manager, cx-business-strategist]
 inherits: null
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
-# Product Manager — Role guidance
+# Product Manager. 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. Solution in the problem statement

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

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

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

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

package/skills/roles/qa.ai-eval.md

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

package/skills/roles/qa.api-contract.md

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

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

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

package/skills/roles/qa.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/qa.md — Anti-pattern guidance for the Qa role.
+skills/roles/qa.md. Anti-pattern guidance for the Qa role.
 
 Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
 Covers common failure modes for the qa domain and counter-moves to avoid them.
@@ -9,15 +9,17 @@ Applies to: cx-qa, cx-test-automation.
 role: qa
 applies_to: [cx-qa, cx-test-automation]
 inherits: null
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
-# QA — Role guidance
+# QA. 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. Testing the mock
-**Symptom**: the test asserts that the mock was called with the expected arguments — and that is all it asserts.
+**Symptom**: the test asserts that the mock was called with the expected arguments. and that is all it asserts.
 **Why it fails**: the test passes regardless of whether the real system would. Mocks drift from the real contract silently.
 **Counter-move**: assert on observable outputs or state. Use mocks for isolation, not as the thing being tested.
 

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

@@ -1,5 +1,5 @@
 <!--
-skills/roles/qa.test-automation.md — Anti-pattern guidance for the Qa.test-automation (test automation) role.
+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.
@@ -9,7 +9,9 @@ Applies to: cx-test-automation.
 role: qa.test-automation
 applies_to: [cx-test-automation]
 inherits: qa
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Test Automation Overlay
 
@@ -18,7 +20,7 @@ Additional failure modes on top of the qa core.
 
 ### 1. Flaky tests tolerated
 **Symptom**: tests retried until green; flakes treated as "environmental noise."
-**Why it fails**: signal erodes — real regressions hide among the flakes. Developers stop trusting the suite.
+**Why it fails**: signal erodes. real regressions hide among the flakes. Developers stop trusting the suite.
 **Counter-move**: quarantine flakes immediately with a tracking ticket. Target zero retries for trusted tests.
 
 ### 2. E2E-heavy pyramid

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

@@ -1,5 +1,5 @@
 <!--
-skills/roles/qa.web-ui.md — Anti-pattern guidance for the Qa.web-ui (web ui) role.
+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.
@@ -9,7 +9,9 @@ Applies to: cx-qa, cx-test-automation.
 role: qa.web-ui
 applies_to: [cx-qa, cx-test-automation]
 inherits: qa
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Web UI QA Overlay
 

package/skills/roles/researcher.explorer.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/researcher.explorer.md — Anti-pattern guidance for the Researcher.explorer (explorer) role.
+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.
@@ -9,7 +9,9 @@ Applies to: cx-explorer.
 role: researcher.explorer
 applies_to: [cx-explorer]
 inherits: researcher
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Codebase Explorer Overlay
 

package/skills/roles/researcher.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/researcher.md — Anti-pattern guidance for the Researcher role.
+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.
@@ -9,11 +9,13 @@ Applies to: cx-researcher, cx-ux-researcher, cx-explorer.
 role: researcher
 applies_to: [cx-researcher, cx-ux-researcher, cx-explorer]
 inherits: null
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
-# Researcher — Role guidance
+# Researcher. 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. Confirmation bias
@@ -27,17 +29,17 @@ Load this before drafting. These are the failure modes that separate strong role
 **Counter-move**: require at least two independent sources for each load-bearing claim. Note when they disagree.
 
 ### 3. Freshness blindness
-**Symptom**: cited source dated 2019–2024 used as current for a fast-moving topic — AI capabilities, framework APIs, security advisories.
+**Symptom**: cited source dated 2019–2024 used as current for a fast-moving topic. AI capabilities, framework APIs, security advisories.
 **Why it fails**: the reader assumes the finding is current; acts on stale information.
 **Counter-move**: start searches from the most recent year and step backward only if insufficient. Record the publication date of every source. For fast-moving topics (LLM behavior, security advisories, market data), treat anything older than 12 months as presumptively stale unless a newer source confirms it is still accurate.
 
 ### 4. Wrong starting point
-**Symptom**: searching Google or a general index when a domain-specific authoritative source exists — arXiv for AI research, NVD for CVEs, NeurIPS/ICML proceedings for ML, official vendor docs for APIs.
+**Symptom**: searching Google or a general index when a domain-specific authoritative source exists. arXiv for AI research, NVD for CVEs, NeurIPS/ICML proceedings for ML, official vendor docs for APIs.
 **Why it fails**: general search returns popularity-ranked results, not authority-ranked ones. The most-cited blog post is not the same as the primary paper.
 **Counter-move**: use the domain's authoritative starting point first (see `rules/common/research.md` §2). Only fall back to general search if the authoritative source is insufficient.
 
 ### 5. Unverified URLs
-**Symptom**: URLs included in the brief have not been fetched — the researcher copied them from a search result or from memory.
+**Symptom**: URLs included in the brief have not been fetched. the researcher copied them from a search result or from memory.
 **Why it fails**: URLs rot. A confident citation pointing to a 404 or a different page than intended is worse than no citation.
 **Counter-move**: fetch every URL before including it. Confirm the content matches the cited claim. Mark any URL that cannot be fetched `[unverified]` and flag it as a gap.
 
@@ -54,7 +56,7 @@ Load this before drafting. These are the failure modes that separate strong role
 ### 8. Secondary sources passed as primary
 **Symptom**: citations point to summaries, listicles, or syntheses instead of the underlying paper, spec, or changelog.
 **Why it fails**: the summary may misrepresent the primary source. The chain of error is invisible.
-**Counter-move**: cite primary sources — the actual paper, spec, commit, or dataset. Use secondary sources only to discover primary ones.
+**Counter-move**: cite primary sources. the actual paper, spec, commit, or dataset. Use secondary sources only to discover primary ones.
 
 ### 9. Scope creep
 **Symptom**: the research question was about X but the brief covers X, Y, and Z because they came up.
@@ -75,7 +77,7 @@ Load this before drafting. These are the failure modes that separate strong role
 - [ ] Each load-bearing claim has at least two independent sources (or one authoritative primary)
 - [ ] Source dates recorded; fast-moving topics use sources within last 12 months
 - [ ] Each finding labeled with confidence (high/medium/low) and one-line reason
-- [ ] Observation separated from inference — labeled differently
+- [ ] Observation separated from inference. labeled differently
 - [ ] Citations point to primary sources, not summaries or index pages
 - [ ] Original question answered first; tangents in a separate section
 - [ ] Evidence threshold for the recommendation is stated explicitly

package/skills/roles/researcher.ux.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/researcher.ux.md — Anti-pattern guidance for the Researcher.ux (ux) role.
+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.
@@ -9,7 +9,9 @@ Applies to: cx-ux-researcher.
 role: researcher.ux
 applies_to: [cx-ux-researcher]
 inherits: researcher
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # UX Researcher Overlay
 

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

@@ -1,5 +1,5 @@
 <!--
-skills/roles/reviewer.devil-advocate.md — Anti-pattern guidance for the Reviewer.devil-advocate (devil advocate) role.
+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.
@@ -9,7 +9,9 @@ Applies to: cx-devil-advocate.
 role: reviewer.devil-advocate
 applies_to: [cx-devil-advocate]
 inherits: reviewer
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Devil's Advocate Overlay
 

package/skills/roles/reviewer.evaluator.md

@@ -1,5 +1,5 @@
 <!--
-skills/roles/reviewer.evaluator.md — Anti-pattern guidance for the Reviewer.evaluator (evaluator) role.
+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.
@@ -9,7 +9,9 @@ Applies to: cx-evaluator.
 role: reviewer.evaluator
 applies_to: [cx-evaluator]
 inherits: reviewer
-version: 1
+version: 2
+profiles: [rnd]
+cap: 1
 ---
 # Evaluator Overlay