@geraldmaron/construct 1.0.3 → 1.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (157) hide show
  1. package/README.md +51 -42
  2. package/agents/prompts/cx-ai-engineer.md +6 -26
  3. package/agents/prompts/cx-architect.md +1 -0
  4. package/agents/prompts/cx-business-strategist.md +2 -0
  5. package/agents/prompts/cx-data-analyst.md +6 -26
  6. package/agents/prompts/cx-docs-keeper.md +1 -31
  7. package/agents/prompts/cx-explorer.md +1 -0
  8. package/agents/prompts/cx-orchestrator.md +40 -112
  9. package/agents/prompts/cx-platform-engineer.md +2 -22
  10. package/agents/prompts/cx-product-manager.md +2 -1
  11. package/agents/prompts/cx-qa.md +0 -20
  12. package/agents/prompts/cx-rd-lead.md +2 -0
  13. package/agents/prompts/cx-researcher.md +77 -31
  14. package/agents/prompts/cx-security.md +11 -49
  15. package/agents/prompts/cx-sre.md +9 -43
  16. package/agents/prompts/cx-ux-researcher.md +1 -0
  17. package/agents/role-manifests.json +4 -4
  18. package/bin/construct +279 -4
  19. package/commands/understand/research.md +5 -3
  20. package/db/schema/004_recommendations.sql +46 -0
  21. package/db/schema/005_strategy.sql +21 -0
  22. package/lib/auto-docs.mjs +3 -4
  23. package/lib/beads-automation.mjs +16 -7
  24. package/lib/cli-commands.mjs +52 -2
  25. package/lib/comment-lint.mjs +7 -1
  26. package/lib/config/schema.mjs +3 -0
  27. package/lib/embed/conflict-detection.mjs +26 -9
  28. package/lib/embed/customer-profiles.mjs +37 -17
  29. package/lib/embed/daemon.mjs +10 -8
  30. package/lib/embed/recommendation-store.mjs +213 -14
  31. package/lib/embed/workspaces.mjs +53 -18
  32. package/lib/flavors/loader.mjs +136 -0
  33. package/lib/gates-audit.mjs +3 -3
  34. package/lib/health-check.mjs +1 -1
  35. package/lib/hooks/agent-tracker.mjs +22 -3
  36. package/lib/hooks/pre-compact.mjs +3 -0
  37. package/lib/hooks/pre-push-gate.mjs +14 -1
  38. package/lib/hooks/read-tracker.mjs +10 -101
  39. package/lib/hooks/session-optimize.mjs +3 -2
  40. package/lib/hooks/session-reflect.mjs +68 -0
  41. package/lib/host-capabilities.mjs +90 -1
  42. package/lib/init-unified.mjs +25 -2
  43. package/lib/init-update.mjs +246 -131
  44. package/lib/intake/classify.mjs +61 -183
  45. package/lib/intake/prepare.mjs +7 -0
  46. package/lib/intake/tables/creative.mjs +94 -0
  47. package/lib/intake/tables/operations.mjs +85 -0
  48. package/lib/intake/tables/research.mjs +85 -0
  49. package/lib/intake/tables/rnd.mjs +175 -0
  50. package/lib/intent-classifier.mjs +1 -0
  51. package/lib/knowledge/layout.mjs +10 -0
  52. package/lib/knowledge/research-store.mjs +109 -0
  53. package/lib/mcp/tools/telemetry.mjs +30 -78
  54. package/lib/model-router.mjs +61 -1
  55. package/lib/observation-store.mjs +19 -0
  56. package/lib/ollama-manager.mjs +1 -1
  57. package/lib/opencode-telemetry.mjs +4 -5
  58. package/lib/orchestration-policy.mjs +9 -0
  59. package/lib/outcomes/aggregate.mjs +104 -0
  60. package/lib/outcomes/record.mjs +115 -0
  61. package/lib/parity.mjs +121 -21
  62. package/lib/profiles/lifecycle.mjs +388 -0
  63. package/lib/profiles/loader.mjs +123 -0
  64. package/lib/profiles/validate-custom.mjs +114 -0
  65. package/lib/prompt-composer.js +106 -29
  66. package/lib/read-tracker-store.mjs +149 -0
  67. package/lib/reflect/extractor.mjs +193 -0
  68. package/lib/reflect.mjs +89 -2
  69. package/lib/sandbox.mjs +102 -0
  70. package/lib/server/index.mjs +76 -0
  71. package/lib/server/telemetry-login.mjs +17 -25
  72. package/lib/service-manager.mjs +30 -22
  73. package/lib/services/local-postgres.mjs +15 -0
  74. package/lib/services/telemetry-backend.mjs +1 -2
  75. package/lib/setup.mjs +8 -43
  76. package/lib/status.mjs +51 -5
  77. package/lib/storage/backend.mjs +12 -2
  78. package/lib/strategy-store.mjs +371 -0
  79. package/lib/telemetry/backends/local.mjs +6 -4
  80. package/lib/telemetry/client.mjs +185 -0
  81. package/lib/telemetry/ingest.mjs +13 -5
  82. package/lib/telemetry/team-rollup.mjs +9 -2
  83. package/lib/worker/trace.mjs +17 -27
  84. package/package.json +10 -2
  85. package/personas/construct.md +20 -20
  86. package/platforms/claude/settings.template.json +13 -0
  87. package/rules/common/research.md +44 -12
  88. package/scripts/sync-agents.mjs +11 -0
  89. package/skills/docs/backlog-proposal-workflow.md +2 -2
  90. package/skills/docs/customer-profile-workflow.md +1 -1
  91. package/skills/docs/evidence-ingest-workflow.md +5 -5
  92. package/skills/docs/prfaq-workflow.md +1 -1
  93. package/skills/docs/product-intelligence-review.md +1 -1
  94. package/skills/docs/product-intelligence-workflow.md +3 -3
  95. package/skills/docs/product-signal-workflow.md +48 -18
  96. package/skills/docs/research-workflow.md +26 -14
  97. package/skills/docs/strategy-workflow.md +36 -0
  98. package/skills/roles/architect.ai-systems.md +4 -2
  99. package/skills/roles/architect.data.md +4 -2
  100. package/skills/roles/architect.enterprise.md +4 -2
  101. package/skills/roles/architect.integration.md +4 -2
  102. package/skills/roles/architect.md +7 -5
  103. package/skills/roles/architect.platform.md +4 -2
  104. package/skills/roles/data-analyst.experiment.md +4 -2
  105. package/skills/roles/data-analyst.md +9 -7
  106. package/skills/roles/data-analyst.product-intelligence.md +5 -3
  107. package/skills/roles/data-analyst.product.md +4 -2
  108. package/skills/roles/data-analyst.telemetry.md +4 -2
  109. package/skills/roles/data-engineer.pipeline.md +4 -2
  110. package/skills/roles/data-engineer.vector-retrieval.md +4 -2
  111. package/skills/roles/data-engineer.warehouse.md +4 -2
  112. package/skills/roles/debugger.md +7 -5
  113. package/skills/roles/designer.accessibility.md +4 -2
  114. package/skills/roles/designer.md +10 -8
  115. package/skills/roles/engineer.ai.md +4 -2
  116. package/skills/roles/engineer.data.md +5 -3
  117. package/skills/roles/engineer.md +14 -12
  118. package/skills/roles/engineer.platform.md +5 -3
  119. package/skills/roles/operator.docs.md +6 -4
  120. package/skills/roles/operator.md +6 -4
  121. package/skills/roles/operator.release.md +4 -2
  122. package/skills/roles/operator.sre.md +5 -3
  123. package/skills/roles/orchestrator.md +5 -3
  124. package/skills/roles/product-manager.ai-product.md +4 -2
  125. package/skills/roles/product-manager.business-strategy.md +4 -2
  126. package/skills/roles/product-manager.enterprise.md +4 -2
  127. package/skills/roles/product-manager.growth.md +4 -2
  128. package/skills/roles/product-manager.md +6 -4
  129. package/skills/roles/product-manager.platform.md +4 -2
  130. package/skills/roles/product-manager.product.md +4 -2
  131. package/skills/roles/qa.ai-eval.md +4 -2
  132. package/skills/roles/qa.api-contract.md +4 -2
  133. package/skills/roles/qa.data-pipeline.md +4 -2
  134. package/skills/roles/qa.md +7 -5
  135. package/skills/roles/qa.test-automation.md +5 -3
  136. package/skills/roles/qa.web-ui.md +4 -2
  137. package/skills/roles/researcher.explorer.md +4 -2
  138. package/skills/roles/researcher.md +35 -20
  139. package/skills/roles/researcher.ux.md +4 -2
  140. package/skills/roles/reviewer.devil-advocate.md +4 -2
  141. package/skills/roles/reviewer.evaluator.md +4 -2
  142. package/skills/roles/reviewer.md +14 -12
  143. package/skills/roles/reviewer.trace.md +4 -2
  144. package/skills/roles/security.ai.md +4 -2
  145. package/skills/roles/security.appsec.md +4 -2
  146. package/skills/roles/security.cloud.md +4 -2
  147. package/skills/roles/security.legal-compliance.md +4 -2
  148. package/skills/roles/security.md +7 -5
  149. package/skills/roles/security.privacy.md +4 -2
  150. package/skills/roles/security.supply-chain.md +4 -2
  151. package/skills/routing.md +8 -1
  152. package/templates/docs/persona-artifact.md +36 -0
  153. package/templates/docs/research-brief.md +63 -9
  154. package/templates/docs/research-finding.md +26 -0
  155. package/templates/docs/skill-artifact.md +27 -0
  156. package/templates/docs/strategy.md +36 -0
  157. package/templates/homebrew/construct.rb +6 -6
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/designer.md Anti-pattern guidance for the Designer role.
2
+ skills/roles/designer.md. Anti-pattern guidance for the Designer role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  Covers common failure modes for the designer domain and counter-moves to avoid them.
@@ -9,15 +9,17 @@ Applies to: cx-designer, cx-accessibility.
9
9
  role: designer
