@event4u/agent-config 14.23.0 → 15.0.0

package/dist/agent-src/skills/blast-radius-analyzer/SKILL.md

@@ -88,7 +88,7 @@ For every dependency, mark:
 
 ### 5. Consult engineering memory
 
-Via [`memory-access`](../../../docs/guidelines/agent-infra/memory-access.md) call
+Via [`memory-access`](../../guidelines/agent-infra/memory-access.md) call
 `retrieve(types=["ownership"],
 keys=<changed paths + changed symbol>, limit=5)`. Surface:
 

package/dist/agent-src/skills/brand-to-tokens/SKILL.md

@@ -27,7 +27,28 @@ execution:
 > hands it to the [`design-tokens`](../design-tokens/SKILL.md) toolchain to emit
 > CSS vars + Tailwind. The same `.tokens.json` is the export that pack-ai-image
 > brand-asset generation and the greenfield scaffold seed consume (B → A;
-> contract: [`brand-token-consumption`](../../../docs/contracts/brand-token-consumption.md)).
+> contract: [`brand-token-consumption`](../../docs/contracts/brand-token-consumption.md)).
+
+## Known contradiction — the filename this skill authors is not the one the resolver reads
+
+**Recorded, not resolved.** This skill's prose says to author `.tokens.json`,
+and the only resolver in the tree reads `tokens.json` — `BRAND_TOKEN_PATHS`
+searches `tokens.json`, `assets/tokens.json`, `resources/tokens.json` and
+`agents/settings/brand/tokens.json` <!-- ref-ignore -->, none of them
+dot-prefixed. A consumer
+following this skill literally therefore produces a file nothing loads.
+
+The authoring name is a consumer-visible decision and is deliberately not
+changed here. What closes the gap in the meantime is
+`agent-config brand:status`, which reports which of the four paths holds a file
+— and separately flags a dot-prefixed `.tokens.json`, which is exactly the file
+a reader of this skill would plausibly have created.
+
+Moved here from [`brand-source-of-truth`](../../rules/brand-source-of-truth.md)
+on 2026-09-09: it is a note about this skill, and its 6 lines in a standing rule
+were paid for on every subagent spawn. The substitution funded that rule's
+artifact-versus-brand pointer, per the council verdict on
+`blocker: standing-payload-headroom`.
 
 ## When to use
 
@@ -98,9 +119,9 @@ execution:
 
 ## See also
 
-- [`design-canon.md`](../../../docs/guidelines/design-canon.md) § Colour references — culturally-situated palettes + a11y-contrast grounding when deriving brand colour tokens.
+- [`design-canon.md`](../../guidelines/design-canon.md) § Colour references — culturally-situated palettes + a11y-contrast grounding when deriving brand colour tokens.
 - [`brand-identity`](../brand-identity/SKILL.md) — supplies the constraint set this skill derives tokens from.
 - [`design-tokens`](../design-tokens/SKILL.md) — the DTCG toolchain that emits CSS/Tailwind from `.tokens.json`.
 - [`typography-system`](../typography-system/SKILL.md) — brand-aware stage-2 supplies the type tokens.
-- [`brand-token-consumption`](../../../docs/contracts/brand-token-consumption.md) — the read contract pack-ai-image and greenfield scaffold consume.
+- [`brand-token-consumption`](../../docs/contracts/brand-token-consumption.md) — the read contract pack-ai-image and greenfield scaffold consume.
 - [`brand-consistency`](../../rules/brand-consistency.md) — validates emitted artifacts against this token source of truth.

package/dist/agent-src/skills/bug-analyzer/SKILL.md

@@ -96,7 +96,7 @@ Gather all available evidence before forming any hypothesis:
 - Read each file in the call chain to understand the data flow.
 - Check existing context docs (`agents/settings/contexts/`) for the affected area.
 - **Consult engineering memory.** Via
-  [`memory-access`](../../../docs/guidelines/agent-infra/memory-access.md) call
+  [`memory-access`](../../guidelines/agent-infra/memory-access.md) call
   `retrieve(types=["historical-patterns", "incident-learnings"],
   keys=[<error class>, <affected file paths>], limit=3)`. A prior
   matching pattern or incident is the single most reliable accelerator

