@event4u/agent-config 14.22.0 → 15.0.0

package/dist/agent-src/skills/dashboard-design/SKILL.md

@@ -131,7 +131,7 @@ Config required: `allow_embedding = true`, `cookie_samesite = none` (cross-origi
 
 Dashboards have their own signature tell: the **hero-metric template** (giant
 number + small label + a row of stats + gradient) is L1 in
-[`docs/guidelines/design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md).
+[`docs/guidelines/design-antipatterns.md`](../../guidelines/design-antipatterns.md).
 Pull the catalog and check L1–L3 (hero-metric, identical-card grids, monotonous
 spacing) before finalizing the layout — a dashboard is product-mode
 (`docs/guidelines/design-modes.md`): design serves the task, so favour data

package/dist/agent-src/skills/data-handling-judgment/SKILL.md

@@ -26,7 +26,7 @@ Do NOT use as a regulatory-regime delta read (route to `privacy-review` (P6); th
 
 ## Cognition cluster
 
-- **Mental model 28 — Inversion.** *"If this data category leaked in this form, who would we have to notify and what would the headline read?"* The headline inversion forces honest classification ahead of operational convenience. See [`mental-models.md`](../../../docs/contracts/mental-models.md) § 28.
+- **Mental model 28 — Inversion.** *"If this data category leaked in this form, who would we have to notify and what would the headline read?"* The headline inversion forces honest classification ahead of operational convenience. See [`mental-models.md`](../../docs/contracts/mental-models.md) § 28.
 - **Mental model 1 — First principles.** Strip every retention claim to: *what purpose does keeping this another day serve, and whose risk does it grow?* Most retention defaults are inherited from the previous system, not chosen. See `mental-models.md` § 1.
 - **Mental model 26 — Optionality.** Aggressive retention preserves *analytical optionality* but forecloses *deletion optionality* and grows *breach optionality* for the attacker. Each retention choice is a trade. See `mental-models.md` § 26.
 - **Context-spine — regulatory-regime + customer-segment + product.** Read **regulatory-regime** (J1) for floor (GDPR storage-limitation principle; HIPAA retention minimums for medical records; financial-regulator retention mandates). Read **customer-segment** for whose data sets the floor. Read **product** for which features actually need the data.

package/dist/agent-src/skills/deal-qualification-meddic/SKILL.md

@@ -37,7 +37,7 @@ scope — this skill is single-deal qualification, one cycle).
   answer survives, qualification is incomplete; if the answer is
   load-bearing and the team has no countermeasure, disqualification
   is the call. See
-  [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 30.
+  [`docs/contracts/mental-models.md`](../../docs/contracts/mental-models.md) § 30.
 - **Mental model 9 — Hypothesis-driven thinking.** Each MEDDIC slot
   is a hypothesis with falsification evidence. *"Mary is the
   champion"* is a claim; *"Mary briefed two peers without us in the
@@ -55,7 +55,7 @@ scope — this skill is single-deal qualification, one cycle).
   **customer-segment** slot for the segment's switch-event shape —
   pain claims that do not match the segment's known switch events
   are coaching opportunities, not qualifications. See
-  [`context-spine`](../../../docs/contracts/context-spine.md).
+  [`context-spine`](../../docs/contracts/context-spine.md).
 
 ## Procedure
 

package/dist/agent-src/skills/decision-record/SKILL.md

@@ -49,7 +49,7 @@ Do NOT use when:
 - **Mental model 4 — Second-order thinking.** Every decision unlocks
   some futures and locks out others; the consequences block names
   what becomes harder, not just what becomes easier. See
-  [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 4.
+  [`docs/contracts/mental-models.md`](../../docs/contracts/mental-models.md) § 4.
 - **Mental model 6 — Theory of constraints.** A decision that does
   not move the binding constraint is theatre; if the trade-off matrix
   scores every option the same on the constraint that matters, the
@@ -67,7 +67,7 @@ Do NOT use when:
   categories are enumerated so the call is not left to a judgement about
   what feels important.
 - **Team context-spine slot.** Read the **team** slot of the
-  [context-spine](../../../docs/contracts/context-spine.md) to
+  [context-spine](../../docs/contracts/context-spine.md) to
   capture who is bound by the decision (review groups, on-call
   rotation). Skip if the consumer project has not filled it; note in
   the record.
@@ -133,7 +133,7 @@ Write:
   `agentic_mode: council` — sources and measurements raise the grade,
   consensus does not. A human product call records `E0` plus
   `authority_basis: owner_intent` rather than a faked grade. Vocabulary:
-  [`adr-layout § Provenance and evidence`](../../../docs/contracts/adr-layout.md).
+  [`adr-layout § Provenance and evidence`](../../docs/contracts/adr-layout.md).
 
 ### 5. Wire the supersession chain (if any)
 

package/dist/agent-src/skills/decision-review/SKILL.md

@@ -21,7 +21,7 @@ install:
 > compare the original assumptions against reality now, and produce a
 > verdict (still valid / needs amendment / superseded). Ends with a
 > `historical-patterns` memory candidate per the
-> [Analysis Memory Loop](../../../docs/contracts/analysis-memory-loop.md).
+> [Analysis Memory Loop](../../docs/contracts/analysis-memory-loop.md).
 >
 > **Direction:** backward (did it hold?) not forward (which option?).
 > For forward flow, use [`decision-record`](../decision-record/SKILL.md).
@@ -110,12 +110,12 @@ running them out of order pays for the expensive ones first:
    `unclassified`, which is not `owner`).
 
 Then price the reopen record from the grade × provenance burden table in
-[`adr-layout § The reopen record`](../../../docs/contracts/adr-layout.md) —
+[`adr-layout § The reopen record`](../../docs/contracts/adr-layout.md) —
 cheap for an `E0`/`E1` agentic snapshot, *surfaced* rather than obeyed or
 overturned for `E0`/`E1` human, the standard five fields at `E2`, and those
 fields plus engaging the original evidence **in kind** at `E3`/`E4`. Read the
 table; do not reconstruct it from memory. The axes are defined by
-[`adr-layout § Provenance and evidence`](../../../docs/contracts/adr-layout.md),
+[`adr-layout § Provenance and evidence`](../../docs/contracts/adr-layout.md),
 not here.
 
 ### 4. Verdict
@@ -142,7 +142,7 @@ key-space (decision area, affected paths):
 - **Match found** — propose a `frequency` / `supersedes` **update**
   to the existing entry. Do not create a duplicate.
 - **No match** — draft a new `historical-patterns` candidate per the
-  [Analysis Memory Loop § 1](../../../docs/contracts/analysis-memory-loop.md):
+  [Analysis Memory Loop § 1](../../docs/contracts/analysis-memory-loop.md):
 
 ```jsonc
 {
@@ -179,7 +179,7 @@ strengthening evidence.
   not rebuild one unless the verdict is "superseded" and a new decision
   process is needed.
 - Auto-promote memory candidates — the human drives promotion per the
-  [Analysis Memory Loop](../../../docs/contracts/analysis-memory-loop.md).
+  [Analysis Memory Loop](../../docs/contracts/analysis-memory-loop.md).
 - Issue a "superseded" verdict without naming the successor option or
   recommending the forward path to `decision-record` + `adr-create`.
 
@@ -306,7 +306,7 @@ in the rule; the lock catalog, fire steps, and failure modes live here.
    disposition, not a re-statement of the old one.
 
    When the lock is an **ADR**, the disposition carries the five-field reopen
-   record from [`adr-layout § Reopen record`](../../../docs/contracts/adr-layout.md):
+   record from [`adr-layout § Reopen record`](../../docs/contracts/adr-layout.md):
    the original rationale **addressed** (not cited), what changed with tree
    evidence, dependants and external commitments touched, the rollback path,
    and a blast radius — `narrow | wide | irreversible` — with the evidence for
@@ -344,7 +344,7 @@ neither the trust boundary nor the blast radius. Whether an *independently
 validated* grade may ever reduce the authorization burden is owner-reserved and
 open: do not answer it here — it is the `authority-coupling-decision` blocker in
 `road-to-evidence-based-adr-governance`, and
-[`adr-layout § The reopen record`](../../../docs/contracts/adr-layout.md) closes
+[`adr-layout § The reopen record`](../../docs/contracts/adr-layout.md) closes
 on the same point.
 
 Two consequences that are easy to get backwards:
@@ -396,4 +396,4 @@ Two consequences that are easy to get backwards:
 - [`decision-record`](../decision-record/SKILL.md) — forward flow: lock a new choice.
 - [`adr-create`](../adr-create/SKILL.md) — file the ADR after a decision is locked.
 - [`blameless-post-mortem`](../blameless-post-mortem/SKILL.md) — incident review; may hand off to decision-review when a prior architectural choice is implicated.
-- [`docs/contracts/analysis-memory-loop.md`](../../../docs/contracts/analysis-memory-loop.md) — produce → propose → promote → retrieve contract.
+- [`docs/contracts/analysis-memory-loop.md`](../../docs/contracts/analysis-memory-loop.md) — produce → propose → promote → retrieve contract.

package/dist/agent-src/skills/deep-reading-analyst/SKILL.md

@@ -32,10 +32,10 @@ Do NOT use when:
 
 | Depth | Time | Frameworks | Reference module |
 |---|---|---|---|
-| **L1 — Quick** | ~15 min | SCQA, 5W2H | [`scqa-framework`](../../../docs/guidelines/agent-infra/scqa-framework.md), [`5w2h-analysis`](../../../docs/guidelines/agent-infra/5w2h-analysis.md) |
-| **L2 — Standard** | ~30 min | L1 + Critical Thinking, Inversion | + [`critical-thinking`](../../../docs/guidelines/agent-infra/critical-thinking.md), [`inversion-thinking`](../../../docs/guidelines/agent-infra/inversion-thinking.md) |
-| **L3 — Deep** | ~60 min | L2 + Mental Models, First Principles, Systems Thinking, Six Hats | + [`mental-models`](../../../docs/guidelines/agent-infra/mental-models.md), [`first-principles`](../../../docs/guidelines/agent-infra/first-principles.md), [`systems-thinking`](../../../docs/guidelines/agent-infra/systems-thinking.md), [`six-hats`](../../../docs/guidelines/agent-infra/six-hats.md) |
-| **L4 — Research** | 120 min+ | L3 + Cross-source comparison via web search | + [`comparison-matrix`](../../../docs/guidelines/agent-infra/comparison-matrix.md) |
+| **L1 — Quick** | ~15 min | SCQA, 5W2H | [`scqa-framework`](../../guidelines/agent-infra/scqa-framework.md), [`5w2h-analysis`](../../guidelines/agent-infra/5w2h-analysis.md) |
+| **L2 — Standard** | ~30 min | L1 + Critical Thinking, Inversion | + [`critical-thinking`](../../guidelines/agent-infra/critical-thinking.md), [`inversion-thinking`](../../guidelines/agent-infra/inversion-thinking.md) |
+| **L3 — Deep** | ~60 min | L2 + Mental Models, First Principles, Systems Thinking, Six Hats | + [`mental-models`](../../guidelines/agent-infra/mental-models.md), [`first-principles`](../../guidelines/agent-infra/first-principles.md), [`systems-thinking`](../../guidelines/agent-infra/systems-thinking.md), [`six-hats`](../../guidelines/agent-infra/six-hats.md) |
+| **L4 — Research** | 120 min+ | L3 + Cross-source comparison via web search | + [`comparison-matrix`](../../guidelines/agent-infra/comparison-matrix.md) |
 
 Every framework module is a project-local guideline under `docs/guidelines/agent-infra/`. Nothing is loaded from upstream at runtime.
 
@@ -86,7 +86,7 @@ Structure:
 Key concepts: [3–5 terms with one-line definitions]
 ```
 
-**2B — SCQA breakdown.** Apply the four-element decomposition from [`scqa-framework`](../../../docs/guidelines/agent-infra/scqa-framework.md):
+**2B — SCQA breakdown.** Apply the four-element decomposition from [`scqa-framework`](../../guidelines/agent-infra/scqa-framework.md):
 
 ```markdown
 **S (Situation)**: [context the article establishes]
@@ -104,20 +104,20 @@ Load only the frameworks the user's depth bought. Each framework follows the sam
 
 **L2 additions:**
 
-- **Critical Thinking** ([`critical-thinking`](../../../docs/guidelines/agent-infra/critical-thinking.md)) — argument strength score (X/10), strengths, weaknesses, logical fallacies detected.
-- **Inversion** ([`inversion-thinking`](../../../docs/guidelines/agent-infra/inversion-thinking.md)) — pre-mortem on the article's recommendation: "how would this fail?", missing risk factors, mitigations.
+- **Critical Thinking** ([`critical-thinking`](../../guidelines/agent-infra/critical-thinking.md)) — argument strength score (X/10), strengths, weaknesses, logical fallacies detected.
+- **Inversion** ([`inversion-thinking`](../../guidelines/agent-infra/inversion-thinking.md)) — pre-mortem on the article's recommendation: "how would this fail?", missing risk factors, mitigations.
 
 **L3 additions:**
 
-- **Mental Models** ([`mental-models`](../../../docs/guidelines/agent-infra/mental-models.md)) — pick 3–5 models from different disciplines (physics, biology, psychology, economics, math), apply each lens, surface cross-model patterns.
-- **First Principles** ([`first-principles`](../../../docs/guidelines/agent-infra/first-principles.md)) — strip to fundamental truths, validate each core assumption, rebuild from base.
-- **Systems Thinking** ([`systems-thinking`](../../../docs/guidelines/agent-infra/systems-thinking.md)) — map relationships, feedback loops, leverage points.
-- **Six Hats** ([`six-hats`](../../../docs/guidelines/agent-infra/six-hats.md)) — White (facts), Red (feelings), Black (cautions), Yellow (benefits), Green (creativity), Blue (process).
+- **Mental Models** ([`mental-models`](../../guidelines/agent-infra/mental-models.md)) — pick 3–5 models from different disciplines (physics, biology, psychology, economics, math), apply each lens, surface cross-model patterns.
+- **First Principles** ([`first-principles`](../../guidelines/agent-infra/first-principles.md)) — strip to fundamental truths, validate each core assumption, rebuild from base.
+- **Systems Thinking** ([`systems-thinking`](../../guidelines/agent-infra/systems-thinking.md)) — map relationships, feedback loops, leverage points.
+- **Six Hats** ([`six-hats`](../../guidelines/agent-infra/six-hats.md)) — White (facts), Red (feelings), Black (cautions), Yellow (benefits), Green (creativity), Blue (process).
 
 **L4 addition:**
 
-- **Cross-source comparison** ([`comparison-matrix`](../../../docs/guidelines/agent-infra/comparison-matrix.md)) — web-search 2–3 related sources, compare SCQA across sources, identify consensus vs divergence, synthesize integrated perspective.
-- **Disconfirmation + per-part grounding (pre-synthesis gate)** — run at least one search that tries to *falsify* the leading takeaway (rule alternatives in/out, not only confirm), and ground each part of the reading goal in a retrieved source before writing it. Distinct from [`verify-before-complete`](../../../src/rules/verify-before-complete.md) (completion evidence).
+- **Cross-source comparison** ([`comparison-matrix`](../../guidelines/agent-infra/comparison-matrix.md)) — web-search 2–3 related sources, compare SCQA across sources, identify consensus vs divergence, synthesize integrated perspective.
+- **Disconfirmation + per-part grounding (pre-synthesis gate)** — run at least one search that tries to *falsify* the leading takeaway (rule alternatives in/out, not only confirm), and ground each part of the reading goal in a retrieved source before writing it. Distinct from [`verify-before-complete`](../../rules/verify-before-complete.md) (completion evidence).
 
 ### Step 4: Synthesize by Goal
 
@@ -184,14 +184,14 @@ Regardless of goal, close with three fixed blocks:
 
 All 8 framework modules are project-local guidelines under `docs/guidelines/agent-infra/` (full text adopted under the Reference-Guideline Sunset Policy). Each carries an `## ADOPT citation` footer pinning its MIT upstream origin.
 
-- [`scqa-framework`](../../../docs/guidelines/agent-infra/scqa-framework.md) — situation / complication / question / answer decomposition.
-- [`5w2h-analysis`](../../../docs/guidelines/agent-infra/5w2h-analysis.md) — completeness check (7 questions).
-- [`critical-thinking`](../../../docs/guidelines/agent-infra/critical-thinking.md) — argument quality / fallacy detection.
-- [`inversion-thinking`](../../../docs/guidelines/agent-infra/inversion-thinking.md) — pre-mortem on decisions, distinct from `adversarial-review`.
-- [`mental-models`](../../../docs/guidelines/agent-infra/mental-models.md) — Munger's multi-discipline toolkit.
-- [`first-principles`](../../../docs/guidelines/agent-infra/first-principles.md) — fundamental-truth extraction.
-- [`systems-thinking`](../../../docs/guidelines/agent-infra/systems-thinking.md) — feedback loops + leverage points.
-- [`six-hats`](../../../docs/guidelines/agent-infra/six-hats.md) — White / Red / Black / Yellow / Green / Blue protocol.
-- [`comparison-matrix`](../../../docs/guidelines/agent-infra/comparison-matrix.md) — cross-source synthesis (L4 only).
+- [`scqa-framework`](../../guidelines/agent-infra/scqa-framework.md) — situation / complication / question / answer decomposition.
+- [`5w2h-analysis`](../../guidelines/agent-infra/5w2h-analysis.md) — completeness check (7 questions).
+- [`critical-thinking`](../../guidelines/agent-infra/critical-thinking.md) — argument quality / fallacy detection.
+- [`inversion-thinking`](../../guidelines/agent-infra/inversion-thinking.md) — pre-mortem on decisions, distinct from `adversarial-review`.
+- [`mental-models`](../../guidelines/agent-infra/mental-models.md) — Munger's multi-discipline toolkit.
+- [`first-principles`](../../guidelines/agent-infra/first-principles.md) — fundamental-truth extraction.
+- [`systems-thinking`](../../guidelines/agent-infra/systems-thinking.md) — feedback loops + leverage points.
+- [`six-hats`](../../guidelines/agent-infra/six-hats.md) — White / Red / Black / Yellow / Green / Blue protocol.
+- [`comparison-matrix`](../../guidelines/agent-infra/comparison-matrix.md) — cross-source synthesis (L4 only).
 
 > **Deprecated — on-demand upstream loading.** Earlier revisions of this skill described loading some modules "on demand from a SHA-pinned URL", backed by an `external_source` frontmatter pin. That capability was **never wired** (no fetcher ever consumed the pin; it was schema-only metadata), so the pin and its `refresh_trigger` / `sunset_criterion` bundle have been **removed** — every module is local, no runtime fetch is needed. If a future revision genuinely needs live upstream content, build an explicit fetch step; do not reintroduce a non-functional metadata pin.

package/dist/agent-src/skills/design-intelligence/SKILL.md

@@ -67,7 +67,7 @@ Carbon, Polaris, GOV.UK, shadcn, Tailwind UI, Radix, etc.):
 0. **Canon grounding first.** If the brief names a system OR
    `components.json`/deps signal one (`@mui/material`, `antd`, `@fluentui/*`,
    `@carbon/*`, `@atlaskit/*`), pull
-   [`docs/guidelines/design-canon.md`](../../../docs/guidelines/design-canon.md),
+   [`docs/guidelines/design-canon.md`](../../guidelines/design-canon.md),
    surface the matching one-line summary, and **offer to fetch the live spec**
    before committing to the system's conventions — rather than improvising.
    The canon index is thin + lazy: do not load it for a generic, unnamed brief.
@@ -85,7 +85,7 @@ Carbon, Polaris, GOV.UK, shadcn, Tailwind UI, Radix, etc.):
 
 **Grounding precedence** (consistent with `brand-source-of-truth`): consumer
 brand tokens > confirmed session decisions > named canon
-([`design-canon.md`](../../../docs/guidelines/design-canon.md)) > generated
+([`design-canon.md`](../../guidelines/design-canon.md)) > generated
 corpus. Canon is a gap-filler, never an override of a registered brand value.
 
 ## Procedure: Produce a grounded design brief (`ui-design-brief` rebound)
@@ -130,7 +130,7 @@ that row's **Don't** column) no longer read as opposite instructions:
 |---|---|---|
 | `Google Fonts URL` | *where do I find / verify this font?* | discovery + availability check |
 | `Self-Hosted Route` | *how does it get onto the page?* | **the default answer** — `@fontsource/*` package ids derived from the row's own Google-Fonts families; two rows name a foundry file instead (Fontshare pairs with a Google alternative) |