10
10
  applies_to: [cx-designer, cx-accessibility]
11
11
  inherits: null
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
- # Designer Role guidance
16
+ # Designer. Role guidance
15
17
 
16
- Load this before drafting. These are the failure modes that separate strong role output from weak role output check your draft against each.
18
+ Load this before drafting. These are the failure modes that separate strong role output from weak role output. check your draft against each.
17
19
 
18
20
 
19
21
  ### 1. Template defaults
20
- **Symptom**: the design looks like an unmodified Tailwind, shadcn, or Material page centered hero, gradient blob, uniform card grid, one accent color.
22
+ **Symptom**: the design looks like an unmodified Tailwind, shadcn, or Material page. centered hero, gradient blob, uniform card grid, one accent color.
21
23
  **Why it fails**: nothing about the output communicates product intent. It could be any app.
22
24
  **Counter-move**: pick an explicit visual direction before designing. Commit to typography, color, and layout choices specific to the product.
23
25
 
@@ -39,12 +41,12 @@ Load this before drafting. These are the failure modes that separate strong role
39
41
  ### 5. Uniform emphasis
40
42
  **Symptom**: every card, section, and action is rendered at the same visual weight.
41
43
  **Why it fails**: the user cannot tell what matters. Attention fails; scanning fails.
42
- **Counter-move**: use hierarchy scale, weight, color, spacing to express importance. One primary action per view.
44
+ **Counter-move**: use hierarchy. scale, weight, color, spacing. to express importance. One primary action per view.
43
45
 
