npm - @event4u/agent-config - Versions diffs - 1.16.0 → 1.18.0 - Mend

@event4u/agent-config 1.16.0 → 1.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (224) hide show

package/docs/catalog.md CHANGED Viewed

@@ -1,6 +1,6 @@
 # agent-config — Public Catalog
-Consumer-facing catalog of all **299 public artefacts** shipped by
+Consumer-facing catalog of all **327 public artefacts** shipped by
 this package. Internal package-maintenance rules and deprecation shims
 are excluded.
@@ -141,7 +141,7 @@ are excluded.
 | skill | [`verify-completion-evidence`](../.agent-src/skills/verify-completion-evidence/SKILL.md) |  | Use when claiming 'done', suggesting a commit, push, or PR — runs the evidence gate so completion claims come from fresh output in this message, not memory or earlier runs. |
 | skill | [`websocket`](../.agent-src/skills/websocket/SKILL.md) |  | Use when building real-time features — WebSocket broadcasting, live updates, presence channels, connection state — even when the user just says 'push this to the client live'. |
-## Rules (54)
+## Rules (55)
 | kind | name | type | description |
 |---|---|---|---|
@@ -175,6 +175,7 @@ are excluded.
 | rule | [`missing-tool-handling`](../.agent-src/rules/missing-tool-handling.md) | auto | When a CLI tool needed for the task is not installed — ask before working around it; do NOT install silently |
 | rule | [`model-recommendation`](../.agent-src/rules/model-recommendation.md) | auto | Starting a new task, switching task type, or invoking a command — detect task complexity and recommend the optimal model (Opus/Sonnet/GPT) before any work |
 | rule | [`no-cheap-questions`](../.agent-src/rules/no-cheap-questions.md) | always | No cheap questions — never ask what context answers, never offer Iron-Law-violating options, never stage no-trade-off choices; mode-independent (off / auto / on) |
+| rule | [`no-roadmap-references`](../.agent-src/rules/no-roadmap-references.md) | auto | Adding a link to a specific file in agents/roadmaps/ from any stable artifact (rule, skill, command, context, guideline) — roadmaps are transient; promote durable findings to agents/contexts/ instead |
 | rule | [`non-destructive-by-default`](../.agent-src/rules/non-destructive-by-default.md) | always | Agent is never destructive — Hard Floor always asks for prod-trunk merges, deploys, pushes, prod data/infra, bulk deletions, and bulk-deletion/infra commits; no autonomy or roadmap bypass |
 | rule | [`onboarding-gate`](../.agent-src/rules/onboarding-gate.md) | auto | First turn of a conversation on a project — check onboarding.onboarded in .agent-settings.yml; when false, prompt the user to run /onboard before executing any other request |
 | rule | [`package-ci-checks`](../.agent-src/rules/package-ci-checks.md) | auto | Before pushing to remote or creating a PR in the agent-config package — run all CI checks locally first |
@@ -200,85 +201,112 @@ are excluded.
 | rule | [`user-interaction`](../.agent-src/rules/user-interaction.md) | auto | Asking the user a question, presenting options, or summarizing progress — numbered-options Iron Law, single-recommendation rule, progress indicators |
 | rule | [`verify-before-complete`](../.agent-src/rules/verify-before-complete.md) | always | Verify before completion — run tests and quality tools before claiming done |
-## Commands (69)
+## Commands (95)
 | kind | name | cluster | description |
 |---|---|---|---|
 | command | [`agent-handoff`](../.agent-src/commands/agent-handoff.md) |  | Generate a context summary for continuing work in a fresh chat. Replaces the session system. |
 | command | [`agent-status`](../.agent-src/commands/agent-status.md) |  | Show current conversation stats — message count, token costs, task progress, next freshness check. |
-| command | [`agents-audit`](../.agent-src/commands/agents-audit.md) |  | Audits agents/ and module agents/ directories — finds outdated docs, structural issues, duplicates, orphaned overrides, and creates an improvement roadmap. |
-| command | [`agents-cleanup`](../.agent-src/commands/agents-cleanup.md) |  | Execute cleanup actions from an agents-audit — move, merge, delete, and update agent docs |
-| command | [`agents-prepare`](../.agent-src/commands/agents-prepare.md) |  | Scaffold the agents/ directory structure with all required subdirectories and .gitkeep files |
+| command | [`agents:audit`](../.agent-src/commands/agents/audit.md) | cluster: agents | Audits agents/ and module agents/ directories — finds outdated docs, structural issues, duplicates, orphaned overrides, and creates an improvement roadmap. |
+| command | [`agents:cleanup`](../.agent-src/commands/agents/cleanup.md) | cluster: agents | Execute cleanup actions from an agents-audit — move, merge, delete, and update agent docs |
+| command | [`agents:prepare`](../.agent-src/commands/agents/prepare.md) | cluster: agents | Scaffold the agents/ directory structure with all required subdirectories and .gitkeep files |
+| command | [`agents`](../.agent-src/commands/agents.md) | cluster: agents | Agents-folder orchestrator — routes to audit, cleanup, prepare |
 | command | [`analyze-reference-repo`](../.agent-src/commands/analyze-reference-repo.md) |  | Analyze an external reference repository (competitor, inspiration, peer) and produce a structured comparison + adoption plan for this project. |
 | command | [`bug-fix`](../.agent-src/commands/bug-fix.md) |  | Plan and implement a bug fix — based on investigation, with quality checks and test verification |
 | command | [`bug-investigate`](../.agent-src/commands/bug-investigate.md) |  | Investigate a bug — auto-detect ticket from branch, gather Jira/Sentry/description context, trace root cause |
