@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: agents-audit
2
+ name: agents:audit
3
+ cluster: agents
4
+ sub: audit
3
5
  description: Audits agents/ and module agents/ directories — finds outdated docs, structural issues, duplicates, orphaned overrides, and creates an improvement roadmap.
4
6
  skills: [agents-audit, agent-docs-writing, override-management, module-management]
5
7
  disable-model-invocation: true
@@ -9,8 +11,7 @@ suggestion:
9
11
  trigger_context: "stale files under agents/ or recent edits to .augment/ without doc updates"
10
12
  ---
11
13
 
12
- # /agents-audit
13
-
14
+ # /agents audit
14
15
  Audits all agent documentation across the project — root `agents/`, module `app/Modules/*/agents/`,
15
16
  and `agents/overrides/`.
16
17
 
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: agents-cleanup
2
+ name: agents:cleanup
3
+ cluster: agents
4
+ sub: cleanup
3
5
  skills: [agent-docs-writing]
4
6
  description: Execute cleanup actions from an agents-audit — move, merge, delete, and update agent docs
5
7
  disable-model-invocation: true
@@ -8,15 +10,19 @@ suggestion:
8
10
  rationale: "Consumes prior audit output; only meaningful right after /agents-audit."
9
11
  ---
10
12
 
11
- # agents-cleanup
12
-
13
+ # /agents cleanup
13
14
  ## Instructions
14
15
 
15
16
  ### 1. Check for audit roadmap
16
17
 
17
- - Check if `agents/roadmaps/agents-cleanup.md` exists (created by `/agents-audit`).
18
- - If yes → load it and show the phases.
19
- - If no → ask:
18
+ Check the audit-roadmap path created by `/agents audit`:
19
+
20
+ ```
21
+ agents/roadmaps/agents-cleanup.md
22
+ ```
23
+
24
+ - If it exists → load it and show the phases.
25
+ - If not → ask:
20
26
 
21
27
  ```
22
28
  ⚠️ No audit roadmap found.
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: agents-prepare
2
+ name: agents:prepare
3
+ cluster: agents
4
+ sub: prepare
3
5
  skills: [agent-docs-writing]
4
6
  description: Scaffold the agents/ directory structure with all required subdirectories and .gitkeep files
5
7
  disable-model-invocation: true
@@ -8,8 +10,7 @@ suggestion:
8
10
  rationale: "One-shot project scaffolding; only run during initial setup."
9
11
  ---
10
12
 
11
- # agents-prepare
12
-
13
+ # /agents prepare
13
14
  ## Instructions
14
15
 
15
16
  ### 1. Check project root
@@ -0,0 +1,46 @@
1
+ ---
2
+ name: agents
3
+ description: Agents-folder orchestrator — routes to audit, cleanup, prepare
4
+ cluster: agents
5
+ disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "audit agents folder, prepare agents structure, clean up agent docs"
9
+ trigger_context: "user wants to inspect, scaffold, or curate the agents/ tree"
10
+ ---
11
+
12
+ # /agents
13
+
14
+ Top-level orchestrator for the `/agents` family. Replaces 3 standalone
15
+ commands with a single entry point + sub-command dispatch.
16
+
17
+ ## Sub-commands
18
+
19
+ | Sub-command | Routes to | Purpose |
20
+ |---|---|---|
21
+ | `/agents audit` | `commands/agents/audit.md` | Audit `agents/` for outdated docs, duplicates, orphaned overrides |
22
+ | `/agents cleanup` | `commands/agents/cleanup.md` | Execute cleanup actions from a prior audit |
23
+ | `/agents prepare` | `commands/agents/prepare.md` | Scaffold the `agents/` directory structure |
24
+
25
+ Sub-command names match the locked contract in
26
+ [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
27
+
28
+ ## Dispatch
29
+
30
+ 1. Parse the user's argument: `/agents <sub-command> [args]`.
31
+ 2. Look up the sub-command in the table above.
32
+ 3. Load the body of the routed file and follow its `## Instructions` section
33
+ verbatim with the remaining args.
34
+ 4. If the sub-command is unknown or missing, print the table above and ask:
35
+
36
+ > 1. audit — find outdated docs, duplicates, orphaned overrides
37
+ > 2. cleanup — execute actions from a prior audit
38
+ > 3. prepare — scaffold the agents/ tree
39
+
40
+ ## Rules
41
+
42
+ - **Do NOT commit, push, or open a PR** unless the sub-command explicitly
43
+ authorizes it.
44
+ - **Do NOT chain sub-commands.** One `/agents <sub>` per turn.
45
+ - If the user invokes `/agents` with no argument, **show the menu** — do
46
+ not guess which sub-command they meant.
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: chat-history-checkpoint
2
+ name: chat-history:checkpoint
3
+ cluster: chat-history
4
+ sub: checkpoint
3
5
  description: Append a phase-boundary entry to .agent-chat-history — CHECKPOINT fallback for platforms without a native hook (Augment IDE, Cursor pre-1.7, Cline non-Mac/Linux). ~1s.