-| `CSS Import` | the third-party CDN `@import` | **opt-in only** — emitting it transmits the visitor's IP to the third party; policy owner is [`design-fidelity-mechanics`](../../../docs/guidelines/design-fidelity-mechanics.md) § Asset & imagery discipline ([`ADR-205`](../../../docs/decisions/ADR-205-webfont-delivery-ownership.md)) |
+| `CSS Import` | the third-party CDN `@import` | **opt-in only** — emitting it transmits the visitor's IP to the third party; policy owner is [`design-fidelity-mechanics`](../../guidelines/design-fidelity-mechanics.md) § Asset & imagery discipline ([`ADR-205`](../../../docs/decisions/ADR-205-webfont-delivery-ownership.md)) |
 
 Per-stack route resolution (Next / bundler / asset-pipeline / plain) lives in
 [`typography-system`](../typography-system/SKILL.md) § Delivery — one table, not
@@ -175,7 +175,7 @@ say why. Never invent pairing metadata.
 ## Anti-slop discipline
 
 Before finalizing any design brief, cross-check against
-[`docs/guidelines/design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md)
+[`docs/guidelines/design-antipatterns.md`](../../guidelines/design-antipatterns.md)
 — especially the Color (C1–C5), Typography (T7–T8), and Layout (L1–L2) sections.
 If the grounded corpus selection lands on a pattern in the catalog, either invoke
 the override condition or adjust the selection.

package/dist/agent-src/skills/design-intelligence/references/context-and-registers.md

@@ -28,7 +28,7 @@ Both are consumed; DESIGN.md takes precedence for usage questions.
 ## Register — brand vs product
 
 Determine the design register before grounding (see
-[`docs/guidelines/design-modes.md`](../../../../docs/guidelines/design-modes.md)):
+[`docs/guidelines/design-modes.md`](../../../guidelines/design-modes.md)):
 **brand mode** ("the impression IS the product" — marketing, landing, consumer
 first-impression) prioritizes distinctive selection; **product mode** ("design
 serves the task" — dashboard, admin, workflow) prioritizes earned familiarity
@@ -109,7 +109,7 @@ Dials persist in `DESIGN.md`; the stack executors (`tailwind-engineer`,
 
 **Anti-Default Discipline — first-impulse check:** Before committing to any
 design direction, cross-check your first impulse against the current-generation
-tells in [`design-antipatterns.md`](../../../../docs/guidelines/design-antipatterns.md)
+tells in [`design-antipatterns.md`](../../../guidelines/design-antipatterns.md)
 (§ Current-generation tells — the warm-editorial C5+T2+T7 signature and the
 previous-generation C1/C2 gradient) plus the L1/L2 layout defaults. If a tell
 was your first reach, name a different direction or explicitly justify why this

package/dist/agent-src/skills/design-review/SKILL.md

@@ -16,7 +16,7 @@ packs:
 ## When to use
 
 > **Render-verification gate.** A UI verdict is gated on the
-> [design-artifact verification checklist](../../../docs/contracts/design-artifact-verification.md#verification-checklist):
+> [design-artifact verification checklist](../../docs/contracts/design-artifact-verification.md#verification-checklist):
 > where render capability exists, do not pass a design task without render
 > evidence (checklist steps 1–5); where it is absent, scope the verdict to what
 > was statically checked and say so — never "looks good" without evidence.
@@ -213,7 +213,7 @@ Load the reference file whose sections the review needs — never all of them by
 ## Read the authority object — the review is scoped by it
 
 Read the resolved `ui_authority`
-([contract](../../../docs/contracts/ui-authority.md)) before reviewing. Three
+([contract](../../docs/contracts/ui-authority.md)) before reviewing. Three
 fields change what a finding *means*:
 
 - **`surface_mode`** sets the density, hierarchy and expressiveness a reviewer
@@ -288,7 +288,7 @@ structured review phases, add an explicit **Anti-Slop Check** section:
    `lint_design_slop` is **flags, never a block** (default exit 0; CI opts into
    failure via `--fail-on`).
 2. **Judge what the detector cannot** — load
-   [`docs/guidelines/design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md)
+   [`docs/guidelines/design-antipatterns.md`](../../guidelines/design-antipatterns.md)
    for the tells that need structural/aesthetic judgment (e.g. T3 icon-tile
    stack, L2 three-identical-card grid, V2 glassmorphism intent). List any that
    appear, cite by entry ID, and check the override condition.
