@event4u/agent-config 1.20.0 → 1.22.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 (268) hide show
  1. package/.agent-src/commands/agents.md +1 -1
  2. package/.agent-src/commands/bug-fix.md +2 -1
  3. package/.agent-src/commands/bug-investigate.md +3 -2
  4. package/.agent-src/commands/challenge-me/vision.md +348 -0
  5. package/.agent-src/commands/challenge-me/with-docs.md +333 -0
  6. package/.agent-src/commands/challenge-me.md +61 -0
  7. package/.agent-src/commands/chat-history/import.md +60 -64
  8. package/.agent-src/commands/compress.md +12 -0
  9. package/.agent-src/commands/context/create.md +2 -2
  10. package/.agent-src/commands/context.md +1 -1
  11. package/.agent-src/commands/copilot-agents.md +1 -1
  12. package/.agent-src/commands/council/default.md +69 -10
  13. package/.agent-src/commands/council.md +1 -1
  14. package/.agent-src/commands/create-pr.md +7 -3
  15. package/.agent-src/commands/e2e-heal.md +1 -1
  16. package/.agent-src/commands/e2e-plan.md +1 -1
  17. package/.agent-src/commands/feature/dev.md +3 -3
  18. package/.agent-src/commands/feature.md +1 -1
  19. package/.agent-src/commands/fix/seeder.md +2 -2
  20. package/.agent-src/commands/fix.md +1 -1
  21. package/.agent-src/commands/grill-me.md +38 -0
  22. package/.agent-src/commands/jira-ticket.md +1 -1
  23. package/.agent-src/commands/judge/steps.md +1 -1
  24. package/.agent-src/commands/judge.md +2 -2
  25. package/.agent-src/commands/memory.md +1 -1
  26. package/.agent-src/commands/mode.md +5 -5
  27. package/.agent-src/commands/module.md +1 -1
  28. package/.agent-src/commands/onboard.md +4 -4
  29. package/.agent-src/commands/optimize/augmentignore.md +1 -1
  30. package/.agent-src/commands/optimize-prompt.md +61 -0
  31. package/.agent-src/commands/optimize.md +1 -1
  32. package/.agent-src/commands/override.md +1 -1
  33. package/.agent-src/commands/review-changes.md +1 -1
  34. package/.agent-src/commands/review-routing.md +1 -1
  35. package/.agent-src/commands/roadmap/ai-council.md +183 -0
  36. package/.agent-src/commands/roadmap/create.md +6 -1
  37. package/.agent-src/commands/roadmap/process-full.md +58 -0
  38. package/.agent-src/commands/roadmap/process-phase.md +69 -0
  39. package/.agent-src/commands/roadmap/process-step.md +57 -0
  40. package/.agent-src/commands/roadmap.md +45 -17
  41. package/.agent-src/commands/set-cost-profile.md +3 -3
  42. package/.agent-src/commands/sync-agent-settings.md +2 -2
  43. package/.agent-src/commands/tests/create.md +2 -2
  44. package/.agent-src/commands/tests.md +1 -1
  45. package/.agent-src/commands/threat-model.md +5 -4
  46. package/.agent-src/contexts/augment-infrastructure.md +1 -1
  47. package/.agent-src/contexts/authority/commit-mechanics.md +14 -1
  48. package/.agent-src/contexts/authority/destructive-mechanics.md +14 -1
  49. package/.agent-src/contexts/authority/scope-mechanics.md +5 -0
  50. package/.agent-src/contexts/communication/rules-auto/guidelines-mechanics.md +76 -0
  51. package/.agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md +54 -19
  52. package/.agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md +98 -0
  53. package/.agent-src/contexts/communication/rules-auto/token-efficiency-mechanics.md +93 -0
  54. package/.agent-src/contexts/communication/rules-auto/user-interaction-mechanics.md +128 -5
  55. package/.agent-src/contexts/execution/autonomy-mechanics.md +44 -0
  56. package/.agent-src/contexts/execution/roadmap-process-loop.md +125 -0
  57. package/.agent-src/contexts/model-recommendations.md +2 -2
  58. package/.agent-src/contexts/override-system.md +1 -1
  59. package/.agent-src/contexts/skills-and-commands.md +1 -1
  60. package/.agent-src/personas/product-owner.md +2 -2
  61. package/.agent-src/personas/qa.md +1 -1
  62. package/.agent-src/rules/agent-authority.md +5 -6
  63. package/.agent-src/rules/agent-docs.md +11 -53
  64. package/.agent-src/rules/analysis-skill-routing.md +10 -40
  65. package/.agent-src/rules/architecture.md +6 -1
  66. package/.agent-src/rules/artifact-drafting-protocol.md +5 -0
  67. package/.agent-src/rules/artifact-engagement-recording.md +23 -59
  68. package/.agent-src/rules/ask-when-uncertain.md +24 -47
  69. package/.agent-src/rules/augment-portability.md +14 -62
  70. package/.agent-src/rules/augment-source-of-truth.md +10 -1
  71. package/.agent-src/rules/autonomous-execution.md +17 -98
  72. package/.agent-src/rules/capture-learnings.md +9 -80
  73. package/.agent-src/rules/cli-output-handling.md +12 -42
  74. package/.agent-src/rules/command-suggestion-policy.md +25 -73
  75. package/.agent-src/rules/commit-conventions.md +9 -58
  76. package/.agent-src/rules/commit-policy.md +16 -47
  77. package/.agent-src/rules/context-hygiene.md +5 -0
  78. package/.agent-src/rules/direct-answers.md +21 -50
  79. package/.agent-src/rules/docker-commands.md +11 -45
  80. package/.agent-src/rules/docs-sync.md +10 -56
  81. package/.agent-src/rules/downstream-changes.md +5 -0
  82. package/.agent-src/rules/e2e-testing.md +9 -44
  83. package/.agent-src/rules/guidelines.md +13 -75
  84. package/.agent-src/rules/improve-before-implement.md +11 -2
  85. package/.agent-src/rules/invite-challenge.md +71 -0
  86. package/.agent-src/rules/language-and-tone.md +41 -106
  87. package/.agent-src/rules/laravel-translations.md +11 -40
  88. package/.agent-src/rules/markdown-safe-codeblocks.md +4 -0
  89. package/.agent-src/rules/minimal-safe-diff.md +4 -0
  90. package/.agent-src/rules/missing-tool-handling.md +4 -0
  91. package/.agent-src/rules/model-recommendation.md +9 -61
  92. package/.agent-src/rules/no-attribution-footers.md +5 -0
  93. package/.agent-src/rules/no-cheap-questions.md +11 -27
  94. package/.agent-src/rules/no-council-references.md +76 -0
  95. package/.agent-src/rules/no-roadmap-references.md +7 -0
  96. package/.agent-src/rules/non-destructive-by-default.md +13 -43
  97. package/.agent-src/rules/onboarding-gate.md +9 -117
  98. package/.agent-src/rules/package-ci-checks.md +10 -37
  99. package/.agent-src/rules/php-coding.md +10 -55
  100. package/.agent-src/rules/preservation-guard.md +9 -0
  101. package/.agent-src/rules/review-routing-awareness.md +9 -97
  102. package/.agent-src/rules/reviewer-awareness.md +8 -83
  103. package/.agent-src/rules/roadmap-progress-sync.md +7 -170
  104. package/.agent-src/rules/role-mode-adherence.md +6 -2
  105. package/.agent-src/rules/rule-type-governance.md +8 -66
  106. package/.agent-src/rules/runtime-safety.md +5 -0
  107. package/.agent-src/rules/scope-control.md +17 -62
  108. package/.agent-src/rules/security-sensitive-stop.md +7 -1
  109. package/.agent-src/rules/size-enforcement.md +6 -1
  110. package/.agent-src/rules/skill-improvement-trigger.md +9 -49
  111. package/.agent-src/rules/skill-quality.md +7 -113
  112. package/.agent-src/rules/slash-command-routing-policy.md +11 -63
  113. package/.agent-src/rules/think-before-action.md +22 -87
  114. package/.agent-src/rules/token-efficiency.md +10 -74
  115. package/.agent-src/rules/token-optimizer-maintenance.md +68 -0
  116. package/.agent-src/rules/tool-safety.md +4 -0
  117. package/.agent-src/rules/ui-audit-gate.md +25 -61
  118. package/.agent-src/rules/upstream-proposal.md +9 -67
  119. package/.agent-src/rules/user-interaction.md +22 -108
  120. package/.agent-src/rules/verify-before-complete.md +1 -1
  121. package/.agent-src/skills/adversarial-review/SKILL.md +1 -0
  122. package/.agent-src/skills/agent-docs-writing/SKILL.md +1 -1
  123. package/.agent-src/skills/ai-council/SKILL.md +197 -8
  124. package/.agent-src/skills/analysis-autonomous-mode/SKILL.md +1 -1
  125. package/.agent-src/skills/analysis-skill-router/SKILL.md +3 -3
  126. package/.agent-src/skills/artisan-commands/SKILL.md +2 -2
  127. package/.agent-src/skills/authz-review/SKILL.md +1 -1
  128. package/.agent-src/skills/aws-infrastructure/SKILL.md +5 -5
  129. package/.agent-src/skills/blast-radius-analyzer/SKILL.md +8 -8
  130. package/.agent-src/skills/bug-analyzer/SKILL.md +6 -5
  131. package/.agent-src/skills/code-refactoring/SKILL.md +4 -4
  132. package/.agent-src/skills/code-review/SKILL.md +2 -2
  133. package/.agent-src/skills/command-writing/SKILL.md +11 -0
  134. package/.agent-src/skills/composer-packages/SKILL.md +2 -2
  135. package/.agent-src/skills/context-authoring/SKILL.md +11 -0
  136. package/.agent-src/skills/context-document/SKILL.md +1 -1
  137. package/.agent-src/skills/copilot-agents-optimization/SKILL.md +23 -0
  138. package/.agent-src/skills/copilot-config/SKILL.md +1 -1
  139. package/.agent-src/skills/dependency-upgrade/SKILL.md +2 -2
  140. package/.agent-src/skills/devcontainer/SKILL.md +2 -2
  141. package/.agent-src/skills/developer-like-execution/SKILL.md +1 -1
  142. package/.agent-src/skills/docker/SKILL.md +1 -1
  143. package/.agent-src/skills/dto-creator/SKILL.md +1 -1
  144. package/.agent-src/skills/estimate-ticket/SKILL.md +2 -2
  145. package/.agent-src/skills/fe-design/SKILL.md +4 -4
  146. package/.agent-src/skills/feature-planning/SKILL.md +5 -5
  147. package/.agent-src/skills/funnel-analysis/SKILL.md +1 -1
  148. package/.agent-src/skills/laravel/SKILL.md +1 -1
  149. package/.agent-src/skills/laravel-notifications/SKILL.md +5 -5
  150. package/.agent-src/skills/laravel-pennant/SKILL.md +1 -1
  151. package/.agent-src/skills/laravel-pulse/SKILL.md +4 -4
  152. package/.agent-src/skills/laravel-reverb/SKILL.md +2 -2
  153. package/.agent-src/skills/laravel-scheduling/SKILL.md +1 -1
  154. package/.agent-src/skills/migration-creator/SKILL.md +7 -7
  155. package/.agent-src/skills/multi-tenancy/SKILL.md +8 -8
  156. package/.agent-src/skills/performance-analysis/SKILL.md +3 -3
  157. package/.agent-src/skills/pest-testing/SKILL.md +6 -6
  158. package/.agent-src/skills/php-service/SKILL.md +2 -2
  159. package/.agent-src/skills/project-analysis-hypothesis-driven/SKILL.md +3 -3
  160. package/.agent-src/skills/project-analysis-react/SKILL.md +1 -1
  161. package/.agent-src/skills/project-analysis-symfony/SKILL.md +1 -1
  162. package/.agent-src/skills/project-analysis-zend-laminas/SKILL.md +2 -2
  163. package/.agent-src/skills/project-analyzer/SKILL.md +4 -4
  164. package/.agent-src/skills/prompt-optimizer/SKILL.md +108 -0
  165. package/.agent-src/skills/readme-reviewer/SKILL.md +1 -1
  166. package/.agent-src/skills/roadmap-management/SKILL.md +7 -7
  167. package/.agent-src/skills/rule-writing/SKILL.md +33 -0
  168. package/.agent-src/skills/sentry-integration/SKILL.md +1 -1
  169. package/.agent-src/skills/skill-writing/SKILL.md +14 -0
  170. package/.agent-src/skills/systematic-debugging/SKILL.md +22 -2
  171. package/.agent-src/skills/technical-specification/SKILL.md +58 -1
  172. package/.agent-src/skills/terraform/SKILL.md +2 -2
  173. package/.agent-src/skills/terragrunt/SKILL.md +8 -8
  174. package/.agent-src/skills/test-performance/SKILL.md +5 -5
  175. package/.agent-src/skills/threat-modeling/SKILL.md +3 -2
  176. package/.agent-src/skills/token-optimizer/SKILL.md +110 -0
  177. package/.agent-src/skills/universal-project-analysis/SKILL.md +1 -1
  178. package/.agent-src/templates/AGENTS.md +1 -1
  179. package/.agent-src/templates/agent-settings.md +35 -19
  180. package/.agent-src/templates/command.md +17 -1
  181. package/.agent-src/templates/contexts/tenant-boundaries.md +2 -2
  182. package/.agent-src/templates/contexts.md +1 -1
  183. package/.agent-src/templates/copilot-instructions.md +21 -0
  184. package/.agent-src/templates/copilot-review-instructions.md +76 -0
  185. package/.agent-src/templates/features.md +1 -1
  186. package/.agent-src/templates/roadmaps.md +10 -2
  187. package/.agent-src/templates/rule.md +129 -0
  188. package/.agent-src/templates/skill.md +17 -0
  189. package/.claude-plugin/marketplace.json +12 -2
  190. package/AGENTS.md +32 -5
  191. package/CHANGELOG.md +107 -3
  192. package/README.md +22 -21
  193. package/config/agent-settings.template.yml +66 -10
  194. package/config/gitignore-block.txt +7 -0
  195. package/docs/architecture.md +86 -5
  196. package/docs/catalog.md +16 -6
  197. package/docs/contracts/agent-memory-contract.md +1 -1
  198. package/docs/contracts/command-clusters.md +45 -1
  199. package/docs/contracts/context-paths.md +2 -1
  200. package/docs/contracts/file-ownership-matrix.json +354 -500
  201. package/docs/contracts/iron-law-overrides.txt +25 -0
  202. package/docs/contracts/kernel-membership.md +273 -0
  203. package/docs/contracts/load-context-schema.md +26 -11
  204. package/docs/contracts/pilot/agent-authority.md +24 -0
  205. package/docs/contracts/pilot/direct-answers.md +70 -0
  206. package/docs/contracts/pilot/language-and-tone.md +63 -0
  207. package/docs/contracts/rule-classification.md +170 -0
  208. package/docs/contracts/rule-router.md +153 -0
  209. package/docs/customization.md +17 -6
  210. package/docs/decisions/ADR-001-kernel-swap-deferred.md +109 -0
  211. package/docs/decisions/ADR-002-kernel-bucket-overrides.md +124 -0
  212. package/docs/decisions/ADR-003-flat-cluster-subs-and-colon-syntax.md +126 -0
  213. package/docs/decisions/ADR-rule-kernel-and-router.md +122 -0
  214. package/docs/getting-started.md +2 -2
  215. package/docs/guidelines/agent-infra/naming.md +1 -1
  216. package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md +176 -0
  217. package/docs/guidelines/agent-infra/rule-type-governance.md +73 -0
  218. package/docs/guidelines/agent-infra/size-and-scope.md +13 -2
  219. package/docs/guidelines/agent-infra/skill-quality-checklist.md +119 -0
  220. package/docs/guidelines/augment-portability-patterns.md +68 -0
  221. package/docs/guidelines/php/php-coding-patterns.md +62 -0
  222. package/package.json +1 -1
  223. package/scripts/_p43_bodies.py +235 -0
  224. package/scripts/_p43_compress.py +118 -0
  225. package/scripts/_p4_migrate.py +199 -0
  226. package/scripts/_phase2_shim_helper.py +1 -1
  227. package/scripts/_pilot_council_question.py +57 -0
  228. package/scripts/_pilot_measure.py +53 -0
  229. package/scripts/ai_council/session.py +107 -5
  230. package/scripts/build_linear_digest.py +3 -5
  231. package/scripts/check_always_budget.py +39 -6
  232. package/scripts/check_compressed_paths.py +213 -0
  233. package/scripts/check_compression.py +15 -0
  234. package/scripts/check_context_paths.py +1 -0
  235. package/scripts/check_council_layout.py +105 -0
  236. package/scripts/check_council_references.py +145 -0
  237. package/scripts/check_portability.py +2 -0
  238. package/scripts/check_references.py +2 -0
  239. package/scripts/check_token_optimizer_freshness.py +131 -0
  240. package/scripts/compile_router.py +148 -0
  241. package/scripts/compress.py +219 -11
  242. package/scripts/council_cli.py +132 -11
  243. package/scripts/council_prune.py +81 -0
  244. package/scripts/count_token_optimizer_usage.sh +54 -0
  245. package/scripts/install.sh +44 -2
  246. package/scripts/iron_law_sha.py +98 -0
  247. package/scripts/lint_load_context.py +35 -5
  248. package/scripts/measure_rule_budget.py +314 -0
  249. package/scripts/migrate_command_suggestions.py +2 -2
  250. package/scripts/prototype_lint_contradictions.py +150 -0
  251. package/scripts/schemas/command.schema.json +5 -0
  252. package/scripts/schemas/rule.schema.json +60 -6
  253. package/scripts/schemas/skill.schema.json +5 -0
  254. package/scripts/skill_linter.py +197 -7
  255. package/scripts/smoke_path_resolution.py +93 -0
  256. package/scripts/validate_frontmatter.py +41 -1
  257. package/.agent-src/commands/roadmap/execute.md +0 -109
  258. package/.agent-src/contexts/communication/rules-auto/artifact-engagement-recording-mechanics.md +0 -72
  259. package/.agent-src/contexts/communication/rules-auto/augment-portability-mechanics.md +0 -79
  260. package/.agent-src/contexts/communication/rules-auto/cli-output-handling-mechanics.md +0 -87
  261. package/.agent-src/contexts/communication/rules-auto/command-suggestion-policy-mechanics.md +0 -62
  262. package/.agent-src/contexts/communication/rules-auto/docs-sync-mechanics.md +0 -78
  263. package/.agent-src/contexts/communication/rules-auto/package-ci-checks-mechanics.md +0 -85
  264. package/.agent-src/contexts/communication/rules-auto/review-routing-awareness-mechanics.md +0 -65
  265. package/.agent-src/contexts/communication/rules-auto/roadmap-progress-sync-mechanics.md +0 -78
  266. package/.agent-src/contexts/communication/rules-auto/ui-audit-gate-mechanics.md +0 -53
  267. /package/{docs → .agent-src/contexts}/contracts/artifact-engagement-flow.md +0 -0
  268. /package/{docs → .agent-src/contexts}/contracts/command-suggestion-flow.md +0 -0
