@event4u/agent-config 1.12.0 → 1.14.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 (260) hide show
  1. package/.agent-src/commands/agent-handoff.md +3 -0
  2. package/.agent-src/commands/agent-status.md +3 -0
  3. package/.agent-src/commands/agents-audit.md +4 -0
  4. package/.agent-src/commands/agents-cleanup.md +6 -1
  5. package/.agent-src/commands/agents-prepare.md +3 -0
  6. package/.agent-src/commands/analyze-reference-repo.md +4 -0
  7. package/.agent-src/commands/bug-fix.md +5 -1
  8. package/.agent-src/commands/bug-investigate.md +4 -0
  9. package/.agent-src/commands/chat-history-checkpoint.md +126 -0
  10. package/.agent-src/commands/chat-history-clear.md +5 -0
  11. package/.agent-src/commands/chat-history-resume.md +5 -0
  12. package/.agent-src/commands/chat-history.md +5 -0
  13. package/.agent-src/commands/check-current-md.md +126 -0
  14. package/.agent-src/commands/commit-in-chunks.md +98 -0
  15. package/.agent-src/commands/commit.md +4 -0
  16. package/.agent-src/commands/compress.md +3 -0
  17. package/.agent-src/commands/context-create.md +4 -0
  18. package/.agent-src/commands/context-refactor.md +4 -0
  19. package/.agent-src/commands/copilot-agents-init.md +3 -0
  20. package/.agent-src/commands/copilot-agents-optimize.md +3 -0
  21. package/.agent-src/commands/create-pr-description.md +4 -0
  22. package/.agent-src/commands/create-pr.md +4 -0
  23. package/.agent-src/commands/do-and-judge.md +4 -1
  24. package/.agent-src/commands/do-in-steps.md +3 -0
  25. package/.agent-src/commands/e2e-heal.md +4 -0
  26. package/.agent-src/commands/e2e-plan.md +4 -0
  27. package/.agent-src/commands/estimate-ticket.md +4 -1
  28. package/.agent-src/commands/feature-dev.md +4 -0
  29. package/.agent-src/commands/feature-explore.md +4 -0
  30. package/.agent-src/commands/feature-plan.md +4 -0
  31. package/.agent-src/commands/feature-refactor.md +4 -0
  32. package/.agent-src/commands/feature-roadmap.md +6 -0
  33. package/.agent-src/commands/fix-ci.md +4 -0
  34. package/.agent-src/commands/fix-portability.md +3 -0
  35. package/.agent-src/commands/fix-pr-bot-comments.md +4 -0
  36. package/.agent-src/commands/fix-pr-comments.md +4 -0
  37. package/.agent-src/commands/fix-pr-developer-comments.md +4 -0
  38. package/.agent-src/commands/fix-references.md +3 -0
  39. package/.agent-src/commands/fix-seeder.md +4 -0
  40. package/.agent-src/commands/implement-ticket.md +39 -13
  41. package/.agent-src/commands/jira-ticket.md +4 -0
  42. package/.agent-src/commands/judge.md +3 -0
  43. package/.agent-src/commands/memory-add.md +5 -3
  44. package/.agent-src/commands/memory-full.md +5 -2
  45. package/.agent-src/commands/memory-promote.md +7 -6
  46. package/.agent-src/commands/mode.md +3 -0
  47. package/.agent-src/commands/module-create.md +4 -0
  48. package/.agent-src/commands/module-explore.md +4 -0
  49. package/.agent-src/commands/onboard.md +24 -0
  50. package/.agent-src/commands/optimize-agents.md +4 -0
  51. package/.agent-src/commands/optimize-augmentignore.md +3 -0
  52. package/.agent-src/commands/optimize-rtk-filters.md +3 -0
  53. package/.agent-src/commands/optimize-skills.md +4 -0
  54. package/.agent-src/commands/override-create.md +4 -0
  55. package/.agent-src/commands/override-manage.md +4 -0
  56. package/.agent-src/commands/package-reset.md +3 -0
  57. package/.agent-src/commands/package-test.md +3 -0
  58. package/.agent-src/commands/prepare-for-review.md +4 -0
  59. package/.agent-src/commands/project-analyze.md +4 -0
  60. package/.agent-src/commands/project-health.md +4 -0
  61. package/.agent-src/commands/propose-memory.md +6 -8
  62. package/.agent-src/commands/quality-fix.md +4 -0
  63. package/.agent-src/commands/refine-ticket.md +4 -1
  64. package/.agent-src/commands/review-changes.md +4 -0
  65. package/.agent-src/commands/review-routing.md +4 -0
  66. package/.agent-src/commands/roadmap-create.md +7 -0
  67. package/.agent-src/commands/roadmap-execute.md +12 -1
  68. package/.agent-src/commands/rule-compliance-audit.md +4 -0
  69. package/.agent-src/commands/set-cost-profile.md +3 -0
  70. package/.agent-src/commands/sync-agent-settings.md +3 -0
  71. package/.agent-src/commands/sync-gitignore.md +3 -0
  72. package/.agent-src/commands/tests-create.md +4 -0
  73. package/.agent-src/commands/tests-execute.md +4 -0
  74. package/.agent-src/commands/threat-model.md +4 -0
  75. package/.agent-src/commands/update-form-request-messages.md +4 -0
  76. package/.agent-src/commands/upstream-contribute.md +4 -0
  77. package/.agent-src/commands/work.md +161 -0
  78. package/.agent-src/guidelines/agent-infra/engineering-memory-data-format.md +2 -6
  79. package/.agent-src/guidelines/agent-infra/layered-settings.md +0 -1
  80. package/.agent-src/guidelines/agent-infra/memory-access.md +0 -7
  81. package/.agent-src/guidelines/agent-infra/role-contracts.md +2 -4
  82. package/.agent-src/guidelines/agent-infra/self-improvement-pipeline.md +0 -1
  83. package/.agent-src/guidelines/php/patterns/strategy.md +180 -2
  84. package/.agent-src/personas/README.md +0 -1
  85. package/.agent-src/rules/artifact-drafting-protocol.md +7 -2
  86. package/.agent-src/rules/artifact-engagement-recording.md +133 -0
  87. package/.agent-src/rules/ask-when-uncertain.md +18 -13
  88. package/.agent-src/rules/augment-portability.md +8 -0
  89. package/.agent-src/rules/autonomous-execution.md +158 -0
  90. package/.agent-src/rules/chat-history.md +147 -118
  91. package/.agent-src/rules/cli-output-handling.md +26 -3
  92. package/.agent-src/rules/command-suggestion.md +133 -0
  93. package/.agent-src/rules/commit-policy.md +99 -0
  94. package/.agent-src/rules/direct-answers.md +114 -0
  95. package/.agent-src/rules/docs-sync.md +36 -0
  96. package/.agent-src/rules/downstream-changes.md +10 -9
  97. package/.agent-src/rules/improve-before-implement.md +9 -6
  98. package/.agent-src/rules/language-and-tone.md +81 -6
  99. package/.agent-src/rules/non-destructive-by-default.md +117 -0
  100. package/.agent-src/rules/package-ci-checks.md +4 -0
  101. package/.agent-src/rules/preservation-guard.md +20 -0
  102. package/.agent-src/rules/roadmap-progress-sync.md +103 -30
  103. package/.agent-src/rules/scope-control.md +42 -1
  104. package/.agent-src/rules/size-enforcement.md +1 -3
  105. package/.agent-src/rules/skill-quality.md +3 -8
  106. package/.agent-src/rules/ui-audit-before-build.md +106 -0
  107. package/.agent-src/rules/user-interaction.md +81 -3
  108. package/.agent-src/scripts/update_roadmap_progress.py +48 -6
  109. package/.agent-src/skills/blade-ui/SKILL.md +30 -5
  110. package/.agent-src/skills/command-routing/SKILL.md +32 -0
  111. package/.agent-src/skills/command-writing/SKILL.md +41 -2
  112. package/.agent-src/skills/description-assist/SKILL.md +21 -0
  113. package/.agent-src/skills/estimate-ticket/SKILL.md +0 -1
  114. package/.agent-src/skills/existing-ui-audit/SKILL.md +187 -0
  115. package/.agent-src/skills/fe-design/SKILL.md +72 -60
  116. package/.agent-src/skills/finishing-a-development-branch/SKILL.md +4 -0
  117. package/.agent-src/skills/flux/SKILL.md +31 -4
  118. package/.agent-src/skills/guideline-writing/SKILL.md +24 -2
  119. package/.agent-src/skills/learning-to-rule-or-skill/SKILL.md +51 -9
  120. package/.agent-src/skills/livewire/SKILL.md +30 -4
  121. package/.agent-src/skills/md-language-check/SKILL.md +103 -0
  122. package/.agent-src/skills/php-coder/SKILL.md +24 -0
  123. package/.agent-src/skills/react-shadcn-ui/SKILL.md +121 -0
  124. package/.agent-src/skills/refine-prompt/SKILL.md +220 -0
  125. package/.agent-src/skills/refine-ticket/SKILL.md +2 -4
  126. package/.agent-src/skills/roadmap-management/SKILL.md +10 -3
  127. package/.agent-src/skills/rule-writing/SKILL.md +23 -1
  128. package/.agent-src/skills/skill-writing/SKILL.md +1 -3
  129. package/.agent-src/skills/upstream-contribute/SKILL.md +1 -1
  130. package/.agent-src/skills/using-git-worktrees/SKILL.md +3 -1
  131. package/.agent-src/templates/AGENTS.md +24 -6
  132. package/.agent-src/templates/agent-settings.md +149 -0
  133. package/.agent-src/templates/github-workflows/roadmap-progress-check.yml +63 -0
  134. package/.agent-src/templates/hooks/pre-commit-roadmap-progress +60 -0
  135. package/.agent-src/templates/roadmaps.md +8 -2
  136. package/.agent-src/templates/scripts/implement_ticket/__init__.py +63 -26
  137. package/.agent-src/templates/scripts/implement_ticket/__main__.py +8 -2
  138. package/.agent-src/templates/scripts/memory_lookup.py +382 -21
  139. package/.agent-src/templates/scripts/memory_status.py +110 -9
  140. package/.agent-src/templates/scripts/telemetry/__init__.py +42 -0
  141. package/.agent-src/templates/scripts/telemetry/aggregator.py +154 -0
  142. package/.agent-src/templates/scripts/telemetry/boundary.py +171 -0
  143. package/.agent-src/templates/scripts/telemetry/engagement.py +238 -0
  144. package/.agent-src/templates/scripts/telemetry/report_renderer.py +170 -0
  145. package/.agent-src/templates/scripts/telemetry/settings.py +112 -0
  146. package/.agent-src/templates/scripts/telemetry_record.py +166 -0
  147. package/.agent-src/templates/scripts/telemetry_report.py +161 -0
  148. package/.agent-src/templates/scripts/telemetry_status.py +142 -0
  149. package/.agent-src/templates/scripts/work_engine/__init__.py +58 -0
  150. package/.agent-src/templates/scripts/work_engine/__main__.py +9 -0
  151. package/.agent-src/templates/scripts/work_engine/cli.py +592 -0
  152. package/.agent-src/templates/scripts/{implement_ticket → work_engine}/delivery_state.py +7 -0
  153. package/.agent-src/templates/scripts/work_engine/directives/__init__.py +33 -0
  154. package/.agent-src/templates/scripts/work_engine/directives/backend/__init__.py +98 -0
  155. package/.agent-src/templates/scripts/{implement_ticket/steps → work_engine/directives/backend}/analyze.py +1 -1
  156. package/.agent-src/templates/scripts/{implement_ticket/steps → work_engine/directives/backend}/implement.py +2 -2
  157. package/.agent-src/templates/scripts/{implement_ticket/steps → work_engine/directives/backend}/memory.py +1 -1
  158. package/.agent-src/templates/scripts/{implement_ticket/steps → work_engine/directives/backend}/plan.py +1 -1
  159. package/.agent-src/templates/scripts/work_engine/directives/backend/refine.py +396 -0
  160. package/.agent-src/templates/scripts/{implement_ticket/steps → work_engine/directives/backend}/report.py +36 -4
  161. package/.agent-src/templates/scripts/{implement_ticket/steps → work_engine/directives/backend}/test.py +2 -2
  162. package/.agent-src/templates/scripts/{implement_ticket/steps → work_engine/directives/backend}/verify.py +2 -2
  163. package/.agent-src/templates/scripts/work_engine/directives/mixed/__init__.py +116 -0
  164. package/.agent-src/templates/scripts/work_engine/directives/mixed/contract.py +254 -0
  165. package/.agent-src/templates/scripts/work_engine/directives/mixed/stitch.py +229 -0
  166. package/.agent-src/templates/scripts/work_engine/directives/mixed/ui.py +231 -0
  167. package/.agent-src/templates/scripts/work_engine/directives/ui/__init__.py +113 -0
  168. package/.agent-src/templates/scripts/work_engine/directives/ui/_passthrough.py +44 -0
  169. package/.agent-src/templates/scripts/work_engine/directives/ui/apply.py +241 -0
  170. package/.agent-src/templates/scripts/work_engine/directives/ui/audit.py +414 -0
  171. package/.agent-src/templates/scripts/work_engine/directives/ui/design.py +335 -0
  172. package/.agent-src/templates/scripts/work_engine/directives/ui/polish.py +510 -0
  173. package/.agent-src/templates/scripts/work_engine/directives/ui/review.py +468 -0
  174. package/.agent-src/templates/scripts/work_engine/directives/ui_trivial/__init__.py +119 -0
  175. package/.agent-src/templates/scripts/work_engine/directives/ui_trivial/_skipped.py +37 -0
  176. package/.agent-src/templates/scripts/work_engine/directives/ui_trivial/apply.py +165 -0
  177. package/.agent-src/templates/scripts/work_engine/directives/ui_trivial/refine.py +66 -0
  178. package/.agent-src/templates/scripts/work_engine/directives/ui_trivial/report.py +62 -0
  179. package/.agent-src/templates/scripts/work_engine/directives/ui_trivial/test.py +115 -0
  180. package/.agent-src/templates/scripts/work_engine/dispatcher.py +331 -0
  181. package/.agent-src/templates/scripts/work_engine/hooks/__init__.py +54 -0
  182. package/.agent-src/templates/scripts/work_engine/hooks/builtin/__init__.py +32 -0
  183. package/.agent-src/templates/scripts/work_engine/hooks/builtin/_chat_history_base.py +103 -0
  184. package/.agent-src/templates/scripts/work_engine/hooks/builtin/chat_history_append.py +44 -0
  185. package/.agent-src/templates/scripts/work_engine/hooks/builtin/chat_history_halt_append.py +42 -0
  186. package/.agent-src/templates/scripts/work_engine/hooks/builtin/chat_history_heartbeat.py +50 -0
  187. package/.agent-src/templates/scripts/work_engine/hooks/builtin/chat_history_turn_check.py +49 -0
  188. package/.agent-src/templates/scripts/work_engine/hooks/builtin/directive_set_guard.py +53 -0
  189. package/.agent-src/templates/scripts/work_engine/hooks/builtin/halt_surface_audit.py +50 -0
  190. package/.agent-src/templates/scripts/work_engine/hooks/builtin/state_shape_validation.py +52 -0
  191. package/.agent-src/templates/scripts/work_engine/hooks/builtin/trace.py +84 -0
  192. package/.agent-src/templates/scripts/work_engine/hooks/context.py +66 -0
  193. package/.agent-src/templates/scripts/work_engine/hooks/events.py +44 -0
  194. package/.agent-src/templates/scripts/work_engine/hooks/exceptions.py +79 -0
  195. package/.agent-src/templates/scripts/work_engine/hooks/registry.py +60 -0
  196. package/.agent-src/templates/scripts/work_engine/hooks/runner.py +73 -0
  197. package/.agent-src/templates/scripts/work_engine/hooks/settings.py +141 -0
  198. package/.agent-src/templates/scripts/work_engine/intent/__init__.py +47 -0
  199. package/.agent-src/templates/scripts/work_engine/intent/classify.py +280 -0
  200. package/.agent-src/templates/scripts/work_engine/migration/__init__.py +8 -0
  201. package/.agent-src/templates/scripts/work_engine/migration/v0_to_v1.py +199 -0
  202. package/.agent-src/templates/scripts/work_engine/resolvers/__init__.py +22 -0
  203. package/.agent-src/templates/scripts/work_engine/resolvers/diff.py +106 -0
  204. package/.agent-src/templates/scripts/work_engine/resolvers/file.py +113 -0
  205. package/.agent-src/templates/scripts/work_engine/resolvers/prompt.py +90 -0
  206. package/.agent-src/templates/scripts/work_engine/scoring/__init__.py +14 -0
  207. package/.agent-src/templates/scripts/work_engine/scoring/confidence.py +300 -0
  208. package/.agent-src/templates/scripts/work_engine/stack/__init__.py +31 -0
  209. package/.agent-src/templates/scripts/work_engine/stack/detect.py +187 -0
  210. package/.agent-src/templates/scripts/work_engine/state.py +641 -0
  211. package/.claude-plugin/marketplace.json +105 -2
  212. package/AGENTS.md +36 -8
  213. package/CHANGELOG.md +558 -0
  214. package/README.md +146 -4
  215. package/composer.json +3 -0
  216. package/config/agent-settings.template.yml +45 -0
  217. package/config/gitignore-block.txt +4 -0
  218. package/docs/architecture.md +28 -1
  219. package/docs/development.md +1 -1
  220. package/docs/getting-started.md +3 -2
  221. package/docs/installation.md +86 -0
  222. package/docs/showcase.md +204 -0
  223. package/package.json +9 -1
  224. package/scripts/agent-config +274 -0
  225. package/scripts/audit_cloud_compatibility.py +288 -0
  226. package/scripts/build_cloud_bundle.py +458 -0
  227. package/scripts/build_linear_digest.py +263 -0
  228. package/scripts/chat_history.py +796 -7
  229. package/scripts/check_compression.py +139 -0
  230. package/scripts/check_iron_law_prominence.py +143 -0
  231. package/scripts/check_md_language.py +159 -0
  232. package/scripts/check_portability.py +36 -0
  233. package/scripts/check_reply_consistency.py +140 -0
  234. package/scripts/command_suggester/__init__.py +51 -0
  235. package/scripts/command_suggester/cooldown.py +132 -0
  236. package/scripts/command_suggester/loader.py +70 -0
  237. package/scripts/command_suggester/match.py +180 -0
  238. package/scripts/command_suggester/rank.py +120 -0
  239. package/scripts/command_suggester/render.py +86 -0
  240. package/scripts/command_suggester/sanitize.py +113 -0
  241. package/scripts/command_suggester/settings.py +125 -0
  242. package/scripts/command_suggester/types.py +78 -0
  243. package/scripts/hooks/augment-chat-history.sh +56 -0
  244. package/scripts/install-hooks.sh +67 -0
  245. package/scripts/install.py +150 -33
  246. package/scripts/lint_marketplace.py +27 -0
  247. package/scripts/memory_lookup.py +143 -7
  248. package/scripts/memory_status.py +76 -14
  249. package/scripts/migrate_command_suggestions.py +151 -0
  250. package/scripts/postinstall.sh +16 -0
  251. package/scripts/schemas/command.schema.json +41 -0
  252. package/scripts/skill_linter.py +67 -0
  253. package/scripts/sync_agent_settings.py +42 -12
  254. package/templates/consumer-settings/augment-cli-hooks.json +54 -0
  255. package/templates/consumer-settings/claude-settings.json +55 -1
  256. package/.agent-src/templates/scripts/implement_ticket/cli.py +0 -171
  257. package/.agent-src/templates/scripts/implement_ticket/dispatcher.py +0 -134
  258. package/.agent-src/templates/scripts/implement_ticket/steps/__init__.py +0 -49
  259. package/.agent-src/templates/scripts/implement_ticket/steps/refine.py +0 -140
  260. /package/.agent-src/templates/scripts/{implement_ticket → work_engine}/persona_policy.py +0 -0