-| command | [`chat-history-checkpoint`](../.agent-src/commands/chat-history-checkpoint.md) |  | Append a phase-boundary entry to .agent-chat-history — CHECKPOINT fallback for platforms without a native hook (Augment IDE, Cursor pre-1.7, Cline non-Mac/Linux). ~1s. |
-| command | [`chat-history-clear`](../.agent-src/commands/chat-history-clear.md) |  | Manually delete the persistent chat-history log — asks for confirmation, optionally archives to a timestamped backup before wiping |
-| command | [`chat-history-resume`](../.agent-src/commands/chat-history-resume.md) |  | Load the persistent chat-history log into the current conversation — picks match/returning/foreign flow and supports resume, merge, replace, or continue |
-| command | [`chat-history`](../.agent-src/commands/chat-history.md) |  | Show the status of the persistent chat-history log — file size, entry count, header fingerprint, age, and the last few entries |
+| command | [`chat-history:checkpoint`](../.agent-src/commands/chat-history/checkpoint.md) | cluster: chat-history | Append a phase-boundary entry to .agent-chat-history — CHECKPOINT fallback for platforms without a native hook (Augment IDE, Cursor pre-1.7, Cline non-Mac/Linux). ~1s. |
+| command | [`chat-history:clear`](../.agent-src/commands/chat-history/clear.md) | cluster: chat-history | Manually delete the persistent chat-history log — asks for confirmation, optionally archives to a timestamped backup before wiping |
+| command | [`chat-history:resume`](../.agent-src/commands/chat-history/resume.md) | cluster: chat-history | Load the persistent chat-history log into the current conversation — picks match/returning/foreign flow and supports resume, merge, replace, or continue |
+| command | [`chat-history:show`](../.agent-src/commands/chat-history/show.md) | cluster: chat-history | Show the status of the persistent chat-history log — file size, entry count, header fingerprint, age, and the last few entries |
+| command | [`chat-history`](../.agent-src/commands/chat-history.md) | cluster: chat-history | Chat-history orchestrator — routes to show, resume, clear, checkpoint |
 | command | [`check-current-md`](../.agent-src/commands/check-current-md.md) |  | Check the open .md file (or a passed path) for German outside DE:/EN: anchor blocks — umlauts, function words, untranslated quotes. Reports and offers fixes. |
-| command | [`commit-in-chunks`](../.agent-src/commands/commit-in-chunks.md) |  | Stage and commit all uncommitted changes in logical chunks WITHOUT confirmation — sibling of /commit for autonomous flows |
-| command | [`commit`](../.agent-src/commands/commit.md) |  | Stage and commit all uncommitted changes — splits into logical commits following Conventional Commits |
+| command | [`commit:in-chunks`](../.agent-src/commands/commit/in-chunks.md) | cluster: commit | Stage and commit all uncommitted changes in logical chunks WITHOUT confirmation — sibling of /commit for autonomous flows |
+| command | [`commit`](../.agent-src/commands/commit.md) | cluster: commit | Stage and commit all uncommitted changes — splits into logical commits following Conventional Commits |
 | command | [`compress`](../.agent-src/commands/compress.md) |  | Compress .md files from .agent-src.uncompressed/ into caveman format and write to .agent-src/ |
-| command | [`context-create`](../.agent-src/commands/context-create.md) |  | Analyze a codebase area and create a structured context document |
-| command | [`context-refactor`](../.agent-src/commands/context-refactor.md) |  | Analyze, update, and extend an existing context document |
-| command | [`copilot-agents-init`](../.agent-src/commands/copilot-agents-init.md) |  | Create AGENTS.md and .github/copilot-instructions.md from scratch in the consumer project — interactive, auto-detects stack, never leaks other projects' identifiers. |
-| command | [`copilot-agents-optimize`](../.agent-src/commands/copilot-agents-optimize.md) |  | Analyzes and refactors AGENTS.md and copilot-instructions.md — removes duplications, enforces line budgets, and ensures both files are optimized for their audience. |
-| command | [`council-design`](../.agent-src/commands/council-design.md) | cluster: optimize | Run the council on a design document, ADR, or architecture proposal — surfaces hidden coupling, missing rollback, and sequencing risk before commitment. |
-| command | [`council-optimize`](../.agent-src/commands/council-optimize.md) | cluster: optimize | Run the council on an optimization target — perf hot path, memory pattern, query, or an /optimize-* output — for ranked, evidence-based suggestions instead of generic advice. |
-| command | [`council-pr`](../.agent-src/commands/council-pr.md) | cluster: optimize | Pull a GitHub PR via gh CLI and run the council on the diff with a PR-specific neutrality preamble — read-only by default; comment posting is opt-in. |
-| command | [`council`](../.agent-src/commands/council.md) | cluster: optimize | Consult external AIs (OpenAI, Anthropic) for an independent second opinion on a prompt, roadmap, diff, or file set — neutral framing, redacted context, advisory output only. |
-| command | [`create-pr-description`](../.agent-src/commands/create-pr-description.md) |  | Generate a PR description as a copyable markdown block — used standalone or by create-pr |
-| command | [`create-pr`](../.agent-src/commands/create-pr.md) |  | Create a GitHub PR with structured description from Jira ticket and code changes |
-| command | [`do-and-judge`](../.agent-src/commands/do-and-judge.md) |  | Run a single change through an implementer→judge loop with a two-revision ceiling, then hand back to the user |
-| command | [`do-in-steps`](../.agent-src/commands/do-in-steps.md) |  | Execute an ordered plan step by step with a judge gate between steps — stops on first failed verdict |
+| command | [`context:create`](../.agent-src/commands/context/create.md) | cluster: context | Analyze a codebase area and create a structured context document |
+| command | [`context:refactor`](../.agent-src/commands/context/refactor.md) | cluster: context | Analyze, update, and extend an existing context document |
+| command | [`context`](../.agent-src/commands/context.md) | cluster: context | Context orchestrator — routes to create, refactor |
+| command | [`copilot-agents:init`](../.agent-src/commands/copilot-agents/init.md) | cluster: copilot-agents | Create AGENTS.md and .github/copilot-instructions.md from scratch in the consumer project — interactive, auto-detects stack, never leaks other projects' identifiers. |
+| command | [`copilot-agents:optimize`](../.agent-src/commands/copilot-agents/optimize.md) | cluster: copilot-agents | Analyzes and refactors AGENTS.md and copilot-instructions.md — removes duplications, enforces line budgets, and ensures both files are optimized for their audience. |
+| command | [`copilot-agents`](../.agent-src/commands/copilot-agents.md) | cluster: copilot-agents | Copilot agents-doc orchestrator — routes to init, optimize |
+| command | [`council:default`](../.agent-src/commands/council/default.md) | cluster: council | Default council lens — neutral framing, redacted context, advisory output only. Run `/council default <input>` for prompt/roadmap/diff/files; the cluster shows a menu when invoked bare. |
+| command | [`council:design`](../.agent-src/commands/council/design.md) | cluster: council | Run the council on a design document, ADR, or architecture proposal — surfaces hidden coupling, missing rollback, and sequencing risk before commitment. |
+| command | [`council:optimize`](../.agent-src/commands/council/optimize.md) | cluster: council | Run the council on an optimization target — perf hot path, memory pattern, query, or an /optimize-* output — for ranked, evidence-based suggestions instead of generic advice. |
+| command | [`council:pr`](../.agent-src/commands/council/pr.md) | cluster: council | Pull a GitHub PR via gh CLI and run the council on the diff with a PR-specific neutrality preamble — read-only by default; comment posting is opt-in. |
+| command | [`council`](../.agent-src/commands/council.md) | cluster: council | Council orchestrator — routes to default, pr, design, optimize |
+| command | [`create-pr:description-only`](../.agent-src/commands/create-pr/description-only.md) | cluster: create-pr | Generate a PR description as a copyable markdown block — used standalone or by create-pr |
+| command | [`create-pr`](../.agent-src/commands/create-pr.md) | cluster: create-pr | Create a GitHub PR with structured description from Jira ticket and code changes |
 | command | [`e2e-heal`](../.agent-src/commands/e2e-heal.md) |  | Find, debug, and fix failing Playwright E2E tests |
 | command | [`e2e-plan`](../.agent-src/commands/e2e-plan.md) |  | Explore the application and create a structured E2E test plan in Markdown |
 | command | [`estimate-ticket`](../.agent-src/commands/estimate-ticket.md) |  | Estimate a Jira/Linear ticket before sprint planning — size + risk + split recommendation + uncertainty, sibling to /refine-ticket, ends with a close-prompt |