4
6
  disable-model-invocation: true
5
7
  suggestion:
@@ -7,11 +9,9 @@ suggestion:
7
9
  trigger_description: "User wants to flush a chat-history phase boundary on a CHECKPOINT-class platform (Augment IDE, Cursor < 1.7, Cline on Windows) — phrases like 'checkpoint chat history', 'log a phase boundary', 'manual chat-history append'."
8
10
  trigger_context: "chat_history.path == checkpoint AND a phase-shaped boundary just completed (decision recorded, multi-tool sequence finished, task-list item closed)."
9
11
  ---
10
-
11
12
  <!-- cloud_safe: noop -->
12
13
 
13
- # /chat-history-checkpoint
14
-
14
+ # /chat-history checkpoint
15
15
  Force-append a `phase`-typed entry to `.agent-chat-history`. CHECKPOINT
16
16
  fallback for platforms without native hooks — see
17
17
  [`agents/contexts/chat-history-platform-hooks.md`](../../../agents/contexts/chat-history-platform-hooks.md)
@@ -1,16 +1,16 @@
1
1
  ---
2
- name: chat-history-clear
2
+ name: chat-history:clear
3
+ cluster: chat-history
4
+ sub: clear
3
5
  description: Manually delete the persistent chat-history log — asks for confirmation, optionally archives to a timestamped backup before wiping
4
6
  disable-model-invocation: true
5
7
  suggestion:
6
8
  eligible: false
7
9
  rationale: "Destructive log wipe — must be deliberate."
8
10
  ---
9
-
10
11
  <!-- cloud_safe: noop -->
11
12
 
12
- # /chat-history-clear
13
-
13
+ # /chat-history clear
14
14
  Wipes `.agent-chat-history`. Use when the log is stale (wrong session),
15
15
  bloated beyond usefulness, or contains information you do not want
16
16
  persisted on disk.
@@ -1,16 +1,16 @@
1
1
  ---
2
- name: chat-history-resume
2
+ name: chat-history:resume
3
+ cluster: chat-history
4
+ sub: resume
3
5
  description: Load the persistent chat-history log into the current conversation — picks match/returning/foreign flow and supports resume, merge, replace, or continue
4
6
  disable-model-invocation: true
5
7
  suggestion:
6
8
  eligible: false
7
9
  rationale: "Explicit resume mechanic with foreign/returning state machine."
8
10
  ---
9
-
10
11
  <!-- cloud_safe: noop -->
11
12
 
12
- # /chat-history-resume
13
-
13
+ # /chat-history resume
14
14
  Reconnects the current conversation with an existing `.agent-chat-history`
15
15
  file. Depending on the 4-state ownership check, it routes to the right
16
16
  flow: silent summarize, adopt, merge, or replace.