@@ -3,6 +3,9 @@ name: agent-handoff
3
3
  skills: [agent-docs-writing]
4
4
  description: Generate a context summary for continuing work in a fresh chat. Replaces the session system.
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: false
8
+ rationale: "Explicit fresh-chat handoff — must be deliberate, never inferred from prose."
6
9
  ---
7
10
 
8
11
  # /agent-handoff
@@ -3,6 +3,9 @@ name: agent-status
3
3
  skills: [agent-docs-writing]
4
4
  description: Show current conversation stats — message count, token costs, task progress, next freshness check.
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: false
8
+ rationale: "Pure status display; no natural-language trigger distinct from idle small-talk."
6
9
  ---
7
10
 
8
11
  # /agent-status
@@ -3,6 +3,10 @@ name: agents-audit
3
3
  description: Audits agents/ and module agents/ directories — finds outdated docs, structural issues, duplicates, orphaned overrides, and creates an improvement roadmap.
4
4
  skills: [agents-audit, agent-docs-writing, override-management, module-management]
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "audit my agent docs, check the state of the agents/ directory"
9
+ trigger_context: "stale files under agents/ or recent edits to .augment/ without doc updates"
6
10
  ---
7
11
 
8
12
  # /agents-audit
@@ -3,6 +3,9 @@ name: agents-cleanup
3
3
  skills: [agent-docs-writing]