-| command | [`feature-dev`](../.agent-src/commands/feature-dev.md) |  | Full 7-phase feature development workflow for complex features. |
+| command | [`feature:dev`](../.agent-src/commands/feature/dev.md) | cluster: feature | Full 7-phase feature development workflow for complex features. |
+| command | [`feature:explore`](../.agent-src/commands/feature/explore.md) | cluster: feature | Brainstorm and explore a feature idea before committing to a full plan |
+| command | [`feature:plan`](../.agent-src/commands/feature/plan.md) | cluster: feature | Interactively plan a feature — research, discuss, and create a structured feature document |
+| command | [`feature:refactor`](../.agent-src/commands/feature/refactor.md) | cluster: feature | Refine and update an existing feature plan through interactive discussion |
+| command | [`feature:roadmap`](../.agent-src/commands/feature/roadmap.md) | cluster: feature | Generate implementation roadmap(s) from a feature plan and link them |
 | command | [`feature`](../.agent-src/commands/feature.md) | cluster: feature | Feature orchestrator — routes to explore, plan, refactor, roadmap, dev |
+| command | [`fix:ci`](../.agent-src/commands/fix/ci.md) | cluster: fix | Fetch CI errors from GitHub Actions and fix them |
+| command | [`fix:portability`](../.agent-src/commands/fix/portability.md) | cluster: fix | Find and fix project-specific references in shared .augment/ package files |
+| command | [`fix:pr-bots`](../.agent-src/commands/fix/pr-bots.md) | cluster: fix | Fix and reply to bot review comments (Copilot, Augment, Greptile, etc.) on a GitHub PR |
+| command | [`fix:pr-developers`](../.agent-src/commands/fix/pr-developers.md) | cluster: fix | Fix and reply to human reviewer comments on a GitHub PR |
+| command | [`fix:pr`](../.agent-src/commands/fix/pr.md) | cluster: fix | Fix and reply to all open review comments (bots + human reviewers) on a GitHub PR |
+| command | [`fix:refs`](../.agent-src/commands/fix/refs.md) | cluster: fix | Find and fix broken cross-references in .augment/ and agents/ files |
+| command | [`fix:seeder`](../.agent-src/commands/fix/seeder.md) | cluster: fix | Scan seeder data files for broken foreign key references — find constants used without getReference() and fix them |
 | command | [`fix`](../.agent-src/commands/fix.md) | cluster: fix | Fix orchestrator — routes to ci, references, portability, seeder, pr-comments, pr-bot-comments, pr-developer-comments |
 | command | [`implement-ticket`](../.agent-src/commands/implement-ticket.md) |  | Drive a ticket end-to-end through refine → memory → analyze → plan → implement → test → verify → report — Option-A loop over the `work_engine` Python engine, block-on-ambiguity, no auto-git. |
 | command | [`jira-ticket`](../.agent-src/commands/jira-ticket.md) |  | Read Jira ticket from branch name, analyze linked Sentry issues, implement feature or fix bug |
-| command | [`judge`](../.agent-src/commands/judge.md) |  | Run a standalone judge on an existing diff or code change — no implementer, no revision loop, verdict only |
-| command | [`memory-add`](../.agent-src/commands/memory-add.md) |  | Interactively add a validated entry to an engineering-memory file (domain-invariants, architecture-decisions, incident-learnings, product-rules) |
-| command | [`memory-full`](../.agent-src/commands/memory-full.md) |  | Load ALL curated entries of a given memory type into the current context — opt-in full load for deep analysis, never auto-triggered |
-| command | [`memory-promote`](../.agent-src/commands/memory-promote.md) |  | Promote an intake signal (or provisional proposal) into a curated memory entry — opens a PR and runs the admission gate. |
+| command | [`judge:on-diff`](../.agent-src/commands/judge/on-diff.md) | cluster: judge | Run a single change through an implementer→judge loop with a two-revision ceiling, then hand back to the user |
+| command | [`judge:solo`](../.agent-src/commands/judge/solo.md) | cluster: judge | Run a standalone judge on an existing diff or code change — no implementer, no revision loop, verdict only |
+| command | [`judge:steps`](../.agent-src/commands/judge/steps.md) | cluster: judge | Execute an ordered plan step by step with a judge gate between steps — stops on first failed verdict |
+| command | [`judge`](../.agent-src/commands/judge.md) | cluster: judge | Judge orchestrator — routes to solo, steps, on-diff |
+| command | [`memory:add`](../.agent-src/commands/memory/add.md) | cluster: memory | Interactively add a validated entry to an engineering-memory file (domain-invariants, architecture-decisions, incident-learnings, product-rules) |
+| command | [`memory:load`](../.agent-src/commands/memory/load.md) | cluster: memory | Load ALL curated entries of a given memory type into the current context — opt-in full load for deep analysis, never auto-triggered |
+| command | [`memory:promote`](../.agent-src/commands/memory/promote.md) | cluster: memory | Promote an intake signal (or provisional proposal) into a curated memory entry — opens a PR and runs the admission gate. |
+| command | [`memory:propose`](../.agent-src/commands/memory/propose.md) | cluster: memory | Append a provisional memory signal to the intake stream — the universal fallback for any producer (human or agent) to record a finding without committing to a curated entry. |
+| command | [`memory`](../.agent-src/commands/memory.md) | cluster: memory | Memory orchestrator — routes to add, load, promote, propose |
 | command | [`mode`](../.agent-src/commands/mode.md) |  | Set the active role mode — prints the contract, lists default skills, and refuses work outside the contract (see role-contracts) |
