@event4u/agent-config 1.9.1

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 (446) hide show
  1. package/.agent-src/README.md +64 -0
  2. package/.agent-src/commands/agent-handoff.md +64 -0
  3. package/.agent-src/commands/agent-status.md +83 -0
  4. package/.agent-src/commands/agents-audit.md +243 -0
  5. package/.agent-src/commands/agents-cleanup.md +169 -0
  6. package/.agent-src/commands/agents-prepare.md +137 -0
  7. package/.agent-src/commands/analyze-reference-repo.md +191 -0
  8. package/.agent-src/commands/bug-fix.md +181 -0
  9. package/.agent-src/commands/bug-investigate.md +175 -0
  10. package/.agent-src/commands/commit.md +121 -0
  11. package/.agent-src/commands/compress.md +177 -0
  12. package/.agent-src/commands/config-agent-settings.md +126 -0
  13. package/.agent-src/commands/context-create.md +167 -0
  14. package/.agent-src/commands/context-refactor.md +170 -0
  15. package/.agent-src/commands/copilot-agents-init.md +150 -0
  16. package/.agent-src/commands/copilot-agents-optimize.md +251 -0
  17. package/.agent-src/commands/create-pr-description.md +112 -0
  18. package/.agent-src/commands/create-pr.md +76 -0
  19. package/.agent-src/commands/do-and-judge.md +114 -0
  20. package/.agent-src/commands/do-in-steps.md +84 -0
  21. package/.agent-src/commands/e2e-heal.md +98 -0
  22. package/.agent-src/commands/e2e-plan.md +85 -0
  23. package/.agent-src/commands/estimate-ticket.md +80 -0
  24. package/.agent-src/commands/feature-dev.md +111 -0
  25. package/.agent-src/commands/feature-explore.md +180 -0
  26. package/.agent-src/commands/feature-plan.md +288 -0
  27. package/.agent-src/commands/feature-refactor.md +181 -0
  28. package/.agent-src/commands/feature-roadmap.md +184 -0
  29. package/.agent-src/commands/fix-ci.md +48 -0
  30. package/.agent-src/commands/fix-portability.md +97 -0
  31. package/.agent-src/commands/fix-pr-bot-comments.md +146 -0
  32. package/.agent-src/commands/fix-pr-comments.md +58 -0
  33. package/.agent-src/commands/fix-pr-developer-comments.md +152 -0
  34. package/.agent-src/commands/fix-references.md +94 -0
  35. package/.agent-src/commands/fix-seeder.md +146 -0
  36. package/.agent-src/commands/implement-ticket.md +133 -0
  37. package/.agent-src/commands/jira-ticket.md +71 -0
  38. package/.agent-src/commands/judge.md +86 -0
  39. package/.agent-src/commands/memory-add.md +130 -0
  40. package/.agent-src/commands/memory-full.md +97 -0
  41. package/.agent-src/commands/memory-promote.md +144 -0
  42. package/.agent-src/commands/mode.md +121 -0
  43. package/.agent-src/commands/module-create.md +132 -0
  44. package/.agent-src/commands/module-explore.md +157 -0
  45. package/.agent-src/commands/optimize-agents.md +139 -0
  46. package/.agent-src/commands/optimize-augmentignore.md +262 -0
  47. package/.agent-src/commands/optimize-rtk-filters.md +120 -0
  48. package/.agent-src/commands/optimize-skills.md +121 -0
  49. package/.agent-src/commands/override-create.md +97 -0
  50. package/.agent-src/commands/override-manage.md +96 -0
  51. package/.agent-src/commands/package-reset.md +154 -0
  52. package/.agent-src/commands/package-test.md +154 -0
  53. package/.agent-src/commands/prepare-for-review.md +91 -0
  54. package/.agent-src/commands/project-analyze.md +300 -0
  55. package/.agent-src/commands/project-health.md +95 -0
  56. package/.agent-src/commands/propose-memory.md +108 -0
  57. package/.agent-src/commands/quality-fix.md +106 -0
  58. package/.agent-src/commands/refine-ticket.md +81 -0
  59. package/.agent-src/commands/review-changes.md +130 -0
  60. package/.agent-src/commands/review-routing.md +111 -0
  61. package/.agent-src/commands/roadmap-create.md +110 -0
  62. package/.agent-src/commands/roadmap-execute.md +68 -0
  63. package/.agent-src/commands/rule-compliance-audit.md +139 -0
  64. package/.agent-src/commands/tests-create.md +73 -0
  65. package/.agent-src/commands/tests-execute.md +58 -0
  66. package/.agent-src/commands/threat-model.md +115 -0
  67. package/.agent-src/commands/update-form-request-messages.md +189 -0
  68. package/.agent-src/commands/upstream-contribute.md +171 -0
  69. package/.agent-src/contexts/augment-infrastructure.md +181 -0
  70. package/.agent-src/contexts/documentation-hierarchy.md +142 -0
  71. package/.agent-src/contexts/model-recommendations.md +142 -0
  72. package/.agent-src/contexts/override-system.md +187 -0
  73. package/.agent-src/contexts/skills-and-commands.md +154 -0
  74. package/.agent-src/contexts/subagent-configuration.md +62 -0
  75. package/.agent-src/guidelines/agent-infra/agent-interaction-and-decision-quality.md +110 -0
  76. package/.agent-src/guidelines/agent-infra/break-glass-usage.md +113 -0
  77. package/.agent-src/guidelines/agent-infra/developer-judgment.md +82 -0
  78. package/.agent-src/guidelines/agent-infra/engineering-memory-data-format.md +117 -0
  79. package/.agent-src/guidelines/agent-infra/layered-settings.md +158 -0
  80. package/.agent-src/guidelines/agent-infra/memory-access.md +121 -0
  81. package/.agent-src/guidelines/agent-infra/naming.md +69 -0
  82. package/.agent-src/guidelines/agent-infra/output-patterns.md +117 -0
  83. package/.agent-src/guidelines/agent-infra/review-routing-data-format.md +144 -0
  84. package/.agent-src/guidelines/agent-infra/role-contracts.md +211 -0
  85. package/.agent-src/guidelines/agent-infra/role-mode-router.md +89 -0
  86. package/.agent-src/guidelines/agent-infra/runtime-layer.md +89 -0
  87. package/.agent-src/guidelines/agent-infra/self-improvement-pipeline.md +135 -0
  88. package/.agent-src/guidelines/agent-infra/size-and-scope.md +189 -0
  89. package/.agent-src/guidelines/agent-infra/tool-integration.md +73 -0
  90. package/.agent-src/guidelines/docs/readme-size-and-splitting.md +153 -0
  91. package/.agent-src/guidelines/e2e/playwright.md +363 -0
  92. package/.agent-src/guidelines/php/api-design.md +115 -0
  93. package/.agent-src/guidelines/php/artisan-commands.md +81 -0
  94. package/.agent-src/guidelines/php/blade-ui.md +78 -0
  95. package/.agent-src/guidelines/php/controllers.md +90 -0
  96. package/.agent-src/guidelines/php/database.md +111 -0
  97. package/.agent-src/guidelines/php/eloquent.md +208 -0
  98. package/.agent-src/guidelines/php/flux.md +80 -0
  99. package/.agent-src/guidelines/php/general.md +191 -0
  100. package/.agent-src/guidelines/php/git.md +96 -0
  101. package/.agent-src/guidelines/php/jobs.md +111 -0
  102. package/.agent-src/guidelines/php/livewire.md +71 -0
  103. package/.agent-src/guidelines/php/logging.md +79 -0
  104. package/.agent-src/guidelines/php/naming.md +89 -0
  105. package/.agent-src/guidelines/php/patterns/dependency-injection.md +57 -0
  106. package/.agent-src/guidelines/php/patterns/dtos.md +199 -0
  107. package/.agent-src/guidelines/php/patterns/events.md +67 -0
  108. package/.agent-src/guidelines/php/patterns/factory.md +53 -0
  109. package/.agent-src/guidelines/php/patterns/pipelines.md +66 -0
  110. package/.agent-src/guidelines/php/patterns/policies.md +66 -0
  111. package/.agent-src/guidelines/php/patterns/repositories.md +122 -0
  112. package/.agent-src/guidelines/php/patterns/service-layer.md +64 -0
  113. package/.agent-src/guidelines/php/patterns/strategy.md +69 -0
  114. package/.agent-src/guidelines/php/patterns.md +28 -0
  115. package/.agent-src/guidelines/php/performance.md +92 -0
  116. package/.agent-src/guidelines/php/resources.md +100 -0
  117. package/.agent-src/guidelines/php/security.md +110 -0
  118. package/.agent-src/guidelines/php/sql.md +97 -0
  119. package/.agent-src/guidelines/php/validations.md +119 -0
  120. package/.agent-src/guidelines/php/websocket.md +100 -0
  121. package/.agent-src/personas/README.md +104 -0
  122. package/.agent-src/personas/ai-agent.md +77 -0
  123. package/.agent-src/personas/critical-challenger.md +73 -0
  124. package/.agent-src/personas/developer.md +73 -0
  125. package/.agent-src/personas/product-owner.md +78 -0
  126. package/.agent-src/personas/qa.md +67 -0
  127. package/.agent-src/personas/senior-engineer.md +77 -0
  128. package/.agent-src/personas/stakeholder.md +78 -0
  129. package/.agent-src/rules/agent-docs.md +61 -0
  130. package/.agent-src/rules/analysis-skill-routing.md +48 -0
  131. package/.agent-src/rules/architecture.md +62 -0
  132. package/.agent-src/rules/artifact-drafting-protocol.md +73 -0
  133. package/.agent-src/rules/ask-when-uncertain.md +52 -0
  134. package/.agent-src/rules/augment-portability.md +38 -0
  135. package/.agent-src/rules/augment-source-of-truth.md +128 -0
  136. package/.agent-src/rules/capture-learnings.md +89 -0
  137. package/.agent-src/rules/cli-output-handling.md +94 -0
  138. package/.agent-src/rules/commit-conventions.md +64 -0
  139. package/.agent-src/rules/context-hygiene.md +90 -0
  140. package/.agent-src/rules/docker-commands.md +55 -0
  141. package/.agent-src/rules/docs-sync.md +79 -0
  142. package/.agent-src/rules/downstream-changes.md +70 -0
  143. package/.agent-src/rules/e2e-testing.md +53 -0
  144. package/.agent-src/rules/guidelines.md +90 -0
  145. package/.agent-src/rules/improve-before-implement.md +94 -0
  146. package/.agent-src/rules/language-and-tone.md +104 -0
  147. package/.agent-src/rules/laravel-translations.md +48 -0
  148. package/.agent-src/rules/markdown-safe-codeblocks.md +18 -0
  149. package/.agent-src/rules/minimal-safe-diff.md +87 -0
  150. package/.agent-src/rules/missing-tool-handling.md +62 -0
  151. package/.agent-src/rules/model-recommendation.md +70 -0
  152. package/.agent-src/rules/package-ci-checks.md +80 -0
  153. package/.agent-src/rules/php-coding.md +63 -0
  154. package/.agent-src/rules/preservation-guard.md +29 -0
  155. package/.agent-src/rules/review-routing-awareness.md +125 -0
  156. package/.agent-src/rules/reviewer-awareness.md +92 -0
  157. package/.agent-src/rules/roadmap-progress-sync.md +56 -0
  158. package/.agent-src/rules/role-mode-adherence.md +54 -0
  159. package/.agent-src/rules/rule-type-governance.md +46 -0
  160. package/.agent-src/rules/runtime-safety.md +42 -0
  161. package/.agent-src/rules/scope-control.md +40 -0
  162. package/.agent-src/rules/security-sensitive-stop.md +77 -0
  163. package/.agent-src/rules/size-enforcement.md +29 -0
  164. package/.agent-src/rules/skill-improvement-trigger.md +58 -0
  165. package/.agent-src/rules/skill-quality.md +110 -0
  166. package/.agent-src/rules/slash-commands.md +30 -0
  167. package/.agent-src/rules/think-before-action.md +91 -0
  168. package/.agent-src/rules/token-efficiency.md +99 -0
  169. package/.agent-src/rules/tool-safety.md +36 -0
  170. package/.agent-src/rules/upstream-proposal.md +76 -0
  171. package/.agent-src/rules/user-interaction.md +79 -0
  172. package/.agent-src/rules/verify-before-complete.md +120 -0
  173. package/.agent-src/scripts/scan-seeder-violations.php +145 -0
  174. package/.agent-src/scripts/update_roadmap_progress.py +244 -0
  175. package/.agent-src/skills/adversarial-review/SKILL.md +149 -0
  176. package/.agent-src/skills/agent-docs-writing/SKILL.md +234 -0
  177. package/.agent-src/skills/analysis-autonomous-mode/SKILL.md +197 -0
  178. package/.agent-src/skills/analysis-skill-router/SKILL.md +134 -0
  179. package/.agent-src/skills/api-design/SKILL.md +104 -0
  180. package/.agent-src/skills/api-endpoint/SKILL.md +185 -0
  181. package/.agent-src/skills/api-testing/SKILL.md +206 -0
  182. package/.agent-src/skills/artisan-commands/SKILL.md +78 -0
  183. package/.agent-src/skills/authz-review/SKILL.md +171 -0
  184. package/.agent-src/skills/aws-infrastructure/SKILL.md +152 -0
  185. package/.agent-src/skills/blade-ui/SKILL.md +75 -0
  186. package/.agent-src/skills/blast-radius-analyzer/SKILL.md +185 -0
  187. package/.agent-src/skills/bug-analyzer/SKILL.md +256 -0
  188. package/.agent-src/skills/check-refs/SKILL.md +72 -0
  189. package/.agent-src/skills/code-refactoring/SKILL.md +200 -0
  190. package/.agent-src/skills/code-review/SKILL.md +214 -0
  191. package/.agent-src/skills/command-routing/SKILL.md +96 -0
  192. package/.agent-src/skills/command-writing/SKILL.md +143 -0
  193. package/.agent-src/skills/composer-packages/SKILL.md +172 -0
  194. package/.agent-src/skills/context-authoring/SKILL.md +157 -0
  195. package/.agent-src/skills/context-document/SKILL.md +153 -0
  196. package/.agent-src/skills/conventional-commits-writing/SKILL.md +70 -0
  197. package/.agent-src/skills/copilot-agents-optimization/SKILL.md +220 -0
  198. package/.agent-src/skills/copilot-config/SKILL.md +203 -0
  199. package/.agent-src/skills/dashboard-design/SKILL.md +116 -0
  200. package/.agent-src/skills/data-flow-mapper/SKILL.md +160 -0
  201. package/.agent-src/skills/database/SKILL.md +91 -0
  202. package/.agent-src/skills/dependency-upgrade/SKILL.md +204 -0
  203. package/.agent-src/skills/description-assist/SKILL.md +169 -0
  204. package/.agent-src/skills/design-review/SKILL.md +228 -0
  205. package/.agent-src/skills/devcontainer/SKILL.md +121 -0
  206. package/.agent-src/skills/developer-like-execution/SKILL.md +276 -0
  207. package/.agent-src/skills/docker/SKILL.md +245 -0
  208. package/.agent-src/skills/dto-creator/SKILL.md +117 -0
  209. package/.agent-src/skills/eloquent/SKILL.md +92 -0
  210. package/.agent-src/skills/eloquent/evals/last-run.json +99 -0
  211. package/.agent-src/skills/eloquent/evals/triggers.json +16 -0
  212. package/.agent-src/skills/estimate-ticket/SKILL.md +186 -0
  213. package/.agent-src/skills/estimate-ticket/evals/output-schema.yml +20 -0
  214. package/.agent-src/skills/estimate-ticket/evals/triggers.json +18 -0
  215. package/.agent-src/skills/fe-design/SKILL.md +223 -0
  216. package/.agent-src/skills/feature-planning/SKILL.md +226 -0
  217. package/.agent-src/skills/file-editor/SKILL.md +129 -0
  218. package/.agent-src/skills/finishing-a-development-branch/SKILL.md +200 -0
  219. package/.agent-src/skills/flux/SKILL.md +64 -0
  220. package/.agent-src/skills/git-workflow/SKILL.md +102 -0
  221. package/.agent-src/skills/github-ci/SKILL.md +122 -0
  222. package/.agent-src/skills/grafana/SKILL.md +168 -0
  223. package/.agent-src/skills/guideline-writing/SKILL.md +147 -0
  224. package/.agent-src/skills/jira-integration/SKILL.md +182 -0
  225. package/.agent-src/skills/jobs-events/SKILL.md +87 -0
  226. package/.agent-src/skills/judge-bug-hunter/SKILL.md +157 -0
  227. package/.agent-src/skills/judge-code-quality/SKILL.md +158 -0
  228. package/.agent-src/skills/judge-security-auditor/SKILL.md +167 -0
  229. package/.agent-src/skills/judge-test-coverage/SKILL.md +154 -0
  230. package/.agent-src/skills/laravel/SKILL.md +195 -0
  231. package/.agent-src/skills/laravel-horizon/SKILL.md +169 -0
  232. package/.agent-src/skills/laravel-mail/SKILL.md +193 -0
  233. package/.agent-src/skills/laravel-middleware/SKILL.md +185 -0
  234. package/.agent-src/skills/laravel-notifications/SKILL.md +168 -0
  235. package/.agent-src/skills/laravel-pennant/SKILL.md +188 -0
  236. package/.agent-src/skills/laravel-pulse/SKILL.md +160 -0
  237. package/.agent-src/skills/laravel-reverb/SKILL.md +205 -0
  238. package/.agent-src/skills/laravel-scheduling/SKILL.md +167 -0
  239. package/.agent-src/skills/laravel-validation/SKILL.md +71 -0
  240. package/.agent-src/skills/learning-to-rule-or-skill/SKILL.md +249 -0
  241. package/.agent-src/skills/lint-skills/SKILL.md +72 -0
  242. package/.agent-src/skills/livewire/SKILL.md +79 -0
  243. package/.agent-src/skills/logging-monitoring/SKILL.md +100 -0
  244. package/.agent-src/skills/mcp/SKILL.md +193 -0
  245. package/.agent-src/skills/merge-conflicts/SKILL.md +158 -0
  246. package/.agent-src/skills/migration-creator/SKILL.md +160 -0
  247. package/.agent-src/skills/module-management/SKILL.md +154 -0
  248. package/.agent-src/skills/multi-tenancy/SKILL.md +129 -0
  249. package/.agent-src/skills/openapi/SKILL.md +154 -0
  250. package/.agent-src/skills/override-management/SKILL.md +186 -0
  251. package/.agent-src/skills/performance/SKILL.md +69 -0
  252. package/.agent-src/skills/performance-analysis/SKILL.md +118 -0
  253. package/.agent-src/skills/pest-testing/SKILL.md +321 -0
  254. package/.agent-src/skills/php-coder/SKILL.md +78 -0
  255. package/.agent-src/skills/php-coder/evals/triggers.json +16 -0
  256. package/.agent-src/skills/php-debugging/SKILL.md +184 -0
  257. package/.agent-src/skills/php-service/SKILL.md +96 -0
  258. package/.agent-src/skills/playwright-testing/SKILL.md +244 -0
  259. package/.agent-src/skills/project-analysis-core/SKILL.md +138 -0
  260. package/.agent-src/skills/project-analysis-hypothesis-driven/SKILL.md +130 -0
  261. package/.agent-src/skills/project-analysis-laravel/SKILL.md +119 -0
  262. package/.agent-src/skills/project-analysis-nextjs/SKILL.md +123 -0
  263. package/.agent-src/skills/project-analysis-node-express/SKILL.md +111 -0
  264. package/.agent-src/skills/project-analysis-react/SKILL.md +119 -0
  265. package/.agent-src/skills/project-analysis-symfony/SKILL.md +111 -0
  266. package/.agent-src/skills/project-analysis-zend-laminas/SKILL.md +108 -0
  267. package/.agent-src/skills/project-analyzer/SKILL.md +341 -0
  268. package/.agent-src/skills/project-docs/SKILL.md +137 -0
  269. package/.agent-src/skills/quality-tools/SKILL.md +411 -0
  270. package/.agent-src/skills/readme-reviewer/SKILL.md +187 -0
  271. package/.agent-src/skills/readme-writing/SKILL.md +142 -0
  272. package/.agent-src/skills/readme-writing-package/SKILL.md +185 -0
  273. package/.agent-src/skills/receiving-code-review/SKILL.md +190 -0
  274. package/.agent-src/skills/refine-ticket/SKILL.md +310 -0
  275. package/.agent-src/skills/refine-ticket/detection-map.yml +124 -0
  276. package/.agent-src/skills/refine-ticket/evals/output-schema.yml +16 -0
  277. package/.agent-src/skills/refine-ticket/evals/triggers.json +16 -0
  278. package/.agent-src/skills/requesting-code-review/SKILL.md +199 -0
  279. package/.agent-src/skills/review-routing/SKILL.md +195 -0
  280. package/.agent-src/skills/roadmap-management/SKILL.md +303 -0
  281. package/.agent-src/skills/rtk-output-filtering/SKILL.md +184 -0
  282. package/.agent-src/skills/rule-writing/SKILL.md +148 -0
  283. package/.agent-src/skills/security/SKILL.md +79 -0
  284. package/.agent-src/skills/security-audit/SKILL.md +123 -0
  285. package/.agent-src/skills/sentry-integration/SKILL.md +170 -0
  286. package/.agent-src/skills/sequential-thinking/SKILL.md +158 -0
  287. package/.agent-src/skills/skill-improvement-pipeline/SKILL.md +155 -0
  288. package/.agent-src/skills/skill-management/SKILL.md +121 -0
  289. package/.agent-src/skills/skill-reviewer/SKILL.md +218 -0
  290. package/.agent-src/skills/skill-writing/SKILL.md +291 -0
  291. package/.agent-src/skills/skill-writing/evals/triggers.json +16 -0
  292. package/.agent-src/skills/sql-writing/SKILL.md +74 -0
  293. package/.agent-src/skills/subagent-orchestration/SKILL.md +190 -0
  294. package/.agent-src/skills/systematic-debugging/SKILL.md +244 -0
  295. package/.agent-src/skills/technical-specification/SKILL.md +185 -0
  296. package/.agent-src/skills/terraform/SKILL.md +137 -0
  297. package/.agent-src/skills/terragrunt/SKILL.md +217 -0
  298. package/.agent-src/skills/test-driven-development/SKILL.md +252 -0
  299. package/.agent-src/skills/test-performance/SKILL.md +172 -0
  300. package/.agent-src/skills/threat-modeling/SKILL.md +189 -0
  301. package/.agent-src/skills/traefik/SKILL.md +319 -0
  302. package/.agent-src/skills/universal-project-analysis/SKILL.md +179 -0
  303. package/.agent-src/skills/upstream-contribute/SKILL.md +255 -0
  304. package/.agent-src/skills/using-git-worktrees/SKILL.md +148 -0
  305. package/.agent-src/skills/validate-feature-fit/SKILL.md +113 -0
  306. package/.agent-src/skills/verify-before-complete/SKILL.md +188 -0
  307. package/.agent-src/skills/websocket/SKILL.md +75 -0
  308. package/.agent-src/templates/AGENTS.md +146 -0
  309. package/.agent-src/templates/agent-settings.md +256 -0
  310. package/.agent-src/templates/agents/.gitattributes.fragment +16 -0
  311. package/.agent-src/templates/agents/agent-project-settings.example.yml +138 -0
  312. package/.agent-src/templates/agents/memory/architecture-decisions.example.yml +95 -0
  313. package/.agent-src/templates/agents/memory/domain-invariants.example.yml +80 -0
  314. package/.agent-src/templates/agents/memory/historical-patterns.example.yml +82 -0
  315. package/.agent-src/templates/agents/memory/incident-learnings.example.yml +113 -0
  316. package/.agent-src/templates/agents/memory/ownership.example.yml +75 -0
  317. package/.agent-src/templates/agents/memory/product-rules.example.yml +87 -0
  318. package/.agent-src/templates/agents/proposal.example.md +143 -0
  319. package/.agent-src/templates/command.md +84 -0
  320. package/.agent-src/templates/contexts/auth-model.md +59 -0
  321. package/.agent-src/templates/contexts/data-sensitivity.md +60 -0
  322. package/.agent-src/templates/contexts/deployment-order.md +72 -0
  323. package/.agent-src/templates/contexts/observability.md +64 -0
  324. package/.agent-src/templates/contexts/tenant-boundaries.md +68 -0
  325. package/.agent-src/templates/contexts.md +116 -0
  326. package/.agent-src/templates/copilot-instructions.md +115 -0
  327. package/.agent-src/templates/features.md +125 -0
  328. package/.agent-src/templates/github-workflows/memory-hygiene.yml +133 -0
  329. package/.agent-src/templates/github-workflows/pr-risk-review.yml +123 -0
  330. package/.agent-src/templates/github-workflows/proposal-drift.yml +118 -0
  331. package/.agent-src/templates/overrides/command.md +24 -0
  332. package/.agent-src/templates/overrides/guideline.md +21 -0
  333. package/.agent-src/templates/overrides/rule.md +19 -0
  334. package/.agent-src/templates/overrides/skill.md +24 -0
  335. package/.agent-src/templates/overrides/template.md +21 -0
  336. package/.agent-src/templates/persona.md +99 -0
  337. package/.agent-src/templates/roadmaps.md +109 -0
  338. package/.agent-src/templates/scripts/README.md +195 -0
  339. package/.agent-src/templates/scripts/check_memory.py +283 -0
  340. package/.agent-src/templates/scripts/check_memory_proposal.py +180 -0
  341. package/.agent-src/templates/scripts/historical-bug-patterns.example.yml +84 -0
  342. package/.agent-src/templates/scripts/implement_ticket/__init__.py +57 -0
  343. package/.agent-src/templates/scripts/implement_ticket/__main__.py +9 -0
  344. package/.agent-src/templates/scripts/implement_ticket/cli.py +171 -0
  345. package/.agent-src/templates/scripts/implement_ticket/delivery_state.py +130 -0
  346. package/.agent-src/templates/scripts/implement_ticket/dispatcher.py +134 -0
  347. package/.agent-src/templates/scripts/implement_ticket/persona_policy.py +85 -0
  348. package/.agent-src/templates/scripts/implement_ticket/steps/__init__.py +49 -0
  349. package/.agent-src/templates/scripts/implement_ticket/steps/analyze.py +98 -0
  350. package/.agent-src/templates/scripts/implement_ticket/steps/implement.py +145 -0
  351. package/.agent-src/templates/scripts/implement_ticket/steps/memory.py +136 -0
  352. package/.agent-src/templates/scripts/implement_ticket/steps/plan.py +175 -0
  353. package/.agent-src/templates/scripts/implement_ticket/steps/refine.py +140 -0
  354. package/.agent-src/templates/scripts/implement_ticket/steps/report.py +195 -0
  355. package/.agent-src/templates/scripts/implement_ticket/steps/test.py +180 -0
  356. package/.agent-src/templates/scripts/implement_ticket/steps/verify.py +170 -0
  357. package/.agent-src/templates/scripts/memory_hash.py +75 -0
  358. package/.agent-src/templates/scripts/memory_lookup.py +216 -0
  359. package/.agent-src/templates/scripts/memory_report.py +184 -0
  360. package/.agent-src/templates/scripts/memory_signal.py +167 -0
  361. package/.agent-src/templates/scripts/memory_status.py +156 -0
  362. package/.agent-src/templates/scripts/ownership-map.example.yml +87 -0
  363. package/.agent-src/templates/scripts/pr-risk-config.example.yml +76 -0
  364. package/.agent-src/templates/scripts/pr_review_routing.py +340 -0
  365. package/.agent-src/templates/scripts/pr_risk_review.py +211 -0
  366. package/.agent-src/templates/skill.md +136 -0
  367. package/.augment-plugin/marketplace.json +32 -0
  368. package/.augment-plugin/plugin.json +21 -0
  369. package/.claude-plugin/marketplace.json +119 -0
  370. package/AGENTS.md +121 -0
  371. package/CHANGELOG.md +279 -0
  372. package/CONTRIBUTING.md +176 -0
  373. package/LICENSE +21 -0
  374. package/README.md +357 -0
  375. package/bin/install.php +38 -0
  376. package/composer.json +29 -0
  377. package/config/agent-settings.template.yml +96 -0
  378. package/config/profiles/balanced.ini +10 -0
  379. package/config/profiles/full.ini +10 -0
  380. package/config/profiles/minimal.ini +10 -0
  381. package/docs/architecture.md +144 -0
  382. package/docs/customization.md +88 -0
  383. package/docs/development.md +171 -0
  384. package/docs/getting-started.md +130 -0
  385. package/docs/github-topics.md +84 -0
  386. package/docs/installation.md +376 -0
  387. package/docs/mcp.md +133 -0
  388. package/docs/quality.md +98 -0
  389. package/docs/skills-catalog.md +136 -0
  390. package/docs/troubleshooting.md +167 -0
  391. package/llms.txt +130 -0
  392. package/package.json +31 -0
  393. package/scripts/audit_skill_descriptions.py +168 -0
  394. package/scripts/check_compression.py +221 -0
  395. package/scripts/check_memory.py +341 -0
  396. package/scripts/check_memory_proposal.py +180 -0
  397. package/scripts/check_portability.py +320 -0
  398. package/scripts/check_proposal.py +269 -0
  399. package/scripts/check_references.py +400 -0
  400. package/scripts/ci_summary.py +131 -0
  401. package/scripts/compress.py +671 -0
  402. package/scripts/compress.sh +18 -0
  403. package/scripts/first-run.sh +109 -0
  404. package/scripts/generate_catalog.py +116 -0
  405. package/scripts/install +151 -0
  406. package/scripts/install-hooks.sh +29 -0
  407. package/scripts/install.py +487 -0
  408. package/scripts/install.sh +637 -0
  409. package/scripts/install_anthropic_key.sh +101 -0
  410. package/scripts/inventory_frontmatter.py +164 -0
  411. package/scripts/lint_marketplace.py +142 -0
  412. package/scripts/lint_regression.py +232 -0
  413. package/scripts/mcp_render.py +159 -0
  414. package/scripts/measure_patterns.py +376 -0
  415. package/scripts/memory_hash.py +75 -0
  416. package/scripts/memory_lookup.py +441 -0
  417. package/scripts/memory_report.py +336 -0
  418. package/scripts/memory_signal.py +210 -0
  419. package/scripts/memory_status.py +195 -0
  420. package/scripts/postinstall.sh +60 -0
  421. package/scripts/readme_linter.py +580 -0
  422. package/scripts/refine_ticket_detect.py +623 -0
  423. package/scripts/requirements-evals.txt +7 -0
  424. package/scripts/runtime_dispatcher.py +265 -0
  425. package/scripts/runtime_handler.py +148 -0
  426. package/scripts/runtime_registry.py +166 -0
  427. package/scripts/schemas/command.schema.json +32 -0
  428. package/scripts/schemas/persona.schema.json +42 -0
  429. package/scripts/schemas/rule.schema.json +28 -0
  430. package/scripts/schemas/skill.schema.json +73 -0
  431. package/scripts/setup.sh +230 -0
  432. package/scripts/setup_eval_venv.sh +58 -0
  433. package/scripts/skill_linter.py +2175 -0
  434. package/scripts/skill_trigger_eval.py +651 -0
  435. package/scripts/tool_registry.py +146 -0
  436. package/scripts/tools/__init__.py +1 -0
  437. package/scripts/tools/adapter_errors.py +63 -0
  438. package/scripts/tools/base_adapter.py +91 -0
  439. package/scripts/tools/github_adapter.py +128 -0
  440. package/scripts/tools/jira_adapter.py +115 -0
  441. package/scripts/update_counts.py +147 -0
  442. package/scripts/validate_frontmatter.py +424 -0
  443. package/templates/consumer-settings/README.md +46 -0
  444. package/templates/consumer-settings/augment-settings.json +12 -0
  445. package/templates/consumer-settings/claude-settings.json +9 -0
  446. package/templates/consumer-settings/copilot-settings.json +14 -0