4
4
  description: Execute cleanup actions from an agents-audit — move, merge, delete, and update agent docs
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: false
8
+ rationale: "Consumes prior audit output; only meaningful right after /agents-audit."
6
9
  ---
7
10
 
8
11
  # agents-cleanup
@@ -18,10 +21,12 @@ disable-model-invocation: true
18
21
  ```
19
22
  ⚠️ No audit roadmap found.
20
23
 
21
- 1. 🔍 Run /agents-audit first (recommended)
24
+ 1. 🔍 Run /agents-audit first
22
25
  2. 💬 I know what to do — start directly
23
26
  ```
24
27
 
28
+ **Recommendation: 1 — Run /agents-audit first** — without an audit roadmap, the cleanup is shooting in the dark. Caveat: pick 2 only if you already know exactly which docs to touch.
29
+
25
30
  If option 2, ask what to clean up.
26
31
 
27
32
  ### 2. Show action plan
@@ -3,6 +3,9 @@ name: agents-prepare
3
3
  skills: [agent-docs-writing]
4
4
  description: Scaffold the agents/ directory structure with all required subdirectories and .gitkeep files
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: false
8
+ rationale: "One-shot project scaffolding; only run during initial setup."
6
9
  ---
7
10
 
8
11
  # agents-prepare