package/dist/agent-src/skills/build-buy-partner/SKILL.md

@@ -27,7 +27,7 @@ Do NOT use for vendor selection within a "buy" decision (different skill), marke
 
 ## Cognition cluster
 
-- **Mental model 28 — Inversion.** *"What would force us to undo this choice in 18 months?"* Inversion surfaces the dependency-risk and integration-cost that the forward case understates. See [`mental-models.md`](../../../docs/contracts/mental-models.md) § 28.
+- **Mental model 28 — Inversion.** *"What would force us to undo this choice in 18 months?"* Inversion surfaces the dependency-risk and integration-cost that the forward case understates. See [`mental-models.md`](../../docs/contracts/mental-models.md) § 28.
 - **Mental model 21 — Second-order thinking.** Each option chains: build → ongoing maintenance + opportunity cost; buy → integration + lock-in; partner → dependency + boundary management. Single-order *"build is cheaper"* fails on the second-order. See `mental-models.md` § 21.
 - **Mental model 26 — Optionality.** Read each option by which choices it preserves (switch costs, re-build optionality, re-negotiation power) vs forecloses. The option with bounded foreclosure usually wins. See `mental-models.md` § 26.
 - **Context-spine — org-stage + product + customer-segment.** Read **org-stage** for capacity (pre-seed should buy almost everything non-core; growth-stage can build deeper). Read **product** for whether the capability is core-differentiation (build) or commodity (buy). Read **customer-segment** for whether enterprise-segment buyers require a build-it-yourself story.

package/dist/agent-src/skills/churn-prevention/SKILL.md

@@ -34,7 +34,7 @@ to `retention-loops`).
 - **Mental model 30 — Inversion.** Do not ask *"how do we keep this
   account?"* — ask *"name the reason this account will leave."* The
   inversion forces a cause; the cause picks the move. 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 16 — Leading vs. lagging indicators.** Cancellation
   is lagging; usage-decay, relationship-decay, and fit-mismatch
   signals are leading. A health score built on lagging signals can
@@ -50,7 +50,7 @@ to `retention-loops`).
   the **customer-segment** slot for the segment's switch-event
   patterns — fit-churn shows up early in segments whose switch
   event differs from the ICP. See
-  [`context-spine`](../../../docs/contracts/context-spine.md).
+  [`context-spine`](../../docs/contracts/context-spine.md).
 
 ## Procedure
 

package/dist/agent-src/skills/code-refactoring/SKILL.md

@@ -34,7 +34,7 @@ Do NOT use when:
    well (`switch` / `match` / if-chains over it, lookup tables keyed by it,
    validators, serializers, schemas, fixtures, translation keys) and classify each
    as exhaustive, deliberate fallback, or missing case. Procedure:
-   [`downstream-changes-mechanics`](../../../docs/guidelines/agent-infra/downstream-changes-mechanics.md).
+   [`downstream-changes-mechanics`](../../guidelines/agent-infra/downstream-changes-mechanics.md).
 4. **Map the impact** — create a list of all files that will need changes.
 5. **Decide the verdict, if the refactor is a de-duplication** — see the
    safe-abstraction gate below. An extraction with no recorded verdict is a
@@ -66,13 +66,13 @@ read identically can encode different assumptions, and merging them changes
 behaviour silently.
 
 The class names and the full verdict list are in
-[`redundancy-taxonomy`](../../../docs/guidelines/redundancy-taxonomy.md).
+[`redundancy-taxonomy`](../../guidelines/redundancy-taxonomy.md).
 
 When the refactor goes the other way and **creates** a new unit, the reuse
 question comes first: does an existing class or component already cover this, and
 what does composing or extending it cost against a new one? Thresholds per
 artifact class:
-[`component-oriented-and-oop-development`](../../../docs/guidelines/component-oriented-and-oop-development.md).
+[`component-oriented-and-oop-development`](../../guidelines/component-oriented-and-oop-development.md).
 
 ## Procedure: Refactor code
 

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

