@event4u/agent-config 6.0.0 → 6.1.0

package/docs/command-flows.md

@@ -7,7 +7,7 @@
 
 > Every command is classified in `src/flows/surface-map.yaml` (coverage enforced by `scripts/lint_command_flow_coverage.py`). The four user-work flows carry rich definitions in `src/flows/<flow>.yaml`.
 
-**150 commands** across **10 surfaces** (4 user-work flows + 6 platform/domain surfaces).
+**148 commands** across **10 surfaces** (4 user-work flows + 6 platform/domain surfaces).
 
 ## User-work flows
 
@@ -25,10 +25,10 @@ _Explore, plan, estimate, refine, and investigate before building. The "what sho
 - `bug-investigate` — Investigate a bug — auto-detect ticket from branch, gather Jira/Sentry/description context, trace root cause
 - `estimate-ticket` — Estimate a Jira/Linear ticket before sprint planning — size + risk + split recommendation + uncertainty, si…
 - `feature` — Feature orchestrator — routes to explore, plan, refactor, roadmap, dev
-- `feature:explore` — Brainstorm and explore a feature idea before committing to a full plan
-- `feature:plan` — Interactively plan a feature — research, discuss, and create a structured feature document
-- `feature:refactor` — Refine and update an existing feature plan through interactive discussion
-- `feature:roadmap` — Generate implementation roadmap(s) from a feature plan and link them
+- `feature-explore` — Brainstorm and explore a feature idea before committing to a full plan
+- `feature-plan` — Interactively plan a feature — research, discuss, and create a structured feature document
+- `feature-refactor` — Refine and update an existing feature plan through interactive discussion
+- `feature-roadmap` — Generate implementation roadmap(s) from a feature plan and link them
 - `project-analyze` — Full project analysis — detect stack, inventory modules, audit docs, create missing contexts
 - `project-health` — Quick project health check — show status of docs, modules, contexts, and roadmaps without creating anything
 - `refine-ticket` — Refine a Jira/Linear ticket before planning — rewritten ticket + Top-5 risks + persona voices, orchestrates…
@@ -44,13 +44,13 @@ _Build it. The core "make the change" front — drive a prompt, ticket, or featu
 - `bug-fix` — Plan and implement a bug fix — based on investigation, with quality checks and test verification
 - `e2e-heal` — Find, debug, and fix failing Playwright E2E tests
 - `e2e-plan` — Explore the application and create a structured E2E test plan in Markdown
-- `feature:dev` — Full 7-phase feature development workflow for complex features.
+- `feature-dev` — Full 7-phase feature development workflow for complex features.
 - `implement-ticket` — Drive a ticket end-to-end through refine → memory → analyze → plan → implement → test → verify → report — O…
 - `jira-ticket` — Read Jira ticket from branch name, analyze linked Sentry issues, implement feature or fix bug
-- `module:create` — Create a new module from .module-template with interactive setup
+- `module-create` — Create a new module from .module-template with interactive setup
 - `tests` — Tests orchestrator — routes to create, execute
-- `tests:create` — Write meaningful tests for the current branch — stack-adaptive (pest / phpunit / vitest / jest / pytest / …)
-- `tests:execute` — Run the project's test suite — stack-adaptive (pest / phpunit / vitest / jest / pytest / …)
+- `tests-create` — Write meaningful tests for the current branch — stack-adaptive (pest / phpunit / vitest / jest / pytest / …)
+- `tests-execute` — Run the project's test suite — stack-adaptive (pest / phpunit / vitest / jest / pytest / …)
 - `update-form-request-messages` — Sync the messages() method of a FormRequest class — add missing entries, link them to language keys, and cl…
 - `work` — Drive a free-form prompt end-to-end through refine → score → plan → implement → test → verify → report — Op…
 
@@ -62,11 +62,11 @@ _Check it. Self-review, judge, quality-fix, and threat-model a change before it
 
 **Default path:** `review-changes` → `judge` → `quality-fix` → `threat-model`
 
-- `fix:ci` — Fetch CI errors from GitHub Actions and fix them
+- `fix-ci` — Fetch CI errors from GitHub Actions and fix them
 - `judge` — Judge orchestrator — routes to solo, steps, on-diff
