@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,5 +1,7 @@
1
1
  ---
2
- name: create-pr-description
2
+ name: create-pr:description-only
3
+ cluster: create-pr
4
+ sub: description-only
3
5
  skills: [git-workflow]
4
6
  description: Generate a PR description as a copyable markdown block — used standalone or by create-pr
5
7
  disable-model-invocation: true
@@ -9,7 +11,7 @@ suggestion:
9
11
  trigger_context: "PR exists or branch ready for review without description"
10
12
  ---
11
13
 
12
- # create-pr-description
14
+ # /create-pr:description-only
13
15
 
14
16
  ## Input
15
17
 
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: create-pr
3
+ cluster: create-pr
3
4
  skills: [git-workflow]
4
5
  description: Create a GitHub PR with structured description from Jira ticket and code changes
5
6
  disable-model-invocation: true
@@ -9,11 +10,31 @@ suggestion:
9
10
  trigger_context: "branch is ahead of base and not yet on a PR"
10
11
  ---
11
12
 
12
- # create-pr
13
+ # /create-pr
13
14
 
14
- Uses `/create-pr-description` to generate the PR content, then creates the PR via GitHub API.
15
+ Top-level entry point for the `/create-pr` family. Bare `/create-pr`
16
+ runs the full create-PR flow described below. The `:description-only`
17
+ sub-command produces a copyable PR description without creating the PR.
15
18
 
16
- ## Instructions
19
+ ## Sub-commands
20
+
21
+ | Sub-command | Routes to | Purpose |
22
+ |---|---|---|
23
+ | `/create-pr` (bare) | this file (`## Default flow`) | Full flow — generate description, push, create PR |
24
+ | `/create-pr:description-only` | `commands/create-pr/description-only.md` | Generate the PR description as a copyable markdown block, no PR creation |
25
+
26
+ ## Dispatch
27
+
28
+ 1. Parse the user's argument: `/create-pr[:<sub>] [args]`.
29
+ 2. Bare `/create-pr` → run the `## Default flow` below verbatim.
30
+ 3. `/create-pr:description-only` → load
31
+ `commands/create-pr/description-only.md` and follow its
32
+ `## Instructions` section verbatim.
33
+ 4. Unknown sub-command → print the table above and ask which one.
34
+
35
+ ## Default flow
36
+
37
+ Uses `/create-pr:description-only` to generate the PR content, then creates the PR via GitHub API.
17
38
 
18
39
  ### 1. Check prerequisites
19
40
 
@@ -24,12 +45,12 @@ Uses `/create-pr-description` to generate the PR content, then creates the PR vi
24
45
 
25
46
  ### 2. Generate PR content
26
47
 
27
- Run `/create-pr-description` to generate the PR title and body.
48
+ Run `/create-pr:description-only` to generate the PR title and body.
28
49
  This handles: Jira ticket extraction, diff analysis, commit messages, **PR template filling**.
29
50
 
30
51
  **CRITICAL**: The PR body MUST use the project's PR template (`.github/pull_request_template.md`).
31
52
  Read the template file and fill in its sections. If the template does not exist, use the
32
- fallback structure defined in `/create-pr-description`. NEVER invent a custom body structure.
53
+ fallback structure defined in `/create-pr:description-only`. NEVER invent a custom body structure.
33
54
 
34
55
  The user reviews and adjusts the content in that step.
35
56
 
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: feature-dev
2
+ name: feature:dev
3
+ cluster: feature
4
+ sub: dev
3
5
  description: Full 7-phase feature development workflow for complex features.
4
6
  skills: [laravel, php-coder]
5
7
  disable-model-invocation: true
@@ -9,20 +11,13 @@ suggestion:
9
11
  trigger_context: "long-form feature description spanning multiple components"
10
12
  ---
11
13
 
12
- <!-- F2-deprecation-banner -->
13
- > **Deprecated — use `/feature dev`.** This standalone command
14
- > is kept as a deprecation shim for one release cycle and routes to
15
- > the same instructions below. New invocations should go through the
16
- > `/feature` orchestrator (`commands/feature.md`).
17
- <!-- /F2-deprecation-banner -->
18
-
19
- # /feature-dev
14
+ # /feature:dev
20
15
 
21
16
  > Full 7-phase feature development workflow for complex features.
22
17
 
23
18
  ## Trigger
24
19
 
25
- `/feature-dev {description}` or `/feature-dev` (interactive)
20
+ `/feature:dev {description}` or `/feature:dev` (interactive)
26
21
 
