@event4u/agent-config 1.14.0 → 1.16.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 (293) hide show
  1. package/.agent-src/commands/agent-handoff.md +1 -1
  2. package/.agent-src/commands/bug-fix.md +3 -3
  3. package/.agent-src/commands/bug-investigate.md +2 -2
  4. package/.agent-src/commands/chat-history-checkpoint.md +3 -3
  5. package/.agent-src/commands/chat-history-clear.md +2 -2
  6. package/.agent-src/commands/chat-history-resume.md +2 -2
  7. package/.agent-src/commands/chat-history.md +3 -3
  8. package/.agent-src/commands/check-current-md.md +44 -33
  9. package/.agent-src/commands/commit-in-chunks.md +43 -23
  10. package/.agent-src/commands/compress.md +34 -2
  11. package/.agent-src/commands/council-design.md +96 -0
  12. package/.agent-src/commands/council-optimize.md +115 -0
  13. package/.agent-src/commands/council-pr.md +123 -0
  14. package/.agent-src/commands/council.md +219 -0
  15. package/.agent-src/commands/create-pr.md +23 -0
  16. package/.agent-src/commands/do-and-judge.md +3 -3
  17. package/.agent-src/commands/do-in-steps.md +4 -4
  18. package/.agent-src/commands/e2e-heal.md +1 -1
  19. package/.agent-src/commands/e2e-plan.md +1 -1
  20. package/.agent-src/commands/feature-dev.md +8 -0
  21. package/.agent-src/commands/feature-explore.md +6 -1
  22. package/.agent-src/commands/feature-plan.md +33 -2
  23. package/.agent-src/commands/feature-refactor.md +5 -0
  24. package/.agent-src/commands/feature-roadmap.md +8 -3
  25. package/.agent-src/commands/feature.md +58 -0
  26. package/.agent-src/commands/fix-ci.md +5 -0
  27. package/.agent-src/commands/fix-portability.md +7 -2
  28. package/.agent-src/commands/fix-pr-bot-comments.md +5 -0
  29. package/.agent-src/commands/fix-pr-comments.md +5 -0
  30. package/.agent-src/commands/fix-pr-developer-comments.md +5 -0
  31. package/.agent-src/commands/fix-references.md +5 -0
  32. package/.agent-src/commands/fix-seeder.md +5 -0
  33. package/.agent-src/commands/fix.md +60 -0
  34. package/.agent-src/commands/jira-ticket.md +1 -1
  35. package/.agent-src/commands/judge.md +1 -1
  36. package/.agent-src/commands/memory-add.md +3 -3
  37. package/.agent-src/commands/memory-full.md +2 -2
  38. package/.agent-src/commands/memory-promote.md +2 -2
  39. package/.agent-src/commands/mode.md +5 -5
  40. package/.agent-src/commands/onboard.md +17 -8
  41. package/.agent-src/commands/optimize-agents.md +6 -1
  42. package/.agent-src/commands/optimize-augmentignore.md +14 -0
  43. package/.agent-src/commands/optimize-rtk-filters.md +5 -0
  44. package/.agent-src/commands/optimize-skills.md +6 -1
  45. package/.agent-src/commands/optimize.md +54 -0
  46. package/.agent-src/commands/propose-memory.md +2 -2
  47. package/.agent-src/commands/refine-ticket.md +9 -7
  48. package/.agent-src/commands/review-changes.md +61 -9
  49. package/.agent-src/commands/review-routing.md +1 -1
  50. package/.agent-src/commands/roadmap-create.md +42 -4
  51. package/.agent-src/commands/roadmap-execute.md +9 -7
  52. package/.agent-src/commands/set-cost-profile.md +11 -3
  53. package/.agent-src/commands/sync-agent-settings.md +11 -2
  54. package/.agent-src/commands/tests-create.md +1 -1
  55. package/.agent-src/commands/tests-execute.md +2 -3
  56. package/.agent-src/commands/upstream-contribute.md +1 -1
  57. package/.agent-src/contexts/authority/commit-mechanics.md +57 -0
  58. package/.agent-src/contexts/authority/destructive-mechanics.md +66 -0
  59. package/.agent-src/contexts/authority/scope-mechanics.md +87 -0
  60. package/.agent-src/contexts/execution/autonomy-detection.md +54 -0
  61. package/.agent-src/contexts/execution/autonomy-examples.md +90 -0
  62. package/.agent-src/contexts/execution/autonomy-mechanics.md +29 -0
  63. package/.agent-src/contexts/execution/verification-mechanics.md +80 -0
  64. package/.agent-src/personas/README.md +1 -1
  65. package/.agent-src/rules/agent-authority.md +24 -0
  66. package/.agent-src/rules/architecture.md +1 -1
  67. package/.agent-src/rules/artifact-drafting-protocol.md +1 -1
  68. package/.agent-src/rules/artifact-engagement-recording.md +2 -2
  69. package/.agent-src/rules/ask-when-uncertain.md +1 -1
  70. package/.agent-src/rules/augment-portability.md +56 -37
  71. package/.agent-src/rules/autonomous-execution.md +78 -114
  72. package/.agent-src/rules/capture-learnings.md +1 -1
  73. package/.agent-src/rules/chat-history-cadence.md +109 -0
  74. package/.agent-src/rules/chat-history-ownership.md +123 -0
  75. package/.agent-src/rules/chat-history-visibility.md +96 -0
  76. package/.agent-src/rules/cli-output-handling.md +1 -1
  77. package/.agent-src/rules/{command-suggestion.md → command-suggestion-policy.md} +10 -9
  78. package/.agent-src/rules/commit-conventions.md +1 -1
  79. package/.agent-src/rules/commit-policy.md +43 -61
  80. package/.agent-src/rules/context-hygiene.md +3 -3
  81. package/.agent-src/rules/direct-answers.md +2 -2
  82. package/.agent-src/rules/docs-sync.md +1 -1
  83. package/.agent-src/rules/e2e-testing.md +1 -1
  84. package/.agent-src/rules/guidelines.md +4 -4
  85. package/.agent-src/rules/improve-before-implement.md +2 -2
  86. package/.agent-src/rules/language-and-tone.md +41 -96
  87. package/.agent-src/rules/minimal-safe-diff.md +3 -3
  88. package/.agent-src/rules/model-recommendation.md +4 -4
  89. package/.agent-src/rules/no-cheap-questions.md +89 -0
  90. package/.agent-src/rules/non-destructive-by-default.md +25 -59
  91. package/.agent-src/rules/onboarding-gate.md +5 -5
  92. package/.agent-src/rules/review-routing-awareness.md +9 -9
  93. package/.agent-src/rules/roadmap-progress-sync.md +132 -80
  94. package/.agent-src/rules/role-mode-adherence.md +3 -3
  95. package/.agent-src/rules/scope-control.md +65 -46
  96. package/.agent-src/rules/security-sensitive-stop.md +2 -2
  97. package/.agent-src/rules/size-enforcement.md +3 -2
  98. package/.agent-src/rules/think-before-action.md +5 -5
  99. package/.agent-src/rules/token-efficiency.md +4 -4
  100. package/.agent-src/rules/{ui-audit-before-build.md → ui-audit-gate.md} +3 -3
  101. package/.agent-src/rules/user-interaction.md +31 -7
  102. package/.agent-src/rules/verify-before-complete.md +12 -67
  103. package/.agent-src/scripts/update_roadmap_progress.py +65 -8
  104. package/.agent-src/skills/ai-council/SKILL.md +333 -0
  105. package/.agent-src/skills/api-endpoint/SKILL.md +2 -2
  106. package/.agent-src/skills/blade-ui/SKILL.md +30 -11
  107. package/.agent-src/skills/blast-radius-analyzer/SKILL.md +1 -1
  108. package/.agent-src/skills/bug-analyzer/SKILL.md +1 -1
  109. package/.agent-src/skills/command-routing/SKILL.md +1 -1
  110. package/.agent-src/skills/command-writing/SKILL.md +16 -5
  111. package/.agent-src/skills/conventional-commits-writing/SKILL.md +1 -1
  112. package/.agent-src/skills/copilot-agents-optimization/SKILL.md +2 -2
  113. package/.agent-src/skills/developer-like-execution/SKILL.md +2 -2
  114. package/.agent-src/skills/existing-ui-audit/SKILL.md +24 -9
  115. package/.agent-src/skills/fe-design/SKILL.md +20 -15
  116. package/.agent-src/skills/file-editor/SKILL.md +9 -0
  117. package/.agent-src/skills/flux/SKILL.md +1 -1
  118. package/.agent-src/skills/git-workflow/SKILL.md +1 -1
  119. package/.agent-src/skills/guideline-writing/SKILL.md +11 -11
  120. package/.agent-src/skills/learning-to-rule-or-skill/SKILL.md +4 -4
  121. package/.agent-src/skills/livewire/SKILL.md +27 -8
  122. package/.agent-src/skills/override-management/SKILL.md +2 -2
  123. package/.agent-src/skills/php-coder/SKILL.md +1 -1
  124. package/.agent-src/skills/playwright-testing/SKILL.md +2 -2
  125. package/.agent-src/skills/readme-reviewer/SKILL.md +1 -1
  126. package/.agent-src/skills/readme-writing/SKILL.md +1 -1
  127. package/.agent-src/skills/readme-writing-package/SKILL.md +1 -1
  128. package/.agent-src/skills/receiving-code-review/SKILL.md +1 -1
  129. package/.agent-src/skills/refine-ticket/SKILL.md +30 -24
  130. package/.agent-src/skills/review-routing/SKILL.md +2 -2
  131. package/.agent-src/skills/roadmap-management/SKILL.md +22 -16
  132. package/.agent-src/skills/rule-writing/SKILL.md +1 -1
  133. package/.agent-src/skills/skill-reviewer/SKILL.md +1 -1
  134. package/.agent-src/skills/skill-writing/SKILL.md +6 -6
  135. package/.agent-src/skills/subagent-orchestration/SKILL.md +1 -0
  136. package/.agent-src/skills/systematic-debugging/SKILL.md +1 -1
  137. package/.agent-src/skills/upstream-contribute/SKILL.md +3 -3
  138. package/.agent-src/skills/validate-feature-fit/SKILL.md +2 -2
  139. package/.agent-src/skills/{verify-before-complete → verify-completion-evidence}/SKILL.md +2 -2
  140. package/.agent-src/templates/agent-settings.md +9 -9
  141. package/.agent-src/templates/contexts/auth-model.md +1 -1
  142. package/.agent-src/templates/roadmaps.md +9 -8
  143. package/.agent-src/templates/scripts/README.md +2 -2
  144. package/.agent-src/templates/scripts/memory_lookup.py +1 -1
  145. package/.agent-src/templates/scripts/telemetry/aggregator.py +16 -1
  146. package/.agent-src/templates/scripts/telemetry/engagement.py +59 -0
  147. package/.agent-src/templates/scripts/telemetry/report_renderer.py +28 -1
  148. package/.agent-src/templates/scripts/telemetry_record.py +14 -1
  149. package/.agent-src/templates/scripts/work_engine/__init__.py +2 -2
  150. package/.agent-src/templates/scripts/work_engine/cli.py +64 -461
  151. package/.agent-src/templates/scripts/work_engine/cli_args.py +116 -0
  152. package/.agent-src/templates/scripts/work_engine/delivery_state.py +3 -3
  153. package/.agent-src/templates/scripts/work_engine/directives/backend/__init__.py +1 -1
  154. package/.agent-src/templates/scripts/work_engine/directives/backend/implement.py +1 -1
  155. package/.agent-src/templates/scripts/work_engine/directives/backend/memory.py +1 -1
  156. package/.agent-src/templates/scripts/work_engine/directives/backend/plan.py +1 -1
  157. package/.agent-src/templates/scripts/work_engine/directives/backend/report.py +1 -1
  158. package/.agent-src/templates/scripts/work_engine/dispatcher.py +1 -1
  159. package/.agent-src/templates/scripts/work_engine/emitters.py +43 -0
  160. package/.agent-src/templates/scripts/work_engine/errors.py +19 -0
  161. package/.agent-src/templates/scripts/work_engine/hook_bootstrap.py +76 -0
  162. package/.agent-src/templates/scripts/work_engine/input_builders.py +163 -0
  163. package/.agent-src/templates/scripts/work_engine/migration/v0_to_v1.py +34 -2
  164. package/.agent-src/templates/scripts/work_engine/persona_policy.py +1 -1
  165. package/.agent-src/templates/scripts/work_engine/resolvers/prompt.py +1 -1
  166. package/.agent-src/templates/scripts/work_engine/state_io.py +202 -0
  167. package/.claude-plugin/marketplace.json +10 -2
  168. package/AGENTS.md +16 -12
  169. package/CHANGELOG.md +206 -9
  170. package/README.md +51 -52
  171. package/config/agent-settings.template.yml +58 -1
  172. package/config/gitignore-block.txt +3 -0
  173. package/docs/MIGRATION.md +122 -0
  174. package/docs/architecture.md +83 -34
  175. package/docs/catalog.md +331 -0
  176. package/docs/contracts/STABILITY.md +134 -0
  177. package/docs/contracts/adr-chat-history-split.md +132 -0
  178. package/docs/contracts/adr-command-suggestion.md +146 -0
  179. package/docs/contracts/adr-implement-ticket-runtime.md +122 -0
  180. package/docs/contracts/adr-product-ui-track.md +384 -0
  181. package/docs/contracts/adr-prompt-driven-execution.md +187 -0
  182. package/docs/contracts/agent-memory-contract.md +149 -0
  183. package/docs/contracts/artifact-engagement-flow.md +262 -0
  184. package/docs/contracts/command-clusters.md +126 -0
  185. package/docs/contracts/command-suggestion-flow.md +148 -0
  186. package/docs/contracts/implement-ticket-flow.md +628 -0
  187. package/docs/contracts/linear-ai-rules-inclusion.md +143 -0
  188. package/docs/contracts/linear-ai-three-layers.md +131 -0
  189. package/docs/contracts/load-context-schema.md +186 -0
  190. package/docs/contracts/rule-interactions.md +107 -0
  191. package/docs/contracts/rule-interactions.yml +238 -0
  192. package/docs/contracts/rule-priority-hierarchy.md +87 -0
  193. package/docs/contracts/ui-stack-extension.md +236 -0
  194. package/docs/contracts/ui-track-flow.md +338 -0
  195. package/docs/customization.md +14 -0
  196. package/docs/end-to-end-walkthroughs.md +165 -0
  197. package/docs/getting-started.md +27 -9
  198. package/docs/github-topics.md +12 -3
  199. package/docs/guidelines/agent-infra/language-and-tone-examples.md +79 -0
  200. package/{.agent-src → docs}/guidelines/docs/readme-size-and-splitting.md +26 -25
  201. package/docs/guidelines/php/git.md +164 -0
  202. package/docs/installation.md +42 -6
  203. package/docs/migrations/commands-1.15.0.md +112 -0
  204. package/docs/showcase.md +9 -4
  205. package/docs/skills-catalog.md +14 -8
  206. package/docs/ui-track-mental-model.md +121 -0
  207. package/llms.txt +13 -7
  208. package/package.json +1 -1
  209. package/scripts/agent-config +23 -0
  210. package/scripts/ai_council/__init__.py +39 -0
  211. package/scripts/ai_council/_default_prices.py +41 -0
  212. package/scripts/ai_council/_one_off_rebalancing_audit.py +149 -0
  213. package/scripts/ai_council/_one_off_roundtrip.py +106 -0
  214. package/scripts/ai_council/budget_guard.py +172 -0
  215. package/scripts/ai_council/bundler.py +261 -0
  216. package/scripts/ai_council/clients.py +381 -0
  217. package/scripts/ai_council/modes.py +127 -0
  218. package/scripts/ai_council/orchestrator.py +350 -0
  219. package/scripts/ai_council/pricing.py +213 -0
  220. package/scripts/ai_council/project_context.py +159 -0
  221. package/scripts/ai_council/prompts.py +232 -0
  222. package/scripts/ai_council/session.py +144 -0
  223. package/scripts/build_linear_digest.py +4 -4
  224. package/scripts/check_always_budget.py +126 -0
  225. package/scripts/check_augmentignore.py +69 -0
  226. package/scripts/check_command_count_messaging.py +120 -0
  227. package/scripts/check_portability.py +57 -0
  228. package/scripts/check_public_catalog_links.py +122 -0
  229. package/scripts/check_public_links.py +185 -0
  230. package/scripts/check_references.py +5 -1
  231. package/scripts/check_roadmap_trackable.py +111 -0
  232. package/scripts/command_suggester/cooldown.py +1 -1
  233. package/scripts/generate_index.py +266 -0
  234. package/scripts/install_anthropic_key.sh +5 -0
  235. package/scripts/install_openai_key.sh +106 -0
  236. package/scripts/lint_load_context.py +163 -0
  237. package/scripts/lint_no_new_atomic_commands.py +179 -0
  238. package/scripts/lint_rule_interactions.py +149 -0
  239. package/scripts/memory_lookup.py +1 -1
  240. package/scripts/release.py +297 -64
  241. package/scripts/schemas/command.schema.json +20 -0
  242. package/scripts/schemas/rule.schema.json +10 -0
  243. package/scripts/skill_linter.py +26 -4
  244. package/scripts/sync_agent_settings.py +1 -1
  245. package/scripts/update_counts.py +19 -4
  246. package/scripts/update_prices.py +124 -0
  247. package/.agent-src/guidelines/php/git.md +0 -96
  248. package/.agent-src/rules/chat-history.md +0 -200
  249. /package/.agent-src/rules/{slash-commands.md → slash-command-routing-policy.md} +0 -0
  250. /package/{.agent-src → docs}/guidelines/agent-infra/agent-interaction-and-decision-quality.md +0 -0
  251. /package/{.agent-src → docs}/guidelines/agent-infra/break-glass-usage.md +0 -0
  252. /package/{.agent-src → docs}/guidelines/agent-infra/developer-judgment.md +0 -0
  253. /package/{.agent-src → docs}/guidelines/agent-infra/engineering-memory-data-format.md +0 -0
  254. /package/{.agent-src → docs}/guidelines/agent-infra/layered-settings.md +0 -0
  255. /package/{.agent-src → docs}/guidelines/agent-infra/memory-access.md +0 -0
  256. /package/{.agent-src → docs}/guidelines/agent-infra/naming.md +0 -0
  257. /package/{.agent-src → docs}/guidelines/agent-infra/output-patterns.md +0 -0
  258. /package/{.agent-src → docs}/guidelines/agent-infra/review-routing-data-format.md +0 -0
  259. /package/{.agent-src → docs}/guidelines/agent-infra/role-contracts.md +0 -0
  260. /package/{.agent-src → docs}/guidelines/agent-infra/role-mode-router.md +0 -0
  261. /package/{.agent-src → docs}/guidelines/agent-infra/runtime-layer.md +0 -0
  262. /package/{.agent-src → docs}/guidelines/agent-infra/self-improvement-pipeline.md +0 -0
  263. /package/{.agent-src → docs}/guidelines/agent-infra/size-and-scope.md +0 -0
  264. /package/{.agent-src → docs}/guidelines/agent-infra/tool-integration.md +0 -0
  265. /package/{.agent-src → docs}/guidelines/e2e/playwright.md +0 -0
  266. /package/{.agent-src → docs}/guidelines/php/api-design.md +0 -0
  267. /package/{.agent-src → docs}/guidelines/php/artisan-commands.md +0 -0
  268. /package/{.agent-src → docs}/guidelines/php/blade-ui.md +0 -0
  269. /package/{.agent-src → docs}/guidelines/php/controllers.md +0 -0
  270. /package/{.agent-src → docs}/guidelines/php/database.md +0 -0
  271. /package/{.agent-src → docs}/guidelines/php/eloquent.md +0 -0
  272. /package/{.agent-src → docs}/guidelines/php/flux.md +0 -0
  273. /package/{.agent-src → docs}/guidelines/php/general.md +0 -0
  274. /package/{.agent-src → docs}/guidelines/php/jobs.md +0 -0
  275. /package/{.agent-src → docs}/guidelines/php/livewire.md +0 -0
  276. /package/{.agent-src → docs}/guidelines/php/logging.md +0 -0
  277. /package/{.agent-src → docs}/guidelines/php/naming.md +0 -0
  278. /package/{.agent-src → docs}/guidelines/php/patterns/dependency-injection.md +0 -0
  279. /package/{.agent-src → docs}/guidelines/php/patterns/dtos.md +0 -0
  280. /package/{.agent-src → docs}/guidelines/php/patterns/events.md +0 -0
  281. /package/{.agent-src → docs}/guidelines/php/patterns/factory.md +0 -0
  282. /package/{.agent-src → docs}/guidelines/php/patterns/pipelines.md +0 -0
  283. /package/{.agent-src → docs}/guidelines/php/patterns/policies.md +0 -0
  284. /package/{.agent-src → docs}/guidelines/php/patterns/repositories.md +0 -0
  285. /package/{.agent-src → docs}/guidelines/php/patterns/service-layer.md +0 -0
  286. /package/{.agent-src → docs}/guidelines/php/patterns/strategy.md +0 -0
  287. /package/{.agent-src → docs}/guidelines/php/patterns.md +0 -0
  288. /package/{.agent-src → docs}/guidelines/php/performance.md +0 -0
  289. /package/{.agent-src → docs}/guidelines/php/resources.md +0 -0
  290. /package/{.agent-src → docs}/guidelines/php/security.md +0 -0
  291. /package/{.agent-src → docs}/guidelines/php/sql.md +0 -0
  292. /package/{.agent-src → docs}/guidelines/php/validations.md +0 -0
  293. /package/{.agent-src → docs}/guidelines/php/websocket.md +0 -0
