@event4u/agent-config 9.5.0 → 9.6.0

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

@@ -10,9 +10,8 @@ skills: [emit-tickets]
 description: Materialise a roadmap into a self-contained, importable ticket bundle under agents/tickets/
 argument-hint: "[roadmap-path]"
 suggestion:
-  eligible: true
-  trigger_description: "turn this roadmap into tickets, materialise the roadmap, mach Tickets aus der Roadmap"
-  trigger_context: "an existing agents/roadmaps/*.md the user wants decomposed into build-ready tickets"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

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

@@ -10,9 +10,8 @@ skills: [agent-docs-writing, ai-council, roadmap-management]
 description: Autonomously process every open step across every phase of a roadmap until the file is fully closed. Largest execution scope of the /roadmap cluster — runs continuously across phase boundaries.
 argument-hint: "[roadmap]"
 suggestion:
-  eligible: true
-  trigger_description: "process the whole roadmap, finish the roadmap, komplette roadmap abarbeiten"
-  trigger_context: "existing agents/roadmaps/*.md and user wants the entire file done end-to-end"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

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

@@ -10,9 +10,8 @@ skills: [agent-docs-writing, ai-council, roadmap-management]
 description: Autonomously process every open step in the next or current phase of a roadmap, then stop. Default execution scope of the /roadmap cluster.
 argument-hint: "[roadmap]"
 suggestion:
-  eligible: true
-  trigger_description: "process the next phase, finish this phase autonomously, eine phase abarbeiten"
-  trigger_context: "existing agents/roadmaps/*.md and user wants the next phase done end-to-end"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

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

@@ -10,9 +10,8 @@ skills: [agent-docs-writing, ai-council, roadmap-management]
 description: Autonomously process the single next open step of a roadmap and stop. Smallest execution scope of the /roadmap cluster — one step in, one step out.
 argument-hint: "[roadmap]"
 suggestion:
-  eligible: true
-  trigger_description: "process the next step, do the next roadmap step, einen schritt abarbeiten"
-  trigger_context: "existing agents/roadmaps/*.md and user wants exactly one step done autonomously"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

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

@@ -10,9 +10,8 @@ description: Non-destructive preview of a skill — its declared steps, executio
 argument-hint: "<skill-name> [--technical]"
 skills: [file-editor]
 suggestion:
-  eligible: true
-  trigger_description: "what does this skill do, preview <skill> before running, what will it change, is it safe, /skill:preview competitive-positioning"
-  trigger_context: "user wants to inspect a skill's declared intent before committing to run it"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

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