@@ -52,7 +52,7 @@ principle, not a decision, and it has no answer for the case where two copies
 should stay. Replace it with a verdict.
 
 Classify the finding against
-[`redundancy-taxonomy`](../../../docs/guidelines/redundancy-taxonomy.md) —
+[`redundancy-taxonomy`](../../guidelines/redundancy-taxonomy.md) —
 implementation, knowledge, or representation — and record one verdict from that
 document's list. `keep-duplicated` and `de-abstract` are successful outcomes; a
 finding with no recorded verdict stays open. Knowledge, policy, contract and
@@ -85,7 +85,7 @@ consumers and their status — every `switch` / `match` / if-chain over the type
 every lookup table keyed by it, every validator, serializer, schema, fixture and
 translation key. A `default` branch that silently absorbs the new member is a
 missing case, not a handled one. Procedure:
-[`downstream-changes-mechanics`](../../../docs/guidelines/agent-infra/downstream-changes-mechanics.md).
+[`downstream-changes-mechanics`](../../guidelines/agent-infra/downstream-changes-mechanics.md).
 
 **A shared behaviour moved and its siblings did not.** A defect fixed in one
 place is presumed to recur until searched: name the exact wrong construct, grep
@@ -100,7 +100,7 @@ changing one, the question is whether it needed to exist: what was searched,
 what was found, and why composing or extending the incumbent was rejected. An
 answer, not a ceremony — and the thresholds for when repetition actually earns
 an abstraction are in
-[`component-oriented-and-oop-development`](../../../docs/guidelines/component-oriented-and-oop-development.md).
+[`component-oriented-and-oop-development`](../../guidelines/component-oriented-and-oop-development.md).
 
 ## Change-type routing — load only the checklist the diff needs
 

package/dist/agent-src/skills/command-writing/SKILL.md

@@ -39,7 +39,7 @@ author as a skill and add a thin command that delegates to it.
 
 **A command must EARN a top-level slot.** Only three justifications qualify:
 **flow-entry**, **state-query**, or **product-surface** — everything else is a