@@ -2,179 +2,16 @@
2
2
  type: "auto"
3
3
  tier: "1"
4
4
  description: "Any touch to agents/roadmaps/ — create/rename/delete/move, edit checkboxes ([x]/[~]/[-]), add/rename/remove phases — must regenerate dashboard and archive if 0 open items, same response"
5
- alwaysApply: false
6
5
  source: package
7
- load_context:
8
- - .agent-src.uncompressed/contexts/communication/rules-auto/roadmap-progress-sync-mechanics.md
6
+ triggers:
7
+ - path_prefix: "agents/roadmaps/"
8
+ routes_to:
9
+ - "guideline:agent-infra/roadmap-progress-mechanics"
9
10
  ---
10
11
 
11
- <!-- cloud_safe: degrade -->
12
- <!-- Authoring discipline applies in cloud; local script + regen are no-ops there. -->
13
-
14
12
  # Roadmap Progress Sync
15
13
 
16
- > **Enforced by:** [`scripts/roadmap_progress_hook.py`](../../scripts/roadmap_progress_hook.py)
17
- > on Augment + Claude Code (`PostToolUse`). Hook is primary; the prose
18
- > below is the specification the hook implements and the fallback when
19
- > the platform has no hook surface.
20
-
21
- ## Iron Law — dashboard sync
22
-
23
- ```
24
- ANY ROADMAP TOUCH → REGENERATE THE DASHBOARD, SAME RESPONSE.
25
- NO EXCEPTIONS. NO "I'LL DO IT AT THE END". NO BATCHING ACROSS TURNS.
26
- A ROADMAP NOT IN THE DASHBOARD IS A RULE VIOLATION, NOT AN OVERSIGHT.
27
- ```
28
-
29
- **Roadmap touch =** create the file, rename it, delete it, move it
30
- between `roadmaps/` ↔ `archive/` ↔ `skipped/`, add/rename/remove a
31
- phase, **OR** flip any checkbox (`[ ]` ↔ `[x]` ↔ `[~]` ↔ `[-]`).
32
-
33
- `agents/roadmaps-progress.md` is the read-only dashboard. Every
34
- unsynced edit makes it lie to the next reader. Created a roadmap
35
- without regenerating? The dashboard claims it does not exist. Marked
36
- 8 steps `[x]` and forgot the regen? The dashboard says 0 done.
37
-
38
- ## Iron Law — every active roadmap is trackable
39
-
40
- ```
41
- EVERY ACTIVE ROADMAP MUST CONTAIN AT LEAST ONE TRACKABLE CHECKBOX
42
- (`- [ ]`) PER NON-INTRO PHASE. ROADMAPS WITHOUT EXECUTABLE STEPS
43
- EITHER GET A CHECKLIST OR THE `status: draft` FLAG.
44
- CI-ENFORCED: `scripts/check_roadmap_trackable.py` (CANNOT BE DEFERRED).
45
- ```
46
-
47
- **Active roadmap =** any file in `agents/roadmaps/` (root, not
48
- `archive/` or `skipped/`) without `status: draft` frontmatter.
49
-
50
- **Trackable checkbox =** an actionable `- [ ]` line under a `## Phase N`
51
- or `### Phase N` heading (numeric `Phase 1`, roman `Phase II`, or
52
- letter-track `Phase A1` — matched by the dashboard's `PHASE_RE`).
53
- Tables of decisions, ICE matrices, ADR captures, and "block
54
- sequencing" tables are valid **rationale**, but they do not satisfy
55
- this rule on their own — they must be paired with at least one
56
- `## Phase N` section whose checkboxes execute the decision.
57
- Headings such as `## Phase steps`, `### Sequencing — Phase 1 …`,
58
- `### P0 #1 — …`, or `## Block A` do **not** count — only the
59
- canonical `Phase <id>` form parsed by the dashboard.
60
-
61
- **CI backstop.** `scripts/check_roadmap_trackable.py` (package-shipped,
62
- wire into the consumer's pre-commit / pre-push / Actions gate) fails
63
- when an active roadmap has zero canonical `Phase` headings or when
64
- any parsed phase has zero checkboxes. Last line of defence — real-time
65
- authoring still flips checkboxes and regenerates the dashboard the
66
- same response.
67
-
68
- ## Status — binary `ready` (default) vs `draft`
69
-
70
- ```yaml
71
- ---
72
- status: draft # hidden from the dashboard until flipped
73
- ---
74
- ```
75
-
76
- Two values, no synonyms. Anything else — no frontmatter at all,
77
- `status: ready`, an unknown value — counts as **ready** and lands
78
- in the dashboard.
79
-
80
- - **Ready** is the implicit default. New roadmaps are created
81
- ready unless the user explicitly says draft. Ready roadmaps are
82
- listed in the dashboard, count towards open/done totals, and
83
- trip the "completed but not archived" warning when they close.
84
- - **Draft** hides the file from the dashboard entirely (not
85
- counted, not listed). Use it while the roadmap is still being
86
- authored, while waiting for upstream decisions, or as a
87
- capture-only synthesis that has not yet been promoted to
88
- executable phases. Flip to ready (or remove the field) the
89
- moment the roadmap is ready to track.
90
-
91
- **Completion = archival, same response.** When the edit takes a
92
- roadmap to `count_open == 0` (every item is `[x]`, `[~]`, or `[-]`),
93
- `git mv` it into `agents/roadmaps/archive/` (or `skipped/` if no `[x]`
94
- at all) **before** regenerating the dashboard. A 100%-complete
95
- roadmap left under `agents/roadmaps/` is a rule violation, not an
96
- optional cleanup. See `roadmap-management` skill for the archive vs
97
- skipped decision table.
98
-
99
- ## Agent-authored roadmaps — placement is mandatory
100
-
101
- ```
102
- A FILE THE AGENT DROPS INTO agents/roadmaps/ MUST EITHER
103
- (a) PASS check_roadmap_trackable.py AND LAND IN THE DASHBOARD, OR
104
- (b) NOT BE IN agents/roadmaps/ AT ALL.
105
- NO "DECISION MATRIX" / "DESIGN NOTE" SHORTCUT.
106
- ```
107
-
108
- When the agent autonomously creates a roadmap, it owns the placement
109
- in the **same response**:
110
-
111
- - **Phase plan** (checkboxes, multi-turn execution) → `agents/roadmaps/<name>.md`, `status: ready` (default), regen dashboard.
112
- - **Decision matrix / ADR / pattern / lookup** (no `Phase N`, durable rationale) → `agents/contexts/<name>.md`.
113
- - **Completed work snapshot** → `agents/roadmaps/archive/<name>.md`.
114
-
115
- A non-trackable file in `agents/roadmaps/` is a rule violation — the
116
- trackable CI fails it, the dashboard hides it. The agent that
117
- created it moves it the same response. If the autonomous run also
118
- **finishes** the roadmap within the session (every box `[x]`/`[~]`/`[-]`),
119
- the completion-archival rule above fires too — same response.
120
-
121
- ## Autonomous execution — checkbox cadence
122
-
123
- When executing a roadmap autonomously (multi-turn, no per-step user
124
- prompt), the user loses progress visibility unless checkboxes flip
125
- **as work lands**, not in a batch at the end. Iron Law:
126
-
127
- ```
128
- EVERY DONE STEP FLIPS [ ] → [x] IN NEXT REPLY THAT ACKNOWLEDGES IT.
129
- NO "I UPDATE ROADMAP AT END OF PHASE."
130
- NO "FOUR STEPS DONE, ONE COMMIT, ONE REGEN."
131
- ```
132
-
133
- Step counts as completed when:
134
-
135
- - Code / docs change for that step has been **written and saved** AND
136
- - Verification cited in the step (project CI command, targeted test, lint) has
137
- **passed in this response or an earlier one** — fresh output, not memory.
138
-
139
- Then in the **same reply**: flip the checkbox, regenerate the
140
- dashboard, commit if commit policy allows.
141
-
142
- **Forbidden:** four turns of step work, dashboard flat, single regen at the end.
143
- **Required:** each turn — implement step, flip `[x]`, regen, commit (if policy allows).
144
- A reply that lands a verified step without flipping its checkbox is a rule violation.
145
-
146
- **In-progress marker:** when a step takes more than one reply,
147
- mark it `[~]` the moment work starts on it and regenerate. The
148
- user sees one row move from `[ ]` to `[~]` to `[x]` instead of
149
- silent rows. `[~]` is treated as open for `count_open` but moves
150
- the phase percentage forward in the dashboard.
151
-
152
- ## Mechanics — triggers, regen command, self-check, failures
153
-
154
- The triggers table, the regen command (`./agent-config roadmap:progress`),
155
- the mandatory pre-send self-check, the failure-mode catalog, and the
156
- `Do NOT` list live in
157
- [`contexts/communication/rules-auto/roadmap-progress-sync-mechanics.md`](../contexts/communication/rules-auto/roadmap-progress-sync-mechanics.md).
158
- Pull it whenever a trigger fires — the rule above is the obligation
159
- surface; the mechanics file is the lookup material.
160
-
161
- ## Copilot fallback
162
-
163
- GitHub Copilot has no `PostToolUse` hook surface, so
164
- `scripts/roadmap_progress_hook.py` cannot detect roadmap-file writes
165
- structurally. The dashboard at `agents/roadmaps-progress.md` will
166
- not regenerate on its own.
167
-
168
- The cooperative path: every time a roadmap touch fires (per the
169
- trigger list in the mechanics context above), the agent regenerates
170
- the dashboard in the same response — which is the same Iron Law the
171
- hook enforces, just executed manually:
172
-
173
- ```bash
174
- ./agent-config roadmap:progress
175
- ```
14
+ **Iron Law.** Any touch to `agents/roadmaps/` regenerates the dashboard in the same response; archive the roadmap when 0 open items remain.
176
15
 
177
- The hook implementation is the specification; on Copilot the agent
178
- runs the regenerator itself after the same triggers fire. Skipping
179
- it is a rule violation, not a hook gap — the Iron Law on dashboard
180
- sync survives the missing hook surface.
16
+ Body migrated to `guideline:agent-infra/roadmap-progress-mechanics` (per P4 of `road-to-kernel-and-router.md`).
17
+ Trigger-set above activates this routing under the `balanced` and `full` profiles.
@@ -4,13 +4,17 @@ tier: "2a"
4
4
  description: "When roles.active_role is set in .agent-settings.yml — closing outputs must match the mode's contract and emit the structured mode marker"
5
5
  alwaysApply: false
6
6
  source: package
7
+ triggers:
8
+ - keyword: "active_role"
9
+ - keyword: "role-mode"
10
+ - intent: "mode marker"
7
11
  ---
8
12
 
9
13
  # Role Mode Adherence
10
14
 
11
15
  Auto-activates when `.agent-settings.yml` sets `roles.active_role` to
12
16
  one of the six modes defined in
13
- [`role-contracts`](../../docs/guidelines/agent-infra/role-contracts.md):
17
+ [`role-contracts`](../docs/guidelines/agent-infra/role-contracts.md):
14
18
  `developer`, `reviewer`, `tester`, `po`, `incident`, `planner`.
15
19
 
16
20
  Read `roles.active_role` from `.agent-settings.yml` at session start. Empty / missing → rule is inert; do NOT guess a mode.
@@ -47,7 +51,7 @@ Infer the mode (Phase-3 router does that). Touch `.agent-settings.yml`
47
51
 
48
52
  ## See also
49
53
 
50
- - [`role-contracts`](../../docs/guidelines/agent-infra/role-contracts.md)
54
+ - [`role-contracts`](../docs/guidelines/agent-infra/role-contracts.md)
51
55
  - [`/mode`](../commands/mode.md)
52
56
  - [`ask-when-uncertain`](ask-when-uncertain.md)
53
57
  - [`scope-control`](scope-control.md)
@@ -2,74 +2,16 @@
2
2
  type: "auto"
3
3
  tier: "2a"
4
4
  description: "Creating or editing rules, or auditing rule types — decides when a rule should be always vs auto"
5
- alwaysApply: false
6
5
  source: package
6
+ triggers:
7
+ - path_prefix: ".agent-src.uncompressed/rules/"
8
+ routes_to:
9
+ - "guideline:agent-infra/rule-type-governance"
7
10
  ---
8
11
 
9
- # rule-type-governance
12
+ # Rule Type Governance
10
13
 
11
- ## `always` = loaded every conversation
14
+ **Iron Law.** Choose `always` vs `auto` per the governance table; over-broad `always` rules degrade the kernel budget.
12
15
 
13
- Use ONLY when the rule applies to virtually every interaction:
14
-
15
- - Universal agent behavior (language, tone, interaction style)
16
- - Safety constraints (scope control, verification before completion)
17
- - Token/efficiency constraints
18
- - First-message checks that cannot wait for auto-trigger
19
-
20
- ## `auto` = loaded on demand by description match
21
-
22
- Use for everything else:
23
-
24
- - Language-specific rules (PHP, JS, SQL)
25
- - Tool-specific rules (Docker, Git, quality tools)
26
- - Workflow-specific rules (commands, skill creation, E2E testing)
27
- - Domain-specific rules (translations, architecture)
28
-
29
- ## Decision test
30
-
31
- > "Does this rule need to be active when the user asks a simple question, reviews a PR, or discusses architecture?"
32
-
33
- - Yes → `always`
34
- - No → `auto` with a clear trigger description
35
-
36
- ## Auto description quality
37
-
38
- The `description` field IS the trigger. It must describe **when** the rule applies, not **what** it contains.
39
-
40
- - ❌ `"PHP coding standards"` — too vague, won't match reliably
41
- - ✅ `"Writing or reviewing PHP code — strict types, naming, Eloquent conventions"`
42
-
43
- ## Hard constraint
44
-
45
- - Default to `auto`. Justify `always`.
46
- - If >50% of conversations don't need a rule → it must be `auto`.
47
- - `optimize-agents` command checks this and suggests changes.
48
-
49
- ## Hardening tier — required on new or edited rules
50
-
51
- Every new rule, and every edited rule whose body changes the trigger
52
- or the obligation, MUST classify itself against the hardening tiers
53
- documented in [`rule-trigger-matrix.md`](../../agents/contexts/rule-trigger-matrix.md):
54
-
55
- | Tier | Meaning |
56
- |---|---|
57
- | `1` | Mechanically enforceable — hook acts, rule body stays minimal. |
58
- | `2a` | Marker nudge — hook injects signal, agent acts on it. |
59
- | `2b` | Structured injection / tool-call gate — hook reads/writes state, may deny. |
60
- | `3` | Soft, judgment-bound — no platform surface; self-check rule. |
61
- | `safety-floor` | Iron-Law subset, never modified. |
62
- | `mechanical-already` | Precedent — script enforces, rule body documents. |
63
-
64
- Classification surface: the optional `tier:` frontmatter field
65
- (declared in `scripts/schemas/rule.schema.json`). Recommended for new
66
- rules; bulk-retrofit of existing rules is tracked separately.
67
-
68
- Tier 3 dispositions are recorded centrally in
69
- [`agents/contexts/tier-3-dispositions.md`](../../agents/contexts/tier-3-dispositions.md)
70
- with a 6-month re-audit clock. New Tier 3 rules append to that list
71
- on landing.
72
-
73
- The `optimize-agents` command checks the tier alongside `type`/`source`
74
- and suggests escalations when a rule's trigger matches a hardening
75
- opportunity that has shipped since the rule was authored.
16
+ Body migrated to `guideline:agent-infra/rule-type-governance` (per P4 of `road-to-kernel-and-router.md`).
17
+ Trigger-set above activates this routing under the `balanced` and `full` profiles.
@@ -3,6 +3,11 @@ type: auto
3
3
  tier: "2b"
4
4
  source: package
5
5
  description: "When a skill declares execution metadata — enforce safety constraints for assisted and automated execution types"
6
+ triggers:
7
+ - keyword: "execution"
8
+ - keyword: "automated"
9
+ - keyword: "assisted"
10
+ - keyword: "handler"
6
11
  ---
7
12
 
8
13
  # Runtime Safety
@@ -5,7 +5,7 @@ description: "Scope control — no unsolicited architectural changes, refactors,
5
5
  alwaysApply: true
6
6
  source: package
7
7
  load_context:
8
- - .agent-src.uncompressed/contexts/authority/scope-mechanics.md
8
+ - ../contexts/authority/scope-mechanics.md
9
9
  ---
10
10
 
11
11
  # Scope Control
@@ -14,73 +14,35 @@ load_context:
14
14
  - Do NOT replace existing patterns with alternatives.
15
15
  - Do NOT refactor existing code solely to comply with current rules.
16
16
  - Do NOT suggest new libraries unless explicitly requested.
17
- - Existing code should only be modified if directly related to the current change, required for bug fixes, security, or explicitly requested.
18
- - New or newly modified code MUST follow all coding rules.
19
- - Stay within the established project structure and conventions.
20
- - When unsure about the scope, ask the user.
17
+ - Modify existing code only when directly related to the current change, required for bug fixes / security, or explicitly requested.
18
+ - New / modified code MUST follow all coding rules.
19
+ - Stay within established project structure and conventions.
20
+ - When unsure about scope, ask the user.
21
21
 
22
22
  ## Git operations — permission-gated
23
23
 
24
- The user decides the git shape of the work. Never improvise.
25
-
26
- > **Commit specifics:** see the canonical [`commit-policy`](commit-policy.md)
27
- > rule — narrower than the general "no git ops without permission"
28
- > below (covers the never-ask-about-committing default and the
29
- > roadmap-authorized exception).
24
+ The user decides the git shape. Never improvise. Commit specifics: canonical [`commit-policy`](commit-policy.md).
30
25
 
31
26
  - NEVER commit, push, merge, rebase, or force-push without explicit user permission.
32
- - NEVER create a new branch, switch to a different branch, or delete a
33
- branch without explicit user permission. This includes spike, scratch,
34
- throwaway, and worktree branches.
35
- - NEVER create, close, reopen, or change the target of a pull request
36
- without explicit user permission.
37
- - NEVER push a tag or create a release without explicit user permission.
38
- - NEVER include version numbers, target releases, deprecation dates,
39
- release-tied milestones, or git tags inside roadmaps, plans, tickets,
40
- or any other planning artifact. Roadmaps plan **work**; releases and
41
- tags are a separate decision the user makes outside the roadmap.
42
- Never surface "which release should this ship in?" as an option in
43
- numbered choices, ADRs, or roadmap text. If the user wants a release
44
- pinned to a milestone, they will say so explicitly.
45
- - If a task seems to need a separate branch or PR, STOP and **brief
46
- the user before asking** — see
47
- [`scope-mechanics`](../contexts/authority/scope-mechanics.md)
48
- § Brief-before-asking for the required Why / What / How sequence.
27
+ - NEVER create / switch / delete a branch without explicit permission includes spike, scratch, throwaway, worktree branches.
28
+ - NEVER create, close, reopen, or change the target of a pull request without permission.
29
+ - NEVER push a tag or create a release without permission.
30
+ - NEVER include version numbers, target releases, deprecation dates, release-tied milestones, or git tags in roadmaps, plans, tickets, or any planning artifact. Roadmaps plan **work**; releases / tags are a separate decision outside the roadmap. Never surface "which release should this ship in?" as a numbered choice. User pins by saying so explicitly.
31
+ - Task seems to need a separate branch / PR → STOP and **brief before asking** ([`scope-mechanics § Brief-before-asking`](../contexts/authority/scope-mechanics.md)).
49
32
 
50
- "Explicit permission" means the user said so **in this turn or in a
51
- standing instruction they have not revoked**. Earlier permission for a
52
- different operation does not carry over.
33
+ "Explicit permission" = user said so **this turn or in a standing instruction not yet revoked**. Earlier permission for a different operation does not carry over.
53
34
 
54
35
  ## Production, infrastructure, bulk-destructive — Hard Floor
55
36
 
56
- A subset of the operations above is **never** autonomous and never
57
- auto-permitted by a standing autonomy directive. Canonical rule:
58
- [`non-destructive-by-default`](non-destructive-by-default.md). The
59
- trigger list (production-branch merges, deploys / releases, prod
60
- data / infra, bulk-destructive ops) and the
61
- "authorization is this turn, not earlier" clarification live in
62
- [`scope-mechanics`](../contexts/authority/scope-mechanics.md)
63
- § Production, infrastructure, bulk-destructive.
37
+ A subset is **never** autonomous and never auto-permitted by a standing autonomy directive. Canonical: [`non-destructive-by-default`](non-destructive-by-default.md). Trigger list (prod-branch merges, deploys / releases, prod data / infra, bulk-destructive ops) and the "authorization is this turn, not earlier" clarification: [`scope-mechanics § Production, infrastructure, bulk-destructive`](../contexts/authority/scope-mechanics.md).
64
38
 
65
39
  ## Decline = silence — no re-asking on the same task
66
40
 
67
- After the user **declines** a proposal (branch switch, PR creation,
68
- tag/release entry, separate worktree, version pinning in a roadmap),
69
- do **not** raise the same proposal again on the same task. The decline
70
- stands until the user reopens the topic themselves.
71
-
72
- Timing and "is this worth asking?" guidance lives in
73
- [`scope-mechanics`](../contexts/authority/scope-mechanics.md)
74
- § Decline = silence — context.
41
+ After the user **declines** a proposal (branch switch, PR creation, tag/release entry, separate worktree, version pinning), do **not** raise it again on the same task. Decline stands until the user reopens the topic. Timing / "is this worth asking?": [`scope-mechanics § Decline = silence`](../contexts/authority/scope-mechanics.md).
75
42
 
76
43
  ## Fenced step — user-set review gates
77
44
 
78
- When the user explicitly fences off the next step — *"don't implement
79
- yet"*, *"plan only"*, *"just write the roadmap, I'll review"*,
80
- *"review first"*, *"erst Roadmap, ich schau drüber"*, *"nichts
81
- implementieren"*, *"nur planen"*, *"erstmal nur X, dann ich"* — the
82
- agent's reply is **the deliverable plus a handoff**, never the
83
- deliverable plus *"shall we start?"*.
45
+ User explicitly fences off the next step — *"don't implement yet"*, *"plan only"*, *"just write the roadmap, I'll review"*, *"review first"*, *"erst Roadmap, ich schau drüber"*, *"nichts implementieren"*, *"nur planen"*, *"erstmal nur X, dann ich"* — reply is **the deliverable plus a handoff**, never deliverable plus *"shall we start?"*.
84
46
 
85
47
  ```
86
48
  USER FENCED OFF EXECUTION → DELIVER + HAND BACK.
@@ -89,13 +51,6 @@ NO "READY TO IMPLEMENT?" RE-ASK.
89
51
  NO "STARTEN WIR MIT PHASE 1?" PIVOT.
90
52
  ```
91
53
 
92
- The fence stands until the user reopens the topic themselves, exactly
93
- like `Decline = silence` above. Permitted follow-up questions on the
94
- same turn cover **the deliverable** (adjust scope, fix wording, add a
95
- section), never **its execution**.
54
+ Fence stands until the user reopens, exactly like `Decline = silence`. Permitted follow-up questions cover **the deliverable** (adjust scope, fix wording, add a section), never **its execution**.
96
55
 
97
- For the failure-mode catalog (Option 1 = "start now", re-asking after
98
- delivery, hand-off-to-execution drift, inferring acceptance from a
99
- thumbs-up) and the explicit bypass phrases that lift the fence, see
100
- [`scope-mechanics`](../contexts/authority/scope-mechanics.md)
101
- § Fenced step.
56
+ Failure-mode catalog (Option 1 = "start now", re-asking after delivery, hand-off-to-execution drift, inferring acceptance from a thumbs-up) and explicit bypass phrases: [`scope-mechanics § Fenced step`](../contexts/authority/scope-mechanics.md).
@@ -4,6 +4,12 @@ tier: "2a"
4
4
  alwaysApply: false
5
5
  description: "Security-sensitive paths — auth, billing, tenant boundaries, secrets, file uploads, external integrations, webhooks, public endpoints — stop and run threat analysis BEFORE editing"
6
6
  source: package
7
+ triggers:
8
+ - keyword: "auth"
9
+ - keyword: "billing"
10
+ - keyword: "tenant"
11
+ - keyword: "secret"
12
+ - keyword: "webhook"
7
13
  ---
8
14
 
9
15
  # Security-Sensitive Stop Rule
@@ -43,7 +49,7 @@ STOP writing code. Run the matching analysis skill first:
43
49
  | Wide refactor of security-sensitive code | `blast-radius-analyzer` |
44
50
 
45
51
  **Before running the analysis, consult memory for prior incidents** on
46
- this surface. Via [`memory-access`](../../docs/guidelines/agent-infra/memory-access.md):
52
+ this surface. Via [`memory-access`](../docs/guidelines/agent-infra/memory-access.md):
47
53
 
48
54
  ```python
49
55
  from scripts.memory_lookup import retrieve
@@ -4,6 +4,11 @@ tier: "mechanical-already"
4
4
  description: "Creating or editing rules, skills, commands, guidelines, AGENTS.md, or copilot-instructions.md — enforce size and scope limits"
5
5
  alwaysApply: false
6
6
  source: package
7
+ triggers:
8
+ - intent: "create rule"
9
+ - intent: "create skill"
10
+ - intent: "create command"
11
+ - intent: "create guideline"
7
12
  ---
8
13
 
9
14
  # size-enforcement
@@ -23,7 +28,7 @@ source: package
23
28
  - Rules and system instructions should stay well below 200 lines
24
29
  - Smaller (≈60 lines) is strongly preferred
25
30
 
26
- → Size limits and details: `../../docs/guidelines/agent-infra/size-and-scope.md`
31
+ → Size limits and details: `../docs/guidelines/agent-infra/size-and-scope.md`
27
32
 
28
33
  → Frontmatter contract: schemas live in `scripts/schemas/` and are enforced by
29
34
  `python3 scripts/validate_frontmatter.py`.
@@ -2,58 +2,18 @@
2
2
  type: "auto"
3
3
  tier: "2a"
4
4
  description: "After completing a meaningful task — trigger post-task learning capture if pipelines.skill_improvement is enabled"
5
- alwaysApply: false
6
5
  source: package
6
+ triggers:
7
+ - phrase: "after completing"
8
+ - keyword: "improvement"
9
+ - keyword: "pipeline"
10
+ routes_to:
11
+ - "skill:skill-improvement-pipeline"
7
12
  ---
8
13
 
9
14
  # Skill Improvement Trigger
10
15
 
11
- ## When to activate
16
+ **Iron Law.** After a meaningful task, trigger the post-task learning capture if `pipelines.skill_improvement` is enabled.
12
17
 
13
- Read `pipelines.skill_improvement` from `.agent-settings.yml`.
14
-
15
- - **If `false` or missing** → do nothing. Stop here.
16
- - **If `true`** → continue.
17
-
18
- ## What counts as "meaningful task"
19
-
20
- Trigger after completing tasks that involve:
21
- - Debugging a non-trivial bug (root cause wasn't obvious)
22
- - Implementing a feature that required learning something new
23
- - A pattern that worked well and should be remembered
24
- - A mistake that cost >5 minutes to diagnose
25
- - A workaround for a tool limitation
26
-
27
- ## What does NOT trigger
28
-
29
- - Config changes, typos, docs-only edits
30
- - Routine tasks with no surprises
31
- - Tasks where the agent is just following instructions step by step
32
- - Tasks shorter than 3 messages
33
-
34
- ## Trigger behavior
35
-
36
- After completing a qualifying task, do a **quick mental check** (not a full workflow):
37
-
38
- 1. Was there a concrete, actionable learning?
39
- 2. Is it generalizable (not project-specific one-off)?
40
- 3. Is it NOT already covered by an existing rule or skill?
41
-
42
- If all 3 are YES → propose to the user:
43
-
44
- ```
45
- > 💡 Learning detected: "{one-sentence summary}"
46
- >
47
- > 1. Capture & improve — run the improvement pipeline
48
- > 2. Skip — not worth capturing
49
- ```
50
-
51
- If user picks 1 → invoke the `skill-improvement-pipeline` skill.
52
- If user picks 2 → stop, do not ask again for this task.
53
-
54
- ## Important
55
-
56
- - **Never auto-run the pipeline** — always ask first.
57
- - **Max 1 trigger per task** — don't ask repeatedly.
58
- - **Be honest** — if the learning is vague ("be more careful"), skip it silently.
59
- - **Do not interrupt the user's flow** — only trigger AFTER the task is done.
18
+ Body migrated to `skill:skill-improvement-pipeline` (per P4 of `road-to-kernel-and-router.md`).
19
+ Trigger-set above activates this routing under the `balanced` and `full` profiles.