44
46
  ### 6. Motion for motion's sake
45
47
  **Symptom**: decorative transitions, parallax, and animated backgrounds that do not clarify flow or state.
46
48
  **Why it fails**: slows the interaction, distracts from content, fails reduced-motion preferences.
47
- **Counter-move**: motion should clarify state change, origin-destination, or loading progress. Respect `prefers-reduced-motion`.
49
+ **Counter-move**: motion should clarify. state change, origin-destination, or loading progress. Respect `prefers-reduced-motion`.
48
50
 
49
51
  ### 7. Desktop-first, responsive later
50
52
  **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
54
56
  ### 8. Invisible system
55
57
  **Symptom**: every screen reinvents spacing, radius, shadow, and color values.
56
58
  **Why it fails**: the product feels inconsistent even when individual screens are fine. Engineering cannot implement cleanly.
57
- **Counter-move**: name the tokens space, color, type, radius, motion before designing. Use them.
59
+ **Counter-move**: name the tokens. space, color, type, radius, motion. before designing. Use them.
58
60
 
59
61
  ## Self-check before shipping
60
62
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/engineer.ai.md Anti-pattern guidance for the Engineer.ai (ai) role.
2
+ skills/roles/engineer.ai.md. Anti-pattern guidance for the Engineer.ai (ai) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: engineer.ai
10
10
  applies_to: [cx-ai-engineer]
