@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
  1. package/.agent-src/commands/{agents-audit.md → agents/audit.md} +4 -3
  2. package/.agent-src/commands/{agents-cleanup.md → agents/cleanup.md} +12 -6
  3. package/.agent-src/commands/{agents-prepare.md → agents/prepare.md} +4 -3
  4. package/.agent-src/commands/agents.md +46 -0
  5. package/.agent-src/commands/{chat-history-checkpoint.md → chat-history/checkpoint.md} +4 -4
  6. package/.agent-src/commands/{chat-history-clear.md → chat-history/clear.md} +4 -4
  7. package/.agent-src/commands/{chat-history-resume.md → chat-history/resume.md} +4 -4
  8. package/.agent-src/commands/chat-history/show.md +107 -0
  9. package/.agent-src/commands/chat-history.md +33 -89
  10. package/.agent-src/commands/{commit-in-chunks.md → commit/in-chunks.md} +15 -13
  11. package/.agent-src/commands/commit.md +22 -2
  12. package/.agent-src/commands/{context-create.md → context/create.md} +4 -3
  13. package/.agent-src/commands/{context-refactor.md → context/refactor.md} +4 -3
  14. package/.agent-src/commands/context.md +44 -0
  15. package/.agent-src/commands/{copilot-agents-init.md → copilot-agents/init.md} +4 -3
  16. package/.agent-src/commands/{copilot-agents-optimize.md → copilot-agents/optimize.md} +4 -3
  17. package/.agent-src/commands/copilot-agents.md +44 -0
  18. package/.agent-src/commands/council/default.md +221 -0
  19. package/.agent-src/commands/{council-design.md → council/design.md} +6 -5
  20. package/.agent-src/commands/{council-optimize.md → council/optimize.md} +7 -6
  21. package/.agent-src/commands/{council-pr.md → council/pr.md} +6 -5
  22. package/.agent-src/commands/council.md +47 -212
  23. package/.agent-src/commands/{create-pr-description.md → create-pr/description-only.md} +4 -2
  24. package/.agent-src/commands/create-pr.md +26 -5
  25. package/.agent-src/commands/{feature-dev.md → feature/dev.md} +5 -10
  26. package/.agent-src/commands/{feature-explore.md → feature/explore.md} +4 -8
  27. package/.agent-src/commands/{feature-plan.md → feature/plan.md} +4 -8
  28. package/.agent-src/commands/{feature-refactor.md → feature/refactor.md} +4 -8
  29. package/.agent-src/commands/{feature-roadmap.md → feature/roadmap.md} +6 -10
  30. package/.agent-src/commands/feature.md +6 -12
  31. package/.agent-src/commands/{fix-ci.md → fix/ci.md} +4 -8
  32. package/.agent-src/commands/{fix-portability.md → fix/portability.md} +4 -8
  33. package/.agent-src/commands/{fix-pr-bot-comments.md → fix/pr-bots.md} +4 -8
  34. package/.agent-src/commands/{fix-pr-developer-comments.md → fix/pr-developers.md} +4 -8
  35. package/.agent-src/commands/{fix-pr-comments.md → fix/pr.md} +7 -11
  36. package/.agent-src/commands/{fix-references.md → fix/refs.md} +4 -8
  37. package/.agent-src/commands/{fix-seeder.md → fix/seeder.md} +4 -8
  38. package/.agent-src/commands/fix.md +7 -13
  39. package/.agent-src/commands/{do-and-judge.md → judge/on-diff.md} +4 -3
  40. package/.agent-src/commands/judge/solo.md +90 -0
  41. package/.agent-src/commands/{do-in-steps.md → judge/steps.md} +4 -3
  42. package/.agent-src/commands/judge.md +35 -70
  43. package/.agent-src/commands/{memory-add.md → memory/add.md} +4 -3
  44. package/.agent-src/commands/{memory-full.md → memory/load.md} +4 -3
  45. package/.agent-src/commands/{memory-promote.md → memory/promote.md} +4 -3
  46. package/.agent-src/commands/{propose-memory.md → memory/propose.md} +4 -3
  47. package/.agent-src/commands/memory.md +48 -0
  48. package/.agent-src/commands/{module-create.md → module/create.md} +4 -3
  49. package/.agent-src/commands/{module-explore.md → module/explore.md} +4 -3
  50. package/.agent-src/commands/module.md +44 -0
  51. package/.agent-src/commands/{optimize-agents.md → optimize/agents.md} +4 -8
  52. package/.agent-src/commands/{optimize-augmentignore.md → optimize/augmentignore.md} +4 -9
  53. package/.agent-src/commands/{optimize-rtk-filters.md → optimize/rtk.md} +4 -8
  54. package/.agent-src/commands/{optimize-skills.md → optimize/skills.md} +4 -8
  55. package/.agent-src/commands/optimize.md +4 -10
  56. package/.agent-src/commands/{override-create.md → override/create.md} +4 -3
  57. package/.agent-src/commands/{override-manage.md → override/manage.md} +4 -3
  58. package/.agent-src/commands/override.md +44 -0
  59. package/.agent-src/commands/{roadmap-create.md → roadmap/create.md} +4 -3
  60. package/.agent-src/commands/{roadmap-execute.md → roadmap/execute.md} +4 -3
  61. package/.agent-src/commands/roadmap.md +44 -0
  62. package/.agent-src/commands/{tests-create.md → tests/create.md} +4 -3
  63. package/.agent-src/commands/{tests-execute.md → tests/execute.md} +4 -3
  64. package/.agent-src/commands/tests.md +44 -0
  65. package/.agent-src/contexts/communication/rules-auto/artifact-engagement-recording-mechanics.md +72 -0
  66. package/.agent-src/contexts/communication/rules-auto/augment-portability-mechanics.md +79 -0
  67. package/.agent-src/contexts/communication/rules-auto/augment-source-of-truth-mechanics.md +98 -0
  68. package/.agent-src/contexts/communication/rules-auto/cli-output-handling-mechanics.md +87 -0
  69. package/.agent-src/contexts/communication/rules-auto/command-suggestion-policy-mechanics.md +62 -0
  70. package/.agent-src/contexts/communication/rules-auto/docs-sync-mechanics.md +78 -0
  71. package/.agent-src/contexts/communication/rules-auto/package-ci-checks-mechanics.md +85 -0
  72. package/.agent-src/contexts/communication/rules-auto/review-routing-awareness-mechanics.md +65 -0
  73. package/.agent-src/contexts/communication/rules-auto/roadmap-progress-sync-mechanics.md +78 -0
  74. package/.agent-src/contexts/communication/rules-auto/skill-quality-mechanics.md +62 -0
  75. package/.agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md +55 -0
  76. package/.agent-src/contexts/communication/rules-auto/ui-audit-gate-mechanics.md +53 -0
  77. package/.agent-src/contexts/communication/rules-auto/user-interaction-mechanics.md +77 -0
  78. package/.agent-src/contexts/judges/no-consolidate-rationale.md +102 -0
  79. package/.agent-src/contexts/judges/persona-voice-rubric.md +140 -0
  80. package/.agent-src/rules/artifact-engagement-recording.md +13 -69
  81. package/.agent-src/rules/ask-when-uncertain.md +27 -42
  82. package/.agent-src/rules/augment-portability.md +15 -61
  83. package/.agent-src/rules/augment-source-of-truth.md +27 -93
  84. package/.agent-src/rules/cli-output-handling.md +10 -76
  85. package/.agent-src/rules/command-suggestion-policy.md +18 -59
  86. package/.agent-src/rules/commit-conventions.md +17 -14
  87. package/.agent-src/rules/context-hygiene.md +6 -0
  88. package/.agent-src/rules/direct-answers.md +35 -59
  89. package/.agent-src/rules/docker-commands.md +5 -5
  90. package/.agent-src/rules/docs-sync.md +15 -69
  91. package/.agent-src/rules/language-and-tone.md +48 -72
  92. package/.agent-src/rules/missing-tool-handling.md +28 -22
  93. package/.agent-src/rules/no-cheap-questions.md +39 -53
  94. package/.agent-src/rules/no-roadmap-references.md +73 -0
  95. package/.agent-src/rules/onboarding-gate.md +7 -0
  96. package/.agent-src/rules/package-ci-checks.md +21 -61
  97. package/.agent-src/rules/preservation-guard.md +64 -29
  98. package/.agent-src/rules/review-routing-awareness.md +24 -43
  99. package/.agent-src/rules/roadmap-progress-sync.md +31 -65
  100. package/.agent-src/rules/rule-type-governance.md +28 -0
  101. package/.agent-src/rules/security-sensitive-stop.md +8 -8
  102. package/.agent-src/rules/skill-quality.md +16 -48
  103. package/.agent-src/rules/slash-command-routing-policy.md +7 -4
  104. package/.agent-src/rules/think-before-action.md +52 -42
  105. package/.agent-src/rules/tool-safety.md +19 -16
  106. package/.agent-src/rules/ui-audit-gate.md +24 -38
  107. package/.agent-src/rules/user-interaction.md +13 -68
  108. package/.agent-src/skills/ai-council/SKILL.md +2 -0
  109. package/.agent-src/skills/api-testing/SKILL.md +1 -1
  110. package/.agent-src/skills/check-refs/SKILL.md +59 -40
  111. package/.agent-src/skills/conventional-commits-writing/SKILL.md +86 -28
  112. package/.agent-src/skills/copilot-agents-optimization/SKILL.md +5 -5
  113. package/.agent-src/skills/developer-like-execution/SKILL.md +4 -4
  114. package/.agent-src/skills/finishing-a-development-branch/SKILL.md +101 -65
  115. package/.agent-src/skills/flux/SKILL.md +30 -10
  116. package/.agent-src/skills/github-ci/SKILL.md +2 -2
  117. package/.agent-src/skills/judge-code-quality/SKILL.md +7 -8
  118. package/.agent-src/skills/judge-security-auditor/SKILL.md +4 -5
  119. package/.agent-src/skills/judge-test-coverage/SKILL.md +3 -4
  120. package/.agent-src/skills/lint-skills/SKILL.md +57 -39
  121. package/.agent-src/skills/md-language-check/SKILL.md +61 -39
  122. package/.agent-src/skills/override-management/SKILL.md +5 -5
  123. package/.agent-src/skills/quality-tools/SKILL.md +2 -2
  124. package/.agent-src/skills/react-shadcn-ui/SKILL.md +116 -43
  125. package/.agent-src/skills/readme-reviewer/SKILL.md +30 -29
  126. package/.agent-src/skills/readme-writing/SKILL.md +78 -53
  127. package/.agent-src/skills/readme-writing-package/SKILL.md +50 -47
  128. package/.agent-src/skills/receiving-code-review/SKILL.md +52 -47
  129. package/.agent-src/skills/refine-prompt/SKILL.md +0 -1
  130. package/.agent-src/skills/requesting-code-review/SKILL.md +35 -30
  131. package/.agent-src/skills/security/SKILL.md +7 -2
  132. package/.agent-src/skills/security-audit/SKILL.md +7 -3
  133. package/.agent-src/skills/systematic-debugging/SKILL.md +68 -60
  134. package/.agent-src/skills/test-driven-development/SKILL.md +59 -57
  135. package/.agent-src/skills/test-performance/SKILL.md +0 -1
  136. package/.agent-src/skills/traefik/SKILL.md +4 -4
  137. package/.agent-src/skills/verify-completion-evidence/SKILL.md +28 -26
  138. package/.agent-src/templates/roadmaps.md +4 -0
  139. package/.claude-plugin/marketplace.json +22 -11
  140. package/AGENTS.md +2 -2
  141. package/CHANGELOG.md +125 -1
  142. package/README.md +18 -17
  143. package/docs/architecture.md +4 -6
  144. package/docs/catalog.md +67 -39
  145. package/docs/contracts/STABILITY.md +13 -7
  146. package/docs/contracts/adr-chat-history-split.md +1 -3
  147. package/docs/contracts/adr-command-suggestion.md +0 -2
  148. package/docs/contracts/adr-implement-ticket-runtime.md +1 -2
  149. package/docs/contracts/adr-product-ui-track.md +3 -6
  150. package/docs/contracts/adr-prompt-driven-execution.md +3 -4
  151. package/docs/contracts/agent-memory-contract.md +6 -11
  152. package/docs/contracts/artifact-engagement-flow.md +6 -9
  153. package/docs/contracts/command-clusters.md +56 -46
  154. package/docs/contracts/command-suggestion-flow.md +1 -3
  155. package/docs/contracts/context-paths.md +99 -0
  156. package/docs/contracts/file-ownership-matrix.json +6722 -0
  157. package/docs/contracts/file-ownership-matrix.md +134 -0
  158. package/docs/contracts/implement-ticket-flow.md +6 -9
  159. package/docs/contracts/linear-ai-rules-inclusion.md +0 -1
  160. package/docs/contracts/linear-ai-three-layers.md +0 -2
  161. package/docs/contracts/load-context-budget-model.md +258 -0
  162. package/docs/contracts/load-context-schema.md +21 -3
  163. package/docs/contracts/roadmap-complexity-standard.md +137 -0
  164. package/docs/contracts/rule-interactions.md +0 -1
  165. package/docs/contracts/rule-priority-hierarchy.md +1 -1
  166. package/docs/contracts/ui-track-flow.md +7 -17
  167. package/docs/customization.md +2 -0
  168. package/docs/getting-started.md +5 -4
  169. package/docs/guidelines/agent-infra/ask-when-uncertain-demos.md +134 -0
  170. package/docs/guidelines/agent-infra/asking-and-brevity-examples.md +100 -0
  171. package/docs/guidelines/agent-infra/direct-answers-demos.md +145 -0
  172. package/docs/guidelines/agent-infra/verify-before-complete-demos.md +128 -0
  173. package/package.json +1 -1
  174. package/scripts/_phase2_shim_helper.py +109 -0
  175. package/scripts/agent-config +30 -0
  176. package/scripts/ai_council/one_off_archive/2026-05/README.md +45 -0
  177. package/scripts/ai_council/one_off_archive/2026-05/_one_off_2a4_acceptance.py +208 -0
  178. package/scripts/ai_council/one_off_archive/2026-05/_one_off_budget_v2_audit.py +206 -0
  179. package/scripts/ai_council/one_off_archive/2026-05/_one_off_context_layer_v1_estimate.py +67 -0
  180. package/scripts/ai_council/one_off_archive/2026-05/_one_off_context_layer_v1_review.py +292 -0
  181. package/scripts/ai_council/one_off_archive/2026-05/_one_off_followups_review.py +259 -0
  182. package/scripts/ai_council/one_off_archive/2026-05/_one_off_nondestructive_inline_audit.py +209 -0
  183. package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase4_dispatch_latency.py +108 -0
  184. package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase6_trigger_jaccard.py +92 -0
  185. package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase_2a_budget_rebalance.py +257 -0
  186. package/scripts/ai_council/one_off_archive/2026-05/_one_off_phase_2a_post_revert.py +197 -0
  187. package/scripts/ai_council/one_off_archive/2026-05/_one_off_rule_hardening_v1.py +251 -0
  188. package/scripts/ai_council/one_off_archive/2026-05/_one_off_structural_open_questions.py +232 -0
  189. package/scripts/ai_council/one_off_archive/2026-05/_one_off_structural_optimization.py +144 -0
  190. package/scripts/ai_council/one_off_archive/2026-05/_one_off_structural_v3_gaps.py +252 -0
  191. package/scripts/ai_council/one_off_archive/2026-05/_one_off_structural_v3_review.py +240 -0
  192. package/scripts/build_rule_trigger_matrix.py +360 -0
  193. package/scripts/check_always_budget.py +402 -45
  194. package/scripts/check_cluster_patterns.py +159 -0
  195. package/scripts/check_command_count_messaging.py +14 -7
  196. package/scripts/check_context_paths.py +201 -0
  197. package/scripts/check_no_roadmap_refs.py +155 -0
  198. package/scripts/check_one_off_location.py +81 -0
  199. package/scripts/check_phase_coupling.py +148 -0
  200. package/scripts/check_portability.py +2 -0
  201. package/scripts/check_references.py +35 -2
  202. package/scripts/check_safety_floor_untouched.py +125 -0
  203. package/scripts/command_suggester/loader.py +4 -1
  204. package/scripts/compress.py +64 -15
  205. package/scripts/context_hygiene_hook.py +173 -0
  206. package/scripts/generate_index.py +6 -2
  207. package/scripts/generate_ownership_matrix.py +323 -0
  208. package/scripts/hooks/augment-context-hygiene.sh +55 -0
  209. package/scripts/hooks/augment-onboarding-gate.sh +55 -0
  210. package/scripts/hooks/augment-roadmap-progress.sh +57 -0
  211. package/scripts/install.py +105 -45
  212. package/scripts/lint_examples.py +98 -0
  213. package/scripts/lint_no_new_atomic_commands.py +12 -11
  214. package/scripts/lint_roadmap_complexity.py +127 -0
  215. package/scripts/onboarding_gate_hook.py +137 -0
  216. package/scripts/requirements-evals.txt +1 -0
  217. package/scripts/roadmap_progress_hook.py +159 -0
  218. package/scripts/schemas/command.schema.json +4 -3
  219. package/scripts/schemas/rule.schema.json +5 -0
  220. package/scripts/skill_linter.py +1 -0
  221. package/scripts/sync_agent_settings.py +25 -2
  222. package/scripts/update_counts.py +7 -0
  223. /package/scripts/ai_council/{_one_off_rebalancing_audit.py → one_off_archive/2026-05/_one_off_rebalancing_audit.py} +0 -0
  224. /package/scripts/ai_council/{_one_off_roundtrip.py → one_off_archive/2026-05/_one_off_roundtrip.py} +0 -0