-- `judge:on-diff` — Run a single change through an implementer→judge loop with a two-revision ceiling, then hand back to the user
-- `judge:solo` — Run a standalone judge on an existing diff or code change — no implementer, no revision loop, verdict only
-- `judge:steps` — Execute an ordered plan step by step with a judge gate between steps — stops on first failed verdict
+- `judge-on-diff` — Run a single change through an implementer→judge loop with a two-revision ceiling, then hand back to the user
+- `judge-solo` — Run a standalone judge on an existing diff or code change — no implementer, no revision loop, verdict only
+- `judge-steps` — Execute an ordered plan step by step with a judge gate between steps — stops on first failed verdict
 - `quality-fix` — Run quality pipeline (PHP and/or JS/TS) and fix all errors — auto-detects language from changed files
 - `review-changes` — Self-review local changes before creating a PR — dispatches to five specialized judges (bug, security, test…
 - `threat-model` — Run a pre-implementation threat model on a proposed change — enumerates abuse cases, trust boundaries, and…
@@ -81,13 +81,13 @@ _Ship it. Commit in logical chunks, open the PR, answer review comments, and pre
 
 - `git-commit` — Stage and commit all uncommitted changes — splits into logical commits following Conventional Commits
 - `git-commit-in-chunks` — Stage and commit all uncommitted changes in logical chunks WITHOUT confirmation — sibling of /commit for au…
-- `fix` — Fix orchestrator — routes to ci, references, portability, seeder, pr-comments, pr-bot-comments, pr-develope…
-- `fix:portability` — Find and fix project-specific references in shared .augment/ package files
-- `fix:pr-bot-comments` — Fix and reply to bot review comments (Copilot, Augment, Greptile, etc.) on a GitHub PR
-- `fix:pr-comments` — Fix and reply to all open review comments (bots + human reviewers) on a GitHub PR
-- `fix:pr-developer-comments` — Fix and reply to human reviewer comments on a GitHub PR
-- `fix:refs` — Find and fix broken cross-references in .augment/ and agents/ files
-- `fix:seeder` — Scan seeder data files for broken foreign key references — find constants used without getReference() and f…
+- `fix` — Fix orchestrator — routes to ci, references, portability, seeder, pr-comments
+- `fix-portability` — Find and fix project-specific references in shared .augment/ package files
+- `fix/pr-bot-comments`
+- `fix-pr-comments` — Fix and reply to all open review comments (bots + human reviewers) on a GitHub PR
+- `fix/pr-developer-comments`
+- `fix-refs` — Find and fix broken cross-references in .augment/ and agents/ files
+- `fix-seeder` — Scan seeder data files for broken foreign key references — find constants used without getReference() and f…
 - `git-pr-create` — Create a GitHub PR with structured description from Jira ticket and code changes
 - `git-pr-create-description-only` — Generate a PR description as a copyable markdown block — used standalone or by create-pr
 - `prepare-for-review` — Prepare a PR branch for local review — updates main and merges the full branch chain so the branch is up to…
@@ -99,93 +99,91 @@ _Ship it. Commit in logical chunks, open the PR, answer review comments, and pre
 _Deliberately-started features — not daily flow members, never buried as skills._
 
 - `challenge-me` — Challenge-me orchestrator — routes to vision, with-docs
-- `challenge-me:vision` — Stress-test a plan or idea by one-question-at-a-time interview until 95% confidence — emits a copyable Mark…
-- `challenge-me:with-docs` — Doc-aware /challenge-me — 95%-confidence interview with session glossary vs CONTEXT.md, load-bearing claim-…
+- `challenge-me-vision` — Stress-test a plan or idea by one-question-at-a-time interview until 95% confidence — emits a copyable Mark…
+- `challenge-me-with-docs` — Doc-aware /challenge-me — 95%-confidence interview with session glossary vs CONTEXT.md, load-bearing claim-…
 - `council` — Council orchestrator — routes to default, pr, design, optimize, analysis, debate
-- `council:analysis` — Run the council on a local analysis output (project-analyze, audit script, codebase scan) — critiques the a…
-- `council:debate` — Multi-round council debate with progressive cost disclosure — each member produces a position, then rebuts…
-- `council:default` — Default council lens — neutral framing, redacted context, advisory output only. Run `/council default <inpu…
-- `council:design` — Run the council on a design document, ADR, or architecture proposal — surfaces hidden coupling, missing rol…
-- `council:optimize` — Run the council on an optimization target — perf hot path, memory pattern, query, or an /optimize-* output…
-- `council:pr` — Pull a GitHub PR via gh CLI and run the council on the diff with a PR-specific neutrality preamble — read-o…
+- `council-analysis` — Run the council on a local analysis output (project-analyze, audit script, codebase scan) — critiques the a…
+- `council-debate` — Multi-round council debate with progressive cost disclosure — each member produces a position, then rebuts…
+- `council-default` — Default council lens — neutral framing, redacted context, advisory output only. Run `/council default <inpu…
+- `council-design` — Run the council on a design document, ADR, or architecture proposal — surfaces hidden coupling, missing rol…
+- `council-optimize` — Run the council on an optimization target — perf hot path, memory pattern, query, or an /optimize-* output…
+- `council-pr` — Pull a GitHub PR via gh CLI and run the council on the diff with a PR-specific neutrality preamble — read-o…
 - `grill-me` — Alias for /challenge-me — interactive grill-style interview that sharpens a fuzzy plan/idea into a copyable…
 - `research` — Preliminary research scaffolder — pick objects, define fields, emit `outline.yaml` + `fields.yaml` for down…
-- `research:deep` — Read `outline.yaml`, research each item in batches, write per-item JSON validated against the project-local…
-- `research:report` — Summarise per-item JSON results from `/research:deep` into `report.md`. Agent renders directly + emits an o…
+- `research-deep` — Read `outline.yaml`, research each item in batches, write per-item JSON validated against the project-local…
+- `research-report` — Summarise per-item JSON results from `/research:deep` into `report.md`. Agent renders directly + emits an o…
 - `roadmap` — Roadmap orchestrator — routes to create (authoring) and process-step / process-phase / process-full (autono…
-- `roadmap:ai-council` — Challenge a roadmap with the AI council (deep tier) and refactor from convergence findings. Wraps `/council…
-- `roadmap:create` — Interactively create a new roadmap file in agents/roadmaps/
-- `roadmap:process-full` — Autonomously process every open step across every phase of a roadmap until the file is fully closed. Larges…
-- `roadmap:process-phase` — Autonomously process every open step in the next or current phase of a roadmap, then stop. Default executio…
-- `roadmap:process-step` — Autonomously process the single next open step of a roadmap and stop. Smallest execution scope of the /road…
+- `roadmap-ai-council` — Challenge a roadmap with the AI council (deep tier) and refactor from convergence findings. Wraps `/council…
+- `roadmap-create` — Interactively create a new roadmap file in agents/roadmaps/
+- `roadmap-process-full` — Autonomously process every open step across every phase of a roadmap until the file is fully closed. Larges…
+- `roadmap-process-phase` — Autonomously process every open step in the next or current phase of a roadmap, then stop. Default executio…
+- `roadmap-process-step` — Autonomously process the single next open step of a roadmap and stop. Smallest execution scope of the /road…
 
 ### Platform surface — `agent-admin`
 
 _The system/admin surface (NOT a flow): memory · analytics · governance · config · introspection, reached on demand._
 
 - `agents` — Agent-layer orchestrator — routes to init, optimize, audit. Covers AGENTS.md and its multi-tool stubs (CLAU…
-- `agents:audit` — Audit agent infrastructure — token overhead, rule triggers, AGENTS.md health, Capability-over-Structure adh…
-- `agents:init` — Initialize the agent layer for a consumer project — creates AGENTS.md and .github/copilot-instructions.md f…
-- `agents:optimize` — Refactor AGENTS.md to the Thin-Root contract (caps, pointer ratio, capability bullets, emergency-triage) an…
-- `agents:user` — User-persona file (.agent-user.md) — interview, render, and maintain who the user is and how they want to b…
-- `agents:user-accept` — Apply a buffered observation to .agent-user.md after explicit user confirmation; bumps last_updated and dro…
-- `agents:user-init` — Interactive interview that creates the project-root .agent-user.md from the locked v1 schema (name, languag…
-- `agents:user-review` — List buffered observations from .agent-user.observations.jsonl with numbered options to inspect or accept i…
-- `agents:user-show` — Read-only render of .agent-user.md — prints the persona summary the host agent loads at session start.
-- `agents:user-update` — Open .agent-user.md in the user's IDE for manual edit; validates schema and 100-line cap on save.
+- `agents-audit` — Audit agent infrastructure — token overhead, rule triggers, AGENTS.md health, Capability-over-Structure adh…
+- `agents-init` — Initialize the agent layer for a consumer project — creates AGENTS.md and .github/copilot-instructions.md f…
+- `agents-optimize` — Refactor AGENTS.md to the Thin-Root contract (caps, pointer ratio, capability bullets, emergency-triage) an…
+- `agents-user` — User-persona file (.agent-user.md) — interview, render, and maintain who the user is and how they want to b…
+- `agents-user-accept` — Apply a buffered observation to .agent-user.md after explicit user confirmation; bumps last_updated and dro…
+- `agents-user-init` — Interactive interview that creates the project-root .agent-user.md from the locked v1 schema (name, languag…
+- `agents-user-review` — List buffered observations from .agent-user.observations.jsonl with numbered options to inspect or accept i…
+- `agents-user-show` — Read-only render of .agent-user.md — prints the persona summary the host agent loads at session start.
+- `agents-user-update` — Open .agent-user.md in the user's IDE for manual edit; validates schema and 100-line cap on save.
 - `analytics` — Analytics orchestrator — routes to show, prune. Local-only workspace event log under `~/.event4u/agent-conf…
-- `analytics:prune` — Drop events older than the 90-day retention window from the local analytics log. Atomic and idempotent.
-- `analytics:show` — Render top prompts, launcher → completion rate per role, average session length, and knowledge-source usage…
-- `chat-history` — Chat-history orchestrator — routes to show, import, learn
-- `chat-history:import` — Surface prior chat-history sessions as a numbered table, let the user pick one, read it silently, and emit…
-- `chat-history:learn` — Pick a prior chat-history session and mine it for project-improving learnings — runs learning-to-rule-or-sk…
-- `chat-history:show` — Show the status of the persistent chat-history log — file size, entry count, header fingerprint, age, and t…
-- `check-current-md`
-- `condense` — Condense .md files from .agent-src.uncondensed/ into telegraph format and write to dist/agent-src/
+- `analytics-prune` — Drop events older than the 90-day retention window from the local analytics log. Atomic and idempotent.
+- `analytics-show` — Render top prompts, launcher → completion rate per role, average session length, and knowledge-source usage…
+- `chat-history` — Chat-history orchestrator — routes to import (selective cross-session resume). Mining moved to /memory mine…
+- `chat-history-import` — Surface prior chat-history sessions as a numbered table, let the user pick one, read it silently, and emit…
+- `check-current-md` — Check the open .md file (or a passed path) for German outside DE:/EN: anchor blocks — umlauts, function wor…
+- `condense` — Condense .md files from src/ into telegraph format and write to dist/agent-src/
 - `context` — Context orchestrator — routes to create, refactor
-- `context:create` — Analyze a codebase area and create a structured context document
-- `context:refactor` — Analyze, update, and extend an existing context document
+- `context-create` — Analyze a codebase area and create a structured context document
+- `context-refactor` — Analyze, update, and extend an existing context document
 - `cost-report` — Capture token cost from the active Claude Code session, append to the local sessions store, and surface the…
 - `knowledge` — Knowledge orchestrator — routes to ingest, list, forget. Local-only file ingestion into the agent memory na…
-- `knowledge:cross-repo` — Targeted, read-only retrieval over opted-in linked-project siblings (ADR-032 Option A). Pulls a shared type…
-- `knowledge:forget` — Drop a knowledge ingest from `agents/memory/knowledge/` by id prefix. Atomic, no partial state. Pinning pro…
-- `knowledge:ingest` — Walk a local path (folder, .zip, single file), redact PII + secrets, chunk to 2 KB markdown, and persist in…
-- `knowledge:list` — List existing knowledge ingests in `agents/memory/knowledge/` (table or JSON); pin / unpin by id prefix to…
+- `knowledge-cross-repo` — Targeted, read-only retrieval over opted-in linked-project siblings (ADR-032 Option A). Pulls a shared type…
+- `knowledge-forget` — Drop a knowledge ingest from `agents/memory/knowledge/` by id prefix. Atomic, no partial state. Pinning pro…
+- `knowledge-ingest` — Walk a local path (folder, .zip, single file), redact PII + secrets, chunk to 2 KB markdown, and persist in…
+- `knowledge-list` — List existing knowledge ingests in `agents/memory/knowledge/` (table or JSON); pin / unpin by id prefix to…
 - `memory` — Memory orchestrator — routes to add, load, mine-session, promote, propose
-- `memory:add` — Interactively add a validated entry to an engineering-memory file (domain-invariants, architecture-decision…
-- `memory:learn-low-impact` — Preview validated low-impact entries that would be upstreamed to the package seed (default `--preview`); `-…
-- `memory:load` — Load ALL curated entries of a given memory type into the current context — opt-in full load for deep analys…
-- `memory:mine-session` — Mine the active session transcript for memory signals (corrections, preferences, decisions, recurring patte…
-- `memory:promote` — Promote an intake signal (or provisional proposal) into a curated memory entry — opens a PR and runs the ad…
-- `memory:propose` — Append a provisional memory signal to the intake stream — the universal fallback for any producer (human or…
+- `memory-add` — Interactively add a validated entry to an engineering-memory file (domain-invariants, incident-learnings, p…
+- `memory-learn-low-impact` — Preview validated low-impact entries that would be upstreamed to the package seed (default `--preview`); `-…
+- `memory-load` — Load ALL curated entries of a given memory type into the current context — opt-in full load for deep analys…
+- `memory-mine-session` — Mine a session (cross-host chat-history log) for memory signals and/or rule/skill proposal seeds via --mode…
+- `memory-promote` — Promote an intake signal (or provisional proposal) into a curated memory entry — opens a PR and runs the ad…
+- `memory-propose` — Append a provisional memory signal to the intake stream — the universal fallback for any producer (human or…
 - `module` — Module orchestrator — routes to create, explore
-- `module:explore` — Explore a module — load its structure, docs, and context into the current conversation
+- `module-explore` — Explore a module — load its structure, docs, and context into the current conversation
 - `optimize` — Optimize orchestrator — routes to skills, agents-dir, augmentignore, rtk-filters
 - `optimize-prompt` — Optimize a raw prompt for ChatGPT, Claude, Gemini, or another AI via the 4-D methodology — BASIC vs DETAIL…
-- `optimize:agents-dir` — Manage the agents/ directory — scaffold, folder-audit, fix. Single command with three modes (--scaffold / -…
-- `optimize:augmentignore` — Creates or updates .augmentignore based on the project's actual tech stack, large files, generated artifact…
-- `optimize:rtk` — Create or optimize project-local rtk filters based on the actual toolchain
-- `optimize:skills` — Audits skills — measures baseline, finds duplicates/merge candidates, runs linter. Suggest only, never auto…
+- `optimize-agents-dir` — Manage the agents/ directory — scaffold, folder-audit, fix. Single command with three modes (--scaffold / -…
+- `optimize-augmentignore` — Creates or updates .augmentignore based on the project's actual tech stack, large files, generated artifact…
+- `optimize-rtk` — Create or optimize project-local rtk filters based on the actual toolchain
+- `optimize-skills` — Audits skills — measures baseline, finds duplicates/merge candidates, runs linter. Suggest only, never auto…
 - `orchestrate` — Run a YAML pipeline defined under `.agent-config/orchestrations/` — chains personas / skills / commands / s…
 - `override` — Override orchestrator — routes to create, manage
-- `override:create` — Creates a project-level override for a shared skill, rule, or command.
-- `override:manage` — Reviews, updates, and refactors existing project-level overrides.
+- `override-create` — Creates a project-level override for a shared skill, rule, or command.
+- `override-manage` — Reviews, updates, and refactors existing project-level overrides.
 - `package-reset` — /package-reset
 - `package-test` — /package-test
 - `profile` — Session-profile orchestrator — activate / deactivate / show the active packs for this session (recommendati…
-- `profile:activate` — Activate a session profile — surface only the named profile/pack closure plus core artefacts, no persistence
-- `profile:deactivate` — Deactivate the session profile — clear the overlay (or drop named packs) so the full surface returns
-- `profile:show` — Show the active session profile — active packs and surfaced/hidden command+skill counts (observability surf…
+- `profile-activate` — Activate a session profile — surface only the named profile/pack closure plus core artefacts, no persistence
+- `profile-deactivate` — Deactivate the session profile — clear the overlay (or drop named packs) so the full surface returns
+- `profile-show` — Show the active session profile — active packs and surfaced/hidden command+skill counts (observability surf…
 - `review-routing` — Compute reviewer roles and matched historical bug patterns for the current diff, using project-local owners…
 - `rule-compliance-audit` — Audit rule trigger quality, simulate activation, detect overlaps, and find never-activating rules
 - `set-cost-profile` — Change the rule_loading_tier in .agent-settings.yml — shows each profile's meaning and applies the selection
 - `skill` — Single-skill orchestrator — routes to preview. Non-destructive "what will this skill do?" before you run it.
-- `skill:preview` — Non-destructive preview of a skill — its declared steps, execution type, allowed tools, and file/command ta…
+- `skill-preview` — Non-destructive preview of a skill — its declared steps, execution type, allowed tools, and file/command ta…
 - `skills` — Skill discovery orchestrator — routes to discover. Local, explained skill recommendations over the catalog…
-- `skills:discover` — Recommend skills for a role — ranked by four explained classes (most-useful-for-role, related-to-current-ta…
+- `skills-discover` — Recommend skills for a role — ranked by four explained classes (most-useful-for-role, related-to-current-ta…
 - `sync-agent-settings` — Sync `.agent-settings.yml` against the current template + profile — adds new sections/keys, preserves user…
 - `sync-gitignore` — Sync the `event4u/agent-config` block in the consumer project's .gitignore — adds missing entries, preserve…
-- `sync-gitignore:fix` — Scrub legacy pre-`/agents/` patterns from the consumer's .gitignore (inside or outside the managed block) a…
+- `sync-gitignore-fix` — Scrub legacy pre-`/agents/` patterns from the consumer's .gitignore (inside or outside the managed block) a…
 - `upstream-contribute` — Contribute a learning, skill, rule, or fix from a consumer project back to the shared agent-config package
 
 ### Domain flow — media
@@ -193,29 +191,29 @@ _The system/admin surface (NOT a flow): memory · analytics · governance · con
 _AI image + video pipeline._
 
 - `image` — Character-image fidelity orchestrator — analyse, create, and verify a character image against its canon. Ro…
-- `image:analyse` — Analyse a character image down to the smallest mole and diff it against a canon — per-feature spec, OCR tat…
-- `image:create` — Generate a character image to spec — assemble a max-fidelity, anchors-first prompt from a Canon Spec; gover…
-- `image:verify` — Verify a candidate render against its canon — run the analyser in loop mode, emit the gate verdict + remain…
+- `image-analyse` — Analyse a character image down to the smallest mole and diff it against a canon — per-feature spec, OCR tat…
+- `image-create` — Generate a character image to spec — assemble a max-fidelity, anchors-first prompt from a Canon Spec; gover…
+- `image-verify` — Verify a candidate render against its canon — run the analyser in loop mode, emit the gate verdict + remain…
 - `video` — Video-creation orchestrator — Hollywood-level AI video pipeline. Routes to from-script, from-song, scene, s…
-- `video:from-script` — Drive a script end-to-end through the AI video pipeline — scenes → blueprint → image → operator pick → moti…
-- `video:from-song` — Music-video from a song + reference images — accept or derive a timed scene script, optional character-lock…
-- `video:scene` — Render a single scene from a one-line idea — scene-expander → blueprint → image → operator pick → motion →…
-- `video:stitch` — Re-stitch existing clips in `<project>/scenes/*/` after operator edits — no re-render. ffmpeg concat driven…
-- `video:storyboard` — Image-only storyboard — script → scenes → blueprint → image render → contact-sheet PNG via ffmpeg montage.…
+- `video-from-script` — Drive a script end-to-end through the AI video pipeline — scenes → blueprint → image → operator pick → moti…
+- `video-from-song` — Music-video from a song + reference images — accept or derive a timed scene script, optional character-lock…
+- `video-scene` — Render a single scene from a one-line idea — scene-expander → blueprint → image → operator pick → motion →…
+- `video-stitch` — Re-stitch existing clips in `<project>/scenes/*/` after operator edits — no re-render. ffmpeg concat driven…
+- `video-storyboard` — Image-only storyboard — script → scenes → blueprint → image render → contact-sheet PNG via ffmpeg montage.…
 
 ### Domain flow — marketing
 
 _Ghostwriter + post-as voice pipeline._
 
 - `ghostwriter` — Ghostwriter cluster — fetch, write, list, show, and delete public-figure voice profiles (the third voice pr…
-- `ghostwriter:delete` — Hard-delete a ghostwriter profile at agents/reference/ghostwriter/<slug>.md after a two-step confirmation.…
-- `ghostwriter:fetch` — Build or refresh a public-figure voice profile under agents/reference/ghostwriter/ from a URL or bare name;…
-- `ghostwriter:list` — List captured ghostwriter profiles under agents/reference/ghostwriter/ as a numbered table with confidence,…
-- `ghostwriter:show` — Render a single ghostwriter profile in full — identity, style fingerprint, voice samples, taboos, source UR…
-- `ghostwriter:write` — Draft a markdown post in the voice of a captured public-figure ghostwriter profile; appends the mandatory n…
+- `ghostwriter-delete` — Hard-delete a ghostwriter profile at agents/reference/ghostwriter/<slug>.md after a two-step confirmation.…
+- `ghostwriter-fetch` — Build or refresh a public-figure voice profile under agents/reference/ghostwriter/ from a URL or bare name;…
+- `ghostwriter-list` — List captured ghostwriter profiles under agents/reference/ghostwriter/ as a numbered table with confidence,…
+- `ghostwriter-show` — Render a single ghostwriter profile in full — identity, style fingerprint, voice samples, taboos, source UR…
+- `ghostwriter-write` — Draft a markdown post in the voice of a captured public-figure ghostwriter profile; appends the mandatory n…
 - `post-as` — Consumer-facing write entry points — :me drafts in the maintainer's own voice from .agent-user.md (no discl…
-- `post-as:ghostwriter` — Thin alias for /ghostwriter:write — drafts a copyable markdown post in a captured public-figure voice with…
-- `post-as:me` — Draft a copyable markdown post in the maintainer's own voice (style source = .agent-user.md.voice_sample).…
+- `post-as-ghostwriter` — Thin alias for /ghostwriter:write — drafts a copyable markdown post in a captured public-figure voice with…
+- `post-as-me` — Draft a copyable markdown post in the maintainer's own voice (style source = .agent-user.md.voice_sample).…
 
 ### Domain flow — fun
 

package/docs/contracts/adr-layout.md

@@ -4,7 +4,7 @@ stability: stable
 
 # ADR Layout — Per-area Directories
 
-> Status: accepted · 2026-05-16 · Roadmap: `step-11-ruflo-parity` Phase 4
+> Status: accepted · 2026-05-16 · Roadmap: an internal parity roadmap (local-only) Phase 4
 
 ## Scope
 
@@ -42,7 +42,6 @@ Reserved areas (bootstrap pass — step-11 Phase 4 Step 3):
 | `schema` | Frontmatter schemas, v2 rigor, lint behaviour | [`schema-versioning.md`](schema-versioning.md) (when published) |
 | `router` | `router.json` shape, tier semantics, dispatch precedence | [`rule-router.md`](rule-router.md) |
 | `smoke` | Per-tier smoke contracts, baseline locks | [`smoke-contracts.md`](smoke-contracts.md) |
-| `memory` | Memory MCP, propose / promote / poison flow | [`agent-memory-contract.md`](agent-memory-contract.md) |
 
 ## Frontmatter
 
@@ -105,4 +104,4 @@ The skill's template, numbering logic, and validation hooks are identical for bo
 - [`docs/decisions/INDEX.md`](../decisions/INDEX.md) — flat surface index.
 - [`scripts/audit_adr_coverage.py`](../../src/scripts/audit_adr_coverage.py) — coverage gate.
 - [`scripts/adr/regenerate_index.py`](../../src/scripts/adr/regenerate_index.py) — index regenerator (works on both surfaces; pass `--dir`).
-- `step-11-ruflo-parity` Phase 4 — origin.
+- an internal parity roadmap (local-only) Phase 4 — origin.

package/docs/contracts/adr-level-6-productization.md

@@ -63,7 +63,7 @@ stability: stable
 - Rule-Interaction matrix marked rule-only by design;
   [`rule-interactions.md`](rule-interactions.md) § "Out of scope —
   orchestration surfaces" points at `decision-engine-gates`,
-  `decision-trace-v1`, `agent-memory-contract`, `memory-visibility-v1`,
+  `decision-trace-v1`, `memory-visibility-v1`,
   and the `ai-council` skill for Council × Memory × Work-Engine
   interactions (P5.2).
 - `type: orchestrator` frontmatter tag exempts cluster routers from

package/docs/contracts/ai-council-config.md

@@ -3,16 +3,16 @@ stability: beta
 keep-beta-until: 2026-08-12
 ---
 
-# AI-Council Config (`agents/settings/.ai-council.yml`)
+# AI-Council Config (`.ai-council.yml`)
 
 **Purpose.** Lock the schema, validation, and precedence rules for the
 centralized council config file. Every phase of the AI-Council
 consolidation work reads from this file; the contract here is the
 boundary that prevents drift across the loader, the CLI, the
-orchestrator, and the `agents/settings/.ai-council.yml` file itself.
+orchestrator, and the `.ai-council.yml` file itself.
 
 **Audience.** Authors of `scripts/ai_council/config.py`, `council_cli.py`,
-`scripts/ai_council/orchestrator.py`, and the `agents/settings/.ai-council.yml`
+`scripts/ai_council/orchestrator.py`, and the `.ai-council.yml`
 starter. Also reviewers checking that new providers / advisors / debate
 features keep the schema intact.
 
@@ -21,10 +21,45 @@ a revision entry in the consuming roadmap.
 
 ## File location
 
-The single source of truth is **`agents/settings/.ai-council.yml`** at the
-project root. The legacy `ai_council.*` block under `.agent-settings.yml`
-is removed by Phase 0 Step 5 and replaced by a one-line breadcrumb
-pointing at this contract.
+The council is configured **once per user**, not per project. The config
+lives in the user-global namespace:
+
+```
+~/.event4u/agent-config/settings/.ai-council.yml
+```
+
+(with the legacy `~/.config/agent-config/settings/.ai-council.yml` read as a
+fallback during the v2.4 namespace transition). This is where a single
+developer enables members, pins models, and sets caps once — and the
+council then works in **every** project they open, with no per-project
+file to check in or accidentally commit. See
+[ADR-093](../decisions/ADR-093-ai-council-config-user-global.md).
+
+`scripts/ai_council/config.py:resolve_config_path` resolves the active
+file with this precedence (first match wins):
+
+1. **`$AI_COUNCIL_CONFIG`** — an explicit absolute path. Honoured even
+   when the target is absent (so a typo surfaces as "create it here"
+   rather than silently falling back). Primarily for tests / power users.
+2. **Project-local** `<project_root>/agents/settings/.ai-council.yml` —
+   only when a consumer project deliberately checks in its own council
+   config. This **overrides** the user-global file for that project.
+3. **User-global** `~/.event4u/agent-config/settings/.ai-council.yml` — the
+   canonical default described above.
+
+When none exists, the loader reports the user-global path as the place to
+create it. `agents/templates/.ai-council.yml.example` ships the documented
+shape to copy from. The legacy `ai_council.*` block under
+`.agent-settings.yml` remains removed (Phase 0 Step 5); a one-line
+breadcrumb there points at this contract.
+
+> **Why user-global, not project-tracked.** A council config checked into
+> the project tree (the pre-ADR-093 layout) (a) re-applied per-project
+> instead of per-developer, (b) risked being committed to a public repo,
+> and (c) was silently *not found* on cloud / headless / fresh-checkout
+> surfaces with no project copy — the council then refused with
+> "ai_council.enabled is false" even though the user had set it up. The
+> user-global location fixes all three.
 
 ## Top-level schema
 

package/docs/contracts/command-clusters.md

@@ -33,7 +33,7 @@ column 1 of this table.
 | `feature` | 1 | `explore` · `plan` · `refactor` · `roadmap` · `dev` | `feature-explore` · `feature-plan` · `feature-refactor` · `feature-roadmap` · `feature-dev` |
 | `chat-history` | 2 | `show` · `import` · `learn` | `chat-history` (legacy status) — `resume` / `clear` / `checkpoint` removed in `road-to-chat-history-hook-only` (auto-adopt + structural hooks); `import` (verbatim cross-session render) and `learn` (project-improving learning extraction) added in the v4 stateless schema |
 | `agents` | 2 | `init` · `optimize` · `audit` · `user` | AGENTS.md file family (high-frequency) — repurposed 2026-05-09: `init` (was `/copilot-agents init`) · `optimize` (merger of `/optimize agents-md` + `/copilot-agents optimize`) · `audit` (was `/optimize agents`, collapses old `audit` + `check` verbs); legacy folder ops (`prepare` / `cleanup` / folder-`audit`) moved to `/optimize agents-dir`; `user` sub-cluster added 2026-05-15 — manages the project-root `.agent-user.md` persona file (sub-sub-commands: `init` · `show` · `review` · `accept` · `update`) per [`agent-user-schema`](agent-user-schema.md) |
-| `memory` | 2 | `add` · `load` · `promote` · `propose` · `mine-session` · `learn-low-impact` | `memory-add` · `memory-full` · `memory-promote` · `propose-memory`; `mine-session` added 2026-05-10 — manual transcript-mining sub-command from `road-to-dream-skill-adoption.md`, opt-in via `--confirm-transcript-access` per invocation; `learn-low-impact` added 2026-05-15 — upstreams `## Validated` entries from `agents/decisions/low-impact-decisions.md` to the package seed via a DRAFT PR (re-runs the privacy-floor redactor as a second gate per `low-impact-corpus-privacy-floor`) |
+| `memory` | 2 | `add` · `load` · `promote` · `propose` · `mine-session` · `learn-low-impact` | `memory-add` · `memory-full` · `memory-promote` · `propose-memory`; `mine-session` added 2026-05-10 — manual transcript-mining sub-command from an internal roadmap (local-only), opt-in via `--confirm-transcript-access` per invocation; `learn-low-impact` added 2026-05-15 — upstreams `## Validated` entries from `agents/decisions/low-impact-decisions.md` to the package seed via a DRAFT PR (re-runs the privacy-floor redactor as a second gate per `low-impact-corpus-privacy-floor`) |
 | `roadmap` | 2 | `create` · `ai-council` · `process-step` · `process-phase` · `process-full` | `roadmap-create` · `roadmap-execute` (replaced — autonomous, no per-step gate; `process-phase` is the default execution scope); `ai-council` added 2026-05-07 — wraps `/council default` with `--input-mode roadmap --depth deep` |
 | `module` | 2 | `create` · `explore` | `module-create` · `module-explore` |
 | `tests` | 2 | `create` · `execute` | `tests-create` · `tests-execute` |

package/docs/contracts/cost-enforcement.md

@@ -128,7 +128,7 @@ suite is wired to `task test-cost-budget` per `step-11` Phase 2 Step 5.
 
 ## See also
 
-- `step-11-ruflo-parity` — Measurement & Governance Parity roadmap.
+- an internal parity roadmap (local-only) — Measurement & Governance Parity roadmap.
 - `docs/contracts/cost-dashboard.md` — companion dashboard contract.
 - `scripts/cost/budget.mjs` — evaluator implementation.
 - `internal/bench/pricing.yaml` — per-model USD pricing table.

package/docs/contracts/cost-summary-schema.md

@@ -9,7 +9,7 @@ Stable JSON contract for inter-tool consumption of cost-tracking data
 emitted by [`scripts/cost_summary.py`](../../src/scripts/cost_summary.py).
 Schema-versioned so downstream consumers can pin and migrate explicitly.
 
-Design reference: Ruflo `scripts/summary.mjs` (upstream cite). Our shape
+Design reference: the external runtime `scripts/summary.mjs` (upstream cite). Our shape
 diverges to align with the local `agents/cost-tracking/sessions.jsonl`
 fields and the telegraph-suspended-multiplier contract.
 

package/docs/contracts/daily-workspace.md

@@ -139,6 +139,7 @@ counters only. No prompt bodies, no response bodies.
 
 ## Cross-references
 
+- **Boundary:** [`workspace-boundary`](workspace-boundary.md) — what the workspace owns vs. does **not** own ([`ADR-095`](../decisions/ADR-095-workspace-boundary-contract.md)), enforced by the import-edge linter.
 - ADRs: [`022`](../decisions/ADR-022-daily-workspace-decomposition.md) · [`023`](../decisions/ADR-023-host-agent-protocol.md) · [`024`](../decisions/ADR-024-workspace-v0-feature-floor.md) · [`025`](../decisions/ADR-025-workspace-chrome.md).
 - Host-agent protocol: [`host-agent-protocol`](host-agent-protocol.md).
 - GUI substrate: [`gui-wizard`](gui-wizard.md).

package/docs/contracts/discovery-manifest.schema.json

@@ -64,7 +64,8 @@
         "product-basic", "product-discovery",
         "finance-basic", "finance-advanced",
         "gtm-sales", "gtm-marketing",
-        "ops-people", "founder-strategy", "small-business", "construction", "ai-video", "fun", "meta", "git", "frontend-design"
+        "ops-people", "founder-strategy", "small-business", "construction", "ai-video", "fun", "meta", "git", "frontend-design",
+        "memory", "analytics", "product-reasoning"
       ]
     },
     "lifecycle": {
@@ -134,7 +135,8 @@
         "category": { "type": "string", "enum": ["skill", "rule", "command", "template"] },
         "name": { "type": "string" },
         "pack": { "$ref": "#/$defs/pack_id", "description": "capability-packs.md — canonical OWNER pack (ownership/budget unit). Orthogonal to `packs` (discovery tags); the owner need not appear in `packs`." },
-        "tier": { "type": "integer", "enum": [0, 1, 2], "description": "6.0.0-C — command-surface tier surfaced on `category: command` artefacts so the CLI discovery surface reads the manifest, not a parallel catalog." },
+        "tier": { "type": "integer", "enum": [0, 1, 2], "description": "6.0.0-C — command-surface tier surfaced on `category: command` artefacts so the CLI discovery surface reads the manifest, not a parallel catalog. Back-compat alias of `visibility` since ADR-090; dual-emitted during the deprecation window." },
+        "visibility": { "type": "string", "enum": ["visible", "advanced", "internal"], "description": "ADR-090 — named command-surface visibility (visible↔tier 0, advanced↔tier 1, internal↔tier 2); the classifier source of truth. Dual-emitted alongside `tier` on `category: command` artefacts during the deprecation window." },
         "intent": { "type": "string", "description": "6.0.0-C — command routing metadata (one-line existence justification). Present on visible command artefacts." },
         "routes_to": { "type": "array", "items": { "type": "string" }, "description": "6.0.0-C — command routing metadata (skill/cluster-sub/command slugs the intent routes to)." },
         "replaces": { "type": "array", "items": { "type": "string" }, "description": "6.0.0-C — command routing metadata (prior names/aliases this command absorbs; may be empty)." },

package/docs/contracts/explain-modes.md

@@ -182,6 +182,6 @@ profile-explain (`ask-when-uncertain`).
 ## Cross-references
 
 - ADR: [`ADR-026`](../decisions/ADR-026-explain-mode-translation.md).
-- Envelope contract: [`agent-memory-contract`](agent-memory-contract.md) (`explain-v1`).
+- Envelope contract: [`retrieval-v1.schema.json`](../../internal/schemas/retrieval-v1.schema.json) (`explain-v1`).
 - Workspace integration: [`daily-workspace`](daily-workspace.md) (right rail).
 - Roles: [`role-experience`](role-experience.md) (`explain_default` field).

package/docs/contracts/implement-ticket-flow.md

@@ -34,7 +34,7 @@ in Phase 0 and recorded in a short ADR once decided.
 - A runtime implementation spec.
 - A DSL for user-authored flows (explicitly out of scope).
 - A memory retrieval spec — that lives in
-  [`agent-memory-contract.md`](agent-memory-contract.md).
+  [`../guidelines/agent-infra/memory-access.md`](../guidelines/agent-infra/memory-access.md).
 
 ## The linear flow
 
@@ -262,17 +262,16 @@ boundary writes. Full reference: [`work-engine-hooks.md`](work-engine-hooks.md).
 Bounded per the top-level roadmap rule:
 
 - **Max 12 hits total.**
-- **Four allowed types:** `domain-invariants`,
-  `architecture-decisions`, `incident-learnings`,
-  `historical-patterns`. All four exist in the
-  [templates directory](../../.agent-src.uncondensed/templates/agents/memory/).
+- **Three allowed types:** `domain-invariants`, `incident-learnings`,
+  `historical-patterns`. (Architectural rationale lives in ADRs —
+  `docs/decisions/` — not in curated memory.)
 - **Keys:** files touched by the plan, symbols referenced by the
   ticket.
 - **Decision-change rule:** a memory hit that did not change an
   outcome is dropped from the report. If none changed an outcome,
   the `memory` section of the report is omitted — not padded.
 - Follows the retrieval shape in
-  [`agent-memory-contract.md`](agent-memory-contract.md).
+  [`../guidelines/agent-infra/memory-access.md`](../guidelines/agent-infra/memory-access.md).
 
 ## Persona policies
 
@@ -619,7 +618,7 @@ are blocked by `freeze-guard.yml::manifest-integrity` at PR time.
 - `tests/golden/` — capture sandbox, recipes, and Capture Packs
 - [`../../tests/golden/harness.py`](../../tests/golden/harness.py) — Strict-Verb replay harness
 - [`../../.github/workflows/freeze-guard.yml`](../../.github/workflows/freeze-guard.yml) — manifest-integrity + live-replay gates
-- [`agent-memory-contract.md`](agent-memory-contract.md)
+- [`../guidelines/agent-infra/memory-access.md`](../guidelines/agent-infra/memory-access.md)
 - [`../../docs/guidelines/agent-infra/role-contracts.md`](../../docs/guidelines/agent-infra/role-contracts.md)
 - [`../../.agent-src.uncondensed/rules/user-interaction.md`](../../.agent-src.uncondensed/rules/user-interaction.md)
 - [`../../.agent-src.uncondensed/rules/scope-control.md`](../../.agent-src.uncondensed/rules/scope-control.md)

package/docs/contracts/mcp-tool-inventory.md

@@ -10,7 +10,7 @@ keep-beta-until: 2026-08-14
 > [`scripts/mcp_server/consumer_tool_catalog.json`](../../scripts/mcp_server/consumer_tool_catalog.json).
 > Do **not** hand-edit; rerun `python3 scripts/audit_mcp_tools.py --write`.
 >
-> Step-11 Phase 5 Step 3 (`step-11-ruflo-parity.md`).
+> Step-11 Phase 5 Step 3 (an internal parity roadmap (local-only)).
 
 ## Summary
 
@@ -23,12 +23,12 @@ keep-beta-until: 2026-08-14
 
 | Tool | Side-effect | Transports | Catalog | Handler |
 |---|---|---|---|---|
-| `lint_skills` | `ro` | stdio | [`consumer_tool_catalog.json:7`](../../scripts/mcp_server/consumer_tool_catalog.json#L7) | [`tools.py:521`](../../scripts/mcp_server/tools.py#L521) |
-| `chat_history_append` | `fs-write` | stdio | [`consumer_tool_catalog.json:24`](../../scripts/mcp_server/consumer_tool_catalog.json#L24) | [`tools.py:546`](../../scripts/mcp_server/tools.py#L546) |
-| `chat_history_read` | `ro` | stdio | [`consumer_tool_catalog.json:43`](../../scripts/mcp_server/consumer_tool_catalog.json#L43) | [`tools.py:586`](../../scripts/mcp_server/tools.py#L586) |
-| `memory_lookup` | `ro` | stdio | [`consumer_tool_catalog.json:59`](../../scripts/mcp_server/consumer_tool_catalog.json#L59) | [`tools.py:606`](../../scripts/mcp_server/tools.py#L606) |
+| `lint_skills` | `ro` | stdio | [`consumer_tool_catalog.json:7`](../../scripts/mcp_server/consumer_tool_catalog.json#L7) | [`tools.py:509`](../../scripts/mcp_server/tools.py#L509) |
+| `chat_history_append` | `fs-write` | stdio | [`consumer_tool_catalog.json:24`](../../scripts/mcp_server/consumer_tool_catalog.json#L24) | [`tools.py:539`](../../scripts/mcp_server/tools.py#L539) |
+| `chat_history_read` | `ro` | stdio | [`consumer_tool_catalog.json:43`](../../scripts/mcp_server/consumer_tool_catalog.json#L43) | [`tools.py:606`](../../scripts/mcp_server/tools.py#L606) |
+| `memory_lookup` | `ro` | stdio | [`consumer_tool_catalog.json:59`](../../scripts/mcp_server/consumer_tool_catalog.json#L59) | [`tools.py:654`](../../scripts/mcp_server/tools.py#L654) |
 | `memory_signal` | `fs-write` | _(stub)_ | [`consumer_tool_catalog.json:75`](../../scripts/mcp_server/consumer_tool_catalog.json#L75) | _stub-only_ |
-| `memory_status` | `ro` | stdio | [`consumer_tool_catalog.json:91`](../../scripts/mcp_server/consumer_tool_catalog.json#L91) | [`tools.py:633`](../../scripts/mcp_server/tools.py#L633) |
+| `memory_status` | `ro` | stdio | [`consumer_tool_catalog.json:91`](../../scripts/mcp_server/consumer_tool_catalog.json#L91) | [`tools.py:701`](../../scripts/mcp_server/tools.py#L701) |
 | `skill_trigger_eval` | `ro` | _(stub)_ | [`consumer_tool_catalog.json:98`](../../scripts/mcp_server/consumer_tool_catalog.json#L98) | _stub-only_ |
 | `suggest_command` | `ro` | _(stub)_ | [`consumer_tool_catalog.json:114`](../../scripts/mcp_server/consumer_tool_catalog.json#L114) | _stub-only_ |
 | `suggest_skill_for_task` | `ro` | _(stub)_ | [`consumer_tool_catalog.json:129`](../../scripts/mcp_server/consumer_tool_catalog.json#L129) | _stub-only_ |
@@ -38,11 +38,11 @@ keep-beta-until: 2026-08-14
 | `sync_agent_settings` | `fs-write` | _(stub)_ | [`consumer_tool_catalog.json:186`](../../scripts/mcp_server/consumer_tool_catalog.json#L186) | _stub-only_ |
 | `run_tests` | `shell` | _(stub)_ | [`consumer_tool_catalog.json:200`](../../scripts/mcp_server/consumer_tool_catalog.json#L200) | _stub-only_ |
 | `run_quality_checks` | `shell` | _(stub)_ | [`consumer_tool_catalog.json:214`](../../scripts/mcp_server/consumer_tool_catalog.json#L214) | _stub-only_ |
-| `list_skills` | `ro` | stdio | [`consumer_tool_catalog.json:227`](../../scripts/mcp_server/consumer_tool_catalog.json#L227) | [`tools.py:647`](../../scripts/mcp_server/tools.py#L647) |
-| `list_commands` | `ro` | stdio | [`consumer_tool_catalog.json:234`](../../scripts/mcp_server/consumer_tool_catalog.json#L234) | [`tools.py:660`](../../scripts/mcp_server/tools.py#L660) |
-| `list_rules` | `ro` | stdio | [`consumer_tool_catalog.json:241`](../../scripts/mcp_server/consumer_tool_catalog.json#L241) | [`tools.py:673`](../../scripts/mcp_server/tools.py#L673) |
+| `list_skills` | `ro` | stdio | [`consumer_tool_catalog.json:227`](../../scripts/mcp_server/consumer_tool_catalog.json#L227) | [`tools.py:716`](../../scripts/mcp_server/tools.py#L716) |
+| `list_commands` | `ro` | stdio | [`consumer_tool_catalog.json:234`](../../scripts/mcp_server/consumer_tool_catalog.json#L234) | [`tools.py:732`](../../scripts/mcp_server/tools.py#L732) |
+| `list_rules` | `ro` | stdio | [`consumer_tool_catalog.json:241`](../../scripts/mcp_server/consumer_tool_catalog.json#L241) | [`tools.py:748`](../../scripts/mcp_server/tools.py#L748) |
 | `compile_router` | `shell` | _(stub)_ | [`consumer_tool_catalog.json:248`](../../scripts/mcp_server/consumer_tool_catalog.json#L248) | _stub-only_ |
-| `read_resource_body` | `ro` | stdio | [`consumer_tool_catalog.json:261`](../../scripts/mcp_server/consumer_tool_catalog.json#L261) | [`tools.py:686`](../../scripts/mcp_server/tools.py#L686) |
+| `read_resource_body` | `ro` | stdio | [`consumer_tool_catalog.json:261`](../../scripts/mcp_server/consumer_tool_catalog.json#L261) | [`tools.py:765`](../../scripts/mcp_server/tools.py#L765) |
 
 ## Glossary
 

package/docs/contracts/measurement-baseline.md

@@ -90,7 +90,7 @@ P2 roadmap reads — not the live `internal/bench/reports/` directory.
 
 ## Carve-outs
 
-- **Pricing freshness:** [`internal/bench/pricing.yaml`](../../bench/pricing.yaml) rows must carry `sourced_on: YYYY-MM-DD`. Stale prices = stale numbers = no trust (ruflo "measured-vs-claimed" pattern).
+- **Pricing freshness:** [`internal/bench/pricing.yaml`](../../bench/pricing.yaml) rows must carry `sourced_on: YYYY-MM-DD`. Stale prices = stale numbers = no trust (external "measured-vs-claimed" pattern).
 - **Subjective grading excluded:** quality scoring is mechanical via `quality_assertion`. No vibes.
 - **Cursor / Cline / Windsurf:** rules-only surfaces, no SKILL.md projection. `bench:projection` reports them as `not_applicable` — the gap is acknowledged, not silently dropped.
 

package/docs/contracts/memory-visibility-v1.md

@@ -7,9 +7,7 @@ keep-beta-until: 2026-08-12
 
 **Purpose.** Pin the format of the user-facing visibility line that
 every memory-using `/work` and `/implement-ticket` run prints, so the
-user can tell what the agent retrieved and what it ignored.
-Complements [`agent-memory-contract.md`](agent-memory-contract.md):
-that doc describes the **CLI surface and backend states**; this doc
+user can tell what the agent retrieved and what it ignored. This doc
 describes the **operator-facing surface** the engine emits per turn.
 
 **Scope.** Defines the line shape, the privacy floor, and the opt-out
@@ -156,8 +154,6 @@ compat extensions.
 
 ## Cross-references
 
-- CLI surface and backend states:
-  [`agent-memory-contract.md`](agent-memory-contract.md).
 - Decision-trace JSON consumes the same counts:
   [`decision-trace-v1.md`](decision-trace-v1.md).
 - Privacy regression test path:

package/docs/contracts/namespace.md

@@ -10,7 +10,7 @@ stability: stable
 > all five surfaces silently.
 >
 > **Source:** Step-11 Phase 5 Step 1
-> (`step-11-ruflo-parity.md`).
+> (an internal parity roadmap (local-only)).
 > **Enforcer:** [`scripts/lint_namespace.py`](../../src/scripts/lint_namespace.py),
 > wired into `task lint-skills`.