11
11
  inherits: engineer
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # AI Engineer Overlay
15
17
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/engineer.data.md Anti-pattern guidance for the Engineer.data (data) role.
2
+ skills/roles/engineer.data.md. Anti-pattern guidance for the Engineer.data (data) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: engineer.data
10
10
  applies_to: [cx-data-engineer]
11
11
  inherits: engineer
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Data Engineer Overlay
15
17
 
@@ -24,7 +26,7 @@ Additional failure modes on top of the engineer core.
24
26
  ### 2. No idempotency
25
27
  **Symptom**: re-running a job produces duplicates, double-counts, or partial-write corruption.
26
28
  **Why it fails**: every retry or backfill becomes a data cleanup event. Oncall pages multiply.
27
- **Counter-move**: design writes to be idempotent upsert on natural key, or tag by run-id and replace.
29
+ **Counter-move**: design writes to be idempotent. upsert on natural key, or tag by run-id and replace.
28
30
 
29
31
  ### 3. Silent data loss
30
32
  **Symptom**: ETL rows that fail validation get logged and dropped.
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/engineer.md Anti-pattern guidance for the Engineer role.
2
+ skills/roles/engineer.md. Anti-pattern guidance for the Engineer role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: engineer
10
10
  applies_to: [cx-engineer, cx-ai-engineer, cx-data-engineer, cx-platform-engineer]
11
11
  inherits: null
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
- # Engineer Role guidance
16
+ # Engineer. Role guidance
15
17
 
16
- Load this before drafting. These are the failure modes that separate strong role output from weak role output check your draft against each.
18
+ Load this before drafting. These are the failure modes that separate strong role output from weak role output. check your draft against each.
17
19
 
18
20
 
19
21
  ### 1. Writing before reading
@@ -57,7 +59,7 @@ Load this before drafting. These are the failure modes that separate strong role
57
59
  **Counter-move**: explain the cause in one sentence before writing the fix. If you cannot, keep investigating.
58
60
 
59
61
  ### 9. Ignoring the diff
60
- **Symptom**: the change includes unrelated edits formatting churn, drive-by renames, comment cleanups.
62
+ **Symptom**: the change includes unrelated edits. formatting churn, drive-by renames, comment cleanups.
61
63
  **Why it fails**: drowns the real change in noise; reviewers cannot separate intent from accident.
62
64
  **Counter-move**: one change per commit. Keep the diff narrow. Bank the drive-bys for a separate PR.
63
65
 
@@ -68,7 +70,7 @@ Load this before drafting. These are the failure modes that separate strong role
68
70
 
69
71
  ### 11. Unbounded file reads
70
72
  **Symptom**: reading files with large `limit` values without checking size first, or offset reads that fail with "out of range".
71
- **Why it fails**: wastes context, and the failure reveals the file was smaller than assumed a signal that the reading strategy was guess-driven.
73
+ **Why it fails**: wastes context, and the failure reveals the file was smaller than assumed. a signal that the reading strategy was guess-driven.
72
74
  **Counter-move**: before any `Read` over 200 lines, probe with `Glob`, `wc -l`, or a `limit: 50` read. Then request the right range.
73
75
 
74
76
  ## Self-check before shipping
@@ -84,15 +86,15 @@ Load this before drafting. These are the failure modes that separate strong role
84
86
  - [ ] No more than two consecutive thinking turns about the same decision without a tool call or input
85
87
  - [ ] Any `Read` over 200 lines was preceded by a size probe
86
88
 
87
- ## Hard release gates (blocking, run locally never push and pray)
89
+ ## Hard release gates (blocking, run locally. never push and pray)
88
90
 
89
91
  Run all four before declaring work done. CI is a backstop, not the primary gate. See `rules/common/release-gates.md`.
90
92
 