@@ -1,89 +1,54 @@
1
1
  ---
2
2
  name: judge
3
- skills: [subagent-orchestration]
4
- description: Run a standalone judge on an existing diff or code change — no implementer, no revision loop, verdict only
3
+ description: Judge orchestrator — routes to solo, steps, on-diff
4
+ cluster: judge
5
5
  disable-model-invocation: true
6
6
  suggestion:
7
- eligible: false
8
- rationale: "Sibling of /review-changes eligibility routed there; keep this explicit."
7
+ eligible: true
8
+ trigger_description: "judge this diff, review with verdict, run an implementer→judge loop, step-by-step judged execution"
9
+ trigger_context: "user wants a verdict on a diff, a do-and-judge loop, or a step-gated execution"
9
10
  ---
10
11
 
11
- # judge
12
+ # /judge
12
13
 
13
- ## Instructions
14
+ Top-level orchestrator for the `/judge` family. Replaces 3 standalone
15
+ commands with a single entry point + sub-command dispatch.
14
16
 
15
- ### 1. Identify the target
17
+ ## Sub-commands
16
18
 
17
- The user invoked `/judge` on one of:
19
+ | Sub-command | Routes to | Purpose |
20
+ |---|---|---|
21
+ | `/judge solo` | `commands/judge/solo.md` | Standalone verdict on an existing diff — no implementer, no revision loop |
22
+ | `/judge on-diff` | `commands/judge/on-diff.md` | Implementer→judge loop on a single change with a two-revision ceiling |
23
+ | `/judge steps` | `commands/judge/steps.md` | Execute an ordered plan step by step, judge gate between steps |
18
24
 