@@ -304,7 +304,7 @@ structured review phases, add an explicit **Anti-Slop Check** section:
    own design. The flag is scoped to decisions the artifact actually covers;
    anything it leaves open (a state it never showed) is generative work and
    keeps the full scan. Precedence + scope:
-   [`design-fidelity-mechanics`](../../../docs/guidelines/design-fidelity-mechanics.md)
+   [`design-fidelity-mechanics`](../../guidelines/design-fidelity-mechanics.md)
    § Provided-artifact precedence. Regression witness: `daf-slop-vs-provided`.
 
 For the **objective quality floors** (WCAG contrast, font-size, line-length,

package/dist/agent-src/skills/design-system-capture/references/design-system-json.md

@@ -11,6 +11,9 @@
 ```json
 {
   "source": { "kind": "url|repo|dir", "ref": "https://example.com", "captured_at": "<ISO-8601>" },
+  "spec":    { "maturity": "low|finished",
+               "maturity_source": "user|declaration|inference|default",
+               "maturity_signal": "<the concrete thing that decided it>" },
   "colors": {
     "light": { "<role>": "<value>" },
     "dark":  { "<role>": "<value>" }
@@ -39,6 +42,22 @@
   `components[].observed`). It informs the human; it never becomes a token.
 - **`source` is mandatory** — `kind` + `ref` + `captured_at`. An artifact with
   no provenance is rejected (you cannot confirm what you cannot trace).
+- **`spec.maturity` is a field, not a judgement made twice.** `design-fidelity`
+  branches on whether the artifact's pixel detail carries decisions — a
+  wireframe's placeholder grays are non-decisions, and reproducing them 1:1
+  honors the wrong half of the artifact. That axis used to live only as a prose
+  table, so every consumer re-derived it by eye and two consumers could disagree
+  without either misreading the text. `src/scripts/_lib/artifact_maturity.ts`
+  resolves it, and the block carries the verdict **with its provenance**:
+  `maturity_source` says which rung decided (a user signal beats the artifact's
+  own declaration, which beats inference from its content, which beats the
+  default) and `maturity_signal` names the concrete thing — *"the filename names
+  a wireframe"*, *"every colour in the body is greyscale"* — never a restatement
+  of the verdict. **Absent resolves `finished`, deliberately:** the 1:1 floor is
+  the stricter reading, and guessing *low* would make an artifact's silence a
+  license to redesign it. The block is OPTIONAL in the file; an importer that
+  omits it gets the same default, which is why `source` is mandatory and this
+  is not.
 - **`bundled_local`** on a font family is a flag, not an instruction: the
   package never downloads or bundles fonts (out of scope) — it records that the
   source did.
@@ -46,7 +65,7 @@
   a long time that meant nothing read it at all: the block was written by
   capture and consumed by nobody, so easing and duration were re-derived from
   taste on every port. On the **Port a provided artifact** branch
-  ([`design-artifact-lifecycle`](../../../../../docs/contracts/design-artifact-lifecycle.md))
+  ([`design-artifact-lifecycle`](../../../docs/contracts/design-artifact-lifecycle.md))
   the audit reads `motion.durations` and `motion.easings` as the answer. The
   extraction-only marking above still holds: `motion._meta.detected_libs`
   informs the human and never becomes a token.

package/dist/agent-src/skills/design-tokens/SKILL.md

@@ -87,6 +87,21 @@ scan the changed files, append the findings to
 (`var(--token)` over hardcoded hex — the validation rule the council's
 four-operation split assigns to *rules/linters*, not the corpus).
 
+**Set `artifact_covered: true` on a finding whose value traces to a provided
+design artifact.** Without it the polish round edits AWAY from the artifact:
+`polish.ts::partition_artifact_covered` drops flagged findings and treats every
+unmarked one as actionable, and this path appended `token_violation` findings
+without the flag — so a hex the handover states was converted to a project token
+by a loop nobody asked. The flag is per finding, not per run: a hardcoded hex
+the artifact never mentioned stays actionable and is still fixed. Marking is not
+suppression — the finding stays in the report as informational, so a reader
+still sees that the spec carries a value the token system does not.
+(AI council 2026-09-09 on `blocker: findings-actionability-default`, option (b):
+one call site, no package-wide default changed. Reopens if a second
+artifact-derived finding path reaches the loop without provenance — recurrence
+would argue for carrying provenance in the finding TYPE rather than at a third
+call site.)
+
 ## Procedure
 
 1. **Inspect the existing styling surface** — detect the stack (Tailwind
@@ -153,8 +168,8 @@ four-operation split assigns to *rules/linters*, not the corpus).
 
 ## See also
 
-- [`design-canon.md`](../../../docs/guidelines/design-canon.md) § Colour references — a11y-contrast + culturally-specific palettes + named-system token models.
+- [`design-canon.md`](../../guidelines/design-canon.md) § Colour references — a11y-contrast + culturally-specific palettes + named-system token models.
 - [`design-intelligence`](../design-intelligence/SKILL.md) — grounded value selection.
 - [`tailwind-engineer`](../tailwind-engineer/SKILL.md) — utility-discipline consumer.
 - [`react-shadcn-ui`](../react-shadcn-ui/SKILL.md) — shadcn token conventions.
-- [`docs/guidelines/design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md) — when authoring the colour layer, avoid the C5 cream/sand default palette (OKLCH L 0.84–0.97, C < 0.06) and C1 purple/violet primaries unless the brand explicitly defines them; the `brand-consistency` rule validates emitted tokens against the active brand profile.
+- [`docs/guidelines/design-antipatterns.md`](../../guidelines/design-antipatterns.md) — when authoring the colour layer, avoid the C5 cream/sand default palette (OKLCH L 0.84–0.97, C < 0.06) and C1 purple/violet primaries unless the brand explicitly defines them; the `brand-consistency` rule validates emitted tokens against the active brand profile.