-| command | [`module-create`](../.agent-src/commands/module-create.md) |  | Create a new module from .module-template with interactive setup |
-| command | [`module-explore`](../.agent-src/commands/module-explore.md) |  | Explore a module — load its structure, docs, and context into the current conversation |
+| command | [`module:create`](../.agent-src/commands/module/create.md) | cluster: module | Create a new module from .module-template with interactive setup |
+| command | [`module:explore`](../.agent-src/commands/module/explore.md) | cluster: module | Explore a module — load its structure, docs, and context into the current conversation |
+| command | [`module`](../.agent-src/commands/module.md) | cluster: module | Module orchestrator — routes to create, explore |
 | command | [`onboard`](../.agent-src/commands/onboard.md) |  | First-run setup for a developer on this project — captures name, IDE, bot-icon preference, rtk, cost_profile, and learning opt-out, then sets onboarding.onboarded=true |
+| command | [`optimize:agents`](../.agent-src/commands/optimize/agents.md) | cluster: optimize | Audits agent infrastructure — measures token overhead, checks rule triggers, verifies AGENTS.md. Suggest only, never auto-apply. |
+| command | [`optimize:augmentignore`](../.agent-src/commands/optimize/augmentignore.md) | cluster: optimize | Creates or updates .augmentignore based on the project's actual tech stack, large files, generated artifacts, and irrelevant agent skills/rules. |
+| command | [`optimize:rtk`](../.agent-src/commands/optimize/rtk.md) | cluster: optimize | Create or optimize project-local rtk filters based on the actual toolchain |
+| command | [`optimize:skills`](../.agent-src/commands/optimize/skills.md) | cluster: optimize | Audits skills — measures baseline, finds duplicates/merge candidates, runs linter. Suggest only, never auto-apply. |
 | command | [`optimize`](../.agent-src/commands/optimize.md) | cluster: optimize | Optimize orchestrator — routes to skills, agents, augmentignore, rtk-filters |
-| command | [`override-create`](../.agent-src/commands/override-create.md) |  | Creates a project-level override for a shared skill, rule, or command. |
-| command | [`override-manage`](../.agent-src/commands/override-manage.md) |  | Reviews, updates, and refactors existing project-level overrides. |
+| command | [`override:create`](../.agent-src/commands/override/create.md) | cluster: override | Creates a project-level override for a shared skill, rule, or command. |
+| command | [`override:manage`](../.agent-src/commands/override/manage.md) | cluster: override | Reviews, updates, and refactors existing project-level overrides. |
+| command | [`override`](../.agent-src/commands/override.md) | cluster: override | Override orchestrator — routes to create, manage |
 | command | [`package-reset`](../.agent-src/commands/package-reset.md) |  | /package-reset |
 | command | [`package-test`](../.agent-src/commands/package-test.md) |  | /package-test |
 | command | [`prepare-for-review`](../.agent-src/commands/prepare-for-review.md) |  | Prepare a PR branch for local review — updates main and merges the full branch chain so the branch is up to date |
 | command | [`project-analyze`](../.agent-src/commands/project-analyze.md) |  | Full project analysis — detect stack, inventory modules, audit docs, create missing contexts |
 | command | [`project-health`](../.agent-src/commands/project-health.md) |  | Quick project health check — show status of docs, modules, contexts, and roadmaps without creating anything |
-| command | [`propose-memory`](../.agent-src/commands/propose-memory.md) |  | Append a provisional memory signal to the intake stream — the universal fallback for any producer (human or agent) to record a finding without committing to a curated entry. |
 | command | [`quality-fix`](../.agent-src/commands/quality-fix.md) |  | Run quality pipeline (PHP and/or JS/TS) and fix all errors — auto-detects language from changed files |
 | command | [`refine-ticket`](../.agent-src/commands/refine-ticket.md) |  | Refine a Jira/Linear ticket before planning — rewritten ticket + Top-5 risks + persona voices, orchestrates validate-feature-fit and threat-modeling, ends with a close-prompt |
 | command | [`review-changes`](../.agent-src/commands/review-changes.md) |  | Self-review local changes before creating a PR — dispatches to four specialized judges (bug, security, tests, quality) and consolidates verdicts |
 | command | [`review-routing`](../.agent-src/commands/review-routing.md) |  | Compute reviewer roles and matched historical bug patterns for the current diff, using project-local ownership-map.yml and historical-bug-patterns.yml |
-| command | [`roadmap-create`](../.agent-src/commands/roadmap-create.md) |  | Interactively create a new roadmap file in agents/roadmaps/ |
-| command | [`roadmap-execute`](../.agent-src/commands/roadmap-execute.md) |  | Read and interactively execute a roadmap from agents/roadmaps/ |
+| command | [`roadmap:create`](../.agent-src/commands/roadmap/create.md) | cluster: roadmap | Interactively create a new roadmap file in agents/roadmaps/ |
+| command | [`roadmap:execute`](../.agent-src/commands/roadmap/execute.md) | cluster: roadmap | Read and interactively execute a roadmap from agents/roadmaps/ |
+| command | [`roadmap`](../.agent-src/commands/roadmap.md) | cluster: roadmap | Roadmap orchestrator — routes to create, execute |
 | command | [`rule-compliance-audit`](../.agent-src/commands/rule-compliance-audit.md) |  | Audit rule trigger quality, simulate activation, detect overlaps, and find never-activating rules |
 | command | [`set-cost-profile`](../.agent-src/commands/set-cost-profile.md) |  | Change the cost_profile in .agent-settings.yml — shows each profile's meaning and applies the selection |
 | command | [`sync-agent-settings`](../.agent-src/commands/sync-agent-settings.md) |  | Sync `.agent-settings.yml` against the current template + profile — adds new sections/keys, preserves user values, shows a diff before writing |
 | command | [`sync-gitignore`](../.agent-src/commands/sync-gitignore.md) |  | Sync the `event4u/agent-config` block in the consumer project's .gitignore — adds missing entries, preserves user-added lines, shows a diff before writing |