@@ -3,6 +3,10 @@ name: analyze-reference-repo
3
3
  skills: [project-analyzer, learning-to-rule-or-skill]
4
4
  description: Analyze an external reference repository (competitor, inspiration, peer) and produce a structured comparison + adoption plan for this project.
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "look at how X does this, compare with that other repo, study this competitor's approach"
9
+ trigger_context: "external repo URL or path mentioned in the prompt"
6
10
  ---
7
11
 
8
12
  # analyze-reference-repo
@@ -3,6 +3,10 @@ name: bug-fix
3
3
  skills: [bug-analyzer, pest-testing]
4
4
  description: Plan and implement a bug fix — based on investigation, with quality checks and test verification
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "fix this bug, patch the issue, resolve this error"
9
+ trigger_context: "branch name matches fix/* or bug/*"
6
10
  ---
7
11
 
8
12
  # bug-fix
@@ -142,7 +146,7 @@ If the root cause is a recognizable pattern (not a one-off typo),
142
146
  drop a `historical-patterns` signal so future work benefits:
143
147
 
144
148
  ```bash
145
- python3 scripts/memory_signal.py \
149
+ ./agent-config memory:signal \
146
150
  --type historical-patterns \
147
151
  --path "<primary affected file>" \
148
152
  --body "<root cause → fix, one sentence>" \
@@ -3,6 +3,10 @@ name: bug-investigate
3
3
  skills: [bug-analyzer, sentry-integration]
4
4
  description: Investigate a bug — auto-detect ticket from branch, gather Jira/Sentry/description context, trace root cause
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "why is this broken, investigate this error, trace the root cause"
9
+ trigger_context: "Sentry URL, Jira bug ticket key, or stack trace pasted in the prompt"
6
10
  ---
7
11
 
8
12
  # bug-investigate
@@ -0,0 +1,126 @@
1
+ ---
2
+ name: chat-history-checkpoint
3
+ description: Append a phase-boundary entry to .agent-chat-history — the CHECKPOINT fallback for platforms without a native hook surface (Augment Code IDE plugin, Cursor non-1.7+, Cline non-Mac/Linux). Cooperative gate, ~1 second to run.
4
+ disable-model-invocation: true
5
+ suggestion:
6
+ eligible: true
7
+ 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
+ trigger_context: "chat_history.path == checkpoint AND a phase-shaped boundary just completed (decision recorded, multi-tool sequence finished, task-list item closed)."
9
+ ---
10
+
11
+ <!-- cloud_safe: noop -->
12
+
13
+ # /chat-history-checkpoint
14
+
15
+ Force-append a `phase`-typed entry to `.agent-chat-history`. CHECKPOINT
16
+ fallback for platforms without native hooks — see
17
+ [`agents/contexts/chat-history-platform-hooks.md`](../../../agents/contexts/chat-history-platform-hooks.md)
18
+ for the per-platform classification.
19
+
20
+ Use this at decision points, end of phase, or after a meaningful tool
21
+ sequence on a CHECKPOINT/MANUAL platform. On HOOK platforms (Claude
22
+ Code, Augment CLI, Cursor 1.7+, Cline non-Windows, Windsurf, Gemini
23
+ CLI), the platform fires hooks automatically — manual use is allowed
24
+ but rarely needed.
25
+
26
+ ## When to use
27
+
28
+ - IDE plugin without hooks (Augment Code IDE plugin as of 2026-04-30).
29
+ - Long-running tool sequence on any platform that did not flush.
30
+ - Explicit phase-boundary marker after a multi-tool refactor.
31
+ - Crash-recovery rehearsal — verifies the append path works before a
32
+ real outage.
33
+
34
+ ## When NOT to use
35
+
36
+ - HOOK platform mid-session — the platform already records turn-level
37
+ cadence; an extra checkpoint just adds noise.
38
+ - After every line of agent output — that's `per_turn` cadence and is
39
+ configured in `.agent-settings.yml`, not via this command.
40
+ - To inspect the log → [`/chat-history`](chat-history.md).
41
+ - To wipe the log → [`/chat-history-clear`](chat-history-clear.md).
42
+ - To reload the log into context → [`/chat-history-resume`](chat-history-resume.md).
43
+
44
+ ## Steps
45
+
46
+ ### 1. Check if enabled
47
+
48
+ Read `chat_history.enabled` from `.agent-settings.yml`. If `false` or
49
+ the section is missing, say so and stop:
50
+
51
+ ```
52
+ > 📒 chat-history is disabled (chat_history.enabled = false).
53
+ > Nothing to checkpoint. Enable in .agent-settings.yml first.
54
+ ```
55
+
56
+ ### 2. Determine the phase label
57
+
58
+ Pick a short label (2–6 words) that names what just happened:
59
+
60
+ - "phase-1-done", "refactor-extracted", "tests-green",
61
+ "review-comments-fixed", "merge-ready".
62
+
63
+ If the user invoked the command without context, ask once with
64
+ numbered options per [`user-interaction`](../rules/user-interaction.md):
65
+
66
+ ```
67
+ > 1. Use a free-text label — type 2–6 words for the checkpoint
68
+ > 2. Use a generic "manual-checkpoint" label
69
+ > 3. Skip — close without writing
70
+ ```
71
+
72
+ ### 3. Append the checkpoint
73
+
74
+ Invoke the master CLI:
75
+
76
+ ```
77
+ ./agent-config chat-history:checkpoint \
78
+ --first-user-msg "<the conversation's first user message>" \
79
+ --payload '{"phase": "<label>"}'
80
+ ```
81
+
82
+ The wrapper delegates to `scripts/chat_history.py hook-append --event phase`,
83
+ which performs cadence filtering and ownership checks. Cadence is read
84
+ from `chat_history.frequency` in `.agent-settings.yml` — `per_turn` /
85
+ `per_phase` / `per_tool`. `per_tool` cadence drops the `phase` event;
86
+ say so explicitly if that is the active mode.
87
+
88
+ ### 4. Confirm
89
+
90
+ Render a one-line confirmation, mirroring the user's language:
91
+
92
+ ```
93
+ > 📒 Checkpoint logged: <label> (entries: N → N+1)
94
+ ```
95
+
96
+ If the helper returned `skipped_cadence`, surface it:
97
+
98
+ ```
99
+ > 📒 Checkpoint skipped — current cadence is per_tool, phase events are dropped.
100
+ > Switch chat_history.frequency to per_phase or per_turn to capture phase boundaries.
101
+ ```
102
+
103
+ ## Gotchas
104
+
105
+ - The command writes through the same ownership-state machine as
106
+ hooks — a `foreign` log triggers the
107
+ [`chat-history`](../rules/chat-history.md) Foreign-Prompt before any
108
+ append. This is intentional; the checkpoint must not silently
109
+ hijack another session's log.
110
+ - The `phase` payload key is required. Other keys are accepted but
111
+ ignored by the JSONL schema (forward-compat — they may be promoted
112
+ to first-class fields later).
113
+ - On HOOK platforms, hook entries and checkpoint entries coexist
114
+ cleanly. The schema does not deduplicate; if you checkpoint
115
+ immediately after a hook fires, expect two adjacent entries with
116
+ different `source` values.
117
+
118
+ ## See also
119
+
120
+ - [`chat-history`](../rules/chat-history.md) — the rule defining the
121
+ conditional Iron Law (HOOK platforms vs CHECKPOINT/MANUAL platforms)
122
+ - [`/chat-history`](chat-history.md) — read-only status display
123
+ - [`/chat-history-resume`](chat-history-resume.md) — adopt + load
124
+ - [`/chat-history-clear`](chat-history-clear.md) — wipe
125
+ - [`agents/contexts/chat-history-platform-hooks.md`](../../../agents/contexts/chat-history-platform-hooks.md) — per-platform strategy table
126
+ - [`scripts/chat_history.py`](../../../scripts/chat_history.py) — `hook-append` API
@@ -2,8 +2,13 @@
2
2
  name: chat-history-clear
3
3
  description: Manually delete the persistent chat-history log — asks for confirmation, optionally archives to a timestamped backup before wiping
4
4
  disable-model-invocation: true
5
+ suggestion:
6
+ eligible: false
7
+ rationale: "Destructive log wipe — must be deliberate."
5
8
  ---
6
9
 
10
+ <!-- cloud_safe: noop -->
11
+
7
12
  # /chat-history-clear
8
13
 
9
14
  Wipes `.agent-chat-history`. Use when the log is stale (wrong session),
@@ -2,8 +2,13 @@
2
2
  name: chat-history-resume
3
3
  description: Load the persistent chat-history log into the current conversation — picks match/returning/foreign flow and supports resume, merge, replace, or continue
4
4
  disable-model-invocation: true
5
+ suggestion:
6
+ eligible: false
7
+ rationale: "Explicit resume mechanic with foreign/returning state machine."
5
8
  ---
6
9
 
10
+ <!-- cloud_safe: noop -->
11
+
7
12
  # /chat-history-resume
8
13
 
9
14
  Reconnects the current conversation with an existing `.agent-chat-history`
@@ -2,8 +2,13 @@
2
2
  name: chat-history
3
3
  description: Show the status of the persistent chat-history log — file size, entry count, header fingerprint, age, and the last few entries
4
4
  disable-model-invocation: true
5
+ suggestion:
6
+ eligible: false
7
+ rationale: "Status display only; no NL trigger distinct from 'show status'."
5
8
  ---
6
9
 
10
+ <!-- cloud_safe: noop -->
11
+
7
12
  # /chat-history
8
13
 
9
14
  Inspect `.agent-chat-history` — the JSONL log maintained by the
@@ -0,0 +1,126 @@
1
+ ---
2
+ name: check-current-md
3
+ description: Check the currently open .md file (or a path you pass) for German content outside DE:/EN: anchor blocks — umlauts, German function words, untranslated quoted phrases. Reports findings and offers fixes.
4
+ disable-model-invocation: true
5
+ suggestion:
6
+ eligible: false
7
+ rationale: "Package-internal — only the event4u/agent-config repo runs this."
8
+ ---
9
+
10
+ # check-current-md
11
+
12
+ Manual runner for [`md-language-check`](../skills/md-language-check/SKILL.md).
13
+ Use to spot-check an `.md` file the agent did not just edit, or to audit
14
+ before opening a PR.
15
+
16
+ ## Instructions
17
+
18
+ ### 1. Resolve target paths
19
+
20
+ User passed paths → use those. Else default to the file currently open
21
+ in the editor (per `personal.ide` open-file context). No file open and
22
+ no path passed:
23
+
24
+ ```
25
+ > ❌ No target file. Pass a path: /check-current-md path/to/file.md
26
+ ```
27
+
28
+ Stop.
29
+
30
+ ### 2. Run the checker
31
+
32
+ ```bash
33
+ python3 scripts/check_md_language.py <path> [<path> …] --format json
34
+ ```
35
+
36
+ Exit codes: `0` clean, `1` violations (continue to step 3), `3`
37
+ internal error (surface stderr, stop).
38
+
39
+ ### 3. Display findings
40
+
41
+ ```
42
+ ═══════════════════════════════════════════════
43
+ 📒 .md LANGUAGE CHECK
44
+ ═══════════════════════════════════════════════
45
+
46
+ Found: {count} violation(s) across {files} file(s)
47
+ ```
48
+
49
+ Per violation:
50
+
51
+ ```
52
+ {file}:{line} — kind: {umlaut|de_word} — match: `{matched_text}`
53
+ │ {context_line}
54
+ ```
55
+
56
+ Group by file when multiple files are scanned.
57
+
58
+ ### 4. Classify and propose fixes
59
+
60
+ | Cause | Proposed fix |
61
+ |---|---|
62
+ | German sentence in body prose | Translate to English |
63
+ | Quoted German token used as example | Move into a labeled `DE: … · EN: …` block |
64
+ | Meta-doc that documents trigger words | Append `<!-- md-language-check: ignore -->` to the line |
65
+ | Intentionally bilingual but unlabeled | Reformat as labeled anchor block |
66
+
67
+ Summary:
68
+
69
+ ```
70
+ Proposed fixes:
71
+ 1. {file}:{line} — {strategy}
72
+ 2. {file}:{line} — {strategy}
73
+
74
+ > 1. Apply all fixes
75
+ > 2. Apply interactively
76
+ > 3. Skip — report only
77
+ ```
78
+
79
+ Recommendation: **2 — Apply interactively** when ≥3 findings,
80
+ **1 — Apply all fixes** for ≤2 findings or all-translation diffs.
81
+
82
+ ### 5. Apply fixes
83
+
84
+ Edit only the source-of-truth file:
85
+
86
+ - `.agent-src.uncompressed/` → edit directly
87
+ - `.agent-src/` → edit the matching `.agent-src.uncompressed/` file,
88
+ then `bash scripts/compress.sh --sync`
89
+ - `.augment/` → same as `.agent-src/` (it's a projection)
90
+ - `agents/` → edit directly (no compression layer)
91
+
92
+ Re-run after fixes:
93
+
94
+ ```bash
95
+ python3 scripts/check_md_language.py <path> [<path> …]
96
+ ```
97
+
98
+ ### 6. Mark hashes (only if `.agent-src.uncompressed/` was edited)
99
+
100
+ ```bash
101
+ python3 scripts/compress.py --mark-done "{relative_path}"
102
+ ```
103
+
104
+ Keeps `.compression-hashes.json` consistent.
105
+
106
+ ## Rules
107
+
108
+ - **Never edit `.augment/` directly** — it's a generated projection
109
+ ([`augment-source-of-truth`](../rules/augment-source-of-truth.md))
110
+ - **Per-line ignore marker** is reserved for meta-documentation that
111
+ must quote German tokens; not a generic mute
112
+ - **Frontmatter is exempt** — checker skips it; don't try to "fix" it
113
+ - **Do NOT commit or push** — leave the working tree to the user
114
+
115
+ ## When NOT to use
116
+
117
+ - Project content outside `.agent-src*/`, `.augment/`, or `agents/`
118
+ follows a different language policy
119
+ - During autonomous edits the [`md-language-check`](../skills/md-language-check/SKILL.md)
120
+ skill already gates saves; this command is for **manual** spot-checks
121
+
122
+ ## See also
123
+
124
+ - [`md-language-check`](../skills/md-language-check/SKILL.md) — the gate skill this command wraps
125
+ - [`language-and-tone`](../rules/language-and-tone.md) — the rule that defines the policy
126
+ - [`augment-source-of-truth`](../rules/augment-source-of-truth.md) — where to apply fixes
@@ -0,0 +1,98 @@
1
+ ---
2
+ name: commit-in-chunks
3
+ skills: [git-workflow]
4
+ description: Stage and commit all uncommitted changes in logical chunks WITHOUT confirmation — sibling of /commit for autonomous flows
5
+ disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "commit everything autonomously, split and commit without confirmation"
9
+ trigger_context: "autonomous mode active and uncommitted changes present"
10
+ ---
11
+
12
+ # commit-in-chunks
13
+
14
+ Auto-split and commit all local changes in one go. Use when you want
15
+ commits made without being asked to confirm each batch. Sibling of
16
+ [`/commit`](commit.md), which waits for approval; this command skips
17
+ that step.
18
+
19
+ Per [`autonomous-execution`](../rules/autonomous-execution.md), the
20
+ agent does **not** commit on its own initiative — invoking this
21
+ command is the user's explicit consent to commit.
22
+
23
+ ## Instructions
24
+
25
+ ### 1. Detect uncommitted changes
26
+
27
+ ```bash
28
+ git status --short
29
+ git diff --stat
30
+ git diff --cached --stat
31
+ ```
32
+
33
+ No uncommitted changes → report "Nothing to commit." and stop.
34
+
35
+ ### 2. Determine the ticket number
36
+
37
+ - Extract ticket ID from current branch (e.g. `feat/DEV-1234/...` → `DEV-1234`).
38
+ - No ticket ID → omit scope: write `chore: ...` not `chore(): ...`. Do **not** ask the user.
39
+
40
+ ### 3. Analyze and split
41
+
42
+ Group changed files into logical units per [`/commit`](commit.md) step 3:
43
+
44
+ - Same feature / fix → one commit.
45
+ - Migration + corresponding model/seeder → one commit.
46
+ - Test + class under test → one commit.
47
+ - Style-only (ECS/Rector/formatter) → separate `style:` / `chore:` commit when mixed with logic.
48
+ - Truly unrelated change → its own commit.
49
+
50
+ Splitting rules:
51
+ - **Do NOT split arbitrarily** — only when logically independent.
52
+ - **Prefer fewer, coherent commits** over many tiny ones.
53
+ - **Tests go with the code they test** unless test-only changes are large and noisy.
54
+
55
+ Generate messages per [`commit-conventions`](../rules/commit-conventions.md).
56
+
57
+ ### 4. Commit immediately
58
+
59
+ For each planned commit in order:
60
+
61
+ ```bash
62
+ git add {files...}
63
+ git commit -m "{message}"
64
+ ```
65
+
66
+ No "looks good?" prompt. No confirmation. User invoked the command knowing the plan would execute.
67
+
68
+ ### 5. Report
69
+
70
+ ```
71
+ Created N commits:
72
+ 1. {sha1} feat(DEV-1234): {summary}
73
+ 2. {sha2} test(DEV-1234): {summary}
74
+ 3. {sha3} chore: {summary}
75
+ ```
76
+
77
+ Include `git log --oneline -N` output for verification.
78
+
79
+ ## Rules
80
+
81
+ - **Never push** — pushing remains explicit per [`scope-control`](../rules/scope-control.md#git-operations--permission-gated).
82
+ - **Never modify files** — only stage and commit existing changes.
83
+ - **Do NOT add untracked files** unless clearly part of the change (check `git status` first).
84
+ - **Follow commit conventions** per [`commit-conventions`](../rules/commit-conventions.md).
85
+ - **Stop on first failure** — if `git commit` fails (hook rejection, pre-commit lint error), stop, report, leave staged files for the user. Do not continue with remaining commits.
86
+ - **No interactive prompts** — fail fast over hanging on input.
87
+
88
+ ## When NOT to use
89
+
90
+ - User hasn't seen the diff and would benefit from review → use [`/commit`](commit.md).
91
+ - Diff includes large unrelated changes the user might want to reorganise → use [`/commit`](commit.md).
92
+ - Repo has a pre-commit hook requiring manual response → fix the hook or use `/commit`.
93
+
94
+ ## See also
95
+
96
+ - [`/commit`](commit.md) — split + present plan + wait for approval
97
+ - [`autonomous-execution`](../rules/autonomous-execution.md) — the rule that defines the no-ask commit default this command opts out of
98
+ - [`commit-conventions`](../rules/commit-conventions.md) — message format
@@ -3,6 +3,10 @@ name: commit
3
3
  skills: [git-workflow]
4
4
  description: Stage and commit all uncommitted changes — splits into logical commits following Conventional Commits
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "commit my changes, save this to git, create commits for these changes"
9
+ trigger_context: "git status shows uncommitted changes"
6
10
  ---
7
11
 
8
12
  # commit
@@ -3,6 +3,9 @@ name: compress
3
3
  skills: []
4
4
  description: Compress .md files from .agent-src.uncompressed/ into caveman format and write to .agent-src/
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: false
8
+ rationale: "Package-internal tooling; only the event4u/agent-config repo runs this."
6
9
  ---
7
10
 
8
11
  # compress
@@ -3,6 +3,10 @@ name: context-create
3
3
  skills: [agent-docs-writing]
4
4
  description: Analyze a codebase area and create a structured context document
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "document this part of the codebase, create a context doc for X"
9
+ trigger_context: "working in a module without an agents/contexts/ doc"
6
10
  ---
7
11
 
8
12
  # context-create
@@ -3,6 +3,10 @@ name: context-refactor
3
3
  skills: [agent-docs-writing]
4
4
  description: Analyze, update, and extend an existing context document
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "update the context doc, refresh this context document"
9
+ trigger_context: "existing agents/contexts/*.md referenced in the prompt"
6
10
  ---
7
11
 
8
12
  # context-refactor
@@ -3,6 +3,9 @@ name: copilot-agents-init
3
3
  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
4
  skills: [copilot-config, copilot-agents-optimization, agent-docs-writing]
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: false
8
+ rationale: "Project init — only deliberately during onboarding."
6
9
  ---
7
10
 
8
11
  # /copilot-agents-init
@@ -3,6 +3,9 @@ name: copilot-agents-optimize
3
3
  description: Analyzes and refactors AGENTS.md and copilot-instructions.md — removes duplications, enforces line budgets, and ensures both files are optimized for their audience.
4
4
  skills: [copilot-agents-optimization, copilot-config, agent-docs-writing]
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: false
8
+ rationale: "Maintenance refactor; only when the maintainer chooses to run it."
6
9
  ---
7
10
 
8
11
  # /copilot-agents-optimize
@@ -3,6 +3,10 @@ name: create-pr-description
3
3
  skills: [git-workflow]
4
4
  description: Generate a PR description as a copyable markdown block — used standalone or by create-pr
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "write a PR description, draft the PR text"
9
+ trigger_context: "PR exists or branch ready for review without description"
6
10
  ---
7
11
 
8
12
  # create-pr-description
@@ -3,6 +3,10 @@ name: create-pr
3
3
  skills: [git-workflow]
4
4
  description: Create a GitHub PR with structured description from Jira ticket and code changes
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "open a PR, create a pull request, make a PR for this branch"
9
+ trigger_context: "branch is ahead of base and not yet on a PR"
6
10
  ---
7
11
 
8
12
  # create-pr
@@ -3,6 +3,9 @@ name: do-and-judge
3
3
  skills: [subagent-orchestration, verify-before-complete]
4
4
  description: Run a single change through an implementer→judge loop with a two-revision ceiling, then hand back to the user
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: false
8
+ rationale: "Subagent orchestration — overlaps /work and judge skills; keep explicit."
6
9
  ---
7
10
 
8
11
  # do-and-judge
@@ -59,7 +62,7 @@ same failure class on nearby paths during this session, that is a
59
62
  pattern worth recording. Drop a signal:
60
63
 
61
64
  ```bash