package/.agent-src/skills/review-routing/SKILL.md ADDED
@@ -0,0 +1,195 @@
1
+ ---
2
+ name: review-routing
3
+ description: "Use when preparing a PR description, suggesting reviewers, or flagging risk — produces owner-mapped roles plus historical bug-pattern matches from project-local YAML."
4
+ source: package
5
+ ---
6
+
7
+ # review-routing
8
+
9
+ > You are the reviewer-routing specialist. Your only job is to **resolve**
10
+ > reviewer roles and matched historical patterns for a given diff, from
11
+ > the consumer project's `ownership-map.yml` and
12
+ > `historical-bug-patterns.yml`. You do **not** format PR descriptions
13
+ > end-to-end, you do **not** audit diffs for correctness, you do **not**
14
+ > invent ownership — sibling skills and rules handle those.
15
+
16
+ ## When to use
17
+
18
+ - A PR is being prepared and the author wants "who should review this?"
19
+ - A CI job needs to compute the reviewer suggestion block for a sticky
20
+ PR comment (typically alongside the risk classifier).
21
+ - The agent is self-reviewing a diff and wants historical-pattern hits
22
+ surfaced before claiming completion.
23
+
24
+ Do NOT use when:
25
+
26
+ - The diff is low-risk and no ownership map exists — fall back to
27
+ [`reviewer-awareness`](../../rules/reviewer-awareness.md) defaults.
28
+ - A full PR description is requested — route to
29
+ [`create-pr-description`](../create-pr-description/SKILL.md) and let
30
+ it call this skill for the routing block.
31
+ - A threat model is wanted — route to
32
+ [`threat-modeling`](../threat-modeling/SKILL.md).
33
+
34
+ ## Procedure
35
+
36
+ ### 1. Identify the changed file list
37
+
38
+ Inspect the diff: from git (`git diff --name-only <base>...<head>`) or
39
+ from an explicit list supplied by the caller. If the list is empty,
40
+ stop and report "no changes — routing skipped".
41
+
42
+ ### 2. Load project data (if present)
43
+
44
+ Check, in order:
45
+
46
+ - `.github/ownership-map.yml` → fallback `agents/ownership-map.yml`
47
+ - `.github/historical-bug-patterns.yml` → fallback
48
+ `agents/historical-bug-patterns.yml`
49
+
50
+ Parse each with YAML. Validate `version: 1` is present. If a file is
51
+ malformed, **stop and report the parse error** — never silently fall
52
+ back. If neither file exists, emit the generic role-based fallback
53
+ using [`reviewer-awareness`](../../rules/reviewer-awareness.md).
54
+
55
+ **Also** pull agent-written signals via the shared abstraction (see
56
+ [`memory-access`](../../guidelines/agent-infra/memory-access.md)):
57
+
58
+ ```python
59
+ from scripts.memory_lookup import retrieve
60
+ extra = retrieve(
61
+ types=["ownership", "historical-patterns", "incident-learnings"],
62
+ keys=<changed file paths>,
63
+ limit=5,
64
+ )
65
+ ```
66
+
67
+ Treat `source: "curated"` as equal-trust to the project YAML.
68
+ Treat `source: "intake"` as low-confidence — surface matches in a
69
+ separate "provisional" bullet so reviewers can discount them.
70
+ Entries are additive: they never override a YAML match, only
71
+ supplement it.
72
+
73
+ ### 3. Match ownership
74
+
75
+ For every changed file, find the **first** matching entry in
76
+ `ownership-map.yml` (`fnmatch` semantics, same as `pr-risk-config.yml`).
77
+ Collect the union of:
78
+
79
+ - matched roles
80
+ - per-file focus notes (deduplicated)
81
+ - per-file risk hints (deduplicated)
82
+
83
+ Files with no match fall through to `defaults.roles` if defined, else
84
+ to the generic-role fallback.
85
+
86
+ ### 4. Match historical patterns
87
+
88
+ Walk every pattern in `historical-bug-patterns.yml`. A pattern matches
89
+ when **any** of its `paths` globs matches **any** changed file. For each
90
+ match, record:
91
+
92
+ - `id`, `label`, `severity`
93
+ - `required_test` (verbatim)
94
+ - `references` (verbatim)
95
+
96
+ ### 5. Compute severity
97
+
98
+ Take the **max** severity across matched patterns:
99
+
100
+ - any `high` pattern matched → overall `high`
101
+ - else any `medium` → overall `medium`
102
+ - else `low`
103
+
104
+ If a PR-risk classifier has already labeled the PR, **keep the higher**
105
+ of the two levels. Do not downgrade.
106
+
107
+ ### 6. Check staleness
108
+
109
+ If `ownership-map.yml` has an `updated` field older than 6 months,
110
+ include a staleness warning in the output. Still use the data — just
111
+ flag it.
112
+
113
+ ## Validation
114
+
115
+ Before returning:
116
+
117
+ 1. Every emitted role is either in the common vocabulary
118
+ ([`reviewer-awareness`](../../rules/reviewer-awareness.md)) or sourced
119
+ from an ownership entry — never invented.
120
+ 2. Every historical-pattern match cites its `id` and `required_test`
121
+ verbatim.
122
+ 3. At least **primary + secondary** roles for medium/high severity.
123
+ 4. No individual GitHub usernames or email addresses in the output.
124
+ 5. If no data files exist, the output says so explicitly.
125
+
126
+ ## Output format
127
+
128
+ Every routing result must satisfy these requirements:
129
+
130
+ 1. **Header line** — `Skill: review-routing` followed by diff size and
131
+ overall severity emoji (🔴 / 🟡 / 🟢).
132
+ 2. **Ownership block** — primary + secondary role minimum for
133
+ medium/high severity, each with merged focus notes, anchored to the
134
+ ownership-map entry; roles only, never usernames.
135
+ 3. **Historical patterns block** — one line per matched pattern with
136
+ `id`, severity emoji, `label`, verbatim `required_test` and
137
+ `reference`.
138
+ 4. **Footer** — staleness note (or "none") and data source
139
+ (`ownership-map.yml + historical-bug-patterns.yml` or
140
+ `no project data — generic roles`).
141
+
142
+ Canonical layout:
143
+
144
+ ```
145
+ Skill: review-routing
146
+ Diff: <N> changed file(s)
147
+ Overall: 🔴 high / 🟡 medium / 🟢 low
148
+
149
+ Ownership (from ownership-map.yml, updated: YYYY-MM-DD):
150
+ • primary: <role> — focus: <focus notes merged>
151
+ • secondary: <role> — focus: <focus notes merged>
152
+ (additional roles as needed, anchored to specific files)
153
+
154
+ Historical patterns matched:
155
+ 🔴 <id> — <label>
156
+ required test: <verbatim from YAML>
157
+ reference: <verbatim from YAML>
158
+ 🟡 ...
159
+
160
+ Staleness: <none | "ownership map last updated N months ago">
161
+ Data source: <"ownership-map.yml + historical-bug-patterns.yml"
162
+ | "no project data — generic roles">
163
+ ```
164
+
165
+ ## Gotcha
166
+
167
+ - **Silently ignoring parse errors** — a malformed YAML looks like
168
+ absent data. Report the parse error and stop.
169
+ - **Downgrading severity** when a pattern matched but "the author said
170
+ it's fine" — the pattern is registered because it bit before.
171
+ - **Emitting usernames** — this skill outputs roles only. CODEOWNERS
172
+ maps role → person.
173
+ - **Inventing ownership** when the map does not cover the diff — say
174
+ "no match, generic fallback" instead.
175
+ - **Walking old pattern globs** against renamed files — the pattern
176
+ matches paths, not semantics.
177
+
178
+ ## Do NOT
179
+
180
+ - NEVER modify `ownership-map.yml` or `historical-bug-patterns.yml` as
181
+ a side effect of routing a diff. Data edits are a separate task.
182
+ - NEVER merge the ownership and pattern blocks into a single list —
183
+ they answer different questions.
184
+ - NEVER skip historical patterns because the PR is small. A one-line
185
+ change can still hit a registered failure mode.
186
+ - NEVER emit a routing block for a PR with no changed files.
187
+
188
+ ## See also
189
+
190
+ - [`reviewer-awareness`](../../rules/reviewer-awareness.md)
191
+ - [`review-routing-awareness`](../../rules/review-routing-awareness.md)
192
+ - [`review-routing-data-format`](../../guidelines/agent-infra/review-routing-data-format.md)
193
+ - [`create-pr-description`](../create-pr-description/SKILL.md)
194
+ - [`judge-test-coverage`](../judge-test-coverage/SKILL.md) — consumes
195
+ the `required_test` entries from matched patterns.
package/.agent-src/skills/roadmap-management/SKILL.md ADDED
@@ -0,0 +1,303 @@
1
+ ---
2
+ name: roadmap-management
3
+ description: "Use when the user says "create roadmap", "show roadmap", or "execute roadmap". Creates, reads, and manages roadmap files with phase tracking."
4
+ source: package
5
+ ---
6
+
7
+ # roadmap-manager
8
+
9
+ ## When to use
10
+
11
+ Use this skill when:
12
+ - Creating a new roadmap (`roadmap-create` command)
13
+ - Executing a roadmap (`roadmap-execute` command)
14
+ - Checking roadmap progress
15
+ - Updating roadmap status after completing work
16
+
17
+
18
+ Do NOT use when:
19
+ - Small tasks that don't span multiple steps
20
+ - One-off questions or fixes
21
+
22
+ ## ⚠ Dashboard sync — non-negotiable
23
+
24
+ `agents/roadmaps-progress.md` is auto-generated and must reflect the
25
+ live state in real time. After **any** checkbox edit (`[x]`, `[~]`,
26
+ `[-]`, `[ ]`) or phase add/rename/remove in a roadmap file, run
27
+ `task roadmap-progress` **in the same response**.
28
+
29
+ **Completion = archival.** If an edit takes a roadmap to
30
+ `count_open == 0` (pure `[x]`, or `[x]` + `[~]`/`[-]`), `git mv`
31
+ it into `agents/roadmaps/archive/` **before** regenerating — see
32
+ the auto-archive decision table under "Check completion status"
33
+ below. A 100%-complete roadmap left in `agents/roadmaps/` makes
34
+ the next reader think work is still open.
35
+
36
+ Enforced by [`roadmap-progress-sync`](../../rules/roadmap-progress-sync.md).
37
+ Batching edits in one response is fine — one final `task roadmap-progress`
38
+ before replying is enough. But the response must not end without it.
39
+
40
+ ## Procedure: Manage a roadmap
41
+
42
+ 1. **Identify need** — Is this a multi-step change that spans sessions or agents?
43
+ 2. **Create or locate** — Create new roadmap in `agents/roadmaps/` or find existing one.
44
+ 3. **Update progress** — Mark completed steps with `[x]`, add notes for blockers, then run `task roadmap-progress` in the same response (enforced by `roadmap-progress-sync`).
45
+ 4. **Verify** — Confirm all steps reflect current state, no stale information.
46
+
47
+ A roadmap is a structured `.md` file in `agents/roadmaps/` that describes a multi-step change
48
+ (refactoring, feature, migration). It ensures work can be picked up across sessions and by
49
+ different agents.
50
+
51
+ ## Roadmap locations
52
+
53
+ | Location | Scope |
54
+ |---|---|
55
+ | `agents/roadmaps/` | Project-wide roadmaps |
56
+ | `app/Modules/{Module}/agents/roadmaps/` | Module-specific roadmaps |
57
+ | `{package-root}/agents/roadmaps/` | Package-specific roadmaps |
58
+
59
+ The file `.augment/templates/roadmaps.md` defines the canonical structure.
60
+ **Always read it first** before creating or modifying roadmaps.
61
+
62
+ ## Roadmap structure
63
+
64
+ Every roadmap follows this structure:
65
+
66
+ ```markdown
67
+ # Roadmap: {Short descriptive title}
68
+
69
+ > {One sentence: What is the expected outcome?}
70
+
71
+ ## Prerequisites
72
+
73
+ - [ ] Read `AGENTS.md` and relevant docs
74
+ - [ ] {specific prerequisites}
75
+
76
+ ## Context
77
+
78
+ {Why this roadmap exists. Which module/domain. Links to Jira tickets.}
79
+
80
+ ## Phase 1: {Phase name}
81
+
82
+ - [ ] **Step 1:** {Clear, actionable instruction}
83
+ - [ ] **Step 2:** {Next step — reference files/classes}
84
+ - [ ] ...
85
+
86
+ ## Phase 2: {Phase name}
87
+
88
+ - [ ] **Step 1:** {description}
89
+ - [ ] ...
90
+
91
+ ## Acceptance Criteria
92
+
93
+ - [ ] {Observable, testable criterion}
94
+ - [ ] All quality gates pass (PHPStan, Rector, tests)
95
+
96
+ ## Notes
97
+
98
+ {Edge cases, decisions, links}
99
+ ```
100
+
101
+ ## Key rules for roadmaps
102
+
103
+ ### Checkboxes
104
+
105
+ - Every actionable step uses `- [ ]` (unchecked) or `- [x]` (completed).
106
+ - Mark steps as `[x]` immediately after completing them.
107
+ - Never remove completed steps — they serve as history.
108
+
109
+ ### Phases
110
+
111
+ - Group related steps into phases (e.g. "Preparation", "Migration", "Cleanup").
112
+ - Complete one phase before starting the next (unless steps are independent).
113
+ - After completing a phase, summarize what was done.
114
+
115
+ ### Quality gates
116
+
117
+ Every roadmap implicitly includes these gates (run after each step that changes code):
118
+
119
+ - PHPStan must pass (detect command: artisan vs composer, see `rules/docker-commands.md`)
120
+ - Rector: run with fix flag, verify no new PHPStan errors
121
+ - Tests: run affected tests
122
+
123
+ ### Step granularity
124
+
125
+ - Each step should be completable in one session (< 1 hour of work).
126
+ - If a step is too large, break it down into sub-steps.
127
+ - Steps should reference specific files/classes when possible.
128
+
129
+ ### Language
130
+
131
+ - Roadmap files are written in **English** (per project convention).
132
+ - Step descriptions should be precise and actionable, not vague.
133
+
134
+ ## Working with roadmaps
135
+
136
+ ### Creating a roadmap
137
+
138
+ 1. Ask the user for goal, context-create, and phases.
139
+ 2. Use the template structure from `.augment/templates/roadmaps.md`.
140
+ 3. Review with the user iteratively until approved.
141
+ 4. Save with a kebab-case filename (e.g. `optimize-webhook-jobs.md`).
142
+ 5. Run `task roadmap-progress` so the dashboard includes the new roadmap.
143
+
144
+ ### Executing a roadmap
145
+
146
+ 1. Read the full roadmap.
147
+ 2. Find the next unchecked step (`- [ ]`).
148
+ 3. Summarize what needs to be done.
149
+ 4. Ask the user before implementing (numbered options: implement / adjust / skip).
150
+ 5. After implementation: mark `[x]`, run quality gates, then `task roadmap-progress`.
151
+ 6. Move to the next step.
152
+
153
+ ### Resuming a roadmap
154
+
155
+ When picking up a roadmap in a new session:
156
+ 1. Read the roadmap to understand the full context.
157
+ 2. Check which steps are already completed (`[x]`).
158
+ 3. Summarize progress to the user.
159
+ 4. Continue from the next open step.
160
+
161
+ ### Completing, archiving & skipping a roadmap
162
+
163
+ Every roadmap ends in exactly one of three states:
164
+
165
+ | State | Folder | Trigger |
166
+ |---|---|---|
167
+ | **Active** | `agents/roadmaps/` | Work in progress or planned |
168
+ | **Archived** | `agents/roadmaps/archive/` | Work was done (fully or partially) and no more work is planned |
169
+ | **Skipped** | `agents/roadmaps/skipped/` | Decision against pursuit — superseded, scope rejected, wrong direction. Typically **0 items `[x]`** |
170
+
171
+ After the last step of a roadmap is done, check completion status:
172
+
173
+ 1. **Scan the file** for all checkbox markers: `- [x]`, `- [ ]`, `- [~]`, `- [-]`.
174
+ 2. **Classify:**
175
+ - `[x]` = completed
176
+ - `[ ]` = open (not done)
177
+ - `[~]` = deferred (intentionally pushed out, may come back)
178
+ - `[-]` = cancelled (individual item dropped)
179
+
180
+ 3. **Decision rule — `count_open == 0` means the roadmap has no active
181
+ work left. `[x]`, `[~]`, `[-]` are all finalized states; only `[ ]`
182
+ blocks closure. "Fertig ist fertig" — deferred and cancelled items
183
+ don't hold a finished roadmap in the active set.**
184
+
185
+ | count_x | count_open | count_deferred / cancelled | Action |
186
+ |---|---|---|---|
187
+ | ≥ 1 | 0 | 0 | **Auto-archive** (silent) — pure completion |
188
+ | ≥ 1 | 0 | ≥ 1 | **Auto-archive** (silent) — done with intentional skips |
189
+ | 0 | 0 | ≥ 1 | **Auto-skip** (silent) — no work happened, scope dropped |
190
+ | ≥ 0 | ≥ 1 | ≥ 0 | **Ask the user** — open work remains |
191
+
192
+ Show on auto-move:
193
+
194
+ - Archive: `✅ Roadmap archived → agents/roadmaps/archive/{filename}`
195
+ - Skip: `⏭️ Roadmap skipped → agents/roadmaps/skipped/{filename}`
196
+
197
+ The deferred/cancelled items remain searchable inside the archived file
198
+ (grep for `- [~]` / `- [-]` across `archive/`); a future revival opens a
199
+ new roadmap that cites the archived one.
200
+
201
+ 4. **If any items are `[ ]`:** → **Ask the user.** Show what's incomplete:
202
+
203
+ ```
204
+ 📋 Roadmap completion check:
205
+
206
+ ✅ Completed: {count_x}
207
+ ⬜ Open: {count_open} — {list of open items, 1 line each}
208
+ ⏭️ Deferred: {count_skip} — {list of deferred items, 1 line each}
209
+ ❌ Cancelled: {count_cancel} — {list of cancelled items, 1 line each}
210
+
211
+ > 1. Archive — mark open items as cancelled [-] and archive now
212
+ > 2. Keep active — I want to finish the open items
213
+ > 3. Mark open items as deferred [~] and archive
214
+ > 4. Skip — move to skipped/ (no meaningful work done, not pursuing)
215
+ ```
216
+
217
+ Option 4 is only appropriate when `count_x == 0` or the completed items were
218
+ trivial (e.g. prerequisites only). If the user picks 4 despite meaningful work
219
+ being done, confirm once — archive is usually the right choice.
220
+
221
+ 5. **Move the file** with `git mv` so history is preserved:
222
+
223
+ ```bash
224
+ # Archive (work was done)
225
+ git mv agents/roadmaps/{file} agents/roadmaps/archive/{file}
226
+
227
+ # Skipped (not pursuing)
228
+ git mv agents/roadmaps/{file} agents/roadmaps/skipped/{file}
229
+ ```
230
+
231
+ 6. **Regenerate the dashboard:** `task roadmap-progress`. The moved roadmap is
232
+ excluded from the active set once it sits in `archive/` or `skipped/`.
233
+
234
+ ### When to use `skipped/` vs `archive/`
235
+
236
+ | Situation | Destination |
237
+ |---|---|
238
+ | Finished all phases | `archive/` |
239
+ | Finished some phases, rest deferred/cancelled on purpose | `archive/` |
240
+ | Whole roadmap deferred or cancelled (no `[x]` at all) | `skipped/` |
241
+ | Never started, scope decision reversed | `skipped/` |
242
+ | Superseded by another roadmap | `skipped/` — add a pointer line at the top: `> Superseded by agents/roadmaps/{other}.md` |
243
+ | Research proved the direction wrong | `skipped/` — add a 1-line reason at the top |
244
+
245
+ If in doubt: archive beats skipped. `skipped/` is reserved for roadmaps where
246
+ no meaningful work was invested and the scope itself was rejected.
247
+
248
+ ## Progress dashboard — `agents/roadmaps-progress.md`
249
+
250
+ A generated dashboard aggregates progress across every open roadmap. It sits at
251
+ `agents/roadmaps-progress.md` (outside `roadmaps/` to keep the folder clean) and
252
+ is rewritten by `.augment/scripts/update_roadmap_progress.py`.
253
+
254
+ **Always regenerate in the SAME response** after any of the following
255
+ (enforced by [`roadmap-progress-sync`](../../rules/roadmap-progress-sync.md)):
256
+
257
+ - Creating a new roadmap (`roadmap-create`)
258
+ - Marking a step `[x]`, `[~]`, or `[-]` during `roadmap-execute`
259
+ - Archiving or moving a roadmap to `skipped/`
260
+ - Adding, renaming, or removing a phase
261
+
262
+ Command:
263
+
264
+ ```bash
265
+ task roadmap-progress # rewrite the dashboard
266
+ task roadmap-progress-check # CI: fail if stale
267
+ ```
268
+
269
+ The dashboard is a **read-only snapshot**. Do not edit it by hand — regenerate it.
270
+
271
+ ## Output format
272
+
273
+ 1. Roadmap file in agents/roadmaps/ with ordered phases and tasks
274
+ 2. Progress tracking with checkbox status
275
+ 3. `agents/roadmaps-progress.md` regenerated on every change
276
+
277
+ ## Auto-trigger keywords
278
+
279
+ - roadmap
280
+ - roadmap creation
281
+ - phase tracking
282
+ - step completion
283
+
284
+ ## Gotcha
285
+
286
+ - Roadmap files go in `agents/roadmaps/` — don't create them in other directories.
287
+ - Don't mark phases complete without running verification (tests, quality checks) — the verify-before-complete rule applies.
288
+ - The model tends to skip phases it deems "simple" — every phase must be explicitly completed.
289
+ - Auto-archive only when ALL checkboxes are `[x]`. Even one `[~]` or `[-]` requires user confirmation.
290
+ - `archive/` and `skipped/` are distinct — `archive/` = work happened, `skipped/` = no meaningful work, not pursuing. Create either directory if it doesn't exist.
291
+ - Use `git mv` (not `mv`) so history follows the file.
292
+
293
+ ## Do NOT
294
+
295
+ - Do NOT skip quality gates between steps.
296
+ - Do NOT mark steps as done without actually completing them.
297
+ - Do NOT modify completed steps (only add notes if needed).
298
+ - Do NOT create roadmaps for trivial changes (single-file fixes don't need a roadmap).
299
+ - Do NOT commit or push — only local changes.
300
+ - Do NOT archive roadmaps with open `[ ]` items without asking the user.
301
+ - Do NOT delete roadmaps — always move to `archive/` or `skipped/`.
302
+ - Do NOT use `skipped/` as a dumping ground for partially-finished work — that is what `archive/` with deferred items is for.
303
+ - Do NOT assign version numbers, git tags, or release identifiers to phases. Roadmaps plan work; releases and tags are decided by the user separately.
package/.agent-src/skills/rtk-output-filtering/SKILL.md ADDED
@@ -0,0 +1,184 @@
1
+ ---
2
+ name: rtk-output-filtering
3
+ description: "Use when running verbose CLI commands — wraps them with rtk (Rust Token Killer) for 60-90% token savings. Covers installation, configuration, and usage patterns."
4
+ source: package
5
+ execution:
6
+ type: assisted
7
+ handler: shell
8
+ allowed_tools: []
9
+ ---
10
+
11
+ # rtk (Rust Token Killer)
12
+
13
+ ## When to use
14
+
15
+ - Before running any CLI command expected to produce >30 lines of output
16
+ - When setting up rtk on a new machine or project
17
+ - When creating/optimizing project-local rtk filters
18
+
19
+ ## What
20
+
21
+ High-performance CLI proxy that reduces LLM token consumption by 60-90%
22
+ on common dev commands through intelligent output filtering (whitespace, boilerplate,
23
+ comments, duplicate log messages). Single Rust binary, <10ms startup overhead.
24
+
25
+ **Docs:** https://www.mintlify.com/rtk-ai/rtk
26
+ **Repo:** https://github.com/rtk-ai/rtk
27
+
28
+ ## Usage
29
+
30
+ Wrap any CLI command with `rtk`:
31
+ ```bash
32
+ rtk git status # 80-92% savings
33
+ rtk git log # compact log output
34
+ rtk cargo test # 90% savings — only failures shown
35
+ rtk npm test # same for JS/TS
36
+ rtk docker compose ps # compact container status
37
+ ```
38
+
39
+ ## Procedure: Wrap commands with rtk
40
+
41
+ 1. Run `which rtk` (silent) — check if installed.
42
+ 2. **If installed** → prefix commands with `rtk` when output >30 lines expected.
43
+ 3. **If NOT installed** → check `.agent-settings.yml` for `personal.rtk_last_asked`. If not today → prompt user (see Installation below).
44
+ 4. After wrapping: verify output is useful (not truncated on completeness-critical commands).
45
+
46
+ ## Output format
47
+
48
+ 1. Wrapped command with `rtk` prefix
49
+ 2. Token savings estimate (if first use in conversation)
50
+
51
+ ## Detection & Installation
52
+
53
+ **Before using CLI commands that produce verbose output**, check if rtk is available:
54
+
55
+ 1. Run `which rtk` (silent, no output to user).
56
+ 2. **If installed** → prefix commands with `rtk` when output may exceed ~30 lines.
57
+ 3. **If NOT installed** → check `.agent-settings.yml` for `personal.rtk_last_asked`:
58
+ - If missing or date is **before today** → prompt the user (see below).
59
+ - If date is **today** → skip, don't ask again. Use normal commands.
60
+
61
+ **Prompt template** (translate to user's language):
62
+
63
+ > 💡 **rtk** (Rust Token Killer) is not installed on your system.
64
+ > It reduces token consumption by 60-90% on common CLI commands.
65
+ >
66
+ > 1. Install via Homebrew — `brew install rtk` (recommended on macOS)
67
+ > 2. Install via Cargo — `cargo install rtk`
68
+ > 3. Skip for now — I'll ask again tomorrow
69
+
70
+ **On user response:**
71
+ - **1 or 2** → Run the chosen install command. After success:
72
+ 1. `rtk --version` to verify installation.
73
+ 2. `rtk init --global` to enable auto-rewrite hooks.
74
+ 3. Apply **Post-Install Setup** (see below) — telemetry, tee, audit logging.
75
+ 4. Generate project-local filters (see Post-Install Setup).
76
+ 5. Save `personal.rtk_installed: true` in `.agent-settings.yml`.
77
+ - **3** → Save `personal.rtk_last_asked: YYYY-MM-DD` (today) in `.agent-settings.yml`. Use normal commands.
78
+
79
+ ## Post-Install Setup (mandatory)
80
+
81
+ After installation, **always** apply these steps before any rtk usage:
82
+
83
+ ### 1. Disable telemetry
84
+
85
+ rtk ships with **telemetry enabled by default** (opt-out). Sends anonymous usage data daily.
86
+
87
+ ```bash
88
+ # Add BOTH — env var (immediate) + config (persistent)
89
+ echo 'export RTK_TELEMETRY_DISABLED=1' >> ~/.zshrc
90
+
91
+ mkdir -p ~/.config/rtk
92
+ # In ~/.config/rtk/config.toml:
93
+ # [telemetry]
94
+ # enabled = false
95
+ ```
96
+
97
+ ### 2. Enable tee recovery (safety net)
98
+
99
+ Saves raw unfiltered output on command failures. Auto-cleans (max 20 files, oldest deleted).
100
+ Prevents re-running commands just to see full output.
101
+
102
+ ```toml
103
+ # In ~/.config/rtk/config.toml:
104
+ [tee]
105
+ enabled = true
106
+ mode = "failures"
107
+ max_files = 20
108
+ max_file_size = 1048576
109
+ ```
110
+
111
+ ### 3. Enable hook audit logging
112
+
113
+ Logs all hook-rewritten commands so you can trace what rtk intercepted.
114
+
115
+ ```bash
116
+ echo 'export RTK_HOOK_AUDIT=1' >> ~/.zshrc
117
+ ```
118
+
119
+ ### Reference config (`~/.config/rtk/config.toml`)
120
+
121
+ ```toml
122
+ [telemetry]
123
+ enabled = false
124
+
125
+ [tracking]
126
+ enabled = true
127
+ history_days = 30
128
+
129
+ [tee]
130
+ enabled = true
131
+ mode = "failures"
132
+ max_files = 20
133
+ max_file_size = 1048576
134
+
135
+ [display]
136
+ colors = true
137
+ emoji = true
138
+ max_width = 120
139
+ ```
140
+
141
+ ## When to use rtk
142
+
143
+ | Command | Use rtk? |
144
+ |---|---|
145
+ | `git status/log` | ✅ Always |
146
+ | `git push/pull` | ✅ Always |
147
+ | Test runners (`cargo test`, `npm test`, `phpunit`) | ✅ Always |
148
+ | Linters (`phpstan`, `eslint`, `tsc`) | ✅ Always |
149
+ | `docker compose ps/logs` | ✅ Always |
150
+ | Short commands (< 5 lines expected) | ❌ No overhead benefit |
151
+ | Commands piped to `grep`/`tail` already | ❌ Already filtered |
152
+
153
+ ## Never use rtk for
154
+
155
+ | Command | Why |
156
+ |---|---|
157
+ | `git diff` | ⛔ Silent truncation at ~50 changes — LLM decides on incomplete data (Issue #827) |
158
+ | `rtk read` | ⛔ Same truncation risk — use `cat`/`view` instead |
159
+ | Any command where **completeness matters** | ⛔ rtk may strip context needed for correct decisions |
160
+
161
+ When debugging or reviewing diffs, **always run the raw command** without rtk.
162
+
163
+ ## Project-Local Filters
164
+
165
+ Custom filters for the project's PHP/Laravel toolchain live in `.rtk/filters.toml`
166
+ (project root, versioned in Git). These override global filters for matching commands.
167
+
168
+ Covered: PHPStan, Pest, ECS, Rector, Docker Compose, Artisan, Composer.
169
+
170
+ To generate or update project-local filters → use the `/optimize-rtk-filters` command.
171
+
172
+ ## Gotcha
173
+
174
+ - `rtk git diff` silently truncates at ~50 changes — you'll make decisions on incomplete data
175
+ - `rtk read` has the same truncation risk — always use `cat`/`view` instead
176
+ - Telemetry is enabled by default — always disable it during installation
177
+ - The tee recovery (`mode = "failures"`) is your safety net — without it, re-run is the only option
178
+
179
+ ## Do NOT
180
+
181
+ - Do NOT use `rtk` for `git diff` or any command where completeness matters
182
+ - Do NOT skip the post-install setup (telemetry, tee, audit logging)
183
+ - Do NOT use rtk for commands already piped through `grep`/`tail`
184
+ - Do NOT use rtk for short commands (< 5 lines expected output)