27
22
  ## When to use
28
23
 
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: feature-explore
2
+ name: feature:explore
3
+ cluster: feature
4
+ sub: explore
3
5
  skills: [laravel]
4
6
  description: Brainstorm and explore a feature idea before committing to a full plan
5
7
  disable-model-invocation: true
@@ -7,15 +9,9 @@ suggestion:
7
9
  eligible: true
8
10
  trigger_description: "brainstorm this idea, explore this feature concept"
9
11
  trigger_context: "open-ended feature idea without acceptance criteria"
10
- superseded_by: feature explore
11
- deprecated_in: "1.15.0"
12
12
  ---
13
13
 
14
- > ⚠️ /feature-explore is deprecated; use /feature explore 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
- # feature-explore
18
-
14
+ # /feature explore
19
15
  ## Instructions
20
16
 
21
17
  This is a **lightweight, conversational** exploration — no structured output yet.
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: feature-plan
2
+ name: feature:plan
3
+ cluster: feature
4
+ sub: plan
3
5
  skills: [feature-planning]
4
6
  description: Interactively plan a feature — research, discuss, and create a structured feature document
5
7
  disable-model-invocation: true
@@ -7,15 +9,9 @@ suggestion:
7
9
  eligible: true
8
10
  trigger_description: "plan this feature, create a feature spec for X"
9
11
  trigger_context: "feature idea referenced and no plan doc exists"
10
- superseded_by: feature plan
11
- deprecated_in: "1.15.0"
12
12
  ---
13
13
 
14
- > ⚠️ /feature-plan is deprecated; use /feature plan 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
- # feature-plan
18
-
14
+ # /feature plan
19
15
  ## Instructions
20
16
 
21
17
  ### 1. Gather the idea
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: feature-refactor
2
+ name: feature:refactor
3
+ cluster: feature
4
+ sub: refactor
3
5
  skills: [laravel, php-coder]
4
6
  description: Refine and update an existing feature plan through interactive discussion
5
7
  disable-model-invocation: true
@@ -7,15 +9,9 @@ suggestion:
7
9
  eligible: true
8
10
  trigger_description: "update the feature plan, refine the feature spec"
9
11
  trigger_context: "existing agents/features/*.md referenced in the prompt"
10
- superseded_by: feature refactor
11
- deprecated_in: "1.15.0"
12
12
  ---
13
13
 
14
- > ⚠️ /feature-refactor is deprecated; use /feature refactor 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
- # feature-refactor
18
-
14
+ # /feature refactor
19
15
  ## Instructions
20
16
 
21
17
  ### 1. Find the feature
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: feature-roadmap
2
+ name: feature:roadmap
3
+ cluster: feature
4
+ sub: roadmap
3
5
  skills: [agent-docs-writing]
4
6
  description: Generate implementation roadmap(s) from a feature plan and link them
5
7
  disable-model-invocation: true
@@ -7,15 +9,9 @@ suggestion:
7
9
  eligible: true
8
10
  trigger_description: "turn this feature into a roadmap, generate the implementation roadmap"
9
11
  trigger_context: "existing feature plan without linked roadmap"
10
- superseded_by: feature roadmap
11
- deprecated_in: "1.15.0"
12
12
  ---
13
13
 
14
- > ⚠️ /feature-roadmap is deprecated; use /feature roadmap 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
- # feature-roadmap
18
-
14
+ # /feature roadmap
19
15
  ## Instructions
20
16
 
21
17
  ### 1. Find the feature
@@ -47,7 +43,7 @@ Stop.
47
43
  ### 2. Analyze the feature
48
44
 
49
45
  - Read the feature file completely.
50
- - Read `agents/roadmaps/template.md` for the roadmap structure.
46
+ - Read the roadmap template at `.augment/templates/roadmaps.md` for the structure.
51
47
  - Research the codebase for affected areas mentioned in the feature.
52
48
 
53
49
  Determine how many roadmaps are needed:
@@ -185,7 +181,7 @@ What's next?
185
181
  requested them. See [`commit-policy`](../rules/commit-policy.md#never-write-commit-steps-into-roadmaps-unsolicited).
186
182
  - **Do NOT modify the feature plan** beyond updating the Roadmaps section and status.
187
183
  - **Always link roadmaps back to the feature** and vice versa.
188
- - **Use the roadmap template** from `agents/roadmaps/template.md`.
184
+ - **Use the roadmap template** at `.augment/templates/roadmaps.md`.
189
185
  - **Reference specific files** in roadmap tasks — not vague descriptions.
190
186
  - **Include quality gates** (PHPStan, Rector, tests) in every phase.
191
187
  - **Research the codebase** to make tasks concrete and realistic.
@@ -18,11 +18,11 @@ commands with a single entry point + sub-command dispatch.
18
18
 
19
19
  | Sub-command | Routes to | Purpose |
20
20
  |---|---|---|
21
- | `/feature explore` | `feature-explore.md` | Brainstorm an idea before committing to a plan |
22
- | `/feature plan` | `feature-plan.md` | Interactively plan a feature, produce a structured plan doc |
23
- | `/feature refactor` | `feature-refactor.md` | Refine and update an existing feature plan |
24
- | `/feature roadmap` | `feature-roadmap.md` | Generate implementation roadmap(s) from a plan |
25
- | `/feature dev` | `feature-dev.md` | Full 7-phase feature development workflow (heavyweight) |
21
+ | `/feature explore` | `commands/feature/explore.md` | Brainstorm an idea before committing to a plan |
22
+ | `/feature plan` | `commands/feature/plan.md` | Interactively plan a feature, produce a structured plan doc |
23
+ | `/feature refactor` | `commands/feature/refactor.md` | Refine and update an existing feature plan |
24
+ | `/feature roadmap` | `commands/feature/roadmap.md` | Generate implementation roadmap(s) from a plan |
25
+ | `/feature dev` | `commands/feature/dev.md` | Full 7-phase feature development workflow (heavyweight) |
26
26
 
27
27
  ## Workflow ordering
28
28
 
@@ -33,7 +33,7 @@ implementation). Use `refactor` whenever an existing plan needs an update.
33
33
 
34
34
  1. Parse the user's argument: `/feature <sub-command> [args]`.
35
35
  2. Look up the sub-command in the table above.
36
- 3. Load the body of the corresponding `commands/feature-<sub>.md` file and
36
+ 3. Load the body of the corresponding `commands/feature/<sub>.md` file and
37
37
  follow its `## Instructions` (or `## Steps`) section verbatim.
38
38
  4. If the sub-command is unknown or missing, print the menu and ask:
39
39
 
@@ -43,12 +43,6 @@ implementation). Use `refactor` whenever an existing plan needs an update.
43
43
  > 4. roadmap — generate roadmap(s) from a plan
44
44
  > 5. dev — run the full 7-phase development workflow
45
45
 
46
- ## Migration
47
-
48
- The 5 standalone `/feature-*` commands continue to work for one release
49
- cycle as deprecation shims. They emit a notice and route to the same
50
- content. New invocations should use `/feature <sub>`.
51
-
52
46
  ## Rules
53
47
 
54
48
  - **Do NOT chain sub-commands.** One `/feature <sub>` per turn — except
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: fix-ci
2
+ name: fix:ci
3
+ cluster: fix
4
+ sub: ci
3
5
  skills: [github-ci, quality-tools]
4
6
  description: Fetch CI errors from GitHub Actions and fix them
5
7
  disable-model-invocation: true
@@ -7,15 +9,9 @@ suggestion:
7
9
  eligible: true
8
10
  trigger_description: "CI is failing, fix the GitHub Actions errors, the pipeline is red"
9
11
  trigger_context: "open PR with failing checks"
10
- superseded_by: fix ci
11
- deprecated_in: "1.15.0"
12
12
  ---
13
13
 
14
- > ⚠️ /fix-ci is deprecated; use /fix ci 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
- # fix-ci
18
-
14
+ # /fix ci
19
15
  ## Instructions
20
16
 
21
17
  ### 1. Identify the failing CI run
@@ -1,19 +1,15 @@
1
1
  ---
2
- name: fix-portability
2
+ name: fix:portability
3
+ cluster: fix
4
+ sub: portability
3
5
  description: Find and fix project-specific references in shared .augment/ package files
4
6
  disable-model-invocation: true
5
7
  suggestion:
6
8
  eligible: false
7
9
  rationale: "Package-internal — only the event4u/agent-config repo runs this."
8
- superseded_by: fix portability
9
- deprecated_in: "1.15.0"
10
10
  ---
11
11
 
12
- > ⚠️ /fix-portability is deprecated; use /fix portability instead.
13
- > 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).
14
-
15
- # fix-portability
16
-
12
+ # /fix portability
17
13
  ## Instructions