91
- - [ ] `npm test` 0 failed
92
- - [ ] `node bin/construct lint:comments` 0 errors AND 0 warnings
93
- - [ ] `node bin/construct docs:verify` all checks passed, no warnings
94
- - [ ] `node bin/construct docs:update --check` AUTO regions clean
95
- - [ ] `npm run lint:templates` commit subjects + PR body match templates
93
+ - [ ] `npm test`. 0 failed
94
+ - [ ] `node bin/construct lint:comments`. 0 errors AND 0 warnings
95
+ - [ ] `node bin/construct docs:verify`. all checks passed, no warnings
96
+ - [ ] `node bin/construct docs:update --check`. AUTO regions clean
97
+ - [ ] `npm run lint:templates`. commit subjects + PR body match templates
96
98
 
97
99
  Shortcut: `npm run release:check`.
98
100
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/engineer.platform.md Anti-pattern guidance for the Engineer.platform (platform) role.
2
+ skills/roles/engineer.platform.md. Anti-pattern guidance for the Engineer.platform (platform) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: engineer.platform
10
10
  applies_to: [cx-platform-engineer]
11
11
  inherits: engineer
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Platform Engineer Overlay
15
17
 
@@ -38,7 +40,7 @@ Additional failure modes on top of the engineer core.
38
40
 
39
41
  ### 5. Security as afterthought
40
42
  **Symptom**: CI secrets in plaintext env, broad GitHub tokens, no SBOM, no dependency audit in the pipeline.
41
- **Why it fails**: platform surface area compounds blast radius one leaked token touches every repo.
43
+ **Why it fails**: platform surface area compounds blast radius. one leaked token touches every repo.
42
44
  **Counter-move**: treat platform secrets as production secrets. Rotate, scope-minimize, and audit.
43
45
 
44
46
  ## Self-check before shipping
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/operator.docs.md Anti-pattern guidance for the Operator.docs (docs) role.
2
+ skills/roles/operator.docs.md. Anti-pattern guidance for the Operator.docs (docs) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: operator.docs
10
10
  applies_to: [cx-docs-keeper]
11
11
  inherits: operator
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Docs Keeper Overlay
15
17
 
@@ -18,11 +20,11 @@ Additional failure modes on top of the operator core.
18
20
 
19
21
  ### 1. Docs as write-once artifacts
20
22
  **Symptom**: a decision record or runbook is created, then never revisited as the system evolves.
21
- **Why it fails**: stale docs are worse than no docs they mislead with authority.
23
+ **Why it fails**: stale docs are worse than no docs. they mislead with authority.
22
24
  **Counter-move**: every doc has a `last-reviewed` date. Flag anything older than the agreed review cadence.
23
25
 
24
26
  ### 2. Parallel sources of truth
25
- **Symptom**: the same concept explained in README, wiki, CLAUDE.md, and onboarding deck all slightly different.
27
+ **Symptom**: the same concept explained in README, wiki, CLAUDE.md, and onboarding deck. all slightly different.
26
28
  **Why it fails**: readers find one, act on it, hit contradictions later; trust erodes.
27
29
  **Counter-move**: one canonical source per concept. Link to it from all surfaces.
28
30
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/operator.md Anti-pattern guidance for the Operator role.
2
+ skills/roles/operator.md. Anti-pattern guidance for the Operator role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: operator
10
10
  applies_to: [cx-sre, cx-operations, cx-release-manager, cx-docs-keeper]
11
11
  inherits: null
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
- # Operator Role guidance
16
+ # Operator. Role guidance
15
17
 
16
- Load this before producing operator output SRE, ops, release, and durable-knowledge work.
18
+ Load this before producing operator output. SRE, ops, release, and durable-knowledge work.
17
19
 
18
20
 
19
21
  ### 1. Runbook by incantation
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/operator.release.md Anti-pattern guidance for the Operator.release (release) role.
2
+ skills/roles/operator.release.md. Anti-pattern guidance for the Operator.release (release) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: operator.release
10
10
  applies_to: [cx-release-manager]
11
11
  inherits: operator
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Release Manager Overlay
15
17
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/operator.sre.md Anti-pattern guidance for the Operator.sre (sre) role.
2
+ skills/roles/operator.sre.md. Anti-pattern guidance for the Operator.sre (sre) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  Covers common failure modes for the operator.sre (sre) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-sre.
9
9
  role: operator.sre
10
10
  applies_to: [cx-sre]
11
11
  inherits: operator
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # SRE Overlay
15
17
 
@@ -24,7 +26,7 @@ Additional failure modes on top of the operator core.
24
26
  ### 2. SLOs without error budgets