-| command | [`tests-create`](../.agent-src/commands/tests-create.md) |  | Write meaningful tests for the changes in the current branch |
-| command | [`tests-execute`](../.agent-src/commands/tests-execute.md) |  | Run PHP tests inside the Docker container |
+| command | [`tests:create`](../.agent-src/commands/tests/create.md) | cluster: tests | Write meaningful tests for the changes in the current branch |
+| command | [`tests:execute`](../.agent-src/commands/tests/execute.md) | cluster: tests | Run PHP tests inside the Docker container |
+| command | [`tests`](../.agent-src/commands/tests.md) | cluster: tests | Tests orchestrator — routes to create, execute |
 | command | [`threat-model`](../.agent-src/commands/threat-model.md) |  | Run a pre-implementation threat model on a proposed change — enumerates abuse cases, trust boundaries, and authorization gaps before the first line of code is written |
 | command | [`update-form-request-messages`](../.agent-src/commands/update-form-request-messages.md) |  | Sync the messages() method of a FormRequest class — add missing entries, link them to language keys, and clean up stale ones |
 | command | [`upstream-contribute`](../.agent-src/commands/upstream-contribute.md) |  | Contribute a learning, skill, rule, or fix from a consumer project back to the shared agent-config package |
 | command | [`work`](../.agent-src/commands/work.md) |  | Drive a free-form prompt end-to-end through refine → score → plan → implement → test → verify → report — Option-A loop over the `work_engine` Python engine, confidence-band gated, no auto-git. |
-## Guidelines (47)
+## Guidelines (48)
 | kind | name | category | description |
 |---|---|---|---|
 | guideline | [`agent-interaction-and-decision-quality`](../docs/guidelines/agent-infra/agent-interaction-and-decision-quality.md) | agent-infra |  |
+| guideline | [`asking-and-brevity-examples`](../docs/guidelines/agent-infra/asking-and-brevity-examples.md) | agent-infra |  |
 | guideline | [`break-glass-usage`](../docs/guidelines/agent-infra/break-glass-usage.md) | agent-infra |  |
 | guideline | [`developer-judgment`](../docs/guidelines/agent-infra/developer-judgment.md) | agent-infra |  |
 | guideline | [`engineering-memory-data-format`](../docs/guidelines/agent-infra/engineering-memory-data-format.md) | agent-infra |  |

package/docs/contracts/STABILITY.md CHANGED Viewed

@@ -95,13 +95,21 @@ Numeric caps on the always-active rule surface. These are **load-bearing
 constants** — every reply the agent emits pays the always-rule cost, so
 the budget is part of the public contract, not an implementation detail.
+The accounting model since Phase 0.2 of `road-to-structural-optimization`
+is **Model (b) literal** — a rule's effective size is its own char count
+plus every context it loads (transitively, depth ≤ 2). See
+[`load-context-budget-model.md`](load-context-budget-model.md) (beta)
+for the contract and the transitional allowlist.
 | Constant | Value | Stability | Owner |
 |---|---|---|---|
-| Total always-rule budget | **49,000 chars** | `stable` | `tests/test_always_budget.py::test_always_rules_total_chars_under_cap` |
-| Warn threshold (CI) | **80% (39,200 chars)** | `beta` | `scripts/check_always_budget.py` |
-| Fail threshold (CI) | **90% (44,100 chars)** | `beta` | `scripts/check_always_budget.py` |
-| Per-rule cap | **6,000 chars** | `beta` | `tests/test_always_budget.py::test_no_single_always_rule_over_per_rule_cap` · `scripts/check_always_budget.py` |
-| Top-3 combined cap | **24,500 chars** (50% of total) | `beta` | `tests/test_always_budget.py::test_top3_always_rules_under_cap` · `scripts/check_always_budget.py` |
+| Total always-rule budget | **49,000 chars** (extended) | `stable` | `tests/test_always_budget.py::test_always_rules_total_extended_within_tolerance` |
+| G3 tolerance band | **2 % overshoot** (≤ 49,980 chars) | `beta` | `scripts/check_always_budget.py` · `tests/test_always_budget.py` |
+| Warn threshold (CI) | **80 % (39,200 chars)** | `beta` | `scripts/check_always_budget.py` |
+| Fail threshold (CI) | **90 % (44,100 chars)** below 100 %; **> 102 %** above | `beta` | `scripts/check_always_budget.py` |
+| Per-rule cap | **6,000 chars** (extended) with transitional allowlist | `beta` | `tests/test_always_budget.py::test_no_unallowlisted_per_rule_breach` · `scripts/check_always_budget.py` |
+| Top-3 combined cap | **24,500 chars** (extended, 50 % of total) | `beta` | `tests/test_always_budget.py::test_top3_extended_under_cap` · `scripts/check_always_budget.py` |
+| `load_context:` nesting cap | **depth ≤ 2** | `beta` | `tests/test_always_budget.py::test_load_context_depth_within_cap` · `scripts/check_always_budget.py` |
 **Promises a consumer can rely on:**
@@ -128,7 +136,5 @@ the budget is part of the public contract, not an implementation detail.
 ## See also
-- [`agents/roadmaps/road-to-post-pr29-optimize.md`](../../agents/roadmaps/road-to-post-pr29-optimize.md) — P0.1, P0.1a, P0.1b
-- [`agents/roadmaps/road-to-pr-34-followups.md`](../../agents/roadmaps/road-to-pr-34-followups.md) — Phase 7 (budget hardening)
 - [`docs/architecture.md`](../architecture.md) — package architecture overview
 - [`rule-priority-hierarchy.md`](rule-priority-hierarchy.md) — which always-rule wins on conflict

package/docs/contracts/adr-chat-history-split.md CHANGED Viewed

@@ -4,9 +4,7 @@ stability: beta
 # ADR — Chat-history rule split
-> **Status:** Decided · 2026-05-02 · scoped under
-> [`road-to-post-pr29-optimize.md`](../../agents/roadmaps/archive/road-to-post-pr29-optimize.md)
-> Phase 2 item P2.1.
+> **Status:** Decided · 2026-05-02
 > **Context:** AI #1, AI #3, AI #5 review of PR #29 flagged the
 > 200-line monolithic `rules/chat-history.md` as the rule the agent
 > revisited 12+ times during the 1.14.0 cycle — three independent