18
14
 
19
15
  ### 1. Run the portability checker
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: fix-pr-bot-comments
2
+ name: fix:pr-bots
3
+ cluster: fix
4
+ sub: pr-bots
3
5
  skills: [php-coder, quality-tools]
4
6
  description: Fix and reply to bot review comments (Copilot, Augment, Greptile, etc.) on a GitHub PR
5
7
  disable-model-invocation: true
@@ -7,15 +9,9 @@ suggestion:
7
9
  eligible: true
8
10
  trigger_description: "address the Copilot/Greptile comments, fix the bot review feedback"
9
11
  trigger_context: "open PR with bot review comments unresolved"
10
- superseded_by: fix pr-bots
11
- deprecated_in: "1.15.0"
12
12
  ---
13
13
 
14
- > ⚠️ /fix-pr-bot-comments is deprecated; use /fix pr-bots 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
- # fix-pr-bot-comments
18
-
14
+ # /fix pr-bots
19
15
  ## Input
20
16
 
21
17
  The user may or may not provide a PR URL.
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: fix-pr-developer-comments
2
+ name: fix:pr-developers
3
+ cluster: fix
4
+ sub: pr-developers
3
5
  skills: [php-coder]
4
6
  description: Fix and reply to human reviewer comments on a GitHub PR
5
7
  disable-model-invocation: true
@@ -7,15 +9,9 @@ suggestion:
7
9
  eligible: true
8
10
  trigger_description: "fix the human reviewer comments, address the developer feedback"
9
11
  trigger_context: "open PR with unresolved human-reviewer comments"
10
- superseded_by: fix pr-developers
11
- deprecated_in: "1.15.0"
12
12
  ---
13
13
 
14
- > ⚠️ /fix-pr-developer-comments is deprecated; use /fix pr-developers 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
- # fix-pr-developer-comments
18
-
14
+ # /fix pr-developers
19
15
  ## Input
20
16
 
21
17
  The user may or may not provide a PR URL.
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: fix-pr-comments
2
+ name: fix:pr
3
+ cluster: fix
4
+ sub: pr
3
5
  skills: [php-coder]
4
6
  description: Fix and reply to all open review comments (bots + human reviewers) on a GitHub PR
5
7
  disable-model-invocation: true
@@ -7,16 +9,10 @@ suggestion:
7
9
  eligible: true
8
10
  trigger_description: "fix all PR review comments, resolve the review feedback"
9
11
  trigger_context: "open PR with unresolved comments (bot + human)"
10
- superseded_by: fix pr
11
- deprecated_in: "1.15.0"
12
12
  ---
13
13
 
14
- > ⚠️ /fix-pr-comments is deprecated; use /fix pr 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
- # fix-pr-comments
18
-
19
- This command runs `fix-pr-bot-comments` and `fix-pr-developer-comments` in sequence on the same PR.
14
+ # /fix pr
15
+ This command runs `/fix pr-bots` and `/fix pr-developers` in sequence on the same PR.
20
16
 
21
17
  ## Input
22
18
 
@@ -49,14 +45,14 @@ The chosen mode applies to **both** phases.
49
45
 
50
46
  ### Phase 1: Bot comments
51
47
 
52
- Follow the full `fix-pr-bot-comments` instructions (see `.augment/commands/fix-pr-bot-comments.md`).
48
+ Follow the full `/fix pr-bots` instructions (see `commands/fix/pr-bots.md`).
53
49
  Use the already-confirmed PR and mode — do not ask again.
54
50
 
55
51
  Report when done: "Bot comments done. Continuing with reviewer comments..."
56
52
 
57
53
  ### Phase 2: Developer comments
58
54
 
59
- Follow the full `fix-pr-developer-comments` instructions (see `.augment/commands/fix-pr-developer-comments.md`).
55
+ Follow the full `/fix pr-developers` instructions (see `commands/fix/pr-developers.md`).
60
56
  Use the same PR and mode.
61
57
 
62
58
  ### After both phases
@@ -1,19 +1,15 @@
1
1
  ---
2
- name: fix-references
2
+ name: fix:refs
3
+ cluster: fix
4
+ sub: refs
3
5
  description: Find and fix broken cross-references in .augment/ and agents/ files
4
6
  disable-model-invocation: true
5
7
  suggestion:
6
8
  eligible: false
7
9
  rationale: "Package-internal — only the event4u/agent-config repo runs this."