19
- - The current working-tree diff (`git diff`)
20
- - A specific commit range (`git diff A..B`)
21
- - A PR by number or URL
22
- - A single file or set of files
25
+ Sub-command names match the locked contract in
26
+ [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
27
+ The standalone reviewer surface lives at [`/review`](review-changes.md).
23
28
 
24
- Confirm the target in one sentence before proceeding. Do not silently
25
- assume the working tree.
29
+ ## Dispatch
26
30
 
27
- ### 2. Gather the context
31
+ 1. Parse the user's argument: `/judge <sub-command> [args]`.
32
+ 2. Look up the sub-command in the table above.
33
+ 3. Load the body of the routed file and follow its `## Instructions`
34
+ section verbatim with the remaining args.
35
+ 4. If the sub-command is unknown or missing, print the table above and
36
+ ask:
28
37
 
29
- Collect what the judge needs:
38
+ > 1. solo verdict only, no loop
39
+ > 2. on-diff — implementer→judge revision loop
40
+ > 3. steps — judge gate between ordered steps
30
41
 
31
- - The diff in full
32
- - The original task, ticket, or PR description
33
- - Relevant acceptance criteria (tests, linter config, design doc)
42
+ ## Rules
34
43
 
35
- If any of these is missing and the judgment would be shallow without
36
- it, **stop** and ask.
37
-
38
- ### 3. Resolve the judge model
39
-
40
- Read `.agent-settings.yml`:
41
-
42
- - `subagents.judge_model` → empty = one tier above session model
43
-
44
- Unknown alias → stop. Silence is not a fallback.
45
-
46
- ### 4. Invoke the judge
47
-
48
- The judge reviews the diff against the task. Return one of:
49
-
50
- | Verdict | Meaning |
51
- |----------|----------------------------------------------|
52
- | `apply` | Correct, complete, ready to land |
53
- | `revise` | Specific issues listed — user decides next |
54
- | `reject` | Fundamentally wrong approach |
55
-
56
- Unlike `/do-and-judge`, this command does **not** loop — no revision
57
- cycles. The verdict is the deliverable.
58
-
59
- ### 5. Report
60
-
61
- ```
62
- Mode: judge (standalone)
63
- Target: <diff | commit range | PR #N | files>
64
- Judge: <resolved model>
65
- Verdict: apply | revise | reject
66
- Issues: <numbered list if revise/reject>
67
- Next step: <what the user should do based on the verdict>
68
- ```
69
-
70
- ## Use this command when
71
-
72
- - A diff already exists and the user wants a second opinion
73
- - Reviewing someone else's PR before approving it
74
- - Double-checking a change before opening a PR
75
- - Stress-testing a refactor without committing to revisions
76
-
77
- ## Do NOT
78
-
79
- - NEVER apply the diff — this command judges only
80
- - NEVER loop into a revision cycle — use `/do-and-judge` for that
81
- - NEVER run the judge on an empty diff — fail fast
82
- - NEVER silently fall back to the session model for the judge
44
+ - **Do NOT commit, push, or open a PR** unless the sub-command
45
+ explicitly authorizes it.
46
+ - **Do NOT chain sub-commands.** One `/judge <sub>` per turn.
47
+ - If the user invokes `/judge` with no argument, **show the menu** —
48
+ do not guess which sub-command they meant.
83
49
 
84
50
  ## See also
85
51
 
86
52
  - [`subagent-orchestration`](../skills/subagent-orchestration/SKILL.md)
87
- - [`/do-and-judge`](do-and-judge.md) — if a revision loop is wanted
88
- - [`/review-changes`](review-changes.md) — human-oriented self-review
89
- - [`role-contracts`](../../docs/guidelines/agent-infra/role-contracts.md#reviewer) — Reviewer mode output contract (Summary / Risks / Findings / Required actions / Verdict)
53
+ - [`/review`](review-changes.md) — human-oriented self-review (Reviewer-mode contract)
54
+ - [`role-contracts`](../../docs/guidelines/agent-infra/role-contracts.md#reviewer)
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: memory-add
2
+ name: memory:add
3
+ cluster: memory
4
+ sub: add
3
5
  description: Interactively add a validated entry to an engineering-memory file (domain-invariants, architecture-decisions, incident-learnings, product-rules)
4
6
  skills: [file-editor]
5
7
  disable-model-invocation: true
@@ -9,8 +11,7 @@ suggestion:
9
11
  trigger_context: "post-incident or post-decision conversation"
10
12
  ---
11
13
 
12
- # /memory-add
13
-
14
+ # /memory add
14
15
  Creates or updates a single entry in one of the four engineering-memory
15
16
  YAML files under `agents/memory/` in the consumer project. The entry
16
17
  is validated against the schema in
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: memory-full
2
+ name: memory:load
3
+ cluster: memory
4
+ sub: load
3
5
  description: Load ALL curated entries of a given memory type into the current context — opt-in full load for deep analysis, never auto-triggered
4
6
  skills: []
5
7
  disable-model-invocation: true
@@ -8,8 +10,7 @@ suggestion:
8
10
  rationale: "Description states 'never auto-triggered' — opt-in deep-load only."
9
11
  ---
10
12
 
11
- # /memory-full
12
-
13
+ # /memory load
13
14
  Loads every entry of a single memory type into the current conversation
14
15
  as a formatted block. Use when the normal `memory_lookup` filter is too
15
16
  narrow and you need the full type for an architecture decision, audit,
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: memory-promote
2
+ name: memory:promote
3
+ cluster: memory
4
+ sub: promote
3
5
  description: Promote an intake signal (or provisional proposal) into a curated memory entry — opens a PR and runs the admission gate.
4
6
  skills: [file-editor]
5
7
  disable-model-invocation: true
@@ -8,8 +10,7 @@ suggestion:
8
10
  rationale: "Curation pipeline — overlaps /memory-add; keep explicit."
9
11
  ---
10
12
 
11
- # /memory-promote
12
-
13
+ # /memory promote
13
14
  Moves an entry from the provisional layer (intake JSONL) into the
14
15
  curated layer (`agents/memory/<type>.yml` or sharded). Promotion is
15
16
  gated by
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: propose-memory
2
+ name: memory:propose
3
+ cluster: memory
4
+ sub: propose
3
5
  description: 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.
4
6
  skills: [file-editor]
5
7
  disable-model-invocation: true
@@ -8,8 +10,7 @@ suggestion:
8
10
  rationale: "Programmatic intake fallback — overlaps /memory-add; keep explicit."
9
11
  ---
10
12
 
11
- # /propose-memory
12
-
13
+ # /memory propose
13
14
  Drops a **signal** into `agents/memory/intake/signals-YYYY-MM.jsonl` via
14
15
  `scripts/memory_signal.py`. Signals are append-only JSONL and merge-safe.
15
16
 
@@ -0,0 +1,48 @@
1
+ ---
2
+ name: memory
3
+ description: Memory orchestrator — routes to add, load, promote, propose
4
+ cluster: memory
5
+ disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "add a memory entry, load all memories, promote a signal, propose a finding"
9
+ trigger_context: "user wants to write to or curate engineering memory"
10
+ ---
11
+
12
+ # /memory
13
+
14
+ Top-level orchestrator for the `/memory` family. Replaces 4 standalone
15
+ commands with a single entry point + sub-command dispatch.
16
+
17
+ ## Sub-commands
18
+
19
+ | Sub-command | Routes to | Purpose |
20
+ |---|---|---|
21
+ | `/memory add` | `commands/memory/add.md` | Interactively add a validated entry to a memory file |
22
+ | `/memory load` | `commands/memory/load.md` | Load ALL curated entries of a given memory type into context |
23
+ | `/memory promote` | `commands/memory/promote.md` | Promote an intake signal to a curated memory entry |
24
+ | `/memory propose` | `commands/memory/propose.md` | Append a provisional signal to the intake stream |
25
+
26
+ Sub-command names match the locked contract in
27
+ [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
28
+
29
+ ## Dispatch
30
+
31
+ 1. Parse the user's argument: `/memory <sub-command> [args]`.
32
+ 2. Look up the sub-command in the table above.
33
+ 3. Load the body of the routed file and follow its `## Instructions` section
34
+ verbatim with the remaining args.
35
+ 4. If the sub-command is unknown or missing, print the table above and ask:
36
+
37
+ > 1. add — write a curated entry interactively
38
+ > 2. load — load ALL entries of a type for deep analysis
39
+ > 3. promote — promote an intake signal to a curated entry
40
+ > 4. propose — drop a provisional signal into the intake stream
41
+
42
+ ## Rules
43
+
44
+ - **Do NOT commit, push, or open a PR** unless the sub-command explicitly
45
+ authorizes it.
46
+ - **Do NOT chain sub-commands.** One `/memory <sub>` per turn.
47
+ - If the user invokes `/memory` with no argument, **show the menu** — do
48
+ not guess which sub-command they meant.
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: module-create
2
+ name: module:create
3
+ cluster: module
4
+ sub: create
3
5
  skills: [laravel]
4
6
  description: Create a new module from .module-template with interactive setup
5
7
  disable-model-invocation: true
@@ -9,8 +11,7 @@ suggestion:
9
11
  trigger_context: "prompt mentions a new domain area without an existing module"
10
12
  ---
11
13
 
12
- # module-create
13
-
14
+ # /module create
14
15
  ## Instructions
15
16
 
16
17
  ### 1. Check for module support
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: module-explore
2
+ name: module:explore
3
+ cluster: module
4
+ sub: explore
3
5
  skills: [laravel]
4
6
  description: Explore a module — load its structure, docs, and context into the current conversation
5
7
  disable-model-invocation: true
@@ -9,8 +11,7 @@ suggestion:
9
11
  trigger_context: "existing Modules/<Name>/ referenced in the prompt"
10
12
  ---
11
13
 
12
- # module-explore
13
-
14
+ # /module explore
14
15
  ## Instructions
15
16
 
16
17
  ### 1. Check for modules
@@ -0,0 +1,44 @@
1
+ ---
2
+ name: module
3
+ description: Module orchestrator — routes to create, explore
4
+ cluster: module
5
+ disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "create a new module, explore an existing module"
9
+ trigger_context: "user wants to scaffold or load a module's docs and structure"
10
+ ---
11
+
12
+ # /module
13
+
14
+ Top-level orchestrator for the `/module` family. Replaces 2 standalone
15
+ commands with a single entry point + sub-command dispatch.
16
+
17
+ ## Sub-commands
18
+
19
+ | Sub-command | Routes to | Purpose |
20
+ |---|---|---|
21
+ | `/module create` | `commands/module/create.md` | Create a new module from `.module-template` |
22
+ | `/module explore` | `commands/module/explore.md` | Load a module's structure, docs, and context into the conversation |
23
+
24
+ Sub-command names match the locked contract in
25
+ [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
26
+
27
+ ## Dispatch
28
+
29
+ 1. Parse the user's argument: `/module <sub-command> [args]`.
30
+ 2. Look up the sub-command in the table above.
31
+ 3. Load the body of the routed file and follow its `## Instructions` section
32
+ verbatim with the remaining args.
33
+ 4. If the sub-command is unknown or missing, print the table above and ask:
34
+
35
+ > 1. create — scaffold a new module from the template
36
+ > 2. explore — load a module's docs and structure
37
+
38
+ ## Rules
39
+
40
+ - **Do NOT commit, push, or open a PR** unless the sub-command explicitly
41
+ authorizes it.
42
+ - **Do NOT chain sub-commands.** One `/module <sub>` per turn.
43
+ - If the user invokes `/module` with no argument, **show the menu** — do
44
+ not guess which sub-command they meant.
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: optimize-agents
2
+ name: optimize:agents
3
+ cluster: optimize
4
+ sub: agents
3
5
  description: Audits agent infrastructure — measures token overhead, checks rule triggers, verifies AGENTS.md. Suggest only, never auto-apply.
4
6
  skills: [copilot-agents-optimization, agents-audit, agent-docs-writing, quality-tools]
5
7
  disable-model-invocation: true
@@ -7,15 +9,9 @@ suggestion:
7
9
  eligible: true
8
10
  trigger_description: "audit agent infrastructure, tune the agent setup"
9
11
  trigger_context: "maintainer working on .augment/ files"
10
- superseded_by: optimize agents
11
- deprecated_in: "1.15.0"
12
12
  ---
13
13
 
14
- > ⚠️ /optimize-agents is deprecated; use /optimize agents instead.
15
- > This shim is retained for one release cycle (1.15.0 → next minor) and forwards to the same instructions below. See [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
16
-
17
- # /optimize-agents
18
-
14
+ # /optimize agents
19
15
  Agent infrastructure audit: measure token overhead, check rule triggers, verify AGENTS.md, find stale references. **Suggest only — never auto-apply.**
20
16
 
21
17
  **Source of truth:** `.agent-src.uncompressed/` — never read or edit `.agent-src/` or `.augment/` directly.
@@ -1,22 +1,17 @@
1
1
  ---
2
2
  skills: [agent-docs-writing]
3
- name: optimize-augmentignore
3
+ name: optimize:augmentignore
4
+ cluster: optimize
5
+ sub: augmentignore
4
6
  description: Creates or updates .augmentignore based on the project's actual tech stack, large files, generated artifacts, and irrelevant agent skills/rules.
5
7
  disable-model-invocation: true
6
8
  suggestion:
7
9
  eligible: false
8
10
  rationale: "Niche maintenance tool with no recurring NL trigger."
9
- superseded_by: optimize augmentignore
10
- deprecated_in: "1.15.0"
11
11
  ---
12
-
13
- > ⚠️ /optimize-augmentignore is deprecated; use /optimize augmentignore instead.
14
- > This shim is retained for one release cycle (1.15.0 → next minor) and forwards to the same instructions below. See [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
15
-
16
12
  <!-- cloud_safe: noop -->
17
13
 
18
- # /optimize-augmentignore
19
-
14
+ # /optimize augmentignore
20
15
  Scans the project to find files that waste tokens in Augment's retrieval index
21
16
  and creates/updates `.augmentignore` accordingly. Also identifies irrelevant
22
17
  `.augment/skills/` and `.augment/rules/` to exclude them from the system prompt.
@@ -1,20 +1,16 @@
1
1
  ---
2
- name: optimize-rtk-filters
2
+ name: optimize:rtk
3
+ cluster: optimize
4
+ sub: rtk
3
5
  skills: [agent-docs-writing]
4
6
  description: Create or optimize project-local rtk filters based on the actual toolchain
5
7
  disable-model-invocation: true
6
8
  suggestion:
7
9
  eligible: false
8
10
  rationale: "Niche maintenance tool with no recurring NL trigger."
9
- superseded_by: optimize rtk
10
- deprecated_in: "1.15.0"
11
11
  ---
12
12
 
13
- > ⚠️ /optimize-rtk-filters is deprecated; use /optimize rtk instead.
14
- > This shim is retained for one release cycle (1.15.0 → next minor) and forwards to the same instructions below. See [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
15
-
16
- # optimize-rtk-filters
17
-
13
+ # /optimize rtk
18
14
  ## Instructions
19
15
 
20
16
  ### 1. Check rtk is installed
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: optimize-skills
2
+ name: optimize:skills
3
+ cluster: optimize
4
+ sub: skills
3
5
  description: Audits skills — measures baseline, finds duplicates/merge candidates, runs linter. Suggest only, never auto-apply.
4
6
  skills: [skill-reviewer]
5
7
  disable-model-invocation: true
@@ -7,15 +9,9 @@ suggestion:
7
9
  eligible: true
8
10
  trigger_description: "audit my skills, find duplicate skills"
9
11
  trigger_context: "maintainer working on .augment/skills/ files"
10
- superseded_by: optimize skills
11
- deprecated_in: "1.15.0"
12
12
  ---
13
13
 
14
- > ⚠️ /optimize-skills is deprecated; use /optimize skills instead.
15
- > This shim is retained for one release cycle (1.15.0 → next minor) and forwards to the same instructions below. See [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
16
-
17
- # /optimize-skills
18
-
14
+ # /optimize skills
19
15
  Skill audit: measure, find duplicates/merge candidates, run linter, present findings. **Suggest only — never auto-apply.**
20
16
 
21
17
  **Source of truth:** `.agent-src.uncompressed/` — never read or edit `.agent-src/` or `.augment/` directly.
@@ -18,10 +18,10 @@ commands with a single entry point + sub-command dispatch.
18
18
 
19
19
  | Sub-command | Routes to | Purpose |
20
20
  |---|---|---|
21
- | `/optimize skills` | `optimize-skills.md` | Audit skills — measure baseline, find duplicates, run linter |
22
- | `/optimize agents` | `optimize-agents.md` | Audit agent infrastructure — token overhead, rule triggers, AGENTS.md |
23
- | `/optimize augmentignore` | `optimize-augmentignore.md` | Create or refine `.augmentignore` based on actual stack |
24
- | `/optimize rtk` | `optimize-rtk-filters.md` | Create or refine project-local rtk filters |
21
+ | `/optimize skills` | `commands/optimize/skills.md` | Audit skills — measure baseline, find duplicates, run linter |
22
+ | `/optimize agents` | `commands/optimize/agents.md` | Audit agent infrastructure — token overhead, rule triggers, AGENTS.md |
23
+ | `/optimize augmentignore` | `commands/optimize/augmentignore.md` | Create or refine `.augmentignore` based on actual stack |
24
+ | `/optimize rtk` | `commands/optimize/rtk.md` | Create or refine project-local rtk filters |
25
25
 
26
26
  Sub-command names match the locked contract in
27
27
  [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
@@ -39,12 +39,6 @@ Sub-command names match the locked contract in
39
39
  > 3. augmentignore — create or refine `.augmentignore`
40
40
  > 4. rtk — create or refine project-local rtk filters
41
41
 
42
- ## Migration
43
-
44
- The 4 standalone `/optimize-*` commands continue to work for one release
45
- cycle as deprecation shims. They emit a notice and route to the same
46
- content. New invocations should use `/optimize <sub>`.
47
-
48
42
  ## Rules
49
43
 
50
44
  - **Suggest only — never auto-apply.** All `/optimize` sub-commands are
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: override-create
2
+ name: override:create
3
+ cluster: override
4
+ sub: create
3
5
  description: Creates a project-level override for a shared skill, rule, or command.
4
6
  skills: [override-management, agent-docs-writing]
5
7
  disable-model-invocation: true
@@ -9,8 +11,7 @@ suggestion:
9
11
  trigger_context: "prompt names a shared skill/rule needing project-specific behavior"
10
12
  ---
11
13
 
12
- # /override-create
13
-
14
+ # /override create
14
15
  Creates an override file in `agents/overrides/` for a shared `.augment/` resource.
15
16
 
16
17
  ## Steps
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: override-manage
2
+ name: override:manage
3
+ cluster: override
4
+ sub: manage
3
5
  description: Reviews, updates, and refactors existing project-level overrides.
4
6
  skills: [override-management, agent-docs-writing]
5
7
  disable-model-invocation: true
@@ -9,8 +11,7 @@ suggestion:
9
11
  trigger_context: "existing entries under agents/overrides/"
10
12
  ---
11
13
 
12
- # /override-manage
13
-
14
+ # /override manage
14
15
  Manages existing overrides in `agents/overrides/`.
15
16
 
16
17
  ## Steps
@@ -0,0 +1,44 @@
1
+ ---
2
+ name: override
3
+ description: Override orchestrator — routes to create, manage
4
+ cluster: override
5
+ disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "create an override, manage existing overrides, refactor an override"
9
+ trigger_context: "user wants to add or curate project-level overrides under agents/overrides/"
10
+ ---
11
+
12
+ # /override
13
+
14
+ Top-level orchestrator for the `/override` family. Replaces 2 standalone
15
+ commands with a single entry point + sub-command dispatch.
16
+
17
+ ## Sub-commands
18
+
19
+ | Sub-command | Routes to | Purpose |
20
+ |---|---|---|
21
+ | `/override create` | `commands/override/create.md` | Create a project-level override for a shared skill, rule, or command |
22
+ | `/override manage` | `commands/override/manage.md` | Review, update, and refactor existing overrides |
23
+
24
+ Sub-command names match the locked contract in
25
+ [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
26
+
27
+ ## Dispatch
28
+
29
+ 1. Parse the user's argument: `/override <sub-command> [args]`.
30
+ 2. Look up the sub-command in the table above.
31
+ 3. Load the body of the routed file and follow its `## Instructions` section
32
+ verbatim with the remaining args.
33
+ 4. If the sub-command is unknown or missing, print the table above and ask:
34
+
35
+ > 1. create — author a new project-level override
36
+ > 2. manage — review, update, refactor existing overrides
37
+
38
+ ## Rules
39
+
40
+ - **Do NOT commit, push, or open a PR** unless the sub-command explicitly
41
+ authorizes it.
42
+ - **Do NOT chain sub-commands.** One `/override <sub>` per turn.
43
+ - If the user invokes `/override` with no argument, **show the menu** — do
44
+ not guess which sub-command they meant.
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: roadmap-create
2
+ name: roadmap:create
3
+ cluster: roadmap
4
+ sub: create
3
5
  skills: [agent-docs-writing]
4
6
  description: Interactively create a new roadmap file in agents/roadmaps/
5
7
  disable-model-invocation: true
@@ -9,8 +11,7 @@ suggestion:
9
11
  trigger_context: "multi-phase work without an existing agents/roadmaps/*.md"
10
12
  ---
11
13
 
12
- # roadmap-create
13
-
14
+ # /roadmap create
14
15
  ## Instructions
15
16
 
16
17
  ### 1. Determine location
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: roadmap-execute
2
+ name: roadmap:execute
3
+ cluster: roadmap
4
+ sub: execute
3
5
  skills: [agent-docs-writing]
4
6
  description: Read and interactively execute a roadmap from agents/roadmaps/
5
7
  disable-model-invocation: true
@@ -9,8 +11,7 @@ suggestion:
9
11
  trigger_context: "existing agents/roadmaps/*.md referenced in the prompt"
10
12
  ---
11
13
 
12
- # roadmap-execute
13
-
14
+ # /roadmap execute
14
15
  ## Instructions
15
16
 
16
17
  ### 1. Find the roadmap
@@ -0,0 +1,44 @@
1
+ ---
2
+ name: roadmap
3
+ description: Roadmap orchestrator — routes to create, execute
4
+ cluster: roadmap
5
+ disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "create a roadmap, execute a roadmap, plan a roadmap interactively"
9
+ trigger_context: "user wants to scaffold or run a roadmap under agents/roadmaps/"
10
+ ---
11
+
12
+ # /roadmap
13
+
14
+ Top-level orchestrator for the `/roadmap` family. Replaces 2 standalone
15
+ commands with a single entry point + sub-command dispatch.
16
+
17
+ ## Sub-commands
18
+
19
+ | Sub-command | Routes to | Purpose |
20
+ |---|---|---|
21
+ | `/roadmap create` | `commands/roadmap/create.md` | Interactively create a new roadmap in `agents/roadmaps/` |
22
+ | `/roadmap execute` | `commands/roadmap/execute.md` | Read and interactively execute a roadmap |
23
+
24
+ Sub-command names match the locked contract in
25
+ [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
26
+
27
+ ## Dispatch
28
+
29
+ 1. Parse the user's argument: `/roadmap <sub-command> [args]`.
30
+ 2. Look up the sub-command in the table above.
31
+ 3. Load the body of the routed file and follow its `## Instructions` section
32
+ verbatim with the remaining args.
33
+ 4. If the sub-command is unknown or missing, print the table above and ask:
34
+
35
+ > 1. create — scaffold a new roadmap interactively
36
+ > 2. execute — run an existing roadmap step by step
37
+
38
+ ## Rules
39
+
40
+ - **Do NOT commit, push, or open a PR** unless the sub-command explicitly
41
+ authorizes it.
42
+ - **Do NOT chain sub-commands.** One `/roadmap <sub>` per turn.
43
+ - If the user invokes `/roadmap` with no argument, **show the menu** — do
44
+ not guess which sub-command they meant.
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: tests-create
2
+ name: tests:create
3
+ cluster: tests
4
+ sub: create
3
5
  skills: [pest-testing]
4
6
  description: Write meaningful tests for the changes in the current branch
5
7
  disable-model-invocation: true
@@ -9,8 +11,7 @@ suggestion:
9
11
  trigger_context: "code changes on the branch without matching test changes"
10
12
  ---
11
13
 
12
- # tests-create
13
-
14
+ # /tests create
14
15
  ## Instructions
15
16
 
16
17
  ### 1. Detect the test framework