package/docs/contracts/adr-command-suggestion.md CHANGED Viewed

@@ -5,7 +5,6 @@ stability: stable
 # ADR — Context-Aware Command Suggestion
 > **Status:** Decided · Phases 1–7 shipped · 2026-04-30
-> **Roadmap:** [`road-to-context-aware-command-suggestion.md`](../../agents/roadmaps/road-to-context-aware-command-suggestion.md)
 > **Rule:** [`command-suggestion`](../../.agent-src.uncompressed/rules/command-suggestion-policy.md)
 > **Eligibility table:** [`command-suggestion-eligibility.md`](command-suggestion-eligibility.md)
 > **Engine:** `scripts/command_suggester/`
@@ -141,6 +140,5 @@ retirement candidates without a hard SLA.
 - [`command-suggestion`](../../.agent-src.uncompressed/rules/command-suggestion-policy.md) — runtime rule
 - [`command-suggestion-eligibility.md`](command-suggestion-eligibility.md) — locked eligibility table
-- [`road-to-context-aware-command-suggestion.md`](../../agents/roadmaps/road-to-context-aware-command-suggestion.md) — phased delivery
 - [`adr-prompt-driven-execution.md`](adr-prompt-driven-execution.md) — `/work` entrypoint that explicit slash invocations route to
 - [`agent-settings`](../../.agent-src.uncompressed/templates/agent-settings.md) — `commands.suggestion.*` reference

package/docs/contracts/adr-implement-ticket-runtime.md CHANGED Viewed

@@ -5,8 +5,7 @@ stability: stable
 # ADR — `/implement-ticket` runtime: Python
 > **Status:** Decided · Phase 0 spike closed · 2026-04-22
-> **Context:** [`implement-ticket-flow.md`](implement-ticket-flow.md) ·
-> [`road-to-implement-ticket.md`](../../agents/roadmaps/road-to-implement-ticket.md)
+> **Context:** [`implement-ticket-flow.md`](implement-ticket-flow.md)
 > **Supersedes:** the `Runtime: TBD` placeholder in `implement-ticket-flow.md`.
 ## Decision

package/docs/contracts/adr-product-ui-track.md CHANGED Viewed

@@ -5,13 +5,11 @@ stability: stable
 # ADR — Product UI Track: audit-as-hard-gate, design-review loop, stack dispatch
 > **Status:** Decided · R3 Phases 1–6 shipped · 2026-05-01
-> **Context:** [`ui-track-flow.md`](ui-track-flow.md) ·
-> [`road-to-product-ui-track.md`](../../agents/roadmaps/road-to-product-ui-track.md) ·
-> [`road-to-product-ui-track-followup.md`](../../agents/roadmaps/archive/road-to-product-ui-track-followup.md)
+> **Context:** [`ui-track-flow.md`](ui-track-flow.md)
 > **Builds on:** [`adr-prompt-driven-execution.md`](adr-prompt-driven-execution.md)
 > — R2 envelope routing and the band-action gate that R3 widens to UI.
-> **Defers to:** Roadmap 4 (`road-to-visual-review-loop.md`, stub) for
-> headless-browser screenshot capture and visual-regression assertions.
+> **Defers to:** the visual-review-loop track for headless-browser
+> screenshot capture and visual-regression assertions.
 ## Decision
@@ -315,7 +313,6 @@ the contract first costs one halt and saves an entire polish round.
 ## R4 amendment — Visual Review Loop (2026-05-01)
 > **Status:** Decided · R4 Phases 0–4 shipped · Phase 5 in progress
-> **Roadmap:** [`road-to-visual-review-loop.md`](../../agents/roadmaps/road-to-visual-review-loop.md)
 R4 narrows the polish-termination contract from "subjective ceiling
 only" to "subjective ceiling **plus** objective a11y block", adds a

package/docs/contracts/adr-prompt-driven-execution.md CHANGED Viewed

@@ -5,12 +5,11 @@ stability: stable
 # ADR — Prompt-Driven Execution: `/work` and the confidence-band gate
 > **Status:** Decided · R2 Phases 1–6 shipped · 2026-04-28
-> **Context:** [`implement-ticket-flow.md`](implement-ticket-flow.md) ·
-> [`road-to-prompt-driven-execution.md`](../../agents/roadmaps/archive/road-to-prompt-driven-execution.md)
+> **Context:** [`implement-ticket-flow.md`](implement-ticket-flow.md)
 > **Builds on:** [`adr-work-engine-rename.md`](adr-work-engine-rename.md) —
 > the universal-dispatcher refactor that this entrypoint slots into.
-> **Defers to:** Roadmap 3 (`road-to-product-ui-track.md`) for UI- and
-> mixed-intent prompts; this ADR is backend-only.
+> **Defers to:** [`adr-product-ui-track.md`](adr-product-ui-track.md) for
+> UI- and mixed-intent prompts; this ADR is backend-only.
 ## Decision

package/docs/contracts/agent-memory-contract.md CHANGED Viewed

@@ -20,9 +20,9 @@ Last refreshed: 2026-04-22.
 ## What this doc is *not*
-- Not a replacement for
-  [`road-to-retrieval-contract.md`](../../agents/roadmaps/agent-memory/road-to-retrieval-contract.md)
-  — that is the spec we hand to the agent-memory implementer.
+- Not a replacement for the agent-memory retrieval-contract spec —
+  that lives in the agent-memory package and is the spec we hand to
+  the implementer.
 - Not a commitment that consumer code looks exactly like this forever
   — it is a point-in-time pin.
 - Not an agent-facing skill. Humans read this when the package lands.
@@ -64,9 +64,9 @@ If the released package diverges from these names, we update
 ## Expected retrieval shape (present path)
-Source of truth:
-[`road-to-retrieval-contract.md`](../../agents/roadmaps/agent-memory/road-to-retrieval-contract.md).
-Consumer skills call the shared abstraction, not the package directly.
+Source of truth: the retrieval-contract spec in the agent-memory
+package. Consumer skills call the shared abstraction, not the package
+directly.
 **Request** (Python):
@@ -139,11 +139,6 @@ holds:
 ## See also