@@ -0,0 +1,107 @@
1
+ ---
2
+ name: chat-history:show
3
+ cluster: chat-history
4
+ sub: show
5
+ description: Show the status of the persistent chat-history log — file size, entry count, header fingerprint, age, and the last few entries
6
+ disable-model-invocation: true
7
+ suggestion:
8
+ eligible: false
9
+ rationale: "Status display only; no NL trigger distinct from 'show status'."
10
+ ---
11
+ <!-- cloud_safe: noop -->
12
+
13
+ # /chat-history show
14
+ Inspect `.agent-chat-history` — the JSONL log maintained by the
15
+ [`chat-history`](../rules/chat-history-ownership.md) rule for crash recovery.
16
+
17
+ Shows:
18
+
19
+ - Whether the file exists and whether logging is currently enabled
20
+ - File size vs `max_size_kb`
21
+ - Header metadata: fingerprint preview, created-at, `frequency`
22
+ - Entry count and age of the oldest/newest entry
23
+ - A peek at the last 3–5 entries so the user can see what was captured
24
+
25
+ Read-only — this command never writes to the file.
26
+
27
+ ## When NOT to use
28
+
29
+ - Load the log back into the conversation for context →
30
+ [`/chat-history resume`](chat-history-resume.md).
31
+ - Wipe the file → [`/chat-history clear`](chat-history-clear.md).
32
+ - Configure logging behavior → edit `.agent-settings.yml` directly
33
+ (`chat_history.*`); see
34
+ [`layered-settings`](../../docs/guidelines/agent-infra/layered-settings.md#section-aware-merge-rules).
35
+
36
+ ## Steps
37
+
38
+ ### 1. Check if enabled
39
+
40
+ Read `chat_history.enabled` from `.agent-settings.yml`. If `false` or
41
+ the section is missing, say so and stop:
42
+
43
+ ```
44
+ > 📒 chat-history is disabled (chat_history.enabled = false).
45
+ > Set it to true in .agent-settings.yml to start logging.
46
+ ```
47
+
48
+ ### 2. Read status via helper
49
+
50
+ Run `scripts/chat_history.py status`. The helper returns a JSON object
51
+ with `exists`, `size_bytes`, `size_kb`, `entries`, `header`, and `path`.
52
+
53
+ If `exists: false`, tell the user the file has not been created yet —
54
+ it will be created on the next agent turn that writes an entry.
55
+
56
+ ### 3. Read last N entries
57
+
58
+ Run `scripts/chat_history.py read --last 5` (or equivalent — see the
59
+ helper's CLI). Capture timestamps and entry types without loading the
60
+ full file.
61
+
62
+ ### 4. Present the summary
63
+
64
+ Render a concise report:
65
+
66
+ ```
67
+ > 📒 chat-history status
68
+ >
69
+ > File: .agent-chat-history ({size_kb} KB / {max_size_kb} KB)
70
+ > Entries: {entries}
71
+ > Fingerprint:{short_fp} (session started {created_at_relative})
72
+ > Frequency: {frequency}
73
+ > Overflow: {on_overflow}
74
+ >
75
+ > Last entries:
76
+ > {ts_1} {type_1} {preview_1}
77
+ > {ts_2} {type_2} {preview_2}
78
+ > ...
79
+ ```
80
+
81
+ Keep previews short (≤ 60 chars). Do not render the full entry text
82
+ unless the user asks (avoids flooding the conversation with old log
83
+ data, see [`token-efficiency`](../rules/token-efficiency.md)).
84
+
85
+ ### 5. Offer follow-ups (optional)
86
+
87
+ If the file exists and the fingerprint does **not** match the current
88
+ session, suggest `/chat-history resume` to adopt it.
89
+
90
+ If the file is close to `max_size_kb` (> 80 %), mention it — the next
91
+ append may trigger overflow handling.
92
+
93
+ ## Gotchas
94
+
95
+ - `.agent-chat-history` is git-ignored. This command never commits.
96
+ - The helper is the only way to read the file — do not cat or parse
97
+ the JSONL directly; entry shape is owned by `scripts/chat_history.py`.
98
+ - If `exists: false` but the rule says logging is enabled, the file is
99
+ created lazily on the first append. That is expected — not an error.
100
+
101
+ ## See also
102
+
103
+ - [`chat-history`](../rules/chat-history-ownership.md) — the rule that writes the file
104
+ - [`/chat-history resume`](chat-history-resume.md) — adopt + load
105
+ - [`/chat-history clear`](chat-history-clear.md) — wipe
106
+ - [`agent-settings` template](../templates/agent-settings.md) — `chat_history.*` reference
107
+ - [`scripts/chat_history.py`](../../../scripts/chat_history.py) — helper API
@@ -1,107 +1,51 @@
1
1
  ---
2
2
  name: chat-history
3
- description: Show the status of the persistent chat-history logfile size, entry count, header fingerprint, age, and the last few entries
3
+ description: Chat-history orchestratorroutes to show, resume, clear, checkpoint
4
+ cluster: chat-history
4
5
  disable-model-invocation: true
5
6
  suggestion:
6
- eligible: false
7
- rationale: "Status display only; no NL trigger distinct from 'show status'."
7
+ eligible: true
8
+ trigger_description: "show chat-history status, resume from log, clear the chat-history file, append a checkpoint entry"
9
+ trigger_context: "user wants to inspect, restore, wipe, or manually flush .agent-chat-history"
8
10
  ---
9
11
 
10
12
  <!-- cloud_safe: noop -->
11
13
 
12
14
  # /chat-history
13
15
 
14
- Inspect `.agent-chat-history` the JSONL log maintained by the
15
- [`chat-history`](../rules/chat-history-ownership.md) rule for crash recovery.
16
+ Top-level orchestrator for the `/chat-history` family. Replaces 4
17
+ standalone commands with a single entry point + sub-command dispatch.
16
18
 
17
- Shows:
19
+ ## Sub-commands
18
20
 
19
- - Whether the file exists and whether logging is currently enabled
20
- - File size vs `max_size_kb`
21
- - Header metadata: fingerprint preview, created-at, `frequency`
22
- - Entry count and age of the oldest/newest entry
23
- - A peek at the last 3–5 entries so the user can see what was captured
21
+ | Sub-command | Routes to | Purpose |
22
+ |---|---|---|
23
+ | `/chat-history show` | `commands/chat-history/show.md` | Inspect the log — size, entries, fingerprint, last entries |
24
+ | `/chat-history resume` | `commands/chat-history/resume.md` | Adopt and load the persistent log into the current conversation |
25
+ | `/chat-history clear` | `commands/chat-history/clear.md` | Wipe the log (with optional archival backup) |
26
+ | `/chat-history checkpoint` | `commands/chat-history/checkpoint.md` | Append a phase-boundary entry on CHECKPOINT-class platforms |
24
27
 
25
- Read-only this command never writes to the file.
28
+ Sub-command names match the locked contract in
29
+ [`docs/contracts/command-clusters.md`](../../docs/contracts/command-clusters.md).
26
30
 
27
- ## When NOT to use
31
+ ## Dispatch
28
32
 
29
- - Load the log back into the conversation for context →
30
- [`/chat-history-resume`](chat-history-resume.md).
31
- - Wipe the file [`/chat-history-clear`](chat-history-clear.md).
32
- - Configure logging behavior edit `.agent-settings.yml` directly
33
- (`chat_history.*`); see
34
- [`layered-settings`](../../docs/guidelines/agent-infra/layered-settings.md#section-aware-merge-rules).
33
+ 1. Parse the user's argument: `/chat-history <sub-command> [args]`.
34
+ 2. Look up the sub-command in the table above.
35
+ 3. Load the body of the routed file and follow its `## Instructions`
36
+ (or `## Steps`) section verbatim with the remaining args.
37
+ 4. If the sub-command is unknown or missing, print the table above and
38
+ ask:
35
39
 
36
- ## Steps
40
+ > 1. show — inspect status, size, last entries
41
+ > 2. resume — adopt the log into the conversation
42
+ > 3. clear — wipe the file
43
+ > 4. checkpoint — append a phase-boundary entry
37
44
 
38
- ### 1. Check if enabled
45
+ ## Rules
39
46
 
40
- Read `chat_history.enabled` from `.agent-settings.yml`. If `false` or
41
- the section is missing, say so and stop:
42
-
43
- ```
44
- > 📒 chat-history is disabled (chat_history.enabled = false).
45
- > Set it to true in .agent-settings.yml to start logging.
46
- ```
47
-
48
- ### 2. Read status via helper
49
-
50
- Run `scripts/chat_history.py status`. The helper returns a JSON object
51
- with `exists`, `size_bytes`, `size_kb`, `entries`, `header`, and `path`.
52
-
53
- If `exists: false`, tell the user the file has not been created yet —
54
- it will be created on the next agent turn that writes an entry.
55
-
56
- ### 3. Read last N entries
57
-
58
- Run `scripts/chat_history.py read --last 5` (or equivalent — see the
59
- helper's CLI). Capture timestamps and entry types without loading the
60
- full file.
61
-
62
- ### 4. Present the summary
63
-
64
- Render a concise report:
65
-
66
- ```
67
- > 📒 chat-history status
68
- >
69
- > File: .agent-chat-history ({size_kb} KB / {max_size_kb} KB)
70
- > Entries: {entries}
71
- > Fingerprint:{short_fp} (session started {created_at_relative})
72
- > Frequency: {frequency}
73
- > Overflow: {on_overflow}
74
- >
75
- > Last entries:
76
- > {ts_1} {type_1} {preview_1}
77
- > {ts_2} {type_2} {preview_2}
78
- > ...
79
- ```
80
-
81
- Keep previews short (≤ 60 chars). Do not render the full entry text
82
- unless the user asks (avoids flooding the conversation with old log
83
- data, see [`token-efficiency`](../rules/token-efficiency.md)).
84
-
85
- ### 5. Offer follow-ups (optional)
86
-
87
- If the file exists and the fingerprint does **not** match the current
88
- session, suggest `/chat-history-resume` to adopt it.
89
-
90
- If the file is close to `max_size_kb` (> 80 %), mention it — the next
91
- append may trigger overflow handling.
92
-
93
- ## Gotchas
94
-
95
- - `.agent-chat-history` is git-ignored. This command never commits.
96
- - The helper is the only way to read the file — do not cat or parse
97
- the JSONL directly; entry shape is owned by `scripts/chat_history.py`.
98
- - If `exists: false` but the rule says logging is enabled, the file is
99
- created lazily on the first append. That is expected — not an error.
100
-
101
- ## See also
102
-
103
- - [`chat-history`](../rules/chat-history-ownership.md) — the rule that writes the file
104
- - [`/chat-history-resume`](chat-history-resume.md) — adopt + load
105
- - [`/chat-history-clear`](chat-history-clear.md) — wipe
106
- - [`agent-settings` template](../templates/agent-settings.md) — `chat_history.*` reference
107
- - [`scripts/chat_history.py`](../../../scripts/chat_history.py) — helper API
47
+ - **Do NOT commit, push, or open a PR** unless the sub-command
48
+ explicitly authorizes it.
49
+ - **Do NOT chain sub-commands.** One `/chat-history <sub>` per turn.
50
+ - If the user invokes `/chat-history` with no argument, **show the
51
+ menu** do not guess which sub-command they meant.
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: commit-in-chunks
2
+ name: commit:in-chunks
3
+ cluster: commit
4
+ sub: in-chunks
3
5
  skills: [git-workflow]
4
6
  description: Stage and commit all uncommitted changes in logical chunks WITHOUT confirmation — sibling of /commit for autonomous flows
5
7
  disable-model-invocation: true
@@ -9,14 +11,14 @@ suggestion:
9
11
  trigger_context: "autonomous mode active and uncommitted changes present"
10
12
  ---
11
13
 
12
- # commit-in-chunks
14
+ # /commit:in-chunks
13
15
 
14
16
  Auto-split and commit all local changes in one go. Use this when you
15
17
  want commits made without being asked to confirm each batch. Sibling
16
- of [`/commit`](commit.md), which presents the plan and waits for
18
+ of [`/commit`](../commit.md), which presents the plan and waits for
17
19
  approval. This command skips the approval step.
18
20
 
19
- Per [`autonomous-execution`](../rules/autonomous-execution.md), the
21
+ Per [`autonomous-execution`](../../rules/autonomous-execution.md), the
20
22
  agent does **not** commit on its own initiative — invoking this
21
23
  command is the user's explicit consent to commit.
22
24
 
@@ -42,7 +44,7 @@ If there are no uncommitted changes (staged or unstaged), report
42
44
 
43
45
  ### 3. Analyze and split
44
46
 
45
- Group changed files into logical units following [`/commit`](commit.md)
47
+ Group changed files into logical units following [`/commit`](../commit.md)
46
48
  step 3 grouping rules:
47
49
 
48
50
  - Same feature / fix → one commit.
@@ -59,7 +61,7 @@ Splitting rules:
59
61
  - **Tests go with the code they test** unless test-only changes are
60
62
  large and noisy.
61
63
 
62
- Generate commit messages per [`commit-conventions`](../rules/commit-conventions.md).
64
+ Generate commit messages per [`commit-conventions`](../../rules/commit-conventions.md).
63
65
 
64
66
  ### 4. Commit immediately
65
67
 
@@ -88,11 +90,11 @@ Include `git log --oneline -N` output for verification.
88
90
 
89
91
  ## Rules
90
92
 
91
- - **Never push** — pushing remains explicit per [`scope-control`](../rules/scope-control.md#git-operations--permission-gated).
93
+ - **Never push** — pushing remains explicit per [`scope-control`](../../rules/scope-control.md#git-operations--permission-gated).
92
94
  - **Never modify files** — only stage and commit existing changes.
93
95
  - **Do NOT add untracked files** unless they are clearly part of the
94
96
  change (check with `git status` first).
95
- - **Follow commit conventions** as defined in [`commit-conventions`](../rules/commit-conventions.md).
97
+ - **Follow commit conventions** as defined in [`commit-conventions`](../../rules/commit-conventions.md).
96
98
  - **Stop on first failure** — if `git commit` fails (hook rejection,
97
99
  pre-commit lint error), stop, report the error, and do not continue
98
100
  with the remaining planned commits. Leave staged files for the user
@@ -103,16 +105,16 @@ Include `git log --oneline -N` output for verification.
103
105
  ## When NOT to use
104
106
 
105
107
  - The user has not seen the diff yet and would benefit from review →
106
- use [`/commit`](commit.md) instead.
108
+ use [`/commit`](../commit.md) instead.
107
109
  - The diff includes large unrelated changes the user might want to
108
- reorganise → use [`/commit`](commit.md).
110
+ reorganise → use [`/commit`](../commit.md).
109
111
  - The repo has a pre-commit hook that requires manual response → fix
110
112
  the hook or use `/commit`.
111
113
 
112
114
  ## See also
113
115
 
114
- - [`/commit`](commit.md) — split + present plan + wait for approval
115
- - [`autonomous-execution`](../rules/autonomous-execution.md) — the
116
+ - [`/commit`](../commit.md) — split + present plan + wait for approval
117
+ - [`autonomous-execution`](../../rules/autonomous-execution.md) — the
116
118
  rule that defines the no-ask commit default this command opts out of
117
- - [`commit-conventions`](../rules/commit-conventions.md) — message
119
+ - [`commit-conventions`](../../rules/commit-conventions.md) — message
118
120
  format
@@ -1,5 +1,6 @@
1
1
  ---
2
2
  name: commit
3
+ cluster: commit
3
4
  skills: [git-workflow]
4
5
  description: Stage and commit all uncommitted changes — splits into logical commits following Conventional Commits
5
6
  disable-model-invocation: true
@@ -9,9 +10,28 @@ suggestion:
9
10
  trigger_context: "git status shows uncommitted changes"
10
11
  ---
11
12
 
12
- # commit
13
+ # /commit
13
14
 
14
- ## Instructions
15
+ Top-level entry point for the `/commit` family. Bare `/commit` runs the
16
+ interactive split-and-confirm flow described below. The `:in-chunks`
17
+ sub-command runs the same split logic without the confirmation prompt.
18
+
19
+ ## Sub-commands
20
+
21
+ | Sub-command | Routes to | Purpose |
22
+ |---|---|---|
23
+ | `/commit` (bare) | this file (`## Default flow`) | Interactive — split, present plan, wait for approval, commit |
24
+ | `/commit:in-chunks` | `commands/commit/in-chunks.md` | Autonomous — split and commit without confirmation |
25
+
26
+ ## Dispatch
27
+
28
+ 1. Parse the user's argument: `/commit[:<sub>] [args]`.
29
+ 2. Bare `/commit` → run the `## Default flow` below verbatim.
30
+ 3. `/commit:in-chunks` → load `commands/commit/in-chunks.md` and follow
31
+ its `## Instructions` section verbatim.
32
+ 4. Unknown sub-command → print the table above and ask which one.
33
+
34
+ ## Default flow
15
35
 
16
36
  ### 1. Detect uncommitted changes
17
37
 
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: context-create
2
+ name: context:create
3
+ cluster: context
4
+ sub: create
3
5
  skills: [agent-docs-writing]
4
6
  description: Analyze a codebase area and create a structured context document
5
7
  disable-model-invocation: true
@@ -9,8 +11,7 @@ suggestion:
9
11
  trigger_context: "working in a module without an agents/contexts/ doc"
10
12
  ---
11
13
 
12
- # context-create
13
-
14
+ # /context create
14
15
  ## Instructions
15
16
 
16
17
  ### 1. Ask what to document
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: context-refactor
2
+ name: context:refactor
3
+ cluster: context
4
+ sub: refactor
3
5
  skills: [agent-docs-writing]
4
6
  description: Analyze, update, and extend an existing context document
5
7
  disable-model-invocation: true
@@ -9,8 +11,7 @@ suggestion:
9
11
  trigger_context: "existing agents/contexts/*.md referenced in the prompt"
10
12
  ---
11
13
 
12
- # context-refactor
13
-
14
+ # /context refactor
14
15
  ## Instructions
15
16
 
16
17
  ### 1. Find the context
@@ -0,0 +1,44 @@
1
+ ---
2
+ name: context
3
+ description: Context orchestrator — routes to create, refactor
4
+ cluster: context
5
+ disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "create a context document, update an existing context, refactor a context file"
9
+ trigger_context: "user wants to author or restructure a context document"
10
+ ---
11
+
12
+ # /context
13
+
14
+ Top-level orchestrator for the `/context` 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
+ | `/context create` | `commands/context/create.md` | Analyze a codebase area and create a structured context document |
22
+ | `/context refactor` | `commands/context/refactor.md` | Analyze, update, and extend an existing context document |
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: `/context <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 context document
36
+ > 2. refactor — update an existing context document
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 `/context <sub>` per turn.
43
+ - If the user invokes `/context` with no argument, **show the menu** — do
44
+ not guess which sub-command they meant.
@@ -1,5 +1,7 @@
1
1
  ---
2
- name: copilot-agents-init
2
+ name: copilot-agents:init
3
+ cluster: copilot-agents
4
+ sub: init
3
5
  description: Create AGENTS.md and .github/copilot-instructions.md from scratch in the consumer project — interactive, auto-detects stack, never leaks other projects' identifiers.
4
6
  skills: [copilot-config, copilot-agents-optimization, agent-docs-writing]
5
7
  disable-model-invocation: true
@@ -8,8 +10,7 @@ suggestion:
8
10
  rationale: "Project init — only deliberately during onboarding."
9
11
  ---
10
12
 
11
- # /copilot-agents-init
12
-
13
+ # /copilot-agents init
13
14
  Interactive initializer that **creates** `AGENTS.md` and
14
15
  `.github/copilot-instructions.md` in the consumer project from the
15
16
  package-shipped templates (`.augment/templates/AGENTS.md` and