@event4u/agent-config 14.23.0 → 16.0.0

package/dist/agent-src/commands/jira-ticket.md

@@ -81,4 +81,4 @@ packs:
 
 ## See also
 
-- [`role-contracts`](../docs/guidelines/agent-infra/role-contracts.md#developer) — Developer mode output contract (Goal / Plan / Changes / Tests / Open questions)
+- [`role-contracts`](../guidelines/agent-infra/role-contracts.md#developer) — Developer mode output contract (Goal / Plan / Changes / Tests / Open questions)

package/dist/agent-src/commands/judge/solo.md

@@ -94,4 +94,4 @@ Next step: <what the user should do based on the verdict>
 - [`subagent-orchestration`](../skills/subagent-orchestration/SKILL.md)
 - [`/judge on-diff`](do-and-judge.md) — if a revision loop is wanted
 - [`/review-changes`](review-changes.md) — human-oriented self-review
-- [`role-contracts`](../../docs/guidelines/agent-infra/role-contracts.md#reviewer) — Reviewer mode output contract (Summary / Risks / Findings / Required actions / Verdict)
+- [`role-contracts`](../../guidelines/agent-infra/role-contracts.md#reviewer) — Reviewer mode output contract (Summary / Risks / Findings / Required actions / Verdict)

package/dist/agent-src/commands/judge.md

@@ -84,4 +84,4 @@ the implementer loop, so it never fires on a bare safe-default fallback.
 
 - [`subagent-orchestration`](../skills/subagent-orchestration/SKILL.md)
 - [`/review`](review-changes.md) — human-oriented self-review (Reviewer-mode contract)
-- [`role-contracts`](../docs/guidelines/agent-infra/role-contracts.md#reviewer)
+- [`role-contracts`](../guidelines/agent-infra/role-contracts.md#reviewer)

package/dist/agent-src/commands/knowledge/cross-repo.md

@@ -23,7 +23,7 @@ Targeted, **read-only** retrieval across the IDE-attached sibling repos the user
 has opted into (`linked_projects[].include: true`). Returns a bounded set of
 matches — a shared type, an API contract the frontend consumes, a config the
 sibling owns — **without bulk-including** any sibling file. Implements
-[`cross-repo-retrieval`](../../../docs/contracts/cross-repo-retrieval.md) and
+[`cross-repo-retrieval`](../../docs/contracts/cross-repo-retrieval.md) and
 stays inside [ADR-032](../../../docs/decisions/ADR-032-linked-projects-scope.md)
 Option A.
 

package/dist/agent-src/commands/knowledge/forget.md

@@ -93,5 +93,5 @@ If the prefix matched multiple ingests:
 
 - [`/knowledge ingest`](ingest.md) — add a new ingest.
 - [`/knowledge list`](list.md) — find an id prefix.
-- [`local-knowledge-ingestion`](../../../docs/contracts/local-knowledge-ingestion.md)
+- [`local-knowledge-ingestion`](../../docs/contracts/local-knowledge-ingestion.md)
   § Storage — directory layout.

package/dist/agent-src/commands/knowledge/ingest.md

@@ -21,7 +21,7 @@ packs:
 
 Indexes a local path into the agent's memory namespace. Local-only,
 single-user, bounded. Implements the
-[`local-knowledge-ingestion`](../../../docs/contracts/local-knowledge-ingestion.md)
+[`local-knowledge-ingestion`](../../docs/contracts/local-knowledge-ingestion.md)
 contract.
 
 ## Prerequisites
@@ -107,7 +107,7 @@ Show the user how to retrieve:
 
 ## See also
 
-- [`local-knowledge-ingestion`](../../../docs/contracts/local-knowledge-ingestion.md)
+- [`local-knowledge-ingestion`](../../docs/contracts/local-knowledge-ingestion.md)
   — contract (input shapes, bounds, storage, redaction).
 - [`/knowledge list`](list.md) — what's been ingested, pinning.
 - [`/knowledge forget`](forget.md) — drop an ingest atomically.

package/dist/agent-src/commands/knowledge/list.md

@@ -100,5 +100,5 @@ user has already provided. See also
 
 - [`/knowledge ingest`](ingest.md) — add a new ingest.
 - [`/knowledge forget`](forget.md) — drop an ingest atomically.
-- [`local-knowledge-ingestion`](../../../docs/contracts/local-knowledge-ingestion.md)
+- [`local-knowledge-ingestion`](../../docs/contracts/local-knowledge-ingestion.md)
   § Bounds — when LRU fires.

package/dist/agent-src/commands/memory/add.md

@@ -20,7 +20,7 @@ packs:
 Creates or updates a single entry in one of the four engineering-memory
 YAML files under `agents/memory/` in the consumer project. The entry
 is validated against the schema in
-[`engineering-memory-data-format`](../../docs/guidelines/agent-infra/engineering-memory-data-format.md)
+[`engineering-memory-data-format`](../../guidelines/agent-infra/engineering-memory-data-format.md)
 before the file is written.
 
 Absence of these files is legal — this command is the entry point for
@@ -65,7 +65,7 @@ sharded layout: `agents/memory/<type>/*.yml`). For each existing
 ### 3. Collect the required fields
 
 All four types share the frontmatter in
-[`engineering-memory-data-format`](../../docs/guidelines/agent-infra/engineering-memory-data-format.md#shared-frontmatter-fields).
+[`engineering-memory-data-format`](../../guidelines/agent-infra/engineering-memory-data-format.md#shared-frontmatter-fields).
 Collect in this order, one numbered question at a time:
 
 1. `id` — kebab-case slug, unique within the type.
@@ -140,7 +140,7 @@ Read `verbosity.post_action_reports` from `.agent-settings.yml` (default
 
 ## See also
 
-- [`engineering-memory-data-format`](../../docs/guidelines/agent-infra/engineering-memory-data-format.md)
+- [`engineering-memory-data-format`](../../guidelines/agent-infra/engineering-memory-data-format.md)
   — full schema
 - [`skill:learning-to-rule-or-skill`](../skills/learning-to-rule-or-skill/SKILL.md) —
   when a learning is better captured as an `incident-learnings` entry vs

package/dist/agent-src/commands/memory/load.md

@@ -122,7 +122,7 @@ opts in.
 
 The agent should now treat every loaded entry as an authority signal
 with its declared `confidence` — see
-[`memory-access`](../../docs/guidelines/agent-infra/memory-access.md) for
+[`memory-access`](../../guidelines/agent-infra/memory-access.md) for
 how entries modulate edits.
 
 ### 5. Inline-review hook (intake backlog)
@@ -184,8 +184,8 @@ When resolving a knowledge/memory read — including cross-project access — cl
 the ladder and stop at the first rung that answers; do not jump straight to a
 full scan:
 
-1. **Hot cache** — the already-loaded session slice (`hot-context.md` / the
-   Tier-0 slice above); zero new reads.
+1. **Already loaded** — the session slice already in context (the Tier-0 slice
+   above, plus the `session_start` memory index when armed); zero new reads.
 2. **Index** — the lexical index / `memory_lookup retrieve_v1` over the keys.
 3. **Type index** — narrow to the relevant type directory, then its entries.
 4. **Entry** — read the specific entry only once the first three located it.
@@ -198,5 +198,5 @@ nothing on this" — never invent an entry to fill the gap.
 - [`memory-add`](memory-add.md) — add a single entry
 - [`memory-promote`](memory-promote.md) — promote an intake signal to
   a curated entry
-- [`memory-access`](../../docs/guidelines/agent-infra/memory-access.md) —
+- [`memory-access`](../../guidelines/agent-infra/memory-access.md) —
   how entries flow into agent decisions

package/dist/agent-src/commands/memory/mine-session.md

@@ -180,5 +180,5 @@ Confirm:
   `TranscriptAdapter` matches the current host.
 - [`memory:promote`](promote.md) — lifts validated intake lines into
   curated YAML.
-- [`memory-access`](../../../docs/guidelines/agent-infra/memory-access.md) —
+- [`memory-access`](../../guidelines/agent-infra/memory-access.md) —
   file-backed retrieval contract for curated + intake entries.

package/dist/agent-src/commands/memory/promote.md

@@ -69,7 +69,7 @@ gate script to lower the bar.
 ### 3. Draft the curated entry
 
 Using the schema in
-[`engineering-memory-data-format`](../../docs/guidelines/agent-infra/engineering-memory-data-format.md),
+[`engineering-memory-data-format`](../../guidelines/agent-infra/engineering-memory-data-format.md),
 hydrate the full frontmatter:
 
 - `id` — kebab-case slug (not the `sig-*` id — that is an intake marker).
@@ -83,7 +83,7 @@ hydrate the full frontmatter:
   on every `/memory:load` regardless of query — e.g. a tenant-isolation
   invariant or a payment-flow rule. The validator warns when a type
   accumulates more than 10 active critical entries; raise the bar
-  deliberately. See [`engineering-memory-data-format`](../../docs/guidelines/agent-infra/engineering-memory-data-format.md)
+  deliberately. See [`engineering-memory-data-format`](../../guidelines/agent-infra/engineering-memory-data-format.md)
   § Priority semantics for the full contract.
 - `ts_week:` — optional ISO-week stamp `YYYY-Www` (e.g. `2026-W17`).
   **Convention, not enforced.** Stamp the curated entry with the week
@@ -94,7 +94,7 @@ hydrate the full frontmatter:
   ```bash
   date -u +'%G-W%V'   # POSIX ISO week-numbering year + ISO week
   ```
-  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)
   § Temporal jitter for rationale.
 - Type-specific fields (`rule`, `symptom`, `path`, …).
 
@@ -236,4 +236,4 @@ Read `verbosity.post_action_reports` from `.agent-settings.yml` (default
 
 - [`/propose-memory`](propose-memory.md) — write-side entry point.
 - [`/memory-add`](memory-add.md) — direct curated write (skips intake).
-- [`engineering-memory-data-format`](../../docs/guidelines/agent-infra/engineering-memory-data-format.md)
+- [`engineering-memory-data-format`](../../guidelines/agent-infra/engineering-memory-data-format.md)

package/dist/agent-src/commands/memory/propose.md

@@ -131,6 +131,6 @@ is intended (rarely).
 ## See also
 
 - [`/memory-add`](memory-add.md) — curated (reviewer-validated) entries.
-- [`engineering-memory-data-format`](../../docs/guidelines/agent-infra/engineering-memory-data-format.md)
-- [`memory-access`](../../docs/guidelines/agent-infra/memory-access.md) — the
+- [`engineering-memory-data-format`](../../guidelines/agent-infra/engineering-memory-data-format.md)
+- [`memory-access`](../../guidelines/agent-infra/memory-access.md) — the
   read-side contract that consumes what this command writes.

package/dist/agent-src/commands/mode.md

@@ -21,7 +21,7 @@ packs:
 
 Sets `roles.active_role` in `.agent-settings.yml` and surfaces the active
 contract before any work. Six modes are defined in
-[`role-contracts`](../docs/guidelines/agent-infra/role-contracts.md):
+[`role-contracts`](../guidelines/agent-infra/role-contracts.md):
 
 - `developer` · `reviewer` · `tester` · `po` · `incident` · `planner`
 
@@ -47,7 +47,7 @@ Anything else: refuse. List the valid values and stop.
 
 ### 2. Validate the mode name
 
-Read [`role-contracts.md`](../docs/guidelines/agent-infra/role-contracts.md).
+Read [`role-contracts.md`](../guidelines/agent-infra/role-contracts.md).
 Extract H3 headings under `## Contract skeletons` and lowercase them.
 If `<name>` is not in that set, refuse and print the valid list.
 
@@ -74,7 +74,7 @@ exactly what the contract demands.
 ### 5. Write the active role
 
 Update `roles.active_role` in `.agent-settings.yml` using the
-[section-aware merge rules](../docs/guidelines/agent-infra/layered-settings.md#section-aware-merge-rules)
+[section-aware merge rules](../guidelines/agent-infra/layered-settings.md#section-aware-merge-rules)
 (preserve comments, preserve key order, touch only the changed field).
 
 For `/mode none`: set `active_role: ""`.
@@ -132,7 +132,7 @@ For `/mode` (status only):
 
 ## See also
 
-- [`role-contracts`](../docs/guidelines/agent-infra/role-contracts.md) — the six modes
+- [`role-contracts`](../guidelines/agent-infra/role-contracts.md) — the six modes
 - [`role-mode-adherence`](../rules/role-mode-adherence.md) — closing-output gate
-- [`layered-settings`](../docs/guidelines/agent-infra/layered-settings.md) — merge rules for settings edits
+- [`layered-settings`](../guidelines/agent-infra/layered-settings.md) — merge rules for settings edits
 - [`ask-when-uncertain`](../rules/ask-when-uncertain.md) — never invent modes

package/dist/agent-src/commands/post-as/ghostwriter.md

@@ -46,7 +46,7 @@ re-implement, do not skip, do not add steps.
 ### 2. Disclosure footer (mandatory — inherited from `/ghostwriter:write`)
 
 The footer is appended by `/ghostwriter:write`'s output template (per
-[`write-engine § 5`](../../../docs/contracts/write-engine.md)). This
+[`write-engine § 5`](../../docs/contracts/write-engine.md)). This
 alias inherits the footer unconditionally — no `--no-disclosure`
 flag, no `--internal` flag, no opt-out. Any flag that would suppress
 it is forbidden by design.
@@ -68,5 +68,5 @@ it is forbidden by design.
 - [`/ghostwriter:write`](../ghostwriter/write.md) — canonical implementation; this file is a thin alias.
 - [`/post-as`](../post-as.md) — parent cluster.
 - [`/post-as:me`](me.md) — sibling consumer, user-self voice, no footer.
-- [`write-engine`](../../../docs/contracts/write-engine.md) — shared procedural contract.
-- [`ghostwriter-schema`](../../../docs/contracts/ghostwriter-schema.md) — locked v1 frontmatter.
+- [`write-engine`](../../docs/contracts/write-engine.md) — shared procedural contract.
+- [`ghostwriter-schema`](../../docs/contracts/ghostwriter-schema.md) — locked v1 frontmatter.

package/dist/agent-src/commands/post-as/me.md

@@ -21,7 +21,7 @@ packs:
 
 Generate a copyable markdown draft in the **maintainer's own voice**.
 Style source is the project-root `.agent-user.md` file. Implements
-the [`write-engine`](../../../docs/contracts/write-engine.md)
+the [`write-engine`](../../docs/contracts/write-engine.md)
 contract — **the disclosure footer is omitted** because the user is
 the author.
 
@@ -43,7 +43,7 @@ Look in the project root.
 | File exists with `voice_sample` | Proceed |
 
 Schema reference:
-[`agent-user-schema`](../../../docs/contracts/agent-user-schema.md).
+[`agent-user-schema`](../../docs/contracts/agent-user-schema.md).
 
 ### 2. Load the style source
 
@@ -72,7 +72,7 @@ operator notes, not voice signal.
 
 ### 3. Collect topic + modifiers
 
-Per [`write-engine § 2`](../../../docs/contracts/write-engine.md).
+Per [`write-engine § 2`](../../docs/contracts/write-engine.md).
 Flag form: `--tone=<formal|casual|neutral>`,
 `--length=<words>`, `--channel=<linkedin-post|tweet|blog|freeform>`,
 `--audience=<text>`. The channel values and their length defaults are
@@ -87,12 +87,12 @@ the pace mapping above.
 ### 4. Negative-constraint pass (skipped)
 
 `.agent-user.md` v1 has no `taboos` field. Skip per
-[`write-engine § 3`](../../../docs/contracts/write-engine.md).
+[`write-engine § 3`](../../docs/contracts/write-engine.md).
 
 ### 5. Draft
 
 Generate the body as a single fenced markdown block per
-[`write-engine § 4`](../../../docs/contracts/write-engine.md). Honour
+[`write-engine § 4`](../../docs/contracts/write-engine.md). Honour
 the loaded fingerprint (sentence-length ±25 %, pace),
 ±15 % length tolerance, write in `language`.
 
@@ -126,8 +126,8 @@ commit, no save. The user copies the output manually.
 
 ## See also
 
-- [`write-engine`](../../../docs/contracts/write-engine.md) — shared procedural contract.
-- [`agent-user-schema`](../../../docs/contracts/agent-user-schema.md) — `.agent-user.md` source schema.
+- [`write-engine`](../../docs/contracts/write-engine.md) — shared procedural contract.
+- [`agent-user-schema`](../../docs/contracts/agent-user-schema.md) — `.agent-user.md` source schema.
 - [`/post-as`](../post-as.md) — parent cluster.
 - [`/post-as:ghostwriter`](ghostwriter.md) — sibling consumer, public-figure voice, mandatory footer.
 - [`/agents:user:init`](../agents/user/init.md) — bootstrap `.agent-user.md`.

package/dist/agent-src/commands/pr/create.md

@@ -227,7 +227,7 @@ runs on the post-archival state (the findings artifact references
 post-archival paths), (3) the PR is created only with a valid findings
 artifact, honest-null, or skip declaration **for the current review-scope
 hash** per
-[`plan-review-gates § 2`](../../../docs/contracts/plan-review-gates.md).
+[`plan-review-gates § 2`](../../docs/contracts/plan-review-gates.md).
 
 - A completion-review artifact from the roadmap-completion event
   (`agents/evidence/reviews/<slug>.findings.md`) is re-used when its

package/dist/agent-src/commands/pr/merge.md

@@ -60,7 +60,7 @@ among them.
 *(none, deliberately.)* `all` changes **cardinality**, not lifecycle, so it is
 an argument rather than a second command — the locked registry's rule that
 "sibling variants become a flag, never a second command"
-([`command-clusters`](../../../../../docs/contracts/command-clusters.md)) applied
+([`command-clusters`](../../docs/contracts/command-clusters.md)) applied
 to this cluster. A future sub belongs here only if it has a materially
 different lifecycle, not a different count.
 

package/dist/agent-src/commands/profile/activate.md

@@ -79,4 +79,4 @@ unscoped artefacts are always in `shown`.
 ## See also
 
 - [`/profile show`](show.md) · [`/profile deactivate`](deactivate.md)
-- [`docs/contracts/session-profile-overlay.md`](../../../docs/contracts/session-profile-overlay.md)
+- [`docs/contracts/session-profile-overlay.md`](../../docs/contracts/session-profile-overlay.md)

package/dist/agent-src/commands/profile/show.md

@@ -38,7 +38,7 @@ deterministic template (no LLM), the right content for an employee-facing surfac
 ./scripts-run src/scripts/config/session_profiles show --plain
 ```
 
-Shape + constraints: [`session-profile-overlay` § Plain status surface](../../../../docs/contracts/session-profile-overlay.md#plain-status-surface).
+Shape + constraints: [`session-profile-overlay` § Plain status surface](../../docs/contracts/session-profile-overlay.md#plain-status-surface).
 
 ### 2. Report
 

package/dist/agent-src/commands/research/deep.md

@@ -96,8 +96,8 @@ Read {fields_path} to get all field definitions.
    no part is written unless a retrieved source grounds it. And run at least
    one search that actively tries to **falsify** the leading hypothesis (rule
    alternatives in or out), not only searches that confirm it. Distinct from
-   [`source-discovery-gate`](../../../../src/rules/source-discovery-gate.md)
-   (structural evidence) and [`verify-before-complete`](../../../../src/rules/verify-before-complete.md)
+   [`source-discovery-gate`](../../rules/source-discovery-gate.md)
+   (structural evidence) and [`verify-before-complete`](../../rules/verify-before-complete.md)
    (completion evidence) — this is *research* evidence.
 
 ## Output path

package/dist/agent-src/commands/research/report.md

@@ -59,8 +59,8 @@ Before writing, apply the **per-part grounding + disconfirmation gate**: every
 part of the request must be grounded in a retrieved source before it appears in
 the report, and at least one search must have actively tried to falsify the
 leading hypothesis (not only confirm it). Distinct from
-[`source-discovery-gate`](../../../../src/rules/source-discovery-gate.md) and
-[`verify-before-complete`](../../../../src/rules/verify-before-complete.md).
+[`source-discovery-gate`](../../rules/source-discovery-gate.md) and
+[`verify-before-complete`](../../rules/verify-before-complete.md).
 
 The agent itself reads each JSON + `fields.yaml` + the user's TOC
 choices, then writes `{topic_slug}/report.md`. **No `generate_report.py`

package/dist/agent-src/commands/review/changes.md

@@ -383,7 +383,7 @@ Per `verbosity.routine_confirmations` (default `false`):
 - [`verify-repair-loop`](../../skills/verify-repair-loop/SKILL.md) — opt-in test-verdict-gated iterate-to-green loop (step 6 hand-off); judge confirms after the numeric gate
 - [`/judge`](judge.md) — standalone judge, no review-changes dispatch
 - [`code-review`](../../skills/code-review/SKILL.md) — human-oriented review patterns (tone, feedback handling)
-- [`role-contracts`](../../../docs/guidelines/agent-infra/role-contracts.md#reviewer) — Reviewer mode output contract (Summary / Risks / Findings / Required actions / Verdict)
+- [`role-contracts`](../../guidelines/agent-infra/role-contracts.md#reviewer) — Reviewer mode output contract (Summary / Risks / Findings / Required actions / Verdict)
 
 ## References
 

package/dist/agent-src/commands/review/routing.md

@@ -120,7 +120,7 @@ After the block, ask:
 
 - [`review-routing`](../../skills/review-routing/SKILL.md) — the resolver
 - [`reviewer-awareness`](../../rules/reviewer-awareness.md) — the rule that routes here: paths and risk over seniority, primary + secondary on medium/high
-- [`review-routing-data-format`](../../../docs/guidelines/agent-infra/review-routing-data-format.md)
+- [`review-routing-data-format`](../../guidelines/agent-infra/review-routing-data-format.md)
   — YAML schemas
 - [`create-pr-description`](../../skills/create-pr:description-only/SKILL.md) —
   consumes the routing block

package/dist/agent-src/commands/roadmap/create.md

@@ -162,7 +162,7 @@ Show the complete roadmap to the user and ask (in their language) if anything sh
 
 Unless the roadmap will be saved as `status: draft`, add a
 `## Risk Register` per
-[`plan-review-gates § 1`](../../../docs/contracts/plan-review-gates.md):
+[`plan-review-gates § 1`](../../docs/contracts/plan-review-gates.md):
 read the C→R1 handoff state from step 0 if present (resolved branches
 seed the risk list — never re-ask them), identify the highest product and
 implementation risks, rank descending, write a mitigation per row, and
@@ -272,8 +272,9 @@ Ask (in the user's language) exactly one numbered-options question:
 
 > How should this roadmap be executed later?
 >
-> 1. Fully autonomous — one run-start contract confirmation, then no
->    interruptions except the safety floors
+> 1. Fully autonomous — one run-start contract confirmation, then the
+>    only halts are the safety floors, a quality-red, and a step that
+>    reveals out-of-roadmap work
 > 2. Checkpoint at phase boundaries — compact status + continue prompt
 >    per phase
 > 3. Interactive — every gate fires as today

package/dist/agent-src/commands/roadmap/materialize.md

@@ -39,7 +39,7 @@ roadmap, writes one ticket per materialisable step into
 (acyclic dependency graph + empty `linear_state`), writes
 `<!-- ticket: T-NNN -->` markers back into the roadmap, and regenerates
 `agents/tickets/_registry.yml`. Format contract:
-[`ticket-bundle-format`](../../../../docs/contracts/ticket-bundle-format.md).
+[`ticket-bundle-format`](../../docs/contracts/ticket-bundle-format.md).
 
 ### 3. Gate on buildability
 
@@ -69,4 +69,4 @@ pastes a ticket into Linear/Jira (or creates it via MCP), or runs a per-ticket b
 - **Do NOT auto-create tracker issues** — paste/MCP is a separate user-invoked step (ADR-102, no API export).
 - **Do NOT commit or push.**
 - Bundle is the source of truth; the tracker is a projection
-  ([`ticket-bundle-format`](../../../../docs/contracts/ticket-bundle-format.md)).
+  ([`ticket-bundle-format`](../../docs/contracts/ticket-bundle-format.md)).

package/dist/agent-src/commands/roadmap/next.md

@@ -122,7 +122,7 @@ For each candidate read its frontmatter, its open-step count, and every
 3. **A date that must pass.**
 4. **A kernel-rule edit** — [`scope-control`](../../rules/scope-control.md)
    demands its own PR plus a ≥24 h soak, so it cannot close in this run
-   (kernel list: [`kernel-membership`](../../../docs/contracts/kernel-membership.md)).
+   (kernel list: [`kernel-membership`](../../docs/contracts/kernel-membership.md)).
 5. **Phases gated on a spike verdict** that may return FINDING.
 
 Also check the **family concurrency cap** (`lint_roadmap_family_cap`) —

package/dist/agent-src/commands/roadmap/process-full.md

@@ -87,7 +87,7 @@ with the **scope delta below**.
 `--all` changes **cardinality, not lifecycle**: the same single-roadmap loop,
 iterated over the whole active estate. It is a flag rather than a
 `/roadmap:process-all` command because
-[`command-clusters`](../../../../../docs/contracts/command-clusters.md) says
+[`command-clusters`](../../docs/contracts/command-clusters.md) says
 sibling variants become a flag, and a drain is a count of the thing this
 command already does.
 
@@ -320,7 +320,7 @@ is therefore remediation work rather than a blocker.
 | a halt | one of the five conditions fired | **no** — the halt is reported | `exhausted` when a declared budget ran out; `stagnated` when the same failure signature repeated with budget left |
 
 **The closing report names the terminal state by word**, from
-[`terminal-states`](../../../../src/agent-src/contexts/execution/terminal-states.md).
+[`terminal-states`](../../contexts/execution/terminal-states.md).
 The reason is the failure that vocabulary exists to stop: a run that stopped at
 its iteration cap and one that finished both leave the roadmap looking the same,
 because the checkbox glyphs cannot express `exhausted`, `stagnated` or

package/dist/agent-src/commands/security-audit-config.md

@@ -35,7 +35,7 @@ suite's own `lint_agent_security` self-audit gate.
 
 (omit `--root` to audit the current repo). The script reuses the Phase-1
 detection library under the false-positive containment convention
-([`security-lint-containment`](../../docs/guidelines/agent-infra/security-lint-containment.md)),
+([`security-lint-containment`](../guidelines/agent-infra/security-lint-containment.md)),
 so doc/example files do not tank the score. It scans instruction files
 (`CLAUDE.md`, `AGENTS.md`, `.cursor/rules`, `.github/copilot-instructions.md`,
 `.clinerules`, `.windsurfrules`), MCP configs (`.mcp.json`, `.cursor/mcp.json`,
@@ -63,7 +63,7 @@ Output is **decision support**, not a gate — detection is probabilistic
 (guardrails are evadable). Recommend the fix per finding (move a secret to
 `${env:VAR}`, pin an MCP server, remove a `bypassPermissions` flag, strip
 hidden Unicode), but never rewrite the consumer's config without confirmation
-(per [`scope-control`](../../../src/rules/scope-control.md)).
+(per [`scope-control`](../rules/scope-control.md)).
 
 ## Output format
 
@@ -81,5 +81,5 @@ Overall: B (84/100)
 ## See also
 
 - [`lint_agent_security`](../../../src/scripts/lint_agent_security.ts) — the self-audit (our own corpus) sibling.
-- [`untrusted-input-defense`](../../../src/rules/untrusted-input-defense.md), [`lethal-trifecta-guard`](../../../src/rules/lethal-trifecta-guard.md) — the always-on prevention rules.
+- [`untrusted-input-defense`](../rules/untrusted-input-defense.md), [`lethal-trifecta-guard`](../rules/lethal-trifecta-guard.md) — the always-on prevention rules.
 - [`/threat-model`](../threat-model/command.md), [`judge-security-auditor`](../skills/judge-security-auditor/SKILL.md) — deep-pass dispatch.

package/dist/agent-src/commands/skill/preview.md

@@ -22,7 +22,7 @@ packs:
 Renders a skill's **declared intent** — its `## Steps`, execution type, handler,
 `allowed_tools`, and any file/command targets named in its body — so you can
 decide whether to run it. Read-only, no network, no execution. Implements the
-[`skill-dry-run`](../../../docs/contracts/skill-dry-run.md) contract.
+[`skill-dry-run`](../../docs/contracts/skill-dry-run.md) contract.
 
 ## Prerequisites
 

package/dist/agent-src/commands/skills/discover.md

@@ -22,7 +22,7 @@ packs:
 Surfaces a short, explained skill shortlist for a role. Reuses existing local
 signals only — the skill catalog frontmatter, the role's `skills.yml`
 shortlist, and (when present and not opted out) the local-analytics JSONL.
-Implements the [`skill-discovery`](../../../docs/contracts/skill-discovery.md)
+Implements the [`skill-discovery`](../../docs/contracts/skill-discovery.md)
 contract. Local-only, read-only, no network.
 
 ## Prerequisites

package/dist/agent-src/commands/sync/agent-settings.md

@@ -25,7 +25,7 @@ Reconciles `.agent-settings.yml` with the shipped template
 (`config/agent-settings.template.yml`) and the selected cost-profile
 preset (`config/profiles/{profile}.ini`). Applies the section-aware
 merge rules documented in
-[`layered-settings`](../../../docs/guidelines/agent-infra/layered-settings.md):
+[`layered-settings`](../../guidelines/agent-infra/layered-settings.md):
 
 - Template section order wins — keys reorder to match.
 - Existing user scalar values are preserved.
@@ -141,6 +141,6 @@ is a local-agent concern.
 - [`scripts/sync_agent_settings.ts`](../../../../scripts/sync_agent_settings.ts) — the helper
 - [`config/agent-settings.template.yml`](../../../../config/agent-settings.template.yml) — canonical template
 - [`config/profiles/`](../../../../config/profiles/) — profile presets
-- [`layered-settings`](../../../docs/guidelines/agent-infra/layered-settings.md) — the merge rules this command enforces
+- [`layered-settings`](../../guidelines/agent-infra/layered-settings.md) — the merge rules this command enforces
 - [`scripts/install.ts`](../../../../scripts/install.ts) — first-install path; this command handles the update path
 - [`/sync-gitignore`](sync-gitignore.md) — sibling command for the `.gitignore` block

package/dist/agent-src/commands/sync/gitignore/fix.md

@@ -189,5 +189,5 @@ If the check fails, offer to re-sync the block with the current template:
   ignored-but-tracked detection (Phase 5.2)
 - [`scripts/check_gitignore_freshness.ts`](../../../../src/scripts/check_gitignore_freshness.ts) —
   manifest vs block coverage check (Phase 3.4)
-- [`docs/contracts/agents-layout.md`](../../../../../docs/contracts/agents-layout.md) —
+- [`docs/contracts/agents-layout.md`](../../../docs/contracts/agents-layout.md) —
   full classification contract for `agents/` entries

package/dist/agent-src/commands/tests/create.md

@@ -109,4 +109,4 @@ funnel per changed behavior — enumerate first, write second:
 
 ## See also
 
-- [`role-contracts`](../../docs/guidelines/agent-infra/role-contracts.md#tester) — Tester mode output contract (Behaviour under test / Edge cases / Negative paths / Reproduction / Coverage gaps)
+- [`role-contracts`](../../guidelines/agent-infra/role-contracts.md#tester) — Tester mode output contract (Behaviour under test / Edge cases / Negative paths / Reproduction / Coverage gaps)

package/dist/agent-src/commands/tests/e2e-heal.md

@@ -32,7 +32,7 @@ packs:
 > 2. Fix a specific test file — which one?
 > 3. Fix tests that failed in CI — provide the CI run URL or error output
 
-- Read the Playwright guideline: `../../docs/guidelines/e2e/playwright.md`
+- Read the Playwright guideline: `../../guidelines/e2e/playwright.md`
 
 ### 2. Run failing tests
 

package/dist/agent-src/commands/tests/e2e-plan.md

@@ -32,7 +32,7 @@ packs:
 > 2. Which feature area? (e.g., "checkout flow", "user settings", or "all visible flows")
 > 3. Is there an existing seed/setup file? (e.g., `tests/e2e/fixtures/auth.ts`)
 
-- Read the Playwright guideline: `../../docs/guidelines/e2e/playwright.md`
+- Read the Playwright guideline: `../../guidelines/e2e/playwright.md`
 - Check for existing test plans in `specs/` or `tests/e2e/specs/`.
 
 ### 2. Explore the application

package/dist/agent-src/contexts/authority/kernel-rule-edits.md

@@ -19,13 +19,16 @@ weight, a trigger that swallows a sibling rule's domain) surfaces in
 real interactions before the second edit lands and confounds the
 diagnosis.
 
+A kernel-rule PR also carries a ratification artifact
+([`ratification-artifact`](../../docs/contracts/ratification-artifact.md)),
+gated by `check_kernel_edit_ratified` — an ADDITION to this soak, never a
+replacement, until blocker `ratification-platform-anchor` is decided.
+
 ## Trigger
 
 A PR is a "kernel-rule edit" iff it modifies any file in `src/rules/`
 that is in the locked kernel set
-(see [`docs/contracts/kernel-membership.md`](../../../docs/contracts/kernel-membership.md)).
-(Until 2026-07-31 this named the pre-ADR-051 authoring tree, which no
-longer exists — so the trigger could not match a live file.)
+(see [`docs/contracts/kernel-membership.md`](../../docs/contracts/kernel-membership.md)).
 
 The CI guard (Phase 4.2 of the always-budget-relief roadmap) fails
 any PR that touches **> 1** kernel rule in the same diff. Override is
@@ -59,6 +62,3 @@ diff instead of a silent 10× cost event.
 ## Source
 
 - Roadmap Phase 4: always-budget-relief roadmap § Phase 4 (transient — see `agents/roadmaps/archive/`).
-- Lesson: PR #36 (2026-05-04) condensed the rollout schedule under
-  autonomous mandate; the slow-rollout note was deferred until this
-  ADR pass.

package/dist/agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md

@@ -4,7 +4,7 @@ Lookup table for the `slash-command-routing-policy` rule. Lists the
 locked clusters and their sub-commands so the rule itself can stay at
 its current LOC while still reflecting the full surface. Source of
 truth for the cluster names is
-[`docs/contracts/command-clusters.md`](../../../../../docs/contracts/command-clusters.md);
+[`docs/contracts/command-clusters.md`](../../../docs/contracts/command-clusters.md);
 this file mirrors that contract for runtime lookup. Linter:
 `scripts/check_cluster_patterns.ts` (verifies dispatcher shape).
 
@@ -15,7 +15,6 @@ this file mirrors that contract for runtime lookup. Linter:
 | `/fix` | 1 | `ci` · `pr-comments` · `portability` · `refs` · `seeder` | `/fix-ci` · `/fix-pr-comments` · `/fix-portability` · `/fix-references` · `/fix-seeder` |
 | `/optimize` | 1 | `agents` · `augmentignore` · `rtk` · `skills` | `/optimize-agents` · `/optimize-augmentignore` · `/optimize-rtk-filters` · `/optimize-skills`                                                   |
 | `/feature` | 1 | `explore` · `plan` · `refactor` · `roadmap` | `/feature-explore` · `/feature-plan` · `/feature-refactor` · `/feature-roadmap`                                                                 |
-| `/chat-history` | 2 | `show` | `/chat-history` (legacy status) — `resume` / `clear` / `checkpoint` removed in `road-to-chat-history-hook-only`                                 |
 | `/agents` | 2 | `init` · `optimize` · `audit` | `/copilot-agents-init` · merger of `/optimize-agents-md` + `/copilot-agents-optimize` · `/optimize-agents` (folder ops moved to `/optimize:agents-dir`) |
 | `/memory` | 2 | `add` · `load` · `promote` · `propose` | `/memory-add` · `/memory-full` · `/memory-promote` · `/propose-memory`                                                                          |
 | `/roadmap` | 2 | `create` · `process-step` · `process-phase` · `process-full` | `/roadmap-create` · `/roadmap-process` (replaced — autonomous, no per-step gate; `process-phase` is the default execution scope)                |

package/dist/agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md

@@ -43,7 +43,7 @@ behavior. Cannot → read more.
 ## Consult memory before editing
 
 Invariants live in the memory layer; architectural rationale lives in ADRs.
-Via [`memory-access`](../../../../../docs/guidelines/agent-infra/memory-access.md),
+Via [`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. For *why* the current
 shape exists, check the ADR index `docs/decisions/INDEX.md`. Cite the `id` /
@@ -129,4 +129,4 @@ success cannot be checked is a clarification trigger, not an execution
 trigger (route to `ask-when-uncertain`).
 
 Wrong/right demos:
-[`simplicity-and-goal-demos`](../../../../../../docs/guidelines/agent-infra/simplicity-and-goal-demos.md).
+[`simplicity-and-goal-demos`](../../../guidelines/agent-infra/simplicity-and-goal-demos.md).