package/dist/agent-src/skills/design-variations/SKILL.md

@@ -79,7 +79,7 @@ existing design → [`design-review`](../design-review/SKILL.md).
 8. **Quality gate.** Novel ≠ sloppy: run `lint_design_slop` over the emitted
    file (every variation individually passes; a DESIGN.md-declared direction
    suppresses its flags) and honor the outward-artifact hygiene floor (Q13 in
-   [`design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md)) —
+   [`design-antipatterns.md`](../../guidelines/design-antipatterns.md)) —
    no workspace paths, skill/tool names, or generator traces in the markup.
    Final pass before delivery → [`design-review`](../design-review/SKILL.md).
 
@@ -127,4 +127,4 @@ existing design → [`design-review`](../design-review/SKILL.md).
 - [`design-tokens`](../design-tokens/SKILL.md) — token emission for variation values.
 - [`fe-design`](../fe-design/SKILL.md) — production heuristics the by-the-book variation follows.
 - [`design-review`](../design-review/SKILL.md) — final gate before delivery.
-- [`docs/guidelines/design-antipatterns.md`](../../../docs/guidelines/design-antipatterns.md) — catalog + Q13 outward-artifact hygiene.
+- [`docs/guidelines/design-antipatterns.md`](../../guidelines/design-antipatterns.md) — catalog + Q13 outward-artifact hygiene.

package/dist/agent-src/skills/developer-like-execution/SKILL.md

@@ -135,14 +135,14 @@ If important information is missing:
 - Compare with requirements, tickets, current behavior, tests, existing patterns
 - Identify likely cause and smallest correct change
 - **Consult memory — invariants and prior decisions.** Via
-  [`memory-access`](../../../docs/guidelines/agent-infra/memory-access.md), call
+  [`memory-access`](../../guidelines/agent-infra/memory-access.md), call
   `retrieve(types=["domain-invariants"], keys=<touched paths>, limit=3)`.
   A matching `domain-invariant` is a hard constraint — violating it = regression,
   surface the conflict to the user before proceeding. For architectural rationale
   (*why* the current shape exists), check the ADR index
   [`docs/decisions/INDEX.md`](../../../docs/decisions/INDEX.md); plan around it, do
   not silently overturn it. Cite matching `id`s / ADR numbers in the plan.
-  See [`engineering-memory-data-format`](../../../docs/guidelines/agent-infra/engineering-memory-data-format.md)
+  See [`engineering-memory-data-format`](../../guidelines/agent-infra/engineering-memory-data-format.md)
   for the schema.
 
 ### 4. Define expected behavior first

package/dist/agent-src/skills/discovery-interview/SKILL.md

@@ -36,7 +36,7 @@ quantitative survey design or scale-bound research.
 - **Mental model 22 — Data-informed, not data-driven.** Interview
   data is signal at low N; treat it as evidence to reason with, not
   a vote count. See
-  [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 22.
+  [`docs/contracts/mental-models.md`](../../docs/contracts/mental-models.md) § 22.
 - **Mental model 15 — Signal vs noise.** A vivid quote from one
   articulate user can swamp three muted but consistent signals;
   frequency-rank by distinct people, never by quote count. See
@@ -47,7 +47,7 @@ quantitative survey design or scale-bound research.
   `mental-models.md` § 28.
 - **Product context-spine slot.** Read **product** for the focal job
   + competitor names; do **not** re-derive these inside this skill.
-  See [`context-spine`](../../../docs/contracts/context-spine.md).
+  See [`context-spine`](../../docs/contracts/context-spine.md).
 
 ## Procedure
 

package/dist/agent-src/skills/doc-coauthoring/SKILL.md

@@ -15,7 +15,7 @@ packs:
 
 > **Cross-surface handoff.** When this document consumes upstream work (research
 > → document, spreadsheet → report), read the handoff envelope from
-> [`surface-agent-contracts`](../../../docs/contracts/surface-agent-contracts.md#cross-surface-handoff-envelope):
+> [`surface-agent-contracts`](../../docs/contracts/surface-agent-contracts.md#cross-surface-handoff-envelope):
 > trust `verification_already_done`, honour source restrictions, and don't
 > re-fetch what the source already grounded.
 
@@ -49,7 +49,7 @@ Move from a fuzzy ask to a complete document the user owns, by:
 ## Document format & export floor
 
 The document surface's floor (per
-[`surface-agent-contracts`](../../../docs/contracts/surface-agent-contracts.md)):
+[`surface-agent-contracts`](../../docs/contracts/surface-agent-contracts.md)):
 
 - **Choose the format by intent.** Markdown vs `.docx` vs PDF follows what the
   user will DO with it — when a named format is requested, produce THAT format
@@ -63,7 +63,7 @@ The document surface's floor (per
   selectable. (fixture: `ssac-pdf-screenshot-rasterized`.)
 - **Verify the output opens/exports.** Confirm the generated file opens /
   round-trips
-  ([`design-artifact-verification`](../../../docs/contracts/design-artifact-verification.md));
+  ([`design-artifact-verification`](../../docs/contracts/design-artifact-verification.md));
   where the format's tooling is absent, ship the source + say what could not be
   verified rather than claiming a produced file.
 

package/dist/agent-src/skills/editorial-calendar/SKILL.md

@@ -36,7 +36,7 @@ scope — channel-agnostic skill), or sequence a one-off launch wave
   the editorial beats produce 80 % of the audience pull. The
   calendar is the discipline of doubling down on the 20 % and
   letting the 80 % be reactive, not core. See
-  [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 3.
+  [`docs/contracts/mental-models.md`](../../docs/contracts/mental-models.md) § 3.
 - **Mental model 18 — Pull vs. push systems.** Evergreen content is
   a *pull* system (the audience finds it); campaigns are a *push*
   system (we time the arrival). The calendar separates the two so
@@ -48,7 +48,7 @@ scope — channel-agnostic skill), or sequence a one-off launch wave
   for where the audience is in the awareness arc, and
   **funnel-stage** for whether a beat is top-of-funnel reach or
   mid-funnel proof. See
-  [`context-spine`](../../../docs/contracts/context-spine.md).
+  [`context-spine`](../../docs/contracts/context-spine.md).
 
 ## Procedure
 

package/dist/agent-src/skills/existing-ui-audit/SKILL.md

@@ -37,7 +37,7 @@ Do NOT use when:
 
 Any request to **recreate, redesign, mock, prototype, or improve** a UI runs
 this gate BEFORE styling — the Inspect stage of the
-[design-artifact lifecycle](../../../docs/contracts/design-artifact-lifecycle.md).
+[design-artifact lifecycle](../../docs/contracts/design-artifact-lifecycle.md).
 Design starts from project truth, not generic aesthetic memory.
 
 - **Search first (owned UI).** Before proposing anything, search the project
@@ -202,6 +202,49 @@ For each item in `state.ui_audit.components`, score similarity to `state.input.d
 
 If `candidates` is empty, the user is building net-new. That is normal — record the empty list, do not halt.
 
+#### 6b. Conformance gate — when a provided artifact is the spec
+
+Similarity above is scored against `state.input.data`. That answers *"is this
+component like the thing being asked for"* and it does **not** answer *"does
+this component satisfy the artifact"* — which is a different question with a
+different answer, because a candidate can be an excellent name-and-props match
+and still use the wrong type scale, the wrong control, or a colour the artifact
+never states. Until this step existed nothing anywhere asked the second
+question, while [`ui-audit-gate`](../../rules/ui-audit-gate.md) carried *"reuse
+beats duplication"* as unqualified prose. Reused on an artifact port, an
+unconforming candidate is a fidelity deviation dressed as good hygiene.
+
+So when a provided design artifact is the spec
+([`design-fidelity`](../../rules/design-fidelity.md)), each candidate carries a
+**conformance verdict** alongside its score, and reuse is conditional on it:
+
+```
+[{path, name, score, reason,
+  conformance: {verdict: "conforms|deviates|unknown",
+                dimensions: {structure, values, behaviour, responsive},
+                refused_by: "values"}}, ...]
+```
+
+- **`conforms`** → reuse it. This is the ordinary case and nothing changed.
+- **`deviates`** → do **not** reuse silently. Name the dimension that refused
+  it — *"`Card` deviates on `values`: type scale 14/20 against the artifact's
+  16/24"* — and surface reuse-with-adaptation versus build-new as a choice.
+  A bare "candidate rejected" is not a discharge; the caller cannot act on it.
+- **`unknown`** → the candidate was not scored against the artifact (no
+  extraction yet, or a subtree the audit could not read). Treat as `deviates`
+  for the purpose of not reusing silently, and say which of the two it is —
+  "did not conform" and "was not checked" are different facts.
+
+**And the decision moves after extraction, not before it.** A conformance
+verdict needs the artifact's own values, so a reuse decision taken before
+extraction is taken without the evidence that decides it. Where the run has an
+artifact, order is: extract → audit → score → conform → decide. The unqualified
+reuse-first ordering stands only where there is no artifact to conform to.
+
+**Scope:** this is a gate on REUSE, not a license to rewrite the incumbent. A
+candidate that deviates is left alone; the choice is whether *this* work builds
+on it.
+
 ### 7. Greenfield branch
 
 If **all** are true:

package/dist/agent-src/skills/existing-ui-audit/references/anti-slop-cross-reference.md

@@ -9,7 +9,7 @@
 When the audit inventory reveals an existing aesthetic direction (dominant color
 scheme, border-radius convention, motion patterns), cross-check the findings
 against
-[`docs/guidelines/design-antipatterns.md`](../../../../docs/guidelines/design-antipatterns.md).
+[`docs/guidelines/design-antipatterns.md`](../../../guidelines/design-antipatterns.md).
 If the existing UI already uses a listed anti-pattern, surface it as a design-debt
 finding (separate from the reuse inventory) — flag by entry ID and severity.
 
@@ -26,6 +26,6 @@ A corrective direction change against a supplied spec is not a design
 improvement, it is overriding a decision the user already made — the failure
 [`design-fidelity`](../../rules/design-fidelity.md) exists to prevent, arriving
 through the audit's side door. Precedence and its exact scope:
-[`design-fidelity-mechanics`](../../../../docs/guidelines/design-fidelity-mechanics.md)
+[`design-fidelity-mechanics`](../../../guidelines/design-fidelity-mechanics.md)
 § Provided-artifact precedence. Where the two sources disagree, surface the
 conflict rather than picking (fixture `daf-slop-vs-provided`).

package/dist/agent-src/skills/expansion-playbook/SKILL.md

@@ -36,7 +36,7 @@ unattended by a human play (route to `retention-loops`).
   vendor pushes (because the quarter needs the number) corrodes
   the relationship and inflates churn the next cycle. Pick the
   trigger that signals pull. See
-  [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 18.
+  [`docs/contracts/mental-models.md`](../../docs/contracts/mental-models.md) § 18.
 - **Mental model 9 — Hypothesis-driven thinking.** Each expansion
   trigger is a hypothesis: *"if signal X is true, the buyer will
   accept expansion Y at price Z."* Triggers without falsification
@@ -52,7 +52,7 @@ unattended by a human play (route to `retention-loops`).
   segment cannot use yet inflates churn), and the
   **customer-segment** slot for switch-event patterns that signal
   organic scope expansion. See
-  [`context-spine`](../../../docs/contracts/context-spine.md).
+  [`context-spine`](../../docs/contracts/context-spine.md).
 
 ## Procedure
 

package/dist/agent-src/skills/experiment-loop/SKILL.md

@@ -13,7 +13,7 @@ packs:
 
 > A bounded **change → commit → evaluate → keep-or-revert** cycle against a
 > **scalar metric**, where the decision input is an
-> [evaluator-output](../../../docs/contracts/evaluator-output.md) verdict and the
+> [evaluator-output](../../docs/contracts/evaluator-output.md) verdict and the
 > loop's entire state lives in an append-only register on disk.
 
 This file **routes**. The protocol, the register format, and the pivot ladder are

package/dist/agent-src/skills/experiment-loop/references/protocol.md

@@ -16,7 +16,7 @@ Loaded on demand by [`experiment-loop`](../SKILL.md). One iteration, in order.
 4. **Commit.** The revert is then a git operation rather than a manual undo, and
    the branch carries one commit per iteration whether it survives or not.
 5. **Evaluate** — run the evaluator, read its
-   [evaluator-output](../../../../../docs/contracts/evaluator-output.md) verdict.
+   [evaluator-output](../../../docs/contracts/evaluator-output.md) verdict.
 6. **Decide**, and update the row:
 
    | Verdict | Decision |