@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.
- package/README.md +51 -42
- package/agents/prompts/cx-ai-engineer.md +6 -26
- package/agents/prompts/cx-architect.md +1 -0
- package/agents/prompts/cx-business-strategist.md +2 -0
- package/agents/prompts/cx-data-analyst.md +6 -26
- package/agents/prompts/cx-docs-keeper.md +1 -31
- package/agents/prompts/cx-explorer.md +1 -0
- package/agents/prompts/cx-orchestrator.md +40 -112
- package/agents/prompts/cx-platform-engineer.md +2 -22
- package/agents/prompts/cx-product-manager.md +2 -1
- package/agents/prompts/cx-qa.md +0 -20
- package/agents/prompts/cx-rd-lead.md +2 -0
- package/agents/prompts/cx-researcher.md +77 -31
- package/agents/prompts/cx-security.md +11 -49
- package/agents/prompts/cx-sre.md +9 -43
- package/agents/prompts/cx-ux-researcher.md +1 -0
- package/agents/role-manifests.json +4 -4
- package/bin/construct +279 -4
- package/commands/understand/research.md +5 -3
- package/db/schema/004_recommendations.sql +46 -0
- package/db/schema/005_strategy.sql +21 -0
- package/lib/auto-docs.mjs +3 -4
- package/lib/beads-automation.mjs +16 -7
- package/lib/cli-commands.mjs +52 -2
- package/lib/comment-lint.mjs +7 -1
- package/lib/config/schema.mjs +3 -0
- package/lib/embed/conflict-detection.mjs +26 -9
- package/lib/embed/customer-profiles.mjs +37 -17
- package/lib/embed/daemon.mjs +10 -8
- package/lib/embed/recommendation-store.mjs +213 -14
- package/lib/embed/workspaces.mjs +53 -18
- package/lib/flavors/loader.mjs +136 -0
- package/lib/gates-audit.mjs +3 -3
- package/lib/health-check.mjs +1 -1
- package/lib/hooks/agent-tracker.mjs +22 -3
- package/lib/hooks/pre-compact.mjs +3 -0
- package/lib/hooks/pre-push-gate.mjs +14 -1
- package/lib/hooks/read-tracker.mjs +10 -101
- package/lib/hooks/session-optimize.mjs +3 -2
- package/lib/hooks/session-reflect.mjs +68 -0
- package/lib/host-capabilities.mjs +90 -1
- package/lib/init-unified.mjs +25 -2
- package/lib/init-update.mjs +246 -131
- package/lib/intake/classify.mjs +61 -183
- package/lib/intake/prepare.mjs +7 -0
- package/lib/intake/tables/creative.mjs +94 -0
- package/lib/intake/tables/operations.mjs +85 -0
- package/lib/intake/tables/research.mjs +85 -0
- package/lib/intake/tables/rnd.mjs +175 -0
- package/lib/intent-classifier.mjs +1 -0
- package/lib/knowledge/layout.mjs +10 -0
- package/lib/knowledge/research-store.mjs +109 -0
- package/lib/mcp/tools/telemetry.mjs +30 -78
- package/lib/model-router.mjs +61 -1
- package/lib/observation-store.mjs +19 -0
- package/lib/ollama-manager.mjs +1 -1
- package/lib/opencode-telemetry.mjs +4 -5
- package/lib/orchestration-policy.mjs +9 -0
- package/lib/outcomes/aggregate.mjs +104 -0
- package/lib/outcomes/record.mjs +115 -0
- package/lib/parity.mjs +121 -21
- package/lib/profiles/lifecycle.mjs +388 -0
- package/lib/profiles/loader.mjs +123 -0
- package/lib/profiles/validate-custom.mjs +114 -0
- package/lib/prompt-composer.js +106 -29
- package/lib/read-tracker-store.mjs +149 -0
- package/lib/reflect/extractor.mjs +193 -0
- package/lib/reflect.mjs +89 -2
- package/lib/sandbox.mjs +102 -0
- package/lib/server/index.mjs +76 -0
- package/lib/server/telemetry-login.mjs +17 -25
- package/lib/service-manager.mjs +30 -22
- package/lib/services/local-postgres.mjs +15 -0
- package/lib/services/telemetry-backend.mjs +1 -2
- package/lib/setup.mjs +8 -43
- package/lib/status.mjs +51 -5
- package/lib/storage/backend.mjs +12 -2
- package/lib/strategy-store.mjs +371 -0
- package/lib/telemetry/backends/local.mjs +6 -4
- package/lib/telemetry/client.mjs +185 -0
- package/lib/telemetry/ingest.mjs +13 -5
- package/lib/telemetry/team-rollup.mjs +9 -2
- package/lib/worker/trace.mjs +17 -27
- package/package.json +10 -2
- package/personas/construct.md +20 -20
- package/platforms/claude/settings.template.json +13 -0
- package/rules/common/research.md +44 -12
- package/scripts/sync-agents.mjs +11 -0
- package/skills/docs/backlog-proposal-workflow.md +2 -2
- package/skills/docs/customer-profile-workflow.md +1 -1
- package/skills/docs/evidence-ingest-workflow.md +5 -5
- package/skills/docs/prfaq-workflow.md +1 -1
- package/skills/docs/product-intelligence-review.md +1 -1
- package/skills/docs/product-intelligence-workflow.md +3 -3
- package/skills/docs/product-signal-workflow.md +48 -18
- package/skills/docs/research-workflow.md +26 -14
- package/skills/docs/strategy-workflow.md +36 -0
- package/skills/roles/architect.ai-systems.md +4 -2
- package/skills/roles/architect.data.md +4 -2
- package/skills/roles/architect.enterprise.md +4 -2
- package/skills/roles/architect.integration.md +4 -2
- package/skills/roles/architect.md +7 -5
- package/skills/roles/architect.platform.md +4 -2
- package/skills/roles/data-analyst.experiment.md +4 -2
- package/skills/roles/data-analyst.md +9 -7
- package/skills/roles/data-analyst.product-intelligence.md +5 -3
- package/skills/roles/data-analyst.product.md +4 -2
- package/skills/roles/data-analyst.telemetry.md +4 -2
- package/skills/roles/data-engineer.pipeline.md +4 -2
- package/skills/roles/data-engineer.vector-retrieval.md +4 -2
- package/skills/roles/data-engineer.warehouse.md +4 -2
- package/skills/roles/debugger.md +7 -5
- package/skills/roles/designer.accessibility.md +4 -2
- package/skills/roles/designer.md +10 -8
- package/skills/roles/engineer.ai.md +4 -2
- package/skills/roles/engineer.data.md +5 -3
- package/skills/roles/engineer.md +14 -12
- package/skills/roles/engineer.platform.md +5 -3
- package/skills/roles/operator.docs.md +6 -4
- package/skills/roles/operator.md +6 -4
- package/skills/roles/operator.release.md +4 -2
- package/skills/roles/operator.sre.md +5 -3
- package/skills/roles/orchestrator.md +5 -3
- package/skills/roles/product-manager.ai-product.md +4 -2
- package/skills/roles/product-manager.business-strategy.md +4 -2
- package/skills/roles/product-manager.enterprise.md +4 -2
- package/skills/roles/product-manager.growth.md +4 -2
- package/skills/roles/product-manager.md +6 -4
- package/skills/roles/product-manager.platform.md +4 -2
- package/skills/roles/product-manager.product.md +4 -2
- package/skills/roles/qa.ai-eval.md +4 -2
- package/skills/roles/qa.api-contract.md +4 -2
- package/skills/roles/qa.data-pipeline.md +4 -2
- package/skills/roles/qa.md +7 -5
- package/skills/roles/qa.test-automation.md +5 -3
- package/skills/roles/qa.web-ui.md +4 -2
- package/skills/roles/researcher.explorer.md +4 -2
- package/skills/roles/researcher.md +35 -20
- package/skills/roles/researcher.ux.md +4 -2
- package/skills/roles/reviewer.devil-advocate.md +4 -2
- package/skills/roles/reviewer.evaluator.md +4 -2
- package/skills/roles/reviewer.md +14 -12
- package/skills/roles/reviewer.trace.md +4 -2
- package/skills/roles/security.ai.md +4 -2
- package/skills/roles/security.appsec.md +4 -2
- package/skills/roles/security.cloud.md +4 -2
- package/skills/roles/security.legal-compliance.md +4 -2
- package/skills/roles/security.md +7 -5
- package/skills/roles/security.privacy.md +4 -2
- package/skills/roles/security.supply-chain.md +4 -2
- package/skills/routing.md +8 -1
- package/templates/docs/persona-artifact.md +36 -0
- package/templates/docs/research-brief.md +63 -9
- package/templates/docs/research-finding.md +26 -0
- package/templates/docs/skill-artifact.md +27 -0
- package/templates/docs/strategy.md +36 -0
- package/templates/homebrew/construct.rb +6 -6
package/skills/roles/designer.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<!--
|
|
2
|
-
skills/roles/designer.md
|
|
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:
|
|
12
|
+
version: 2
|
|
13
|
+
profiles: [rnd]
|
|
14
|
+
cap: 1
|
|
13
15
|
---
|
|
14
|
-
# Designer
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
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.
|
package/skills/roles/engineer.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<!--
|
|
2
|
-
skills/roles/engineer.md
|
|
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:
|
|
12
|
+
version: 2
|
|
13
|
+
profiles: [rnd]
|
|
14
|
+
cap: 1
|
|
13
15
|
---
|
|
14
|
-
# Engineer
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
92
|
-
- [ ] `node bin/construct lint:comments
|
|
93
|
-
- [ ] `node bin/construct docs:verify
|
|
94
|
-
- [ ] `node bin/construct docs:update --check
|
|
95
|
-
- [ ] `npm run lint: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
|
|
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:
|
|
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
|
|
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
|
|
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:
|
|
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
|
|
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
|
|
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
|
|
package/skills/roles/operator.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<!--
|
|
2
|
-
skills/roles/operator.md
|
|
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:
|
|
12
|
+
version: 2
|
|
13
|
+
profiles: [rnd]
|
|
14
|
+
cap: 1
|
|
13
15
|
---
|
|
14
|
-
# Operator
|
|
16
|
+
# Operator. Role guidance
|
|
15
17
|
|
|
16
|
-
Load this before producing operator output
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
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
|
|
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:
|
|
12
|
+
version: 2
|
|
13
|
+
profiles: [rnd]
|
|
14
|
+
cap: 1
|
|
13
15
|
---
|
|
14
|
-
# Orchestrator
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
12
|
+
version: 2
|
|
13
|
+
profiles: [rnd]
|
|
14
|
+
cap: 1
|
|
13
15
|
---
|
|
14
|
-
# Product Manager
|
|
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
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
12
|
+
version: 2
|
|
13
|
+
profiles: [rnd]
|
|
14
|
+
cap: 1
|
|
13
15
|
---
|
|
14
16
|
# Data Pipeline QA Overlay
|
|
15
17
|
|
package/skills/roles/qa.md
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
<!--
|
|
2
|
-
skills/roles/qa.md
|
|
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:
|
|
12
|
+
version: 2
|
|
13
|
+
profiles: [rnd]
|
|
14
|
+
cap: 1
|
|
13
15
|
---
|
|
14
|
-
# QA
|
|
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
|
|
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
|
|
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
|
|
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:
|
|
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
|
|
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
|
|
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:
|
|
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
|
|
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:
|
|
12
|
+
version: 2
|
|
13
|
+
profiles: [rnd]
|
|
14
|
+
cap: 1
|
|
13
15
|
---
|
|
14
16
|
# Codebase Explorer Overlay
|
|
15
17
|
|