25
27
  **Symptom**: publishing an SLO (e.g., 99.9% availability) with no policy for what happens when it's breached.
26
28
  **Why it fails**: the SLO becomes decorative; feature work continues to burn reliability.
27
- **Counter-move**: define the error budget policy up front what freezes, who's notified, when it resumes.
29
+ **Counter-move**: define the error budget policy up front. what freezes, who's notified, when it resumes.
28
30
 
29
31
  ### 3. Dashboards of everything
30
32
  **Symptom**: 40-panel dashboards covering every metric the team could expose.
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/orchestrator.md Anti-pattern guidance for the Orchestrator role.
2
+ skills/roles/orchestrator.md. Anti-pattern guidance for the Orchestrator role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  Covers common failure modes for the orchestrator domain and counter-moves to avoid them.
@@ -9,9 +9,11 @@ Applies to: cx-orchestrator.
9
9
  role: orchestrator
10
10
  applies_to: [cx-orchestrator]
11
11
  inherits: null
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
- # Orchestrator Role guidance
16
+ # Orchestrator. Role guidance
15
17
 
16
18
  Use this as a fast dispatch checklist before producing orchestration output.
17
19
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/product-manager.ai-product.md Anti-pattern guidance for the Product-manager.ai-product (ai product) role.
2
+ skills/roles/product-manager.ai-product.md. Anti-pattern guidance for the Product-manager.ai-product (ai product) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: product-manager.ai-product
10
10
  applies_to: [cx-product-manager]
11
11
  inherits: product-manager
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # AI Product PM Overlay
15
17
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/product-manager.business-strategy.md Anti-pattern guidance for the Product-manager.business-strategy (business strategy) role.
2
+ skills/roles/product-manager.business-strategy.md. Anti-pattern guidance for the Product-manager.business-strategy (business strategy) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: product-manager.business-strategy
10
10
  applies_to: [cx-business-strategist]
11
11
  inherits: product-manager
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Business Strategy Overlay
15
17
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/product-manager.enterprise.md Anti-pattern guidance for the Product-manager.enterprise (enterprise) role.
2
+ skills/roles/product-manager.enterprise.md. Anti-pattern guidance for the Product-manager.enterprise (enterprise) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: product-manager.enterprise
10
10
  applies_to: [cx-product-manager]
11
11
  inherits: product-manager
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Enterprise PM Overlay
15
17
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/product-manager.growth.md Anti-pattern guidance for the Product-manager.growth (growth) role.
2
+ skills/roles/product-manager.growth.md. Anti-pattern guidance for the Product-manager.growth (growth) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: product-manager.growth
10
10
  applies_to: [cx-product-manager, cx-business-strategist]
11
11
  inherits: product-manager
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Growth PM Overlay
15
17
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/product-manager.md Anti-pattern guidance for the Product-manager role.
2
+ skills/roles/product-manager.md. Anti-pattern guidance for the Product-manager role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: product-manager
10
10
  applies_to: [cx-product-manager, cx-business-strategist]
11
11
  inherits: null
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
- # Product Manager Role guidance
16
+ # Product Manager. Role guidance
15
17
 
16
- Load this before drafting. These are the failure modes that separate strong role output from weak role output check your draft against each.
18
+ Load this before drafting. These are the failure modes that separate strong role output from weak role output. check your draft against each.
17
19
 
18
20
 
19
21
  ### 1. Solution in the problem statement
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/product-manager.platform.md Anti-pattern guidance for the Product-manager.platform (platform) role.
2
+ skills/roles/product-manager.platform.md. Anti-pattern guidance for the Product-manager.platform (platform) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: product-manager.platform
10
10
  applies_to: [cx-product-manager]
11
11
  inherits: product-manager
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Platform PM Overlay
15
17
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/product-manager.product.md Anti-pattern guidance for the Product-manager.product (product) role.
2
+ skills/roles/product-manager.product.md. Anti-pattern guidance for the Product-manager.product (product) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: product-manager.product
10
10
  applies_to: [cx-product-manager]
11
11
  inherits: product-manager
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Product PM Overlay
15
17
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/qa.ai-eval.md Anti-pattern guidance for the Qa.ai-eval (ai eval) role.
2
+ skills/roles/qa.ai-eval.md. Anti-pattern guidance for the Qa.ai-eval (ai eval) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: qa.ai-eval
10
10
  applies_to: [cx-qa, cx-test-automation, cx-evaluator]