8
- superseded_by: fix refs
9
- deprecated_in: "1.15.0"
10
10
  ---
11
11
 
12
- > ⚠️ /fix-references is deprecated; use /fix refs instead.
13
- > 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).
14
-
15
- # fix-references
16
-
12
+ # /fix refs
17
13
  ## Instructions
18
14
 
19
15
  ### 1. Run the reference checker
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: fix-seeder
2
+ name: fix:seeder
3
+ cluster: fix
4
+ sub: seeder
3
5
  skills: [eloquent]
4
6
  description: Scan seeder data files for broken foreign key references — find constants used without getReference() and fix them
5
7
  disable-model-invocation: true
@@ -7,15 +9,9 @@ suggestion:
7
9
  eligible: true
8
10
  trigger_description: "the seeder is broken, foreign key errors in seeders"
9
11
  trigger_context: "seeder error output or recent edits in database/seeders/"
10
- superseded_by: fix seeder
11
- deprecated_in: "1.15.0"
12
12
  ---
13
13
 
14
- > ⚠️ /fix-seeder is deprecated; use /fix seeder 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
- # fix-seeder
18
-
14
+ # /fix seeder
19
15
  Scans all `PhpDataSeeder` data files for foreign key references that use raw seeder constants
20
16
  instead of `getReference()`. Raw constants don't trigger lazy initialization of the referenced
21
17
  seeder, causing "items not available" errors when seeders run in unpredictable order.
@@ -18,13 +18,13 @@ with a single entry point + sub-command dispatch.
18
18
 
19
19
  | Sub-command | Routes to | Purpose |
20
20
  |---|---|---|
21
- | `/fix ci` | `fix-ci.md` | Fetch CI errors from GitHub Actions and fix them |
22
- | `/fix refs` | `fix-references.md` | Find and fix broken cross-references in `.augment/` and `agents/` |
23
- | `/fix portability` | `fix-portability.md` | Find and fix project-specific references in shared `.augment/` files |
24
- | `/fix seeder` | `fix-seeder.md` | Scan seeder data files for broken FK references |
25
- | `/fix pr` | `fix-pr-comments.md` | Fix and reply to **all** open review comments (bots + humans) |
26
- | `/fix pr-bots` | `fix-pr-bot-comments.md` | Fix and reply to **bot** review comments only |
27
- | `/fix pr-developers` | `fix-pr-developer-comments.md` | Fix and reply to **human** reviewer comments only |
21
+ | `/fix ci` | `commands/fix/ci.md` | Fetch CI errors from GitHub Actions and fix them |
22
+ | `/fix refs` | `commands/fix/refs.md` | Find and fix broken cross-references in `.augment/` and `agents/` |
23
+ | `/fix portability` | `commands/fix/portability.md` | Find and fix project-specific references in shared `.augment/` files |
24
+ | `/fix seeder` | `commands/fix/seeder.md` | Scan seeder data files for broken FK references |
25
+ | `/fix pr` | `commands/fix/pr.md` | Fix and reply to **all** open review comments (bots + humans) |
26
+ | `/fix pr-bots` | `commands/fix/pr-bots.md` | Fix and reply to **bot** review comments only |
27
+ | `/fix pr-developers` | `commands/fix/pr-developers.md` | Fix and reply to **human** reviewer comments only |
28
28
 
29
29
  Sub-command names match the locked contract in