-skill. Check before authoring: [`command-clusters` § Command justification](../../../docs/contracts/command-clusters.md#command-justification--a-command-must-earn-a-top-level-slot)
+skill. Check before authoring: [`command-clusters` § Command justification](../../docs/contracts/command-clusters.md#command-justification--a-command-must-earn-a-top-level-slot)
 ([ADR-048](../../../docs/decisions/ADR-048-command-justification-rule.md)).
 
 **Categorize at creation (checklist).** When you author a NEW top-level command,
@@ -56,7 +56,7 @@ is `flow-entry | state-query | product-surface`:
 
 Sub-commands (`council:debate`) inherit the parent cluster's category — leave
 `category:` off them. Why optional + not yet a blocking lint, and what triggers
-the upgrade: [`command-category-governance`](../../../docs/contracts/command-category-governance.md).
+the upgrade: [`command-category-governance`](../../docs/contracts/command-category-governance.md).
 
 ## Commands ARE Claude skills (projection reality)
 
@@ -346,4 +346,4 @@ Workflow sequencing, preconditions, ID/output provenance ("copy ids verbatim,
 never from memory"), a mandatory "why" intent field, and turn-end contracts
 belong INSIDE this artifact's description/frontmatter — where they fire at the
 decision point — not in always-on prose. See
-[`tool-description-as-policy`](../../../docs/guidelines/agent-infra/tool-description-as-policy.md).
+[`tool-description-as-policy`](../../guidelines/agent-infra/tool-description-as-policy.md).

package/dist/agent-src/skills/comp-banding/SKILL.md

@@ -28,7 +28,7 @@ Do NOT use as a payroll / equity-administration substitute (this skill produces
 
 ## Cognition cluster
 
-- **Mental model 1 — First principles.** Strip every comp question to: *what behavior are we paying for, over what horizon, with what risk-bearing?* Cash pays for present effort; equity pays for future co-built value with risk; bonus pays for outcome-linked behavior. Mixing the levers without first-principles intent produces confusion. See [`mental-models.md`](../../../docs/contracts/mental-models.md) § 1.
+- **Mental model 1 — First principles.** Strip every comp question to: *what behavior are we paying for, over what horizon, with what risk-bearing?* Cash pays for present effort; equity pays for future co-built value with risk; bonus pays for outcome-linked behavior. Mixing the levers without first-principles intent produces confusion. See [`mental-models.md`](../../docs/contracts/mental-models.md) § 1.
 - **Mental model 28 — Inversion.** *"What comp shape would force our best people to leave?"* Inversion surfaces the load-bearing risks (condensation at senior levels, equity refresh gaps, geo arbitrage that punishes loyalty).
 - **Mental model 26 — Optionality.** Each comp lever preserves or forecloses future options. Above-band offers preserve hire optionality but foreclose internal-equity optionality. Equity-heavy mix preserves cash runway but forecloses people who need liquidity. Read every move as an optionality trade.
 - **Mental model 21 — Second-order thinking.** A raise to one person ripples (perceived parity, retention pressure on peers, expectation-setting for next cycle). A band shift ripples (new-hire offers anchor higher, internal expectations re-anchor). Comp moves rarely stay isolated.

package/dist/agent-src/skills/competitive-moat-analysis/SKILL.md

@@ -27,7 +27,7 @@ Do NOT use for narrative / messaging surface (route to Wing-3 `positioning-strat
 
 ## Cognition cluster
 
-- **Mental model 18 — Where to play, where not to play.** A moat is read as much from *what we refuse to do* as from what we do. Trying to win everywhere = winning nowhere. See [`mental-models.md`](../../../docs/contracts/mental-models.md) § 18.
+- **Mental model 18 — Where to play, where not to play.** A moat is read as much from *what we refuse to do* as from what we do. Trying to win everywhere = winning nowhere. See [`mental-models.md`](../../docs/contracts/mental-models.md) § 18.
 - **Mental model 28 — Inversion.** *"What would force a customer to leave us for an incumbent?"* The inversion answer surfaces the load-bearing moat assumption. If the answer is *"nothing"*, the moat is wishful; if the answer is concrete, that's the real fragility. See `mental-models.md` § 28.
 - **Mental model 21 — Second-order thinking.** Moats compound or decay; *"feature parity today"* says nothing about *"feature parity in 18 months"*. Read each moat by its compounding rate, not its current state. See `mental-models.md` § 21.
 - **Context-spine — customer-segment + product + org-stage.** Read **customer-segment** for which incumbent matters in which segment (the enterprise incumbent is rarely the SMB incumbent). Read **product** for which moats are real vs roadmap. Read **org-stage** for moat realism (pre-revenue moats are claims; growth-stage moats are evidence).

package/dist/agent-src/skills/competitive-positioning/SKILL.md

@@ -35,7 +35,7 @@ DCF-style valuation work (route to `dcf-modeling`).
   outcome each package promises its user, not the feature lists. Two
   packages with overlapping features can promise different outcomes
   and therefore are not direct competitors. See
-  [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 1.
+  [`docs/contracts/mental-models.md`](../../docs/contracts/mental-models.md) § 1.
 - **Mental model 24 — Optionality.** A pattern that costs little to
   adopt and preserves exit value beats a "better" pattern that locks
   the package in. Score adoption cost AND exit cost on every row. See
@@ -46,7 +46,7 @@ DCF-style valuation work (route to `dcf-modeling`).
 - **Product context-spine slot.** Read the **product** slot for
   segment / focal job / non-goals before picking axes; the comparison
   is only legitimate inside our own scope. See
-  [`context-spine`](../../../docs/contracts/context-spine.md).
+  [`context-spine`](../../docs/contracts/context-spine.md).
 
 ## Procedure
 

package/dist/agent-src/skills/complexity-first-planning/SKILL.md

@@ -44,7 +44,7 @@ unknown to resolve), or when the user has already fixed the sequence.
 
 1. **Inspect and name the unknowns.** Read the affected components first
    (start from the **repo** slot of the
-   [context-spine](../../../docs/contracts/context-spine.md) when present),
+   [context-spine](../../docs/contracts/context-spine.md) when present),
    then list which carry real uncertainty (technical feasibility, an
    unverified integration, an ambiguous requirement) — analyze the existing
    system before planning any change.

package/dist/agent-src/skills/condense-memory/SKILL.md

@@ -125,5 +125,5 @@ A future `telegraph-v2.md` will tabulate the realised input-token saving against
 - [`src/scripts/validate_safe_paths.ts`](../../../src/scripts/validate_safe_paths.ts) — Phase 0 gate; ported from upstream Telegraph `63a91ec`.
 - [`src/scripts/condense_memory.ts`](../../../src/scripts/condense_memory.ts) — implementation.
 - [`tests/scripts/condense_memory.test.ts`](../../../tests/scripts/condense_memory.test.ts) — regression locks for each carve-out + idempotency + denylist.
-- [`docs/contracts/condensation-default-kill-criterion.md`](../../../docs/contracts/condensation-default-kill-criterion.md) — v1 verdict (output-side; informs but does not gate this skill).
+- [`docs/contracts/condensation-default-kill-criterion.md`](../../docs/contracts/condensation-default-kill-criterion.md) — v1 verdict (output-side; informs but does not gate this skill).
 - [`agents-md-thin-root`](../agents-md-thin-root/SKILL.md) — caps the consumer-shipped `templates/AGENTS.md`; this skill is one tool to land under the cap.

package/dist/agent-src/skills/content-funnel-design/SKILL.md

@@ -37,7 +37,7 @@ draft the asset itself (downstream of this skill).
   funnel design is the discipline of placing the heaviest content
   investment at the structural leverage point, not the parameter
   one. See
-  [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 14.
+  [`docs/contracts/mental-models.md`](../../docs/contracts/mental-models.md) § 14.
 - **Mental model 6 — Theory of constraints.** The slow funnel stage
   caps the whole pipeline. Adding content elsewhere does not loosen
   the constraint. See `mental-models.md` § 6.
@@ -52,7 +52,7 @@ draft the asset itself (downstream of this skill).
   the asset, **customer-segment** for whose questions the asset
   answers, and **product** for the proofs the asset can actually
   back. See
-  [`context-spine`](../../../docs/contracts/context-spine.md).
+  [`context-spine`](../../docs/contracts/context-spine.md).
 
 ## Procedure
 

package/dist/agent-src/skills/contracts-cognition/SKILL.md

@@ -29,7 +29,7 @@ Do NOT use as a substitute for actual legal counsel (this skill produces the *no
 
 ## Cognition cluster
 
-- **Mental model 28 — Inversion.** *"What would force us to invoke this clause? What would force the counterparty to invoke it?"* Inversion surfaces which clauses are dormant boilerplate vs which are loaded triggers. See [`mental-models.md`](../../../docs/contracts/mental-models.md) § 28.
+- **Mental model 28 — Inversion.** *"What would force us to invoke this clause? What would force the counterparty to invoke it?"* Inversion surfaces which clauses are dormant boilerplate vs which are loaded triggers. See [`mental-models.md`](../../docs/contracts/mental-models.md) § 28.
 - **Mental model 21 — Second-order thinking.** Each clause has a second-order shape: indemnity caps interact with insurance coverage; SLAs interact with operating-cost; auto-renewal interacts with switching cost. Reading clauses in isolation misses the load-bearing combinations. See `mental-models.md` § 21.
 - **Mental model 26 — Optionality.** Each clause either preserves or forecloses future choices (terminate-for-convenience preserves; auto-renewal forecloses; exclusivity forecloses; MFN forecloses). The cost of a clause is the optionality it removes. See `mental-models.md` § 26.
 - **Context-spine — regulatory-regime + customer-segment + org-stage.** Read **regulatory-regime** (J1) for floor-bound clauses (GDPR DPA terms, HIPAA BAA, SOC 2 audit). Read **customer-segment** for risk sizing (enterprise SLA terms ≠ SMB SLA terms). Read **org-stage** for what's affordable (early-stage = avoid uncapped indemnities; growth = can absorb tighter SLAs).

package/dist/agent-src/skills/copilot-agents-optimization/SKILL.md

@@ -130,7 +130,7 @@ both. Instead, reference with a table:
 | What | Where |
 |---|---|
 | PHP coding rules | `.augment/rules/php-coding.md` |
-| Controller guidelines | `../../../docs/guidelines/php/controllers.md` |
+| Controller guidelines | `../../guidelines/php/controllers.md` |
 ```
 
 ## Line Budget Enforcement
@@ -192,7 +192,7 @@ broken. When optimizing, **keep that section intact** — never delete
 it as "redundant" and never trim its bullets. The patterns it covers:
 
 - Relative cross-references inside `.augment/` rules / skills
-  (`../docs/guidelines/foo.md`, `../contexts/bar.md`) — paths resolve
+  (`../../guidelines/foo.md`, `../contexts/bar.md`) — paths resolve
   from the file's delivered location, not from the symlink in
   `.claude/rules/` etc. (per `road-to-path-fixes.md` Strategy A).
 - `path_prefix:` triggers containing `src/` —

package/dist/agent-src/skills/corpus-grounding/SKILL.md

@@ -63,7 +63,7 @@ frontend-hardcoded axis moved into the manifest. Full license obligations:
 ### Invocation (consumer runtime)
 
 Scripts resolve all paths **skill-relative** (per
-[`docs/contracts/skill-bundled-assets.md`](../../../docs/contracts/skill-bundled-assets.md))
+[`docs/contracts/skill-bundled-assets.md`](../../docs/contracts/skill-bundled-assets.md))
 — they work from any cwd:
 
 ```bash
@@ -226,5 +226,5 @@ the skill shipping the manifest, and its containment is `resolve_data_path`.
   (frontend corpus + manifest).
 - [ADR-061](../../../docs/decisions/ADR-061-corpus-grounding-layer.md) —
   architecture, qualification rubric, fork resolutions.
-- [`docs/contracts/skill-bundled-assets.md`](../../../docs/contracts/skill-bundled-assets.md)
+- [`docs/contracts/skill-bundled-assets.md`](../../docs/contracts/skill-bundled-assets.md)
   — how bundled `scripts/` + `data/` reach consumer runtime.

package/dist/agent-src/skills/customer-research/SKILL.md

@@ -33,7 +33,7 @@ this skill is about depth-5-to-10 interviews, not statistics.
 
 - **Mental model 2 — Jobs-to-be-Done.** Frames every question against
   the **switch event**: what caused the user to fire the previous
-  solution? See [`docs/contracts/mental-models.md`](../../../docs/contracts/mental-models.md) § 2.
+  solution? See [`docs/contracts/mental-models.md`](../../docs/contracts/mental-models.md) § 2.
 - **Mental model 3 — Pareto principle.** A research week that
   produces 12 distinct insights is usually re-discovering the same
   three. See `mental-models.md` § 3.
@@ -43,7 +43,7 @@ this skill is about depth-5-to-10 interviews, not statistics.
 ### Step 0: Frame the job
 
 1. Write one sentence: *"Users hire \<thing\> to make progress in \<situation\>, when motivated by \<pressure\>, expecting \<outcome\>."* If you cannot finish the sentence, the discovery slice is not yet shaped — stop and route to `po-discovery`.
-2. Read the **product** slot of the [context-spine](../../../docs/contracts/context-spine.md) (if the consumer project has filled it) for bounded scope, and the **team** slot for the senior PO / researcher handoff target. Skip if absent — note in the brief.
+2. Read the **product** slot of the [context-spine](../../docs/contracts/context-spine.md) (if the consumer project has filled it) for bounded scope, and the **team** slot for the senior PO / researcher handoff target. Skip if absent — note in the brief.
 3. Identify **one** competing solution the user might fire. Multiple competitors per session blurs the switch event.
 
 ### Step 1: Recruit the right 5–8

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