11
11
  inherits: qa
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # AI Eval QA Overlay
15
17
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/qa.api-contract.md Anti-pattern guidance for the Qa.api-contract (api contract) role.
2
+ skills/roles/qa.api-contract.md. Anti-pattern guidance for the Qa.api-contract (api contract) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: qa.api-contract
10
10
  applies_to: [cx-qa, cx-test-automation]
11
11
  inherits: qa
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # API Contract QA Overlay
15
17
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/qa.data-pipeline.md Anti-pattern guidance for the Qa.data-pipeline (data pipeline) role.
2
+ skills/roles/qa.data-pipeline.md. Anti-pattern guidance for the Qa.data-pipeline (data pipeline) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: qa.data-pipeline
10
10
  applies_to: [cx-qa, cx-test-automation]
11
11
  inherits: qa
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Data Pipeline QA Overlay
15
17
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/qa.md Anti-pattern guidance for the Qa role.
2
+ skills/roles/qa.md. Anti-pattern guidance for the Qa role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: qa
10
10
  applies_to: [cx-qa, cx-test-automation]
11
11
  inherits: null
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
- # QA Role guidance
16
+ # QA. Role guidance
15
17
 
16
- Load this before drafting. These are the failure modes that separate strong role output from weak role output check your draft against each.
18
+ Load this before drafting. These are the failure modes that separate strong role output from weak role output. check your draft against each.
17
19
 
18
20
 
19
21
  ### 1. Testing the mock
20
- **Symptom**: the test asserts that the mock was called with the expected arguments and that is all it asserts.
22
+ **Symptom**: the test asserts that the mock was called with the expected arguments. and that is all it asserts.
21
23
  **Why it fails**: the test passes regardless of whether the real system would. Mocks drift from the real contract silently.
22
24
  **Counter-move**: assert on observable outputs or state. Use mocks for isolation, not as the thing being tested.
23
25
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/qa.test-automation.md Anti-pattern guidance for the Qa.test-automation (test automation) role.
2
+ skills/roles/qa.test-automation.md. Anti-pattern guidance for the Qa.test-automation (test automation) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: qa.test-automation
10
10
  applies_to: [cx-test-automation]
11
11
  inherits: qa
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Test Automation Overlay
15
17
 
@@ -18,7 +20,7 @@ Additional failure modes on top of the qa core.
18
20
 
19
21
  ### 1. Flaky tests tolerated
20
22
  **Symptom**: tests retried until green; flakes treated as "environmental noise."
21
- **Why it fails**: signal erodes real regressions hide among the flakes. Developers stop trusting the suite.
23
+ **Why it fails**: signal erodes. real regressions hide among the flakes. Developers stop trusting the suite.
22
24
  **Counter-move**: quarantine flakes immediately with a tracking ticket. Target zero retries for trusted tests.
23
25
 
24
26
  ### 2. E2E-heavy pyramid
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/qa.web-ui.md Anti-pattern guidance for the Qa.web-ui (web ui) role.
2
+ skills/roles/qa.web-ui.md. Anti-pattern guidance for the Qa.web-ui (web ui) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  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.
9
9
  role: qa.web-ui
10
10
  applies_to: [cx-qa, cx-test-automation]
11
11
  inherits: qa
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Web UI QA Overlay
15
17
 
@@ -1,5 +1,5 @@
1
1
  <!--
2
- skills/roles/researcher.explorer.md Anti-pattern guidance for the Researcher.explorer (explorer) role.
2
+ skills/roles/researcher.explorer.md. Anti-pattern guidance for the Researcher.explorer (explorer) role.
3
3
 
4
4
  Loaded at sync time to inline role-specific failure modes into specialist agent prompts.
5
5
  Covers common failure modes for the researcher.explorer (explorer) domain and counter-moves to avoid them.
@@ -9,7 +9,9 @@ Applies to: cx-explorer.
9
9
  role: researcher.explorer
10
10
  applies_to: [cx-explorer]
11
11
  inherits: researcher
12
- version: 1
12
+ version: 2
13
+ profiles: [rnd]
14
+ cap: 1
13
15
  ---
14
16
  # Codebase Explorer Overlay
15
17