-- [`road-to-memory-self-consumption.md`](../../agents/roadmaps/road-to-memory-self-consumption.md)
-- [`road-to-agent-memory-integration.md`](../../agents/roadmaps/road-to-agent-memory-integration.md)
-- [`agent-memory/road-to-retrieval-contract.md`](../../agents/roadmaps/agent-memory/road-to-retrieval-contract.md)
-- [`agent-memory/road-to-promotion-flow.md`](../../agents/roadmaps/agent-memory/road-to-promotion-flow.md)
 - [`memory-access guideline`](../../docs/guidelines/agent-infra/memory-access.md)
 - [`scripts/memory_status.py`](../../.agent-src.uncompressed/templates/scripts/memory_status.py)
 - [`scripts/memory_lookup.py`](../../.agent-src.uncompressed/templates/scripts/memory_lookup.py)
-- [`open-questions-2.md`](../../agents/roadmaps/archive/open-questions-2.md) — Q29

package/docs/contracts/artifact-engagement-flow.md CHANGED Viewed

@@ -4,15 +4,13 @@ stability: beta
 # Artifact Engagement — Flow & Recording Contract
-> Cross-cutting reference for the artifact-engagement telemetry system
-> shipped under
-> [`road-to-artifact-engagement-telemetry.md`](../../agents/roadmaps/road-to-artifact-engagement-telemetry.md).
-> Phase 1 + 2 ship the schema, CLI, and engine. Phase 3 ships the
-> agent-side hooks (this document).
+> Cross-cutting reference for the artifact-engagement telemetry system.
+> The schema, CLI, and engine ship first; the agent-side hooks (this
+> document) ship after.
 >
 > - **Created:** 2026-04-30
-> - **Status:** Phase 5 — schema, engine, recording, aggregator, renderer,
->   and redaction validator are in place. Phase 6 (dogfooding) next.
+> - **Status:** schema, engine, recording, aggregator, renderer, and
+>   redaction validator are in place. Dogfooding next.
 This document is the stable reference for **what gets recorded, when, and
 under which constraints**. The roadmap tracks phased delivery; the rule
@@ -255,8 +253,7 @@ layers reject.
 ## See also
-- [`road-to-artifact-engagement-telemetry`](../../agents/roadmaps/road-to-artifact-engagement-telemetry.md) — phased delivery
 - [`artifact-engagement-recording`](../../.agent-src.uncompressed/rules/artifact-engagement-recording.md) — agent-side trigger
 - [`implement-ticket-flow`](implement-ticket-flow.md) — the eight-step contract this rule observes
 - [`scripts/telemetry/`](../../.agent-src.uncompressed/templates/scripts/telemetry/) — schema, boundary session, settings reader
-- [`tests/telemetry/`](../../tests/telemetry/) — contract enforcement (104 cases through Phase 5: schema, settings, aggregator, renderer, CLI, cost-floor, redaction)
+- [`tests/telemetry/`](../../tests/telemetry/) — contract enforcement (schema, settings, aggregator, renderer, CLI, cost-floor, redaction)

package/docs/contracts/command-clusters.md CHANGED Viewed

@@ -4,10 +4,9 @@ stability: beta
 # Command-cluster contract
-> **Status:** beta — locked for `1.15.0` Phase 1 (top-3 clusters).
-> Phase 2 (remaining 12 clusters) waits one deprecation cycle.
-> Source roadmap: [`agents/roadmaps/archive/road-to-governance-cleanup.md`](../../agents/roadmaps/archive/road-to-governance-cleanup.md)
-> § F2.
+> **Status:** beta — Phase 1 locked for `1.15.0` (top-3 clusters);
+> Phase 2 locked for `1.17.0` (the remaining 12 clusters);
+> Phase 3 locked for `1.17.0` (`council` cluster).
 The agent-config command surface collapses related atomic commands
 into **verb clusters**. A cluster is a single top-level command
@@ -21,35 +20,36 @@ linter (`scripts/lint_no_new_atomic_commands.py`) reads this file;
 new atomic commands without a `cluster:` field pointing to an
 entry below fail CI.
-## Phase 1 clusters (locked, ship in 1.15.0)
-| Cluster | Sub-commands | Replaces |
-|---|---|---|
-| `fix` | `ci` · `pr` · `pr-bots` · `pr-developers` · `portability` · `refs` · `seeder` | `fix-ci` · `fix-pr-comments` · `fix-pr-bot-comments` · `fix-pr-developer-comments` · `fix-portability` · `fix-references` · `fix-seeder` |
-| `optimize` | `agents` · `augmentignore` · `rtk` · `skills` | `optimize-agents` · `optimize-augmentignore` · `optimize-rtk-filters` · `optimize-skills` |
-| `feature` | `explore` · `plan` · `refactor` · `roadmap` | `feature-explore` · `feature-plan` · `feature-refactor` · `feature-roadmap` |
-**Net Phase 1:** 15 atomic commands → 3 cluster commands.
-## Phase 2 clusters (deferred to next minor release)
-Listed in `road-to-governance-cleanup.md` § Finding 2. Not yet locked
-into the linter; new atomic commands matching these prefixes still
-fail CI without a `cluster:` field once a Phase 2 entry is added
-here.
-- `chat-history` (`show` · `resume` · `clear` · `checkpoint`)
-- `agents` (`audit` · `cleanup` · `prepare`)
-- `memory` (`add` · `load` · `promote` · `propose`)
-- `roadmap` (`create` · `execute`)
-- `module` (`create` · `explore`)
-- `tests` (`create` · `execute`)
-- `context` (`create` · `refactor`)
-- `override` (`create` · `manage`)
-- `copilot-agents` (`init` · `optimize`)
-- `commit` (flag: `--in-chunks`)
-- `judge` (`solo` · `steps` · `on-diff`) + standalone `/review`
-- `create-pr` (flag: `--description-only`)
+## Locked clusters
+The full set, both phases. Linter parses every backticked name in
+column 1 of this table.
+| Cluster | Phase | Sub-commands | Replaces |
+|---|:-:|---|---|
+| `fix` | 1 | `ci` · `pr` · `pr-bots` · `pr-developers` · `portability` · `refs` · `seeder` | `fix-ci` · `fix-pr-comments` · `fix-pr-bot-comments` · `fix-pr-developer-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` · `dev` | `feature-explore` · `feature-plan` · `feature-refactor` · `feature-roadmap` · `feature-dev` |
+| `chat-history` | 2 | `show` · `resume` · `clear` · `checkpoint` | `chat-history` (legacy status) · `chat-history-resume` · `chat-history-clear` · `chat-history-checkpoint` |
+| `agents` | 2 | `audit` · `cleanup` · `prepare` | `agents-audit` · `agents-cleanup` · `agents-prepare` |
+| `memory` | 2 | `add` · `load` · `promote` · `propose` | `memory-add` · `memory-full` · `memory-promote` · `propose-memory` |
+| `roadmap` | 2 | `create` · `execute` | `roadmap-create` · `roadmap-execute` |
+| `module` | 2 | `create` · `explore` | `module-create` · `module-explore` |
+| `tests` | 2 | `create` · `execute` | `tests-create` · `tests-execute` |
+| `context` | 2 | `create` · `refactor` | `context-create` · `context-refactor` |
+| `override` | 2 | `create` · `manage` | `override-create` · `override-manage` |
+| `copilot-agents` | 2 | `init` · `optimize` | `copilot-agents-init` · `copilot-agents-optimize` |
+| `judge` | 2 | `solo` · `on-diff` · `steps` | `judge` (legacy standalone) · `do-and-judge` · `do-in-steps` |
+| `commit` | 2 | `in-chunks` | `commit-in-chunks` |
+| `create-pr` | 2 | `description-only` | `create-pr-description` |
+| `council` | 3 | `default` · `pr` · `design` · `optimize` | `council` (legacy default lens) · `council-pr` · `council-design` · `council-optimize` |
+**Net change:** Phase 1 collapsed 15 atomics → 3 clusters; Phase 2
+collapses 26 atomics → 11 sub-command clusters. Sub-commands use
+colon syntax (`/cluster:sub`) so Claude Code's command palette can
+autocomplete them. The standalone `/review` surface that mirrors
+`judge solo` lives at
+[`commands/review-changes.md`](../../.agent-src.uncompressed/commands/review-changes.md).
 ## Frontmatter contract