@@ -10,9 +10,8 @@ description: Recommend skills for a role — ranked by four explained classes (m
 argument-hint: "[role]"
 skills: [file-editor]
 suggestion:
-  eligible: true
-  trigger_description: "which skills should I use, recommend skills for my role, what fits this work, help me find a skill, /skills:discover sales"
-  trigger_context: "user wants a short, explained skill shortlist instead of scanning the 220-skill catalog"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

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

@@ -9,9 +9,8 @@ sub: gitignore
 skills: [sync-gitignore]
 description: Scrub legacy pre-`/agents/` patterns from the consumer's .gitignore (inside or outside the managed block) and re-sync the canonical entries
 suggestion:
-  eligible: true
-  trigger_description: "fix .gitignore garbage, clean up legacy agent-config entries, my .gitignore has stale agent entries, /sync-gitignore is not picking up the right paths"
-  trigger_context: "consumer project carries pre-/agents/ runtime patterns (.agent-chat-history, .agent-prices.md) at the root from an older install"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:
@@ -191,5 +190,5 @@ If the check fails, offer to re-sync the block with the current template:
   ignored-but-tracked detection (Phase 5.2)
 - [`scripts/check_gitignore_freshness.ts`](../../../../src/scripts/check_gitignore_freshness.ts) —
   manifest vs block coverage check (Phase 3.4)
-- [`docs/contracts/agents-layout.md`](../../../../docs/contracts/agents-layout.md) —
+- [`docs/contracts/agents-layout.md`](../../../../../../docs/contracts/agents-layout.md) —
   full classification contract for `agents/` entries

package/dist/agent-src/commands/tdd/green.md

@@ -10,9 +10,8 @@ skills: [test-driven-development]
 description: TDD green phase — write the minimum production code to make the failing test pass; no test edits
 argument-hint: "[failing test | context]"
 suggestion:
-  eligible: true
-  trigger_description: "make the failing test pass"
-  trigger_context: "a failing test exists, ready to implement"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/tdd/red.md

@@ -10,9 +10,8 @@ skills: [test-driven-development]
 description: TDD red phase — enumerate cases, write ONE failing test, watch it fail at an assertion (not an import error)
 argument-hint: "[behavior to test]"
 suggestion:
-  eligible: true
-  trigger_description: "write the failing test first"
-  trigger_context: "starting a new behavior test-first"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/tdd/refactor.md

@@ -10,9 +10,8 @@ skills: [test-driven-development]
 description: TDD refactor phase — clean up (rename, deduplicate) while keeping the test green
 argument-hint: "[target | context]"
 suggestion:
-  eligible: true
-  trigger_description: "refactor while the test stays green"
-  trigger_context: "test is green, ready to clean up"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/team/adversarial.md

@@ -11,9 +11,8 @@ description: Thin wrapper — adversarial cross-model review on a named focus vi
 cluster: team
 sub: adversarial
 suggestion:
-  eligible: true
-  trigger_description: "adversarial cross-model review, attack this change with a second model, stress-test the diff with GPT, hostile review by another model"
-  trigger_context: "ai_team.enabled is true AND single-model self-review found nothing or the stakes are high — escalate the Attack-Defend-Revise frame to a second strong model"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

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

@@ -10,9 +10,8 @@ description: Thin wrapper — cross-model review of the current diff via the off
 cluster: team
 sub: review
 suggestion:
-  eligible: true
-  trigger_description: "team review, second model review, cross-model review of my changes, GPT drüberschauen lassen, review the diff with another strong model"
-  trigger_context: "ai_team.enabled is true AND there is an uncommitted / staged diff the user wants a second strong model to review with repo access"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/team-knowledge/bootstrap.md

@@ -9,9 +9,8 @@ sub: bootstrap
 description: One-shot deterministic seed for a fresh project's knowledge layer — stages template pages from real config/directory detection, never LLM-invented claims. Review-then-commit.
 skills: []
 suggestion:
-  eligible: true
-  trigger_description: "bootstrap the knowledge base, seed project knowledge, initialize agents/knowledge, onboard this project's knowledge layer"
-  trigger_context: "a project has no agents/knowledge/ typed pages yet and the user wants a starting baseline"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/team-knowledge/consolidate.md

@@ -9,9 +9,8 @@ sub: consolidate
 description: Review pending typed knowledge-observation events and file them into agents/knowledge/ pages as a human-reviewed batch — never writes without approval.
 skills: [file-editor]
 suggestion:
-  eligible: true
-  trigger_description: "consolidate knowledge events, review pending observations, file captured knowledge, promote knowledge candidates"
-  trigger_context: "pending events have accumulated in agents/knowledge/intake/ and are ready for review"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

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

@@ -9,9 +9,8 @@ sub: create
 skills: [test-case-discovery, pest-testing, quality-tools]
 description: Write meaningful tests for the current branch — stack-adaptive (pest / phpunit / vitest / jest / pytest / …)
 suggestion:
-  eligible: true
-  trigger_description: "write tests for these changes, add tests for this branch"
-  trigger_context: "code changes on the branch without matching test changes"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

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

@@ -11,9 +11,8 @@ skills: [playwright-testing]
 description: Find, debug, and fix failing Playwright E2E tests
 argument-hint: "[test-file | ci-run-url]"
 suggestion:
-  eligible: true
-  trigger_description: "fix the failing E2E tests, playwright tests are red"
-  trigger_context: "failing test output from tests/e2e/"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

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

@@ -11,9 +11,8 @@ skills: [playwright-testing]
 description: Explore the application and create a structured E2E test plan in Markdown
 argument-hint: "[url | feature-area]"
 suggestion:
-  eligible: true
-  trigger_description: "plan E2E tests for this feature, what should we cover in playwright"
-  trigger_context: "new feature or page added without tests/e2e/ coverage"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

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

@@ -10,9 +10,8 @@ skills: [pest-testing, quality-tools]
 description: Run the project's test suite — stack-adaptive (pest / phpunit / vitest / jest / pytest / …)
 argument-hint: "[file | filter] [--include-e2e] [--include-slow] [--php]"
 suggestion:
-  eligible: true
-  trigger_description: "run the tests, execute the test suite"
-  trigger_context: "code changes pending verification"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/video/from-script.md

@@ -11,9 +11,8 @@ argument-hint: "<path-to-script.md> [--mode preview|commit] [--max-spend-usd <us
 personas: [hollywood-director, ai-video-technical-director]
 skills: [scene-expander, video-director, pixar-storyteller, character-consistency, motion-choreographer]
 suggestion:
-  eligible: true
-  trigger_description: "render a video from a script, full AI video pipeline, multi-scene generation"
-  trigger_context: "user supplies a Markdown script with `## Scene N` headings and wants a final MP4"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/video/from-song.md

@@ -11,9 +11,8 @@ argument-hint: "<images-dir> <song-file> [--mode preview|commit] [--brief <text>
 personas: [hollywood-director, ai-video-technical-director]
 skills: [song-to-script, scene-expander, video-director, character-consistency, motion-choreographer, prompt-validator]
 suggestion:
-  eligible: true
-  trigger_description: "make a music video from a song, turn a track into a video, lip-sync clip from images and audio, AI music video"
-  trigger_context: "user supplies an audio file plus reference images and wants a final MP4 cut to the song"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/video/scene.md

@@ -11,9 +11,8 @@ argument-hint: "<idea> [--mode preview|commit] [--image-provider <id>] [--video-
 personas: [hollywood-director, ai-video-technical-director]
 skills: [scene-expander, video-director, character-consistency, motion-choreographer]
 suggestion:
-  eligible: true
-  trigger_description: "render a single video scene, iterate on one shot, test a prompt without a full script"
-  trigger_context: "user supplies a one-line scene idea and wants a single clip, no multi-scene stitching"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/video/stitch.md

@@ -11,9 +11,8 @@ argument-hint: "<project-slug> [--skip-scene <id>] [--continue]"
 personas: [ai-video-technical-director]
 skills: []
 suggestion:
-  eligible: true
-  trigger_description: "re-stitch existing video clips, rebuild final MP4 after edits, ffmpeg concat existing scenes"
-  trigger_context: "user has edited clips in `<project>/scenes/*/` and wants the final.mp4 rebuilt without paying for re-renders"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/video/storyboard.md

@@ -11,9 +11,8 @@ argument-hint: "<path-to-script.md> [--image-provider <id>]"
 personas: [hollywood-director]
 skills: [scene-expander, video-director, character-consistency]
 suggestion:
-  eligible: true
-  trigger_description: "build a storyboard, contact sheet of scenes, image-only preview, validate a script visually before video render"
-  trigger_context: "user wants to see all scenes as stills before committing to motion calls"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/worktree/cleanup.md

@@ -10,9 +10,8 @@ skills: [worktree-lifecycle, git-workflow]
 description: Safe worktree removal gate — refuses while the branch holds commits on no other ref; never force-deletes
 argument-hint: "[worktree-path]"
 suggestion:
-  eligible: true
-  trigger_description: "clean up the worktrees, remove the finished worktree"
-  trigger_context: "git worktree list shows worktrees whose branches are merged"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

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

@@ -10,9 +10,8 @@ skills: [worktree-lifecycle, using-git-worktrees]
 description: Create a governed worktree and write its scope-lock note — propose-once branch naming, host-native primitive preferred
 argument-hint: "[task] [branch-name]"
 suggestion:
-  eligible: true
-  trigger_description: "do this in a worktree, isolate this task, spawn a worktree for X"
-  trigger_context: "parallel or exploratory work while the current branch is mid-work"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/worktree/status.md

@@ -9,9 +9,8 @@ sub: status
 skills: [worktree-lifecycle, git-workflow]
 description: List active worktrees — ownership (scope lock), dirty state, ahead/behind, merge-readiness incl. verification evidence
 suggestion:
-  eligible: true
-  trigger_description: "which worktrees are active, is this worktree merge-ready, worktree overview"
-  trigger_context: "git worktree list shows more than the main working tree"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/commands/worktree/verify.md

@@ -10,9 +10,8 @@ skills: [worktree-lifecycle, verify-completion-evidence]
 description: Run the scoped verification for a worktree's declared change — narrow probes matched to the diff, never the full CI pipeline
 argument-hint: "[worktree-path | branch]"
 suggestion:
-  eligible: true
-  trigger_description: "verify the worktree change, prove this worktree is ready"
-  trigger_context: "a governed worktree with committed changes but no verification evidence attached"
+  eligible: false
+  rationale: "Cluster sub-command — reached via its cluster head's routing or its explicit /cluster:sub name; not independently suggested (surface-consolidation)."
 workspaces:
   - agent-config-maintainer
 packs:

package/dist/agent-src/contexts/contracts/command-suggestion-flow.md

@@ -91,6 +91,16 @@ suggestion:
   cooldown: 30m            # longer than global default
 ```
 
+## Eligibility invariant — cluster sub-commands route via their head
+
+A `/cluster:sub` command (frontmatter `sub:` set) is **not** independently
+suggestion-eligible: `suggestion.eligible: false`. The cluster HEAD is the
+journey that self-suggests; the sub-command is reached by routing from the head
+(the `/fix:route` template) or by its explicit `/cluster:sub` name — which
+always works. This keeps the proactive surface to a few journeys, not one
+entry point per mode (9.4.0 review; `road-to-surface-consolidation`, council
+2026-07-20). Standalone commands (no `sub:`) and cluster heads may be eligible.
+
 ## Subordination — when to stay silent
 
 The rule lists four senior gates that outrank suggestion. The agent

package/dist/agent-src/templates/agents/agent-project-settings.example.yml

@@ -39,7 +39,7 @@ schema_version: 1
 # CI guard: a release bump of `package.json` must update this value
 # in lockstep — see scripts/check_template_pin_drift.ts (road-to-
 # portable-runtime-and-update-check P3.3).
-agent_config_version: "9.5.0"
+agent_config_version: "9.6.0"
 
 # --- Project identity ---
 project:

package/dist/discovery/deprecation-report.md

@@ -1,6 +1,6 @@
 # Discovery — Deprecation Report
 
-- Generated: `2026-07-20T14:45:21Z`
+- Generated: `2026-07-20T21:31:59Z`
 - Deprecated artefacts: **0**
 
 _None. Tree is clean._