@@ -6,7 +6,7 @@
6
6
  },
7
7
  "metadata": {
8
8
  "description": "Shared agent configuration \u2014 skills for AI coding tools (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI).",
9
- "version": "1.14.0"
9
+ "version": "1.16.0"
10
10
  },
11
11
  "plugins": [
12
12
  {
@@ -22,6 +22,7 @@
22
22
  "./.claude/skills/agents-audit",
23
23
  "./.claude/skills/agents-cleanup",
24
24
  "./.claude/skills/agents-prepare",
25
+ "./.claude/skills/ai-council",
25
26
  "./.claude/skills/analysis-autonomous-mode",
26
27
  "./.claude/skills/analysis-skill-router",
27
28
  "./.claude/skills/analyze-reference-repo",
@@ -59,6 +60,10 @@
59
60
  "./.claude/skills/copilot-agents-optimization",
60
61
  "./.claude/skills/copilot-agents-optimize",
61
62
  "./.claude/skills/copilot-config",
63
+ "./.claude/skills/council",
64
+ "./.claude/skills/council-design",
65
+ "./.claude/skills/council-optimize",
66
+ "./.claude/skills/council-pr",
62
67
  "./.claude/skills/create-pr",
63
68
  "./.claude/skills/create-pr-description",
64
69
  "./.claude/skills/dashboard-design",
@@ -79,6 +84,7 @@
79
84
  "./.claude/skills/estimate-ticket",
80
85
  "./.claude/skills/existing-ui-audit",
81
86
  "./.claude/skills/fe-design",
87
+ "./.claude/skills/feature",
82
88
  "./.claude/skills/feature-dev",
83
89
  "./.claude/skills/feature-explore",
84
90
  "./.claude/skills/feature-plan",
@@ -87,6 +93,7 @@
87
93
  "./.claude/skills/feature-roadmap",
88
94
  "./.claude/skills/file-editor",
89
95
  "./.claude/skills/finishing-a-development-branch",
96
+ "./.claude/skills/fix",
90
97
  "./.claude/skills/fix-ci",
91
98
  "./.claude/skills/fix-portability",
92
99
  "./.claude/skills/fix-pr-bot-comments",
@@ -136,6 +143,7 @@
136
143
  "./.claude/skills/multi-tenancy",
137
144
  "./.claude/skills/onboard",
138
145
  "./.claude/skills/openapi",
146
+ "./.claude/skills/optimize",
139
147
  "./.claude/skills/optimize-agents",
140
148
  "./.claude/skills/optimize-augmentignore",
141
149
  "./.claude/skills/optimize-rtk-filters",
@@ -213,7 +221,7 @@
213
221
  "./.claude/skills/upstream-contribute",
214
222
  "./.claude/skills/using-git-worktrees",
215
223
  "./.claude/skills/validate-feature-fit",
216
- "./.claude/skills/verify-before-complete",
224
+ "./.claude/skills/verify-completion-evidence",
217
225
  "./.claude/skills/websocket",
218
226
  "./.claude/skills/work"
219
227
  ]
package/AGENTS.md CHANGED
@@ -1,5 +1,7 @@
1
1
  # event4u/agent-config
2
2
 
3
+ > **agent-config is not a runtime, but it ships a deterministic orchestration contract / state machine for host agents.**
4
+
3
5
  **Shared agent configuration** — skills, rules, commands, guidelines, and templates
4
6
  for AI coding tools (Augment Code, Claude Code, Cursor, Cline, Windsurf, Gemini CLI,
5
7
  GitHub Copilot).
@@ -12,8 +14,9 @@ when they install the package.
12
14
 
13
15
  ## What this repo is
14
16
 
15
- - A distribution package, not an application.
16
- - `type: library` in `composer.json`; no `app/` directory, no Laravel runtime.
17
+ - A distribution package, not an application of any framework.
18
+ - `type: library` in `composer.json`; no `app/` directory, no application
19
+ runtime (no Laravel, Symfony, Next.js, or other framework app code).
17
20
  - Published to Composer and npm as `event4u/agent-config` / `@event4u/agent-config`.
18
21
  - Installed into consumer projects via `scripts/install.sh` (Bash) and
19
22
  `scripts/install.py` (Python bridge).
@@ -41,8 +44,9 @@ and run `task sync` (or `task ci`) to compress + regenerate the tool directories
41
44
  - **Taskfile** — developer entrypoints (`task ci`, `task sync`, `task test`)
42
45
  - **GitHub Actions** — CI workflow under `.github/workflows/`
43
46
 
44
- No PHP, no Laravel, no JavaScript runtime dependencies. The `composer.json` /
45
- `package.json` are thin distribution manifests.
47
+ No application code or framework runtime (no Laravel / Symfony / Next.js /
48
+ Express). The `composer.json` / `package.json` are thin distribution
49
+ manifests.
46
50
 
47
51
  ## Working on this repo
48
52
 
@@ -66,7 +70,7 @@ want to measure which skills/rules/commands the agent actually applies set
66
70
  `telemetry.artifact_engagement.enabled: true` in `.agent-settings.yml`. The
67
71
  log is local-only JSONL (no upload, no cross-project share) and is bound
68
72
  by the redaction floor described in
69
- [`agents/contexts/artifact-engagement-flow.md`](agents/contexts/artifact-engagement-flow.md).
73
+ [`docs/contracts/artifact-engagement-flow.md`](docs/contracts/artifact-engagement-flow.md) (beta).
70
74
  The recording rule lives at
71
75
  [`.agent-src/rules/artifact-engagement-recording.md`](.agent-src/rules/artifact-engagement-recording.md).
72
76
 
@@ -76,11 +80,11 @@ When a user's free-form prompt matches a command's purpose, the agent
76
80
  surfaces matches as a numbered-options block with an always-present
77
81
  "run the prompt as-is" escape. **Nothing auto-executes** — the user
78
82
  picks every time. Engine: `scripts/command_suggester/`. Rule:
79
- [`.agent-src/rules/command-suggestion.md`](.agent-src/rules/command-suggestion.md).
83
+ [`.agent-src/rules/command-suggestion-policy.md`](.agent-src/rules/command-suggestion-policy.md).
80
84
  Locked eligibility table, scoring contract, and hardening list:
81
- [`agents/contexts/adr-command-suggestion.md`](agents/contexts/adr-command-suggestion.md)
85
+ [`docs/contracts/adr-command-suggestion.md`](docs/contracts/adr-command-suggestion.md)
82
86
  and
83
- [`agents/contexts/command-suggestion-flow.md`](agents/contexts/command-suggestion-flow.md).
87
+ [`docs/contracts/command-suggestion-flow.md`](docs/contracts/command-suggestion-flow.md) (beta).
84
88
 
85
89
  ## Key rules for agents editing this repo
86
90
 
@@ -98,14 +102,14 @@ and
98
102
 
99
103
  ```
100
104
  .agent-src.uncompressed/ ← edit here
101
- skills/ (128 skills)
102
- rules/ (53 rules)
103
- commands/ (77 commands)
104
- guidelines/ (46 guidelines)
105
+ skills/ (129 skills)
106
+ rules/ (57 rules)
107
+ commands/ (84 files — 69 active + 15 deprecation shims)
105
108
  personas/ (7 personas)
106
109
  templates/ (AGENTS.md, copilot-instructions.md, skill.md, …)
107
110
  contexts/
108
111
 
112
+ docs/guidelines/ (47 guidelines — reference material, not packaged)
109
113
  .agent-src/ ← compressed output shipped in the package
110
114
  .augment/ ← local projection for Augment Code (gitignored)
111
115
  scripts/ ← install.sh, install.py, compress.py, linters
package/CHANGELOG.md CHANGED
@@ -103,10 +103,10 @@ baselines pin the R3 contract.
103
103
  * **ADR (R1):** [`agents/contexts/adr-work-engine-rename.md`](agents/contexts/adr-work-engine-rename.md)
104
104
  — rationale, scope of the rename, compatibility shim policy, state
105
105
  migration, golden-test contract, tradeoffs, non-goals.
106
- * **ADR (R2):** [`agents/contexts/adr-prompt-driven-execution.md`](agents/contexts/adr-prompt-driven-execution.md)
106
+ * **ADR (R2):** [`docs/contracts/adr-prompt-driven-execution.md`](docs/contracts/adr-prompt-driven-execution.md)
107
107
  — naming decision (`/work` over `/do`), confidence-band gate,
108
108
  AC-projection fix, R3 deferral boundary, and golden contract.
109
- * **flow:** `agents/contexts/implement-ticket-flow.md` gains a "Replay
109
+ * **flow:** `docs/contracts/implement-ticket-flow.md` gains a "Replay
110
110
  protocol — Strict-Verb comparison" section (R1) and a
111
111
  "Prompt envelopes and confidence bands (R2)" section pinning the
112
112
  band-action mapping to the scorer module.
@@ -126,7 +126,7 @@ baselines pin the R3 contract.
126
126
  `directives/mixed/` (`contract → ui → stitch`). Dispatched at the
127
127
  engine boundary on `state.directive_set`; the audit gate is enforced
128
128
  at the dispatcher AND at always-on rule level
129
- ([`ui-audit-before-build`](.agent-src/rules/ui-audit-before-build.md))
129
+ ([`ui-audit-gate`](.agent-src/rules/ui-audit-gate.md))
130
130
  so cloud surfaces and free-form edits cannot bypass it.
131
131
  * **stack detection:** `scripts/work_engine/stack/detect.py` reads
132
132
  `composer.json` + `package.json` and labels the frontend as
@@ -170,17 +170,17 @@ baselines pin the R3 contract.
170
170
 
171
171
  ### Documentation (R3)
172
172
 
173
- * **ADR (R3):** [`agents/contexts/adr-product-ui-track.md`](agents/contexts/adr-product-ui-track.md)
173
+ * **ADR (R3):** [`docs/contracts/adr-product-ui-track.md`](docs/contracts/adr-product-ui-track.md)
174
174
  — audit-as-hard-gate rationale, design-review loop, halt-budget
175
175
  reasoning, trivial-path-and-reclassification, stack-detection
176
176
  strategy, fe-design migration, tradeoffs, non-goals.
177
- * **flow contract:** [`agents/contexts/ui-track-flow.md`](agents/contexts/ui-track-flow.md)
177
+ * **flow contract:** [`docs/contracts/ui-track-flow.md`](docs/contracts/ui-track-flow.md)
178
178
  — slot-by-slot wiring for `ui` / `ui-trivial` / `mixed`, the
179
179
  audit-path table (`STRONG_SIMILARITY = 0.7`, `TIE_GAP = 0.05`),
180
180
  design-brief lock + placeholder patterns, stack-dispatch tables,
181
181
  polish ceiling, trivial preconditions, mixed sentinels,
182
182
  idempotency table, declared ambiguities across all eight directives.
183
- * **extension recipe:** [`agents/contexts/ui-stack-extension.md`](agents/contexts/ui-stack-extension.md)
183
+ * **extension recipe:** [`docs/contracts/ui-stack-extension.md`](docs/contracts/ui-stack-extension.md)
184
184
  — how to add a new stack (Svelte, SolidJS, Astro, …): label
185
185
  conventions, detector heuristic, three required skills, dispatch
186
186
  wiring, version anchor, Golden fixture, end-to-end verification.
@@ -232,7 +232,7 @@ Maintainer-targeted; consumers see no prompts.
232
232
  * **ADR:** [`agents/contexts/adr-artifact-engagement.md`](agents/contexts/adr-artifact-engagement.md)
233
233
  — rationale, default-off doctrine, privacy contract, schema
234
234
  versioning, deprecation horizon.
235
- * **flow:** `agents/contexts/artifact-engagement-flow.md` is the
235
+ * **flow:** `docs/contracts/artifact-engagement-flow.md` is the
236
236
  cross-cutting reference for what gets recorded, when, and under
237
237
  which constraints; includes the maintainer hand-audit recipe.
238
238
  * **AGENTS.md + README.md:** short *Maintainer telemetry (opt-in)*
@@ -288,15 +288,212 @@ the as-is option is always present and always last.
288
288
 
289
289
  ### Documentation
290
290
 
291
- * **ADR:** [`agents/contexts/adr-command-suggestion.md`](agents/contexts/adr-command-suggestion.md)
291
+ * **ADR:** [`docs/contracts/adr-command-suggestion.md`](docs/contracts/adr-command-suggestion.md)
292
292
  — "suggest, never invoke" anchor, eligibility rubric, anti-noise
293
293
  heuristics, hardening list, three opt-out paths.
294
- * **flow:** [`agents/contexts/command-suggestion-flow.md`](agents/contexts/command-suggestion-flow.md)
294
+ * **flow:** [`docs/contracts/command-suggestion-flow.md`](docs/contracts/command-suggestion-flow.md)
295
295
  — scoring breakdown, evidence semantics, subordination order, and
296
296
  hardening tests.
297
297
  * **README + AGENTS.md:** short *Context-aware command suggestion*
298
298
  section pointing to the ADR and the flow doc.
299
299
 
300
+ **Install-path pruning (relabel only)** — `docs/installation.md`
301
+ reorders install paths by recommendation prominence. Composer + npm
302
+ remain the default; manual / submodule / VS Code Git URL are tagged
303
+ `advanced`; Claude.ai Web Skills UI is tagged `experimental`; Linear
304
+ AI workspace guidance is tagged `staged`. **No installer or shipped
305
+ artefact is removed in 1.15.0** — every path on the page still works
306
+ and is still tested. The labels describe how prominent the path is in
307
+ our recommendation order, not its support status.
308
+
309
+ ### Documentation
310
+
311
+ * **`docs/installation.md`:** new label table at the top
312
+ (`(no label)` / `advanced` / `experimental` / `staged`) plus a
313
+ preamble that calls out the no-removal contract explicitly. Section
314
+ headers carry their label inline for skim-readers.
315
+ * **rationale:** see R9 in
316
+ [`agents/roadmaps/archive/road-to-post-pr29-optimize.md`](agents/roadmaps/archive/road-to-post-pr29-optimize.md)
317
+ — relabelling addresses the "four install paths at zero external
318
+ users" tension without removing any path that an existing user
319
+ might rely on.
320
+
321
+ ## [1.16.0](https://github.com/event4u-app/agent-config/compare/1.15.0...1.16.0) (2026-05-03)
322
+
323
+ ### Features
324
+
325
+ * add no-cheap-questions always-rule with pre-send self-check ([2916210](https://github.com/event4u-app/agent-config/commit/2916210887f5ba9fc103d80585f0a8a0e2809686))
326
+ * **lint:** load_context frontmatter convention + linter (Phase 2) ([f7c9c51](https://github.com/event4u-app/agent-config/commit/f7c9c5186e4264baee2a4cc299990ed9f87ded54))
327
+ * **council:** B1–B4 host integration hooks ([f5ec711](https://github.com/event4u-app/agent-config/commit/f5ec71174f21f1f096fb4d8cff94feac2410835f))
328
+ * **council:** specialised modes — /council-pr, /council-design, /council-optimize ([00ec7df](https://github.com/event4u-app/agent-config/commit/00ec7df94397addd4a09365b8e48f54441a3a496))
329
+ * **council:** session persistence (D2) + daily budget guard (D3) ([b2395e9](https://github.com/event4u-app/agent-config/commit/b2395e9d325fb339fb45ada7f4e4297ee8e0811b))
330
+ * **council:** multi-round debate (D1) + smart diff context (D4) ([3a06d8f](https://github.com/event4u-app/agent-config/commit/3a06d8f7b95ddb2db7b4d6d965f6b66abcda78a5))
331
+ * **telemetry:** outcome-aware engagement events (P2 #9) ([bb8a7c3](https://github.com/event4u-app/agent-config/commit/bb8a7c39b9ecb36219eeb4d639706026f0e7db7b))
332
+ * **rules:** expand rule-interaction matrix to 13 pairs across 9 rules ([0ce5891](https://github.com/event4u-app/agent-config/commit/0ce589148ea1a4b56a7fd782bc3492682850024e))
333
+ * **ci:** add check-roadmap-trackable linter ([980e242](https://github.com/event4u-app/agent-config/commit/980e242189129271fb603222589eeb59864d3de6))
334
+ * **check-portability:** F1.5 add identity-framing detector (Layer 5) ([9245f3b](https://github.com/event4u-app/agent-config/commit/9245f3b29cb3719df40c321b0e5c3f7ed50f19dc))
335
+ * **ai-council:** Phase 2b — Manual mode + non-billable orchestrator path ([4cbe5ef](https://github.com/event4u-app/agent-config/commit/4cbe5ef6ff6959c42ebcb40df96f9e6a853d1d03))
336
+ * **ai-council:** Phase 2a — neutral project-context handoff ([25b64dc](https://github.com/event4u-app/agent-config/commit/25b64dc55e0eeba66141d128a8963042735b05dd))
337
+ * **ai-council:** pricing layer + per-member estimate gate + sequential overrun callback ([c6e0203](https://github.com/event4u-app/agent-config/commit/c6e0203acc8e50315e83ee56b156b95b00578fdc))
338
+ * **installer:** add keys:install-* CLI commands and gitignore .agent-prices.md ([c4c29a6](https://github.com/event4u-app/agent-config/commit/c4c29a64bf9335cfb2ae764b7c49a4a3f1ff5ba6))
339
+ * **ai-council:** add /council command + ai-council skill ([68e28e6](https://github.com/event4u-app/agent-config/commit/68e28e6992cd18b8808245b42e348d57f827359c))
340
+ * **ai-council:** implement core orchestrator, bundler, clients, prompts ([d16ef04](https://github.com/event4u-app/agent-config/commit/d16ef04d2d734f527127e3ef884d6a975347d0bd))
341
+ * **roadmap:** plan AI Council — external second-opinion workflow ([f973c38](https://github.com/event4u-app/agent-config/commit/f973c386fafa603bfc3d5935d8c1379d576e6236))
342
+ * **governance:** F7 — universal identity reframe + archive completed roadmap ([8a259f0](https://github.com/event4u-app/agent-config/commit/8a259f0b41cbba8c70961f6e83f1c8dd08e02094))
343
+ * **governance:** F6 — description-budget cap + augmentignore advisory ([5ac837d](https://github.com/event4u-app/agent-config/commit/5ac837d28971e4c8d679f5f3a1f25a0a4b6e50f7))
344
+ * **governance:** F5 — index generator for internal + public catalogs ([bae4e19](https://github.com/event4u-app/agent-config/commit/bae4e198356a7994644f3c19c8da552d5d61560b))
345
+ * **commands:** F2 — collapse fix/optimize/feature clusters into orchestrators ([5db2d1a](https://github.com/event4u-app/agent-config/commit/5db2d1a55533805c77195e35c800a89acdfe0bf3))
346
+ * **rules:** F1.2-F1.5 — close always-rule budget breach (37,879/49,000) ([b9eb922](https://github.com/event4u-app/agent-config/commit/b9eb92232b6ec72209e60ee7d43f167489124690))
347
+ * **rules:** add agent-authority Priority-Index router (F1.1) ([410653f](https://github.com/event4u-app/agent-config/commit/410653f1887bce755f314a97c542100e9dc4696e))
348
+
349
+ ### Bug Fixes
350
+
351
+ * **rules:** trim no-cheap-questions to satisfy top-5 always-rule cap ([41e575b](https://github.com/event4u-app/agent-config/commit/41e575b8439f7f654f0c65284626dbe2c06b9e39))
352
+ * **schema:** allow load_context in rule frontmatter ([342496e](https://github.com/event4u-app/agent-config/commit/342496e12adb7299bf6a20b5d7949aa657b0e6d4))
353
+ * **scripts:** exempt README hero/blurb from update_counts ([6c6822a](https://github.com/event4u-app/agent-config/commit/6c6822aa055698c5d008d6487ab1a65ab5d65fd3))
354
+ * **catalog:** point public catalog at shipped surface, add regression gate ([58ec2e9](https://github.com/event4u-app/agent-config/commit/58ec2e98b19aebe28ab2b718f2199adc2b6c6e82))
355
+ * **rules:** trim language-and-tone.md to satisfy always-rule budget cap ([d20c99a](https://github.com/event4u-app/agent-config/commit/d20c99a36fba5e6c76f21f0be8f3435d699e8d2c))
356
+ * **roadmap-progress:** support digit+letter phase ids (Phase 2a) ([968f7c6](https://github.com/event4u-app/agent-config/commit/968f7c64d39dfea043980cd5bc81af3970202966))
357
+ * **rules:** add 'fenced step' clause to scope-control ([be337d8](https://github.com/event4u-app/agent-config/commit/be337d856b503fc4e15d9d4dfcad5b34f05b2597))
358
+
359
+ ### Documentation
360
+
361
+ * **roadmap:** close + archive road-to-pr-34-followups ([4bb8d36](https://github.com/event4u-app/agent-config/commit/4bb8d3635eb4a8a386f8111ad2dd0a31ca4578fd))
362
+ * **contracts:** Phase 7.2 — publish always-rule budget contract ([ff65861](https://github.com/event4u-app/agent-config/commit/ff65861db977688d9c0fb266c256aab710ba1d6e))
363
+ * **roadmap:** close Phase 6 of road-to-pr-34-followups; mark 7.3 done ([0380083](https://github.com/event4u-app/agent-config/commit/0380083304a6ff22f0989acb3ff06259c58fe8b5))
364
+ * **contracts:** Phase 6.1 — subdirectory conventions for contexts/ ([befdd92](https://github.com/event4u-app/agent-config/commit/befdd92d6cec1b6104316c0270d9dc124f9a2dce))
365
+ * **roadmap:** close Phase 5 of road-to-pr-34-followups ([298b61f](https://github.com/event4u-app/agent-config/commit/298b61fac68efea9020d2a3e56327179116a29d1))
366
+ * **roadmap:** insert Phase 5 CI drift hygiene; renumber 5/6 → 6/7 ([0e708a5](https://github.com/event4u-app/agent-config/commit/0e708a57b40688fe3aeb29ece85873abc6cbc270))
367
+ * **roadmap:** narrow Phase 4.2 to existing engine vocabulary ([1905918](https://github.com/event4u-app/agent-config/commit/1905918cdfd1743680edc4ed1e22e9422424ed3c))
368
+ * **roadmap:** reframe Phase 4 — engine halt tests, not LLM eval ([3eb2017](https://github.com/event4u-app/agent-config/commit/3eb2017a062c7c082d651a03ffe8521e804ae940))
369
+ * **load-context:** close Phase 3 — first consumer documented + verified ([9b09833](https://github.com/event4u-app/agent-config/commit/9b098335e691ecf9c2808ceeabc318314379b367))
370
+ * **reports:** verify autonomous-execution obligation surface (Phase 2.5) ([2e66d8c](https://github.com/event4u-app/agent-config/commit/2e66d8c416c6589203ce61969ebaa3ef347dd299))
371
+ * **contexts:** extract autonomy EXAMPLES (Phase 2.3) ([4d56143](https://github.com/event4u-app/agent-config/commit/4d561437617c1cd74b1664bfab2154381f2352ae))
372
+ * **contexts:** extract autonomy LOGIC + MECHANICS (Phase 2.2) ([1875f9a](https://github.com/event4u-app/agent-config/commit/1875f9a0ea5ac9fa2ef1f3074d98622d0ad2787e))
373
+ * **roadmap:** pin Phase 2 to existing load_context: roots ([e2773f0](https://github.com/event4u-app/agent-config/commit/e2773f0635816d55f696d25be0aeb6107412949e))
374
+ * **roadmap:** inventory autonomous-execution.md (Phase 2.1) ([2bead66](https://github.com/event4u-app/agent-config/commit/2bead66ae89c6f3f54e324e4c4ba7354a939032d))
375
+ * **readme:** honest command count + governance-aligned hero wording ([1053d56](https://github.com/event4u-app/agent-config/commit/1053d56b3e52fd945a9c09555634abb74bfb2e81))
376
+ * **roadmaps:** add road-to-pr-34-followups (round-6 review + round-7 hardening) ([7375759](https://github.com/event4u-app/agent-config/commit/737575907570dc22f83e6e0325ec3a6a85aaf2d7))
377
+ * **roadmaps:** mark road-to-rebalancing complete + archive ([4c83f8e](https://github.com/event4u-app/agent-config/commit/4c83f8e752f83616209b79ae4fade551e932ef96))
378
+ * **contracts:** add rule-priority-hierarchy.md (Phase 5) ([949c7a9](https://github.com/event4u-app/agent-config/commit/949c7a95689b273302dee3f3d1b9f8694425a213))
379
+ * **rules:** point language-and-tone at the relocated examples doc ([45cc06c](https://github.com/event4u-app/agent-config/commit/45cc06c828d4535a013274952c3a3b627552d528))
380
+ * **guidelines:** relocate language-and-tone-examples into agent-infra/ (Phase 3) ([579e162](https://github.com/event4u-app/agent-config/commit/579e162e960e4dd024888efcbab9ac98c5eb3601))
381
+ * **roadmaps:** archive road-to-ai-council, mark council-modes Phase 2a/2b done ([9caba6d](https://github.com/event4u-app/agent-config/commit/9caba6d26a574591bafdc0e7c0a7f5434adbd717))
382
+ * add end-to-end walkthroughs + complete road-to-1-15-followups (P1 #7) ([fa29fc4](https://github.com/event4u-app/agent-config/commit/fa29fc4279c020579e9cfdb6b79ded37268bc012))
383
+ * **roadmaps:** mark P2 #9 shipped + regen dashboard ([821bcb1](https://github.com/event4u-app/agent-config/commit/821bcb16bd29cf2e06b260e341d6931d2a99677f))
384
+ * **roadmap:** mark P0 #2/#3 + P1 #5/#6 verified shipped ([caccf12](https://github.com/event4u-app/agent-config/commit/caccf129e27ac81994bf549741704989b22e53fc))
385
+ * **roadmaps:** canonicalize headings + tag drafts to satisfy linter ([a5e64b8](https://github.com/event4u-app/agent-config/commit/a5e64b8c8c051f79d3a3a1384f91136999a99150))
386
+ * **rules:** harden roadmap-progress-sync with trackability Iron Law ([ef426cd](https://github.com/event4u-app/agent-config/commit/ef426cdfc7463f4ac44e0e323c7904b82f71a745))
387
+ * **readme:** P0 #4 fix Token overhead wording in cost-profiles table ([1bcdb26](https://github.com/event4u-app/agent-config/commit/1bcdb26644875c5aee297957b0845bbab7240bc3))
388
+ * **agents,copilot:** F1.4 generalize Laravel framing in AGENTS + copilot ([c282ae3](https://github.com/event4u-app/agent-config/commit/c282ae3a2ae93658de69dc92082399df552cb317))
389
+ * **readme:** F1.3 reframe § Who this is for — Laravel as value, not headline ([2fa8022](https://github.com/event4u-app/agent-config/commit/2fa802269b2b936d621344dda0a995bd81bf9737))
390
+ * **readme:** F1.2 neutralize opener stack-naming (Laravel ≠ headline) ([d26bf68](https://github.com/event4u-app/agent-config/commit/d26bf68a94ab0471a7270dea95b5cb35190ca581))
391
+ * **roadmap:** F1.1 audit — Laravel-coloured identity language inventory ([2a42fad](https://github.com/event4u-app/agent-config/commit/2a42fad8b3f659d0c9c704942a3581cb7401057a))
392
+ * **roadmap:** rewrite rebalancing roadmap around layered architecture ([5786d9c](https://github.com/event4u-app/agent-config/commit/5786d9c3f7ba8a668f4cf72478d72dfa463aef29))
393
+ * **roadmap:** capture rebalancing roadmap from PR #34 review feedback ([55977d4](https://github.com/event4u-app/agent-config/commit/55977d4f60f4d665d26ea0f362fa2c581e7ebde5))
394
+ * **ai-council:** Phase 2a/2b skill + command + roadmap updates ([c6b284f](https://github.com/event4u-app/agent-config/commit/c6b284fe8fd361636b2c52c75e03d679981bd231))
395
+ * **roadmap:** capture 1.15.0 review followups -- identity rewrite as P0 #1 ([2abd676](https://github.com/event4u-app/agent-config/commit/2abd676aba025f5bc8efcd2ac2b5e27124f25a13))
396
+ * **roadmap:** plan AI Council Phase 2 -- context-handoff, manual + playwright modes ([b578d6d](https://github.com/event4u-app/agent-config/commit/b578d6da916f98eed2baa57a00089b8815033f9f))
397
+ * **ai-council:** document settings, install flow, and skill xref ([3b8a528](https://github.com/event4u-app/agent-config/commit/3b8a52875842fe4c939b2ae1049d347c0b7d443d))
398
+ * **roadmap:** F3.1 close-out — 5 of 6 renames done, row 4 N/A ([713ff59](https://github.com/event4u-app/agent-config/commit/713ff5900fa1ba6e494286f8fa7403c6e26e3966))
399
+
400
+ ### Refactoring
401
+
402
+ * **rules:** Phase 7.4 — slim non-destructive-by-default under 6k cap ([62d39ea](https://github.com/event4u-app/agent-config/commit/62d39ea296c0afe5822514d7c0c707ee91be7ce1))
403
+ * **rules:** Phase 6.2 — migrate 3 rules to load_context ([0b93832](https://github.com/event4u-app/agent-config/commit/0b9383244ff90a0e0fbaa2b387c55f3d65672096))
404
+ * **rules:** slim autonomous-execution + wire load_context: (Phase 2.4) ([94edd24](https://github.com/event4u-app/agent-config/commit/94edd24dd52e9d7ada2ecea4c90f23607686eda2))
405
+ * **commands:** F2 — convert 15 atomic commands to deprecation shims ([84283cb](https://github.com/event4u-app/agent-config/commit/84283cbb98192f6f25e567c902aec246eb55e49a))
406
+ * **governance:** F4 — update scripts, docs, and counts for relocated guidelines ([8234649](https://github.com/event4u-app/agent-config/commit/82346494df9efbca1392e55a858a993bec8b05c5))
407
+ * **governance:** F4 — relocate guidelines to docs/guidelines/ ([6a82c0c](https://github.com/event4u-app/agent-config/commit/6a82c0c8e51fffb9ad0278a8f69fa03dcc2ab808))
408
+ * **skills:** F3 — rename verify-before-complete (skill) → verify-completion-evidence ([1bada56](https://github.com/event4u-app/agent-config/commit/1bada563724a6a74c6e26dac988bde5c73d4246d))
409
+ * **rules:** F3 — rename command-suggestion → command-suggestion-policy ([2338aef](https://github.com/event4u-app/agent-config/commit/2338aeff2f81fc28beae1ae79e1e5584237bf7d2))
410
+ * **rules:** F3 — rename slash-commands → slash-command-routing-policy ([347caf8](https://github.com/event4u-app/agent-config/commit/347caf87cd2dbaeb90761f42865276789a0d89b7))
411
+ * **rules:** F3.2 — rename ui-audit-before-build → ui-audit-gate ([dcab51a](https://github.com/event4u-app/agent-config/commit/dcab51ae1535d10b56ff0afaa3164cd595a1b0d3))
412
+
413
+ ### Tests
414
+
415
+ * **golden:** lock governance anti-pattern baselines ([360f259](https://github.com/event4u-app/agent-config/commit/360f259b72e6d3ab69b4afc344aacf17beabf980))
416
+ * **golden:** add governance anti-pattern recipes ([960c0ec](https://github.com/event4u-app/agent-config/commit/960c0ecf1c106c09a81930a53da10a88e4420f4e))
417
+ * **ai-council:** contract tests for install_{openai,anthropic}_key.sh ([0e193bc](https://github.com/event4u-app/agent-config/commit/0e193bc588394dc41ae4f51cd65021c3c7c13521))
418
+ * **naming:** F3.2 — guard policy-verb vs tool-noun naming split ([efbe2db](https://github.com/event4u-app/agent-config/commit/efbe2dbf04a25fc873e78f5522996ed57bfcc176))
419
+
420
+ ### CI
421
+
422
+ * **budget:** Phase 7.4 — enforce per-rule 6k cap and top-3 ≤ 50% in CI + tests ([9e8b079](https://github.com/event4u-app/agent-config/commit/9e8b079fc8f11b274ff542d91469dd50381e5ae4))
423
+ * **budget:** Phase 7.1 — always-rule budget gate (warn 80% / fail 90%) ([b3af9ad](https://github.com/event4u-app/agent-config/commit/b3af9ad04334d678bf0d49a60c13808ba17a4450))
424
+ * **tests:** allow manual workflow_dispatch trigger on tests.yml ([e230e2b](https://github.com/event4u-app/agent-config/commit/e230e2bcb9e973a4450170cd4f09aba96116cb05))
425
+
426
+ ### Chores
427
+
428
+ * finish council modes ([c1496e4](https://github.com/event4u-app/agent-config/commit/c1496e4a240be4210c7624b41cb389065bdf3aee))
429
+ * update gitignore ([184c27f](https://github.com/event4u-app/agent-config/commit/184c27f6a8d9e7549432b9190f6c929ec1be63af))
430
+ * **index:** regenerate index/catalog for no-cheap-questions ([7c45498](https://github.com/event4u-app/agent-config/commit/7c454983735680ebe1b9efb72ad0e4533997e9b6))
431
+ * **tools:** regenerate .windsurfrules and rule symlinks ([8621e23](https://github.com/event4u-app/agent-config/commit/8621e23578c5200ce58888d1be3dc14a5705eb0e))
432
+ * **check-refs:** skip agents/council-sessions/ ([53ff5a6](https://github.com/event4u-app/agent-config/commit/53ff5a6ba28508bcee257d90302073d17c822e49))
433
+ * **index:** regen agents/index.md + docs/catalog.md for council-* commands ([c9d01e5](https://github.com/event4u-app/agent-config/commit/c9d01e5cb819042a4eecf47aec02ac9a8c96325b))
434
+ * **rules:** mark roadmap-progress-sync cloud_safe degrade and trim under 200-line cap ([c740054](https://github.com/event4u-app/agent-config/commit/c74005487a3898ae416b704ad2fbeea4c4c8daf4))
435
+ * **roadmap:** archive open-questions-3.md (all 13 closed) ([18ba9ba](https://github.com/event4u-app/agent-config/commit/18ba9ba789a9974e51258c2242c1bbb2dfbc5a52))
436
+ * **roadmap:** regenerate progress dashboard after Q43 closure ([f027c55](https://github.com/event4u-app/agent-config/commit/f027c550c6a7fe66eb189440ce22a46990977c45))
437
+ * **tools:** regenerate .windsurfrules after language-and-tone trim ([d9a6cf4](https://github.com/event4u-app/agent-config/commit/d9a6cf4921ca29787b4aaa46341eacd86493a8e8))
438
+ * **ai-council:** recompress council.md (Q43) + refresh stale hash ([005ba1b](https://github.com/event4u-app/agent-config/commit/005ba1bcebcdf945df4023d720fe924471448d3d))
439
+ * **ai-council:** post-install enable hint + close Phase-1 decisions ([595d475](https://github.com/event4u-app/agent-config/commit/595d475911f1621c84d846a2e10452611b7558f1))
440
+ * **readme:** trim 'Who this is for' below 500-line linter budget ([e06237d](https://github.com/event4u-app/agent-config/commit/e06237dec5ae61f26cf9456c7584e500f4a36f0f))
441
+ * **roadmap:** regenerate roadmaps-progress dashboard after F6 ([024916b](https://github.com/event4u-app/agent-config/commit/024916b2fe47deb4d77bc561ca9c8f82833c2da6))
442
+
443
+ ## [1.15.0](https://github.com/event4u-app/agent-config/compare/1.14.0...1.15.0) (2026-05-02)
444
+
445
+ ### Features
446
+
447
+ * **governance:** rule-interaction matrix + linter (P2.2) ([cd68591](https://github.com/event4u-app/agent-config/commit/cd6859174d289737b829fe49a4c7f92bd318a290))
448
+ * **rules:** split chat-history into ownership/cadence/visibility (P2.1) ([7b5348d](https://github.com/event4u-app/agent-config/commit/7b5348d2656c12000fca667c2e577c026839aa11))
449
+ * **governance:** command-collapse contract + atomic-command linter (P0.8) ([5f1ebb7](https://github.com/event4u-app/agent-config/commit/5f1ebb72484da28679f7a49fffc5cbb4bd7a07f6))
450
+ * **work_engine:** default state file → .work-state.json + collision-safe backup ([b0f487a](https://github.com/event4u-app/agent-config/commit/b0f487a3f261797320b3726211206f813f2c2c1a))
451
+ * **docs:** public contracts to docs/contracts/ + STABILITY policy + link checker ([7c6ac17](https://github.com/event4u-app/agent-config/commit/7c6ac17609d19505625cb4fa9a76798a403997ad))
452
+ * support capture-only roadmaps in dashboard generator ([c0df2dc](https://github.com/event4u-app/agent-config/commit/c0df2dc3c680a6cfa6c87f2e64868360695fa3ec))
453
+
454
+ ### Bug Fixes
455
+
456
+ * **rules:** restore Iron Law heading + code blocks in compressed roadmap-progress-sync ([96c633b](https://github.com/event4u-app/agent-config/commit/96c633b583fc17ea560fe1ddf7b915ab5a3be3f3))
457
+ * **ci:** clear check-refs regressions in roadmap files ([56b40f3](https://github.com/event4u-app/agent-config/commit/56b40f397e632337f5f69a507b13aa2b475453c3))
458
+
459
+ ### Performance
460
+
461
+ * **ci:** smoke GT subset + duration line + nightly full replay (P2.4) ([7b0608d](https://github.com/event4u-app/agent-config/commit/7b0608d3f51bac534f835424860049483ae6004a))
462
+
463
+ ### Documentation
464
+
465
+ * **ui-track:** 1-page mental model + archive Phase 2 roadmap — P2.10/P2.11 ([d87673d](https://github.com/event4u-app/agent-config/commit/d87673d75ec8cd0136336a1954b356a953b79e4e))
466
+ * **install:** relabel install paths (advanced/experimental/staged) — P2.5 ([66e5389](https://github.com/event4u-app/agent-config/commit/66e53894f3dd12ff0762a56f677e302d1ca726c1))
467
+ * add visible (beta) markers to public-surface contract links ([282b74f](https://github.com/event4u-app/agent-config/commit/282b74fccab2c0ba585271013c5fe61b396aaa09))
468
+ * positioning headline + work_engine vs runtime_dispatcher separation ([ccf833f](https://github.com/event4u-app/agent-config/commit/ccf833f07b34ff2c6c5cf64e8328fb67b7629c4d))
469
+ * **roadmaps:** reviewer feedback + directional → out-of-horizon ([6af0320](https://github.com/event4u-app/agent-config/commit/6af03205537d761a0cbe6c205662c34854deea6a))
470
+ * **rules:** position-agnostic recommendation in user-interaction ([ee57ae0](https://github.com/event4u-app/agent-config/commit/ee57ae0d233b3332f30dfd3d3f67b3954ce153ef))
471
+ * **roadmaps:** retire stale open-questions and placeholder sections ([c1ec177](https://github.com/event4u-app/agent-config/commit/c1ec17782521bb5688260d1873423fbf4d4adc99))
472
+ * **roadmaps:** synthesize decisions from multi-AI review ([4d9dcc1](https://github.com/event4u-app/agent-config/commit/4d9dcc19929fe7d3fa2657509a4b8a2e9a1ee7e2))
473
+ * add capture-only synthesis roadmaps ([d2bdb76](https://github.com/event4u-app/agent-config/commit/d2bdb76ec562d8a00313f49b388083fdad8f1b42))
474
+
475
+ ### Refactoring
476
+
477
+ * **work_engine:** modularise cli.py into 7 focused modules (P2.3) ([ad92366](https://github.com/event4u-app/agent-config/commit/ad9236681c1537beec3d407bead9b7386c57c73d))
478
+ * **roadmaps:** binary status model — ready (implicit) / draft (hidden) ([2d3d713](https://github.com/event4u-app/agent-config/commit/2d3d713a52ac039c08317817331ba6aaa81fcb12))
479
+
480
+ ### Tests
481
+
482
+ * **work_engine:** cover default state file + UI-prompt routing + medium-band halt (P0.7) ([e97c499](https://github.com/event4u-app/agent-config/commit/e97c499fa7daaf0478423efbdb34d648b6e400c8))
483
+
484
+ ### Chores
485
+
486
+ * **generated:** sync compressed projections for chat-history split (P2.1) ([f53a44f](https://github.com/event4u-app/agent-config/commit/f53a44f31fd7d93c28122b945f8059bd112dc854))
487
+ * **generated:** regenerate .windsurfrules after rule edits ([0090392](https://github.com/event4u-app/agent-config/commit/00903924eaf1955ad2049dc03c3c57d9f4ff016e))
488
+ * **roadmaps:** mark Phase 1 progress in road-to-post-pr29-optimize + dashboard ([a2160af](https://github.com/event4u-app/agent-config/commit/a2160afd6e7280bd3d4a71641fb4dba8234edf21))
489
+ * **scripts:** whitelist scripts/mcp_server/ in portability check ([259745e](https://github.com/event4u-app/agent-config/commit/259745e9f52ea0a60e3e92a553a5938b15adc0ca))
490
+
491
+ ### Other
492
+
493
+ * **readme:** drop redundant 'no runtime deps' bullet — clear 500-line limit ([53b5df4](https://github.com/event4u-app/agent-config/commit/53b5df481122ccbd70ce358a3192643c7fff73b0))
494
+ * **readme:** trim Stability tiers + command-suggestion blocks to clear 500-line limit ([5bb50ba](https://github.com/event4u-app/agent-config/commit/5bb50ba43d8734f5deb02c0b34c9c6e26475c52b))
495
+ * **rules:** trim roadmap-progress-sync to 199 lines (clear CI hard limit) ([12c3a2e](https://github.com/event4u-app/agent-config/commit/12c3a2e1357dfca7ec0bd2f6b507e606ec2de596))
496
+
300
497
  ## [1.14.0](https://github.com/event4u-app/agent-config/compare/1.13.0...1.14.0) (2026-05-01)
301
498
 
302
499
  ### Features