@@ -70,7 +70,7 @@ The linter only flags **newly-added** files under `commands/`
 (git status `A`). Pre-existing commands without `cluster:` are
 grandfathered indefinitely; modifying them does NOT require adding
 the field. The goal is to stop the atomic surface from growing,
-not to retro-fit every legacy command into a Phase 1 cluster.
+not to retro-fit every legacy command into a cluster.
 ## Deprecation shim contract
@@ -92,22 +92,24 @@ file with `superseded_by:` set.
 ## Removal cycle
-| State | Release |
-|---|---|
-| Cluster command shipped, shim active | `1.15.0` |
-| Shim emits warning, both work | `1.15.x` (one minor cycle) |
-| Shim removed, only cluster works | `1.16.0` |
+| State | Phase 1 | Phase 2 |
+|---|---|---|
+| Cluster command shipped, shim active | `1.15.0` | `1.17.0` |
+| Shim emits warning, both work | `1.15.x` / `1.16.x` (≥ one minor cycle) | `1.17.x` (one minor cycle) |
+| Shim removed, only cluster works | `1.17.0` (Phase 1 atomics removed alongside Phase 2 lock-in) | next minor after `1.17.x` |
-No permanent aliases. Consumers who pin a 1.15 minor get a full
-release window of warnings; the 1.16 release notes call out the
-removal explicitly.
+No permanent aliases. Consumers who pin a 1.17 minor get a full
+release window of warnings; the next-minor release notes call out
+the removal explicitly. The 1.17.0 release ships Phase 2 cluster
+locks **and** drops the seven Phase 1 atomic shims at the end of
+their deprecation cycle.
 ## Linter behavior
 `scripts/lint_no_new_atomic_commands.py`:
 - Reads the locked cluster names from this file (parsed from the
-  Phase 1 table above).
+  "Locked clusters" table above — column 1 backticks).
 - Finds every command file **added** since `--baseline`
   (default: `main`) — modifications to existing files are ignored.
 - For each new file, requires `cluster:` to be set to one of the
@@ -116,11 +118,19 @@ removal explicitly.
 `--all` mode (manual audit only, not in CI) lints every command
 file and surfaces grandfathered ones — useful when planning a
-Phase 2 cluster expansion.
+future cluster expansion.
+`scripts/check_cluster_patterns.py` (Phase 2 onward):
+- Compares each cluster dispatcher's structure against the Phase 1
+  reference patterns (`commands/fix.md`, `commands/optimize.md`,
+  `commands/feature.md`).
+- Required sections: top-of-file `# /<cluster>`, `## Sub-commands`
+  table with `Sub-command | Routes to | Purpose` columns, `## Dispatch`
+  steps, `## Migration` notice, `## Rules` block.
+- Fails CI if a new cluster invents a different dispatch shape.
 ## See also
-- [`agents/roadmaps/archive/road-to-governance-cleanup.md`](../../agents/roadmaps/archive/road-to-governance-cleanup.md) — F2 phased-collapse decision.
-- [`agents/roadmaps/road-to-post-pr29-optimize.md`](../../agents/roadmaps/road-to-post-pr29-optimize.md) — P0.8 anchors this contract in 1.15.0.
 - [`docs/migrations/commands-1.15.0.md`](../migrations/commands-1.15.0.md) — user-facing migration notes.
 - [`docs/contracts/STABILITY.md`](STABILITY.md) — `beta` level rules apply.

package/docs/contracts/command-suggestion-flow.md CHANGED Viewed

@@ -4,8 +4,7 @@ stability: beta
 # Command Suggestion — Flow & Scoring Contract
-> Cross-cutting reference for the suggestion layer shipped under
-> [`road-to-context-aware-command-suggestion.md`](../../agents/roadmaps/road-to-context-aware-command-suggestion.md).
+> Cross-cutting reference for the suggestion layer.
 > The runtime rule is [`command-suggestion`](../../.agent-src.uncompressed/rules/command-suggestion-policy.md);
 > the architectural decision lives in [`adr-command-suggestion.md`](adr-command-suggestion.md).
 >
@@ -144,5 +143,4 @@ Cursor, Cline, Windsurf) get the engine via `scripts/`.
 - [`command-suggestion`](../../.agent-src.uncompressed/rules/command-suggestion-policy.md) — runtime rule
 - [`adr-command-suggestion.md`](adr-command-suggestion.md) — architectural decision
 - [`command-suggestion-eligibility.md`](command-suggestion-eligibility.md) — locked eligibility table
-- [`road-to-context-aware-command-suggestion.md`](../../agents/roadmaps/road-to-context-aware-command-suggestion.md) — phased delivery
 - [`agent-settings`](../../.agent-src.uncompressed/templates/agent-settings.md) — `commands.suggestion.*` reference