30
30
  [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
@@ -45,12 +45,6 @@ Sub-command names match the locked contract in
45
45
  > 6. pr-bots — address bot reviewer comments only
46
46
  > 7. pr-developers — address human reviewer comments only
47
47
 
48
- ## Migration
49
-
50
- The 7 standalone `/fix-*` commands continue to work for one release cycle as
51
- deprecation shims. They emit a notice and route to the same content. New
52
- invocations should use `/fix <sub>`.
53
-
54
48
  ## Rules
55
49
 
56
50
  - **Do NOT commit, push, or open a PR** unless the sub-command explicitly
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: do-and-judge
2
+ name: judge:on-diff
3
+ cluster: judge
4
+ sub: on-diff
3
5
  skills: [subagent-orchestration, verify-completion-evidence]
4
6
  description: Run a single change through an implementer→judge loop with a two-revision ceiling, then hand back to the user
5
7
  disable-model-invocation: true
@@ -8,8 +10,7 @@ suggestion:
8
10
  rationale: "Subagent orchestration — overlaps /work and judge skills; keep explicit."
9
11
  ---
10
12
 
11
- # do-and-judge
12
-
13
+ # /judge on-diff
13
14
  ## Instructions
14
15
 
15
16
  ### 1. Confirm scope
@@ -0,0 +1,90 @@
1
+ ---
2
+ name: judge:solo
3
+ cluster: judge
4
+ sub: solo
5
+ skills: [subagent-orchestration]
6
+ description: Run a standalone judge on an existing diff or code change — no implementer, no revision loop, verdict only
7
+ disable-model-invocation: true
8
+ suggestion:
9
+ eligible: false
10
+ rationale: "Sibling of /review-changes — eligibility routed there; keep this explicit."
11
+ ---
12
+
13
+ # /judge solo
14
+ ## Instructions
15
+
16
+ ### 1. Identify the target
17
+
18
+ The user invoked `/judge solo` on one of:
19
+
20
+ - The current working-tree diff (`git diff`)
21
+ - A specific commit range (`git diff A..B`)
22
+ - A PR by number or URL
23
+ - A single file or set of files
24
+
25
+ Confirm the target in one sentence before proceeding. Do not silently
26
+ assume the working tree.
27
+
28
+ ### 2. Gather the context
29
+
30
+ Collect what the judge needs:
31
+
32
+ - The diff in full
33
+ - The original task, ticket, or PR description
34
+ - Relevant acceptance criteria (tests, linter config, design doc)
35
+
36
+ If any of these is missing and the judgment would be shallow without
37
+ it, **stop** and ask.
38
+
39
+ ### 3. Resolve the judge model
40
+
41
+ Read `.agent-settings.yml`:
42
+
43
+ - `subagents.judge_model` → empty = one tier above session model
44
+
45
+ Unknown alias → stop. Silence is not a fallback.
46
+
47
+ ### 4. Invoke the judge
48
+
49
+ The judge reviews the diff against the task. Return one of:
50
+
51
+ | Verdict | Meaning |
52
+ |----------|----------------------------------------------|
53
+ | `apply` | Correct, complete, ready to land |
54
+ | `revise` | Specific issues listed — user decides next |
55
+ | `reject` | Fundamentally wrong approach |
56
+
57
+ Unlike `/judge on-diff`, this command does **not** loop — no revision
58
+ cycles. The verdict is the deliverable.
59
+
60
+ ### 5. Report
61
+
62
+ ```
63
+ Mode: judge (standalone)
64
+ Target: <diff | commit range | PR #N | files>
65
+ Judge: <resolved model>
66
+ Verdict: apply | revise | reject
67
+ Issues: <numbered list if revise/reject>
68
+ Next step: <what the user should do based on the verdict>
69
+ ```
70
+
71
+ ## Use this command when
72
+
73
+ - A diff already exists and the user wants a second opinion
74
+ - Reviewing someone else's PR before approving it
75
+ - Double-checking a change before opening a PR
76
+ - Stress-testing a refactor without committing to revisions
77
+
78
+ ## Do NOT
79
+
80
+ - NEVER apply the diff — this command judges only
81
+ - NEVER loop into a revision cycle — use `/judge on-diff` for that
82
+ - NEVER run the judge on an empty diff — fail fast
83
+ - NEVER silently fall back to the session model for the judge
84
+
85
+ ## See also
86
+
87
+ - [`subagent-orchestration`](../skills/subagent-orchestration/SKILL.md)
88
+ - [`/judge on-diff`](do-and-judge.md) — if a revision loop is wanted
89
+ - [`/review-changes`](review-changes.md) — human-oriented self-review
90
+ - [`role-contracts`](../../docs/guidelines/agent-infra/role-contracts.md#reviewer) — Reviewer mode output contract (Summary / Risks / Findings / Required actions / Verdict)
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: do-in-steps
2
+ name: judge:steps
3
+ cluster: judge
4
+ sub: steps
3
5
  skills: [subagent-orchestration, verify-completion-evidence]
4
6
  description: Execute an ordered plan step by step with a judge gate between steps — stops on first failed verdict
5
7
  disable-model-invocation: true
@@ -8,8 +10,7 @@ suggestion:
8
10
  rationale: "Subagent orchestration — overlaps /work and /roadmap-execute; keep explicit."
9
11
  ---
10
12
 
11
- # do-in-steps
12
-
13
+ # /judge steps
13
14
  ## Instructions
14
15
 
15
16
  ### 1. Confirm the plan