62
- python3 scripts/memory_signal.py \
65
+ ./agent-config memory:signal \
63
66
  --type historical-patterns \
64
67
  --path "<primary path under review>" \
65
68
  --body "<failure class → fix guidance, one sentence>" \
@@ -3,6 +3,9 @@ name: do-in-steps
3
3
  skills: [subagent-orchestration, verify-before-complete]
4
4
  description: Execute an ordered plan step by step with a judge gate between steps — stops on first failed verdict
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: false
8
+ rationale: "Subagent orchestration — overlaps /work and /roadmap-execute; keep explicit."
6
9
  ---
7
10
 
8
11
  # do-in-steps
@@ -3,6 +3,10 @@ name: e2e-heal
3
3
  skills: [playwright-testing]
4
4
  description: Find, debug, and fix failing Playwright E2E tests
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "fix the failing E2E tests, playwright tests are red"
9
+ trigger_context: "failing test output from tests/e2e/"
6
10
  ---
7
11
 
8
12
  # e2e-heal
@@ -3,6 +3,10 @@ name: e2e-plan
3
3
  skills: [playwright-testing]
4
4
  description: Explore the application and create a structured E2E test plan in Markdown
5
5
  disable-model-invocation: true
6
+ suggestion:
7
+ eligible: true
8
+ trigger_description: "plan E2E tests for this feature, what should we cover in playwright"
9
+ trigger_context: "new feature or page added without tests/e2e/ coverage"
6
10
  ---
7
11
 
8
12
  # e2e-plan