@event4u/agent-config 6.0.0 → 6.1.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 (378) hide show
  1. package/.claude-plugin/marketplace.json +5 -5
  2. package/CHANGELOG.md +167 -440
  3. package/README.md +3 -3
  4. package/dist/agent-src/commands/agent-handoff.md +5 -4
  5. package/dist/agent-src/commands/agent-status.md +1 -0
  6. package/dist/agent-src/commands/agents/audit.md +1 -0
  7. package/dist/agent-src/commands/agents/init.md +3 -0
  8. package/dist/agent-src/commands/agents/optimize.md +1 -0
  9. package/dist/agent-src/commands/agents/user/accept.md +1 -0
  10. package/dist/agent-src/commands/agents/user/init.md +1 -0
  11. package/dist/agent-src/commands/agents/user/review.md +1 -0
  12. package/dist/agent-src/commands/agents/user/show.md +1 -0
  13. package/dist/agent-src/commands/agents/user/update.md +1 -0
  14. package/dist/agent-src/commands/agents/user.md +1 -0
  15. package/dist/agent-src/commands/agents.md +1 -0
  16. package/dist/agent-src/commands/analytics/prune.md +3 -2
  17. package/dist/agent-src/commands/analytics/show.md +3 -2
  18. package/dist/agent-src/commands/analytics.md +3 -2
  19. package/dist/agent-src/commands/analyze-reference-repo.md +1 -0
  20. package/dist/agent-src/commands/bug-fix.md +1 -0
  21. package/dist/agent-src/commands/bug-investigate.md +1 -0
  22. package/dist/agent-src/commands/challenge-me/vision.md +3 -2
  23. package/dist/agent-src/commands/challenge-me/with-docs.md +3 -2
  24. package/dist/agent-src/commands/challenge-me.md +3 -2
  25. package/dist/agent-src/commands/chat-history/import.md +9 -9
  26. package/dist/agent-src/commands/chat-history.md +32 -30
  27. package/dist/agent-src/commands/check-current-md.md +1 -0
  28. package/dist/agent-src/commands/commit/in-chunks.md +1 -0
  29. package/dist/agent-src/commands/commit.md +1 -0
  30. package/dist/agent-src/commands/condense.md +1 -0
  31. package/dist/agent-src/commands/context/create.md +1 -0
  32. package/dist/agent-src/commands/context/refactor.md +1 -0
  33. package/dist/agent-src/commands/context.md +1 -0
  34. package/dist/agent-src/commands/cost-report.md +5 -4
  35. package/dist/agent-src/commands/council/analysis.md +3 -2
  36. package/dist/agent-src/commands/council/debate.md +5 -4
  37. package/dist/agent-src/commands/council/default.md +3 -2
  38. package/dist/agent-src/commands/council/design.md +3 -2
  39. package/dist/agent-src/commands/council/optimize.md +3 -2
  40. package/dist/agent-src/commands/council/pr.md +3 -2
  41. package/dist/agent-src/commands/council.md +4 -3
  42. package/dist/agent-src/commands/e2e-heal.md +1 -0
  43. package/dist/agent-src/commands/e2e-plan.md +1 -0
  44. package/dist/agent-src/commands/estimate-ticket.md +1 -0
  45. package/dist/agent-src/commands/feature/dev.md +1 -0
  46. package/dist/agent-src/commands/feature/explore.md +1 -0
  47. package/dist/agent-src/commands/feature/plan.md +6 -6
  48. package/dist/agent-src/commands/feature/refactor.md +1 -0
  49. package/dist/agent-src/commands/feature/roadmap.md +1 -0
  50. package/dist/agent-src/commands/feature.md +1 -0
  51. package/dist/agent-src/commands/fix/ci.md +1 -0
  52. package/dist/agent-src/commands/fix/portability.md +1 -0
  53. package/dist/agent-src/commands/fix/pr-comments.md +147 -15
  54. package/dist/agent-src/commands/fix/refs.md +1 -0
  55. package/dist/agent-src/commands/fix/seeder.md +1 -0
  56. package/dist/agent-src/commands/fix.md +8 -8
  57. package/dist/agent-src/commands/ghostwriter/delete.md +1 -0
  58. package/dist/agent-src/commands/ghostwriter/fetch.md +1 -0
  59. package/dist/agent-src/commands/ghostwriter/list.md +1 -0
  60. package/dist/agent-src/commands/ghostwriter/show.md +1 -0
  61. package/dist/agent-src/commands/ghostwriter/write.md +1 -0
  62. package/dist/agent-src/commands/ghostwriter.md +1 -0
  63. package/dist/agent-src/commands/grill-me.md +3 -2
  64. package/dist/agent-src/commands/image/analyse.md +1 -0
  65. package/dist/agent-src/commands/image/create.md +1 -0
  66. package/dist/agent-src/commands/image/verify.md +1 -0
  67. package/dist/agent-src/commands/image.md +1 -0
  68. package/dist/agent-src/commands/implement-ticket.md +1 -0
  69. package/dist/agent-src/commands/jira-ticket.md +1 -0
  70. package/dist/agent-src/commands/judge/on-diff.md +1 -0
  71. package/dist/agent-src/commands/judge/solo.md +1 -0
  72. package/dist/agent-src/commands/judge/steps.md +1 -0
  73. package/dist/agent-src/commands/judge.md +1 -0
  74. package/dist/agent-src/commands/knowledge/cross-repo.md +1 -0
  75. package/dist/agent-src/commands/knowledge/forget.md +1 -0
  76. package/dist/agent-src/commands/knowledge/ingest.md +1 -0
  77. package/dist/agent-src/commands/knowledge/list.md +1 -0
  78. package/dist/agent-src/commands/knowledge.md +1 -0
  79. package/dist/agent-src/commands/memory/add.md +8 -6
  80. package/dist/agent-src/commands/memory/learn-low-impact.md +3 -2
  81. package/dist/agent-src/commands/memory/load.md +7 -7
  82. package/dist/agent-src/commands/memory/mine-session.md +39 -12
  83. package/dist/agent-src/commands/memory/promote.md +3 -2
  84. package/dist/agent-src/commands/memory/propose.md +7 -6
  85. package/dist/agent-src/commands/memory.md +3 -2
  86. package/dist/agent-src/commands/mode.md +1 -0
  87. package/dist/agent-src/commands/module/create.md +1 -0
  88. package/dist/agent-src/commands/module/explore.md +1 -0
  89. package/dist/agent-src/commands/module.md +1 -0
  90. package/dist/agent-src/commands/optimize/agents-dir.md +1 -0
  91. package/dist/agent-src/commands/optimize/augmentignore.md +1 -0
  92. package/dist/agent-src/commands/optimize/rtk.md +1 -0
  93. package/dist/agent-src/commands/optimize/skills.md +1 -0
  94. package/dist/agent-src/commands/optimize-prompt.md +1 -0
  95. package/dist/agent-src/commands/optimize.md +1 -0
  96. package/dist/agent-src/commands/orchestrate.md +1 -0
  97. package/dist/agent-src/commands/override/create.md +1 -0
  98. package/dist/agent-src/commands/override/manage.md +1 -0
  99. package/dist/agent-src/commands/override.md +1 -0
  100. package/dist/agent-src/commands/package-reset.md +1 -0
  101. package/dist/agent-src/commands/package-test.md +1 -0
  102. package/dist/agent-src/commands/post-as/ghostwriter.md +1 -0
  103. package/dist/agent-src/commands/post-as/me.md +1 -0
  104. package/dist/agent-src/commands/post-as.md +1 -0
  105. package/dist/agent-src/commands/pr/create/description-only.md +1 -0
  106. package/dist/agent-src/commands/pr/create.md +25 -0
  107. package/dist/agent-src/commands/prediction-pool.md +1 -0
  108. package/dist/agent-src/commands/prepare-for-review.md +1 -0
  109. package/dist/agent-src/commands/profile/activate.md +1 -0
  110. package/dist/agent-src/commands/profile/deactivate.md +1 -0
  111. package/dist/agent-src/commands/profile/show.md +1 -0
  112. package/dist/agent-src/commands/profile.md +1 -0
  113. package/dist/agent-src/commands/project-analyze.md +1 -0
  114. package/dist/agent-src/commands/project-health.md +1 -0
  115. package/dist/agent-src/commands/quality-fix.md +1 -0
  116. package/dist/agent-src/commands/refine-ticket.md +1 -0
  117. package/dist/agent-src/commands/research/deep.md +1 -0
  118. package/dist/agent-src/commands/research/report.md +1 -0
  119. package/dist/agent-src/commands/research.md +1 -0
  120. package/dist/agent-src/commands/review-changes.md +1 -0
  121. package/dist/agent-src/commands/review-routing.md +1 -0
  122. package/dist/agent-src/commands/roadmap/ai-council.md +1 -0
  123. package/dist/agent-src/commands/roadmap/create.md +1 -0
  124. package/dist/agent-src/commands/roadmap/process-full.md +1 -0
  125. package/dist/agent-src/commands/roadmap/process-phase.md +1 -0
  126. package/dist/agent-src/commands/roadmap/process-step.md +1 -0
  127. package/dist/agent-src/commands/roadmap.md +1 -0
  128. package/dist/agent-src/commands/rule-compliance-audit.md +1 -0
  129. package/dist/agent-src/commands/security-audit-config.md +84 -0
  130. package/dist/agent-src/commands/set-cost-profile.md +1 -0
  131. package/dist/agent-src/commands/skill/preview.md +1 -0
  132. package/dist/agent-src/commands/skill.md +1 -0
  133. package/dist/agent-src/commands/skills/discover.md +1 -0
  134. package/dist/agent-src/commands/skills.md +1 -0
  135. package/dist/agent-src/commands/sync-agent-settings.md +1 -0
  136. package/dist/agent-src/commands/sync-gitignore/fix.md +1 -0
  137. package/dist/agent-src/commands/sync-gitignore.md +1 -0
  138. package/dist/agent-src/commands/tests/create.md +1 -0
  139. package/dist/agent-src/commands/tests/execute.md +1 -0
  140. package/dist/agent-src/commands/tests.md +1 -0
  141. package/dist/agent-src/commands/threat-model.md +1 -0
  142. package/dist/agent-src/commands/update-form-request-messages.md +1 -0
  143. package/dist/agent-src/commands/upstream-contribute.md +1 -0
  144. package/dist/agent-src/commands/video/from-script.md +1 -0
  145. package/dist/agent-src/commands/video/from-song.md +1 -0
  146. package/dist/agent-src/commands/video/scene.md +1 -0
  147. package/dist/agent-src/commands/video/stitch.md +1 -0
  148. package/dist/agent-src/commands/video/storyboard.md +1 -0
  149. package/dist/agent-src/commands/video.md +1 -0
  150. package/dist/agent-src/commands/work.md +1 -0
  151. package/dist/agent-src/contexts/augment-infrastructure.md +1 -1
  152. package/dist/agent-src/contexts/communication/rules-auto/skill-quality-mechanics.md +1 -1
  153. package/dist/agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md +2 -2
  154. package/dist/agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md +6 -6
  155. package/dist/agent-src/contexts/contracts/consumer-agents-md-guide.md +2 -2
  156. package/dist/agent-src/contexts/execution/rdp-gate.md +75 -0
  157. package/dist/agent-src/contexts/subagent-configuration.md +1 -0
  158. package/dist/agent-src/personas/advisors/contrarian.md +1 -1
  159. package/dist/agent-src/personas/advisors/executor.md +1 -1
  160. package/dist/agent-src/personas/advisors/expansionist.md +1 -1
  161. package/dist/agent-src/personas/advisors/first-principles.md +1 -1
  162. package/dist/agent-src/personas/advisors/outsider.md +1 -1
  163. package/dist/agent-src/rules/autonomous-execution.md +12 -0
  164. package/dist/agent-src/rules/external-reference-deep-dive.md +1 -1
  165. package/dist/agent-src/rules/git-history-discipline.md +47 -1
  166. package/dist/agent-src/rules/improve-before-implement.md +12 -0
  167. package/dist/agent-src/rules/lethal-trifecta-guard.md +80 -0
  168. package/dist/agent-src/rules/no-pr-progress-comments.md +3 -4
  169. package/dist/agent-src/rules/notes-first-reasoning.md +71 -0
  170. package/dist/agent-src/rules/roadmap-progress-sync.md +48 -31
  171. package/dist/agent-src/rules/security-sensitive-stop.md +14 -1
  172. package/dist/agent-src/rules/source-confidentiality.md +97 -0
  173. package/dist/agent-src/rules/think-before-action.md +9 -1
  174. package/dist/agent-src/rules/untrusted-input-defense.md +76 -0
  175. package/dist/agent-src/scripts/archive_completed_roadmaps.py +171 -0
  176. package/dist/agent-src/skills/adversarial-review/SKILL.md +14 -0
  177. package/dist/agent-src/skills/agent-security-review/SKILL.md +113 -0
  178. package/dist/agent-src/skills/agent-security-review/evals/triggers.json +51 -0
  179. package/dist/agent-src/skills/ai-council/SKILL.md +3 -3
  180. package/dist/agent-src/skills/async-python-patterns/SKILL.md +1 -1
  181. package/dist/agent-src/skills/blast-radius-analyzer/SKILL.md +12 -11
  182. package/dist/agent-src/skills/command-routing/SKILL.md +1 -1
  183. package/dist/agent-src/skills/complexity-first-planning/SKILL.md +96 -0
  184. package/dist/agent-src/skills/complexity-first-planning/evals/triggers.json +16 -0
  185. package/dist/agent-src/skills/copilot-config/SKILL.md +3 -4
  186. package/dist/agent-src/skills/defense-in-depth/SKILL.md +1 -1
  187. package/dist/agent-src/skills/developer-like-execution/SKILL.md +5 -4
  188. package/dist/agent-src/skills/error-handling-patterns/SKILL.md +1 -1
  189. package/dist/agent-src/skills/feature-planning/SKILL.md +2 -2
  190. package/dist/agent-src/skills/mcp-builder/SKILL.md +1 -1
  191. package/dist/agent-src/skills/memory-consolidation/SKILL.md +63 -17
  192. package/dist/agent-src/skills/prompt-engineering-patterns/SKILL.md +1 -1
  193. package/dist/agent-src/skills/readme-writing-package/SKILL.md +1 -1
  194. package/dist/agent-src/skills/reasoning-orchestrator/SKILL.md +119 -0
  195. package/dist/agent-src/skills/reasoning-orchestrator/evals/triggers.json +16 -0
  196. package/dist/agent-src/skills/receiving-code-review/SKILL.md +6 -6
  197. package/dist/agent-src/skills/refine-prompt/SKILL.md +1 -1
  198. package/dist/agent-src/skills/refine-ticket/SKILL.md +1 -1
  199. package/dist/agent-src/skills/repomix-packer/SKILL.md +1 -1
  200. package/dist/agent-src/skills/secrets-management/SKILL.md +1 -1
  201. package/dist/agent-src/skills/subagent-orchestration/SKILL.md +10 -3
  202. package/dist/agent-src/skills/testing-anti-patterns/SKILL.md +1 -1
  203. package/dist/agent-src/skills/testing-anti-patterns/process-anti-patterns.md +1 -1
  204. package/dist/agent-src/skills/token-optimizer/SKILL.md +1 -1
  205. package/dist/agent-src/templates/agents/.gitattributes.fragment +0 -1
  206. package/dist/agent-src/templates/agents/agent-project-settings.example.yml +4 -4
  207. package/dist/agent-src/templates/scripts/check_memory.py +1 -2
  208. package/dist/agent-src/templates/scripts/check_memory_proposal.py +1 -1
  209. package/dist/agent-src/templates/scripts/memory_lookup.py +148 -289
  210. package/dist/agent-src/templates/scripts/memory_report.py +132 -2
  211. package/dist/agent-src/templates/scripts/memory_signal.py +7 -9
  212. package/dist/agent-src/templates/scripts/memory_status.py +25 -206
  213. package/dist/agent-src/templates/scripts/work_engine/directives/backend/memory.py +6 -6
  214. package/dist/agent-src/templates/scripts/work_engine/directives/ui/_passthrough.py +3 -3
  215. package/dist/agent-src/templates/scripts/work_engine/scoring/memory_visibility.py +0 -1
  216. package/dist/cli/agent-config.js +31 -300
  217. package/dist/cli/agent-config.js.map +1 -1
  218. package/dist/cli/commands/commands.js +10 -5
  219. package/dist/cli/commands/commands.js.map +1 -1
  220. package/dist/cli/discovery/loadManifest.js.map +1 -1
  221. package/dist/cli/main.js +309 -0
  222. package/dist/cli/main.js.map +1 -0
  223. package/dist/discovery/deprecation-report.md +1 -1
  224. package/dist/discovery/discovery-manifest.json +645 -342
  225. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  226. package/dist/discovery/discovery-manifest.summary.md +8 -5
  227. package/dist/discovery/orphan-report.md +1 -1
  228. package/dist/discovery/packs.json +149 -37
  229. package/dist/discovery/trust-report.md +3 -3
  230. package/dist/discovery/workspaces.json +61 -36
  231. package/dist/mcp/registry-manifest.json +4 -4
  232. package/dist/router.json +1 -1
  233. package/dist/server/routes/wizard.js +4 -3
  234. package/dist/server/routes/wizard.js.map +1 -1
  235. package/dist/server/schemas/settings.js +18 -0
  236. package/dist/server/schemas/settings.js.map +1 -1
  237. package/docs/MIGRATION.md +1 -1
  238. package/docs/adrs/cost/0001-hard-stop-hook.md +5 -5
  239. package/docs/adrs/memory/0001-consumer-side-snapshot.md +15 -7
  240. package/docs/adrs/memory/README.md +6 -5
  241. package/docs/adrs/router/0001-three-tier-routing.md +2 -2
  242. package/docs/adrs/schema/0001-json-schema-frontmatter.md +2 -2
  243. package/docs/adrs/smoke/0001-per-tier-smoke-scripts.md +5 -5
  244. package/docs/adrs/telegraph/0001-default-off-until-bench.md +3 -3
  245. package/docs/architecture.md +9 -9
  246. package/docs/archive/CHANGELOG-pre-2.2.0.md +30 -30
  247. package/docs/archive/CHANGELOG-pre-2.25.0.md +1 -1
  248. package/docs/archive/CHANGELOG-pre-4.5.0.md +1 -1
  249. package/docs/archive/CHANGELOG-pre-6.0.0.md +473 -0
  250. package/docs/benchmark.md +54 -53
  251. package/docs/benchmarks.md +2 -2
  252. package/docs/case-studies/{frontend-design-vs-ui-ux-pro-max.md → frontend-design-positioning.md} +4 -4
  253. package/docs/catalog.md +20 -13
  254. package/docs/command-flows.md +90 -92
  255. package/docs/contracts/adr-layout.md +2 -3
  256. package/docs/contracts/adr-level-6-productization.md +1 -1
  257. package/docs/contracts/ai-council-config.md +42 -7
  258. package/docs/contracts/command-clusters.md +1 -1
  259. package/docs/contracts/cost-enforcement.md +1 -1
  260. package/docs/contracts/cost-summary-schema.md +1 -1
  261. package/docs/contracts/daily-workspace.md +1 -0
  262. package/docs/contracts/discovery-manifest.schema.json +4 -2
  263. package/docs/contracts/explain-modes.md +1 -1
  264. package/docs/contracts/implement-ticket-flow.md +6 -7
  265. package/docs/contracts/mcp-tool-inventory.md +10 -10
  266. package/docs/contracts/measurement-baseline.md +1 -1
  267. package/docs/contracts/memory-visibility-v1.md +1 -5
  268. package/docs/contracts/namespace.md +1 -1
  269. package/docs/contracts/persona-schema.md +1 -1
  270. package/docs/contracts/rule-interactions.md +1 -1
  271. package/docs/contracts/smoke-contracts.md +1 -1
  272. package/docs/contracts/universal-skills.md +0 -1
  273. package/docs/contracts/workspace-boundary.md +84 -0
  274. package/docs/customization.md +3 -3
  275. package/docs/decisions/ADR-009-event4u-namespace.md +1 -1
  276. package/docs/decisions/ADR-013-discovery-frontmatter-contract.md +1 -1
  277. package/docs/decisions/ADR-026-explain-mode-translation.md +1 -1
  278. package/docs/decisions/ADR-088-no-external-runtime-federation.md +26 -27
  279. package/docs/decisions/ADR-090-visibility-command-frontmatter-field.md +95 -0
  280. package/docs/decisions/ADR-091-split-meta-capability-packs.md +113 -0
  281. package/docs/decisions/ADR-092-defer-command-tier-alias-removal.md +93 -0
  282. package/docs/decisions/ADR-093-ai-council-config-user-global.md +111 -0
  283. package/docs/decisions/ADR-094-agent-memory-layer-removal.md +94 -0
  284. package/docs/decisions/ADR-095-workspace-boundary-contract.md +108 -0
  285. package/docs/decisions/INDEX.md +6 -0
  286. package/docs/development.md +5 -7
  287. package/docs/getting-started.md +4 -4
  288. package/docs/guidelines/agent-infra/5w2h-analysis.md +1 -1
  289. package/docs/guidelines/agent-infra/comparison-matrix.md +1 -1
  290. package/docs/guidelines/agent-infra/corpus-grounding-authoring.md +1 -1
  291. package/docs/guidelines/agent-infra/critical-thinking.md +1 -1
  292. package/docs/guidelines/agent-infra/engineering-memory-data-format.md +1 -5
  293. package/docs/guidelines/agent-infra/first-principles.md +1 -1
  294. package/docs/guidelines/agent-infra/frontier-reasoning-operating-profile.md +164 -0
  295. package/docs/guidelines/agent-infra/inversion-thinking.md +1 -1
  296. package/docs/guidelines/agent-infra/ios-simulator-guide.md +9 -14
  297. package/docs/guidelines/agent-infra/mcp-request-signing.md +19 -22
  298. package/docs/guidelines/agent-infra/memory-access.md +25 -31
  299. package/docs/guidelines/agent-infra/mental-models.md +1 -1
  300. package/docs/guidelines/agent-infra/model-recommendation.md +29 -0
  301. package/docs/guidelines/agent-infra/scqa-framework.md +3 -3
  302. package/docs/guidelines/agent-infra/security-lint-containment.md +81 -0
  303. package/docs/guidelines/agent-infra/six-hats.md +1 -1
  304. package/docs/guidelines/agent-infra/systems-thinking.md +1 -1
  305. package/docs/guidelines/agent-infra/untrusted-input-spotlighting.md +72 -0
  306. package/docs/installation.md +1 -1
  307. package/docs/mcp.md +2 -2
  308. package/docs/parity/{bench-ruflo.json → bench-external.json} +10 -10
  309. package/docs/parity/{ruflo.md → external-runtime.md} +9 -9
  310. package/docs/quality.md +3 -3
  311. package/docs/safety.md +3 -3
  312. package/docs/skills-catalog.md +4 -1
  313. package/llms.txt +3 -0
  314. package/package.json +1 -1
  315. package/src/config/agent-settings.template.yml +65 -3
  316. package/src/config/discovery/packs.yml +29 -0
  317. package/src/config/discovery/workspaces.yml +3 -1
  318. package/src/config/gitignore-block.txt +6 -0
  319. package/src/scripts/__pycache__/validate_frontmatter.cpython-312.pyc +0 -0
  320. package/src/scripts/_cli/cmd_doctor.py +99 -13
  321. package/src/scripts/_lib/__pycache__/__init__.cpython-312.pyc +0 -0
  322. package/src/scripts/_lib/__pycache__/agent_src.cpython-312.pyc +0 -0
  323. package/src/scripts/_lib/bench_ab_scoring_v2.py +227 -0
  324. package/src/scripts/_lib/global_deploy_inventory.py +39 -9
  325. package/src/scripts/_lib/link_crypto.py +206 -0
  326. package/src/scripts/_lib/security_lint.py +228 -0
  327. package/src/scripts/ai_council/clients.py +2 -2
  328. package/src/scripts/ai_council/config.py +55 -0
  329. package/src/scripts/audit_adr_coverage.py +0 -2
  330. package/src/scripts/audit_command_surface.py +18 -5
  331. package/src/scripts/audit_mcp_tools.py +2 -2
  332. package/src/scripts/audit_skill_descriptions.py +2 -2
  333. package/src/scripts/bench_ab_clone.py +62 -12
  334. package/src/scripts/bench_ab_task_runner.py +475 -30
  335. package/src/scripts/bench_ab_v2_run.py +247 -0
  336. package/src/scripts/bench_ab_v2_stats.py +347 -0
  337. package/src/scripts/bench_run.py +1 -1
  338. package/src/scripts/build_discovery_manifest.py +10 -0
  339. package/src/scripts/check_bite_sized_granularity.py +1 -2
  340. package/src/scripts/check_memory.py +49 -63
  341. package/src/scripts/check_memory_proposal.py +1 -1
  342. package/src/scripts/check_no_external_sources.py +101 -0
  343. package/src/scripts/check_references.py +2 -0
  344. package/src/scripts/cost_by_conversation.py +1 -1
  345. package/src/scripts/council_cli.py +28 -14
  346. package/src/scripts/external_sources_denylist.json +91 -0
  347. package/src/scripts/hook_manifest.yaml +14 -6
  348. package/src/scripts/injection_scan_hook.py +145 -0
  349. package/src/scripts/install-hooks.sh +11 -0
  350. package/src/scripts/install.py +88 -13
  351. package/src/scripts/lint_agent_security.py +112 -0
  352. package/src/scripts/lint_bench_ab.py +5 -4
  353. package/src/scripts/lint_command_tiers.py +63 -22
  354. package/src/scripts/lint_discovery_vocabulary.py +2 -0
  355. package/src/scripts/lint_empty_roadmaps.py +80 -0
  356. package/src/scripts/lint_hidden_unicode.py +132 -0
  357. package/src/scripts/lint_instruction_smuggling.py +107 -0
  358. package/src/scripts/lint_marketplace.py +1 -1
  359. package/src/scripts/lint_mcp_config_security.py +124 -0
  360. package/src/scripts/lint_skill_frontmatter_safety.py +144 -0
  361. package/src/scripts/lint_workspace_boundary.py +122 -0
  362. package/src/scripts/mcp_server/consumer_tool_catalog.json +2 -3
  363. package/src/scripts/mcp_server/tools.py +8 -32
  364. package/src/scripts/memory_lookup.py +27 -296
  365. package/src/scripts/memory_report.py +1 -23
  366. package/src/scripts/memory_signal.py +6 -53
  367. package/src/scripts/memory_status.py +25 -206
  368. package/src/scripts/mine_session.py +118 -41
  369. package/src/scripts/pack_dependency_allowlist.json +2 -2
  370. package/src/scripts/render_benchmark_md.py +141 -52
  371. package/src/scripts/schemas/command.schema.json +6 -1
  372. package/src/scripts/security_audit_config.py +153 -0
  373. package/dist/agent-src/commands/chat-history/learn.md +0 -184
  374. package/dist/agent-src/commands/chat-history/show.md +0 -113
  375. package/dist/agent-src/commands/fix/pr-bot-comments.md +0 -157
  376. package/dist/agent-src/commands/fix/pr-developer-comments.md +0 -163
  377. package/dist/agent-src/templates/agents/memory/architecture-decisions.example.yml +0 -95
  378. package/docs/contracts/agent-memory-contract.md +0 -159
@@ -167,7 +167,7 @@ complexity: lightweight # default — skips bite-sized granularity
167
167
  ---
168
168
  ```
169
169
 
170
- Source: adapted from `obra/superpowers` `writing-plans/SKILL.md` § Task Structure + § No Placeholders (v5.1.0); complexity-gating is our addition (Council Round 1, Q4 — mitigates UX pushback for senior engineers on well-scoped work).
170
+ Source: adapted from an external reference `writing-plans/SKILL.md` § Task Structure + § No Placeholders (v5.1.0); complexity-gating is our addition (Council Round 1, Q4 — mitigates UX pushback for senior engineers on well-scoped work).
171
171
 
172
172
  ## Self-review (3-scan checklist)
173
173
 
@@ -179,7 +179,7 @@ Before presenting any plan, run these three scans in order. Each is a fast pass
179
179
 
180
180
  This scan is **separate from** adversarial-review (below). Self-review catches mechanical gaps (missing AC, leftover placeholders, mis-shaped types); adversarial-review challenges the plan's reasoning.
181
181
 
182
- Source: adapted from `obra/superpowers` `writing-plans/SKILL.md` § Self-Review (v5.1.0).
182
+ Source: adapted from an external reference `writing-plans/SKILL.md` § Self-Review (v5.1.0).
183
183
 
184
184
  ## Adversarial self-review
185
185
 
@@ -107,7 +107,7 @@ Process: enumerate the tools, explore READ-ONLY data, draft 10 questions, **solv
107
107
 
108
108
  - Upstream protocol: https://modelcontextprotocol.io
109
109
  - Upstream SDKs: https://github.com/modelcontextprotocol/python-sdk · https://github.com/modelcontextprotocol/typescript-sdk
110
- - Adopted from: `Microck/ordinary-claude-skills@8f5c83174f7aa683b4ddc7433150471983b93131:skills_all/mcp-builder/SKILL.md` (MIT, © 2025 Microck) — external `./reference/*.md` file links replaced with inline guidance + upstream URLs.
110
+ - Adopted from: an external reference (MIT, © 2025 an external reference) — external `./reference/*.md` file links replaced with inline guidance + upstream URLs.
111
111
  - Cross-linked: [`mcp`](../mcp/SKILL.md), [`testing-anti-patterns`](../testing-anti-patterns/SKILL.md), [`api-design`](../api-design/SKILL.md).
112
112
  - Provenance registry: `agents/settings/contexts/skills-provenance.yml` (entry: `mcp-builder`).
113
113
  - Iron-Law floor: `verify-before-complete`, `tool-safety`, `skill-quality`.
@@ -90,13 +90,15 @@ miner is too loose; tighten patterns and re-run before promoting.
90
90
 
91
91
  A fact may carry **two** tags; the promoter resolves via tag
92
92
  intersection, not by file extension. See
93
- [`docs/contracts/agent-memory-contract.md`](../../../docs/contracts/agent-memory-contract.md)
94
- for the curated YAML schemas.
93
+ [`memory-access`](../../../docs/guidelines/agent-infra/memory-access.md)
94
+ for the file-backed retrieval contract over the curated YAML.
95
95
 
96
96
  2. Append each fact as one JSONL line to
97
97
  `agents/memory/intake/<primary-tag>.jsonl` with required fields
98
98
  per the contract: `ts`, `type`, `key`, `observation`, `source:
99
99
  agent`, `session_id`, plus the new optional `tags: [<one>, <two>]`.
100
+ Intake is **gitignored, local scratch** — only entries promoted to
101
+ curated YAML (next phase) become team-shared (committed).
100
102
  3. Default to `--preview` mode: render the JSONL block to stdout and
101
103
  stop. Only `--commit-intake` writes the file.
102
104
 
@@ -109,13 +111,45 @@ validates against the contract.
109
111
  archive the consumed JSONL lines into
110
112
  `agents/memory/intake/.archive/YYYY-Www.jsonl` — week-bucketed,
111
113
  not day-bucketed (defeats session-context inference attacks).
112
- 2. If a curated entry's `last_validated` field is older than 90 days
113
- AND no signal in the last 30 days touched its `key`, mark it
114
- stale in the consolidation report but do **not** auto-delete.
115
- Pruning is a human-confirmed action.
116
-
117
- **Exit gate:** report cites 0 promotions, 0 stale flags, 0
118
- auto-deletes.
114
+ 2. **Delete `status: archived` curated entries.** Once an entry is
115
+ marked `archived` (by review or supersession), remove it from the hot
116
+ file **git history is the cold archive** (`git log -- <file>`
117
+ recovers it). This keeps the committed memory small without a decay
118
+ engine. Do not keep an `agents/memory/archive/` directory.
119
+ 3. If an *active* curated entry's `last_validated` is older than 90 days
120
+ AND no signal in the last 30 days touched its `key`, mark it stale in
121
+ the consolidation report — but do **not** auto-delete a still-active
122
+ entry. Only `archived` entries are deleted; staleness is a flag, not a
123
+ delete trigger.
124
+
125
+ **Exit gate:** report cites ≥ 0 promotions, ≥ 0 stale flags, and the
126
+ count of `archived` entries deleted (git history retains them).
127
+
128
+ ## Write-time curation discipline
129
+
130
+ Memory quality comes from what you write, not from a heavy store. Apply
131
+ these at GATHER + CONSOLIDATE (adapted from MemSkill's memory-operation
132
+ skills — github.com/ViktorAxelsen/MemSkill, Apache-2.0, commit `9907c35f8cc7`):
133
+
134
+ - **Dedupe before insert.** Compare against retrieved entries; never add a
135
+ fact already covered. Split distinct facts into separate entries.
136
+ - **Merge on refresh, preserve what still holds.** When a fact updates an
137
+ existing entry, merge into one item and keep the details that remain true.
138
+ - **Delete only on explicit contradiction.** Remove a curated entry only when
139
+ evidence directly contradicts or cancels it. If uncertain, keep it.
140
+ - **Prefer no-op under uncertainty.** A chunk with no new, corrective, or
141
+ actionable information records nothing — silence beats speculation.
142
+ - **Skip trivial / fleeting / speculative content.** Capture durable,
143
+ reusable facts, not transcripts or one-off chatter.
144
+ - **One durable fact per entry.** No narrative blobs — each entry is a single
145
+ PATTERN / CONVENTION / INVARIANT / GOTCHA the next agent can act on.
146
+
147
+ This is **meta-memory**: the skill of *how to remember* (what to extract,
148
+ keep, forget) — distinct from the remembered content. The store stays simple
149
+ and file-backed; the discipline lives here. Do **not** add
150
+ INSERT/UPDATE/DELETE/NOOP operation machinery (append-only JSONL + curated
151
+ YAML need no such ops) and do **not** import any retrieval / decay / trust
152
+ engine.
119
153
 
120
154
  ## TranscriptAdapter contract
121
155
 
@@ -134,11 +168,24 @@ The miner is host-agnostic by design. A `TranscriptAdapter` for host
134
168
  identifier the consumer project lists in
135
169
  `.agent-settings.yml` under `memory.redact_patterns`.
136
170
 
137
- Phase 1 implementation lives in
138
- `/memory:mine-session` (single host: Claude Code,
139
- `~/.claude/projects/*/sessions/*.jsonl`). Phase 3 of the
140
- adoption roadmap adds a second host adapter; the contract above is
141
- documented now so the second implementation is not a vacuum design.
171
+ The GATHER implementation lives in the single mining command
172
+ `/memory:mine-session` (`scripts/mine_session.py`). It reads the
173
+ **cross-host** chat-history JSONL log (`agents/runtime/.agent-chat-history`,
174
+ written by platform hooks on every host), falling back to the per-host
175
+ Claude-Code transcript when the log is absent. `--mode=[signals|proposals|both]`
176
+ selects intake signals and/or rule/skill proposal seeds — the latter folds in
177
+ the former `/chat-history learn`.
178
+
179
+ ## In-task notes → cross-run lessons (RDP)
180
+
181
+ The Reasoning Discipline Protocol writes an **in-task** session-notes file
182
+ (hypotheses, killed beliefs, predictions, decisions, uncertainty — structure in
183
+ [`notes-first-reasoning`](../../rules/notes-first-reasoning.md)). That file is
184
+ ephemeral working state, not curated memory. This skill is the **promotion path**:
185
+ when an in-task killed-belief, calibrated prediction, or decision *generalises*
186
+ beyond the task, consolidate it here as a durable cross-run lesson (one lesson per
187
+ file, with why it mattered). Apply the same signal-vs-noise discipline — most
188
+ in-task notes stay in-task and are discarded with the task.
142
189
 
143
190
  ## Related Skills
144
191
 
@@ -196,9 +243,8 @@ documented now so the second implementation is not a vacuum design.
196
243
 
197
244
  - Do NOT auto-trigger this skill on session end. The flow is manual,
198
245
  per-invocation, and confirmed.
199
- - Do NOT vendor patterns or text from `grandamenium/dream-skill`
200
- the upstream lacks a `LICENSE`. Concept and procedure structure are
201
- the only adoption surface.
246
+ - Do NOT vendor patterns or text from any external source. Concept and
247
+ procedure structure are the only adoption surface.
202
248
  - Do NOT promote a normalised fact whose `key` falls outside the
203
249
  repo root or names another consumer project.
204
250
  - Do NOT delete a stale curated entry without explicit user
@@ -144,7 +144,7 @@ Production prompts handle their own failure cases:
144
144
 
145
145
  ## Provenance
146
146
 
147
- - Adopted from: `Microck/ordinary-claude-skills@8f5c83174f7aa683b4ddc7433150471983b93131:skills_all/prompt-engineering-patterns/SKILL.md` (MIT, © 2025 Microck) — restructured into a decision-framework shape; vendor `prompt_optimizer` Python snippets dropped (project-specific to Microck).
147
+ - Adopted from: an external reference (MIT, © 2025 an external reference) — restructured into a decision-framework shape; vendor `prompt_optimizer` Python snippets dropped (project-specific to an external reference).
148
148
  - Cross-linked: [`prompt-optimizer`](../prompt-optimizer/SKILL.md), [`refine-prompt`](../refine-prompt/SKILL.md), [`mcp-builder`](../mcp-builder/SKILL.md), [`async-python-patterns`](../async-python-patterns/SKILL.md).
149
149
  - Provenance registry: `agents/settings/contexts/skills-provenance.yml` (entry: `prompt-engineering-patterns`).
150
150
  - Iron-Law floor: `verify-before-complete`, `skill-quality`, `non-destructive-by-default`.
@@ -263,7 +263,7 @@ Pair the catalog with a separate "Global install" subsection (same flags
263
263
  plus `--global`) and an "Other commands" subsection. Reference example:
264
264
  [`README.md § Pick specific AIs`](../../../README.md#pick-specific-ais) in
265
265
  this repository. Inspiration:
266
- [`ui-ux-pro-max-skill § Installation`](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill#installation).
266
+ [`an external reference suite § Installation`](https://github.com/an external reference suite#installation).
267
267
 
268
268
  Use the catalog when the package's primary install action varies by
269
269
  platform; use a matrix table (Tool / Rules / Skills / Commands) for
@@ -0,0 +1,119 @@
1
+ ---
2
+ name: reasoning-orchestrator
3
+ description: "Use for complex / ambiguous / long-horizon work — coordinate the reasoning chain ground→intent→notes→gather→audit→verify; composes existing skills, never duplicates them."
4
+ source: package
5
+ domain: engineering
6
+ status: active
7
+ model_tier: medium
8
+ tier: senior
9
+ context_spine: [repo]
10
+ workspaces:
11
+ - agent-config-maintainer
12
+ packs:
13
+ - meta
14
+ requires_skills:
15
+ - memory-consolidation
16
+ - adversarial-review
17
+ - subagent-orchestration
18
+ - complexity-first-planning
19
+ ---
20
+
21
+ # reasoning-orchestrator
22
+
23
+ The **primary coordination mechanism** of the Reasoning Discipline Protocol
24
+ (roadmap L6). It is behavioral glue — like [`subagent-orchestration`](../subagent-orchestration/SKILL.md)
25
+ and [`feature-planning`](../feature-planning/SKILL.md) — that sequences the
26
+ discipline so it acts as one system instead of a buffet of optional steps. It
27
+ **composes** the underlying skills/rules; it never re-implements them, and it
28
+ adds **no new flow** (it is invoked within discovery/implementation, honoring
29
+ `src/flows/README.md`).
30
+
31
+ Engage per [`rdp-gate`](../../contexts/execution/rdp-gate.md): skip on trivial
32
+ tasks; on a strong-reasoning host run **light / as suggestion** (it self-
33
+ coordinates); on a standard host run the full chain.
34
+
35
+ ## When to use
36
+
37
+ - A complex, ambiguous, or long-horizon task on a standard host.
38
+ - Work where the reasoning steps are interdependent (a missed grounding or skipped
39
+ verification compounds downstream).
40
+
41
+ Do NOT use for trivial / linear / fully-specified tasks (the gate filters these),
42
+ and do not let it duplicate the work of the skills it coordinates.
43
+
44
+ ## When the agent should load this
45
+
46
+ - A task is complex / ambiguous / long-horizon and the host is a standard model.
47
+ - The reasoning steps are interdependent and a skipped link (grounding,
48
+ verification) would compound downstream.
49
+ - Several discipline skills would otherwise fire piecemeal — load this to make
50
+ them act as one ordered chain instead of a buffet of optional steps.
51
+
52
+ ## Procedure — the chain it enforces
53
+
54
+ Each link **delegates** to the artifact that owns it (no duplication):
55
+
56
+ 1. **ground** — close constraints/tools/info-gaps before designing
57
+ ([`think-before-action` § Environment grounding](../../rules/think-before-action.md)).
58
+ 2. **intent** — state the inferred goal + one recommendation, standard host only
59
+ ([`improve-before-implement` § Intent inference](../../rules/improve-before-implement.md)).
60
+ 3. **notes** — hypotheses/predictions/decisions/uncertainty to the notes file, not
61
+ the response ([`notes-first-reasoning`](../../rules/notes-first-reasoning.md)).
62
+ 4. **gather** — resolve the load-bearing unknown first
63
+ ([`complexity-first-planning`](../complexity-first-planning/SKILL.md)); dispatch
64
+ independent subtasks async ([`subagent-orchestration` § RDP](../subagent-orchestration/SKILL.md)).
65
+ 5. **audit** — check progress against real tool results
66
+ ([`verify-before-complete`](../../rules/verify-before-complete.md)).
67
+ 6. **verify** — fresh-context verifier on the structural-complexity gate
68
+ ([`adversarial-review` § RDP](../adversarial-review/SKILL.md)).
69
+
70
+ ## Fail-safe
71
+
72
+ If the orchestrator does not fire (gate off, or the host skips it), the
73
+ individual skills/rules still apply on their own triggers — the discipline
74
+ degrades gracefully to the distributed extensions rather than disappearing. The
75
+ orchestrator's value is **coherence** (the links happen in order, with handoffs),
76
+ not exclusivity.
77
+
78
+ ## Output
79
+
80
+ The task's actual deliverable — produced through the chain. Reasoning stays in the
81
+ notes file; the response leads with the outcome + its evidence.
82
+
83
+ ## Do NOT
84
+
85
+ - Re-implement grounding / verification / planning here — **delegate**.
86
+ - Create a new flow or a standalone pack — this is a skill invoked within existing flows.
87
+ - Run the full chain on a strong-reasoning host or a trivial task — the gate says light/off.
88
+
89
+ ## Gotchas
90
+
91
+ - **Buffet collapse.** Without the orchestrator, the discipline skills fire
92
+ independently and the chain's *order* is lost (verification before grounding,
93
+ notes never written). The whole value is the ordered handoff — running the
94
+ links out of sequence is the failure this skill prevents.
95
+ - **Duplication creep.** Inlining a delegated step's logic here (re-doing the
96
+ grounding instead of pointing at `think-before-action`) silently forks the
97
+ behavior; the two copies then drift. Always delegate, never re-implement.
98
+ - **Wrong host, full chain.** Running every link on a strong-reasoning host wastes
99
+ tokens and reads as nagging — the gate says light/suggestion there. Forcing the
100
+ full chain regardless of host is a cost regression, not rigor.
101
+
102
+ ## Related Skills
103
+
104
+ **WHEN to use this**
105
+
106
+ - A complex / ambiguous / long-horizon task on a standard host where the reasoning
107
+ links are interdependent.
108
+ - Several discipline skills would otherwise fire piecemeal and need ordering.
109
+
110
+ **WHEN NOT to use this**
111
+
112
+ - Trivial / linear / fully-specified tasks — the
113
+ [`rdp-gate`](../../contexts/execution/rdp-gate.md) filters these.
114
+ - A single discipline step in isolation — invoke that skill/rule directly
115
+ ([`think-before-action`](../../rules/think-before-action.md),
116
+ [`verify-before-complete`](../../rules/verify-before-complete.md)) instead of the
117
+ whole chain.
118
+ - Needing the rationale behind the protocol — read
119
+ [`frontier-reasoning-operating-profile`](../../../../docs/guidelines/agent-infra/frontier-reasoning-operating-profile.md).
@@ -0,0 +1,16 @@
1
+ {
2
+ "skill": "reasoning-orchestrator",
3
+ "description": "5 should-trigger + 5 should-not-trigger. Should-trigger covers complex / ambiguous / long-horizon work on a standard host where the reasoning steps are interdependent; should-not covers trivial / linear tasks, strong-host self-coordination, and single-discipline neighbors.",
4
+ "queries": [
5
+ {"q": "refactor the entire billing module to be cleaner and safer", "trigger": true},
6
+ {"q": "build this feature end to end from a vague brief — figure out the steps", "trigger": true},
7
+ {"q": "investigate this flaky multi-service failure and fix it properly", "trigger": true},
8
+ {"q": "take this ambiguous ticket and drive it to a verified implementation", "trigger": true},
9
+ {"q": "plan and implement the migration with checks at each stage", "trigger": true},
10
+ {"q": "rename this variable", "trigger": false, "note": "trivial — gate off"},
11
+ {"q": "format this file", "trigger": false, "note": "trivial"},
12
+ {"q": "just write the regex for an email", "trigger": false, "note": "single linear step"},
13
+ {"q": "only run the test suite and report", "trigger": false, "note": "single-discipline (verify), no chain to coordinate"},
14
+ {"q": "add a one-line log statement here", "trigger": false, "note": "trivial"}
15
+ ]
16
+ }
@@ -84,11 +84,12 @@ For each comment classified as blocking/important:
84
84
  for a reason
85
85
  * **Consult memory for prior context.** Via
86
86
  [`memory-access`](../../../docs/guidelines/agent-infra/memory-access.md),
87
- call `retrieve(types=["historical-patterns", "architecture-decisions"],
87
+ call `retrieve(types=["historical-patterns"],
88
88
  keys=<files in the review>, limit=3)`. A registered historical pattern
89
- may confirm the reviewer's concern (accept) or an architecture
90
- decision may explain why the current shape is intentional (push back
91
- with the cited `id`).
89
+ may confirm the reviewer's concern (accept). For architectural rationale
90
+ ("why is the current shape intentional?"), check the ADR index
91
+ [`docs/decisions/INDEX.md`](../../../docs/decisions/INDEX.md) push back
92
+ with the cited ADR number.
92
93
 
93
94
  ### 4. Decide: accept, push back, or escalate
94
95
 
@@ -178,8 +179,7 @@ When reporting back to the user after handling review:
178
179
  ## When to hand over to another skill / command
179
180
 
180
181
  * Executing the fixes across many comments → [`fix-pr-comments`](../../commands/fix-pr-comments.md)
181
- (handles both bot + developer), [`fix-pr-bot-comments`](../../commands/fix-pr-bot-comments.md),
182
- [`fix-pr-developer-comments`](../../commands/fix-pr-developer-comments.md)
182
+ (handles both bot + human reviewers in one pass)
183
183
  * Running the full verification gate before pushing replies →
184
184
  [`verify-before-complete`](../verify-before-complete/SKILL.md)
185
185
  * Writing the commit message that references the review →
@@ -183,7 +183,7 @@ Before emitting the envelope, run these three scans. Each is a fast pass; failur
183
183
  2. **Placeholder / TODO scan** — the rendered envelope contains no `<placeholder>`, `TODO`, `FIXME`, `tbd`, `???`, `XXX` strings. The literal angle-bracket placeholders in the template (`<one sentence …>`, `<bullet>`) must be replaced with concrete text before emission.
184
184
  3. **Type / shape consistency** — every named file, module, route, or command in the AC matches the project's existing conventions. If the prompt names `auth.service.ts` but the codebase uses `AuthService.php`, surface the mismatch in *Assumptions* rather than adopting the prompt's spelling.
185
185
 
186
- Source: adapted from `obra/superpowers` `writing-plans/SKILL.md` § Self-Review (v5.1.0).
186
+ Source: adapted from an external reference `writing-plans/SKILL.md` § Self-Review (v5.1.0).
187
187
 
188
188
  ## Band-action mapping
189
189
 
@@ -272,7 +272,7 @@ Run these three scans on the rendered output before the close-prompt. Each is a
272
272
 
273
273
  Self-review is mechanical (gaps, leftovers, naming drift); persona voices and orchestration outputs handle reasoning critique. Both run; neither replaces the other.
274
274
 
275
- Source: adapted from `obra/superpowers` `writing-plans/SKILL.md` § Self-Review (v5.1.0).
275
+ Source: adapted from an external reference `writing-plans/SKILL.md` § Self-Review (v5.1.0).
276
276
 
277
277
  ## Close-prompt (mandatory final step)
278
278
 
@@ -136,6 +136,6 @@ Cite the snapshot path so the consumer skill can read it.
136
136
  ## Provenance
137
137
 
138
138
  - Upstream tool: https://github.com/yamadashy/repomix (MIT).
139
- - Adopted from: `Microck/ordinary-claude-skills@8f5c83174f7aa683b4ddc7433150471983b93131:skills_all/repomix/SKILL.md` (MIT, © 2025 Microck) — wrapper-style adoption, no upstream code vendored.
139
+ - Adopted from: an external reference (MIT, © 2025 an external reference) — wrapper-style adoption, no upstream code vendored.
140
140
  - Provenance registry: `agents/settings/contexts/skills-provenance.yml` (entry: `repomix`).
141
141
  - Iron-Law floor: `non-destructive-by-default`, `missing-tool-handling`, `tool-safety`.
@@ -135,7 +135,7 @@ Telemetry / APM → strip from request/response captures; allowlist headers.
135
135
 
136
136
  ## Provenance
137
137
 
138
- - Adopted from: `Microck/ordinary-claude-skills@8f5c83174f7aa683b4ddc7433150471983b93131:skills_all/secrets-management/SKILL.md` (MIT, © 2025 Microck) — **Sunset Policy applied**: 346-line provider cookbook reduced to a ~140-line decision framework; per-provider deep-dives externalized to upstream docs below.
138
+ - Adopted from: an external reference (MIT, © 2025 an external reference) — **Sunset Policy applied**: 346-line provider cookbook reduced to a ~140-line decision framework; per-provider deep-dives externalized to upstream docs below.
139
139
  - Externalized provider docs:
140
140
  - HashiCorp Vault: https://developer.hashicorp.com/vault/docs · https://developer.hashicorp.com/vault/docs/secrets/databases
141
141
  - AWS Secrets Manager: https://docs.aws.amazon.com/secretsmanager/ · rotation: https://docs.aws.amazon.com/secretsmanager/latest/userguide/rotating-secrets.html
@@ -49,6 +49,13 @@ judge is a fresh pair of eyes. If `.agent-settings.yml` resolves to
49
49
  identical implementer and judge models, surface the mismatch before
50
50
  running — do not silently continue.
51
51
 
52
+ ## RDP: parallel async dispatch by default
53
+
54
+ Within the Reasoning Discipline Protocol, dispatch independent subtasks to
55
+ parallel subagents **by default** and keep working while they run (async), rather
56
+ than blocking on each return — intervene only if one goes off track. Engage per
57
+ [`rdp-gate`](../../contexts/execution/rdp-gate.md).
58
+
52
59
  ## The seven modes
53
60
 
54
61
  Each mode has a decision row: when to use, when not, and the expected
@@ -60,8 +67,8 @@ model pairing. Defaults come from
60
67
  Descriptive, not enforced. Documents the **expected agent-to-agent
61
68
  communication topology** so consumers can predict latency, failure
62
69
  modes, and where consensus is required. Cited from
63
- [`external-findings.md § 2`](../../../agents/runtime/council/sessions/audit-2026-05-14-north-star/external-findings.md) <!-- council-ref-allowed: ADR decision trace for topology anti-drift defaults -->
64
- row 7 (Ruflo's `hierarchical, 6–8 agents, raft consensus` anti-drift
70
+ an internal findings note (local-only) <!-- council-ref-allowed: ADR decision trace for topology anti-drift defaults -->
71
+ row 7 (the external runtime's `hierarchical, 6–8 agents, raft consensus` anti-drift
65
72
  default).
66
73
 
67
74
  | Mode | Topology | Anti-drift default | Notes |
@@ -74,7 +81,7 @@ default).
74
81
  | judge-with-debate | `hierarchical-mesh` | 2 judges · 1 meta-judge | Judges debate (mesh edge); meta-judge reconciles (hierarchical). |
75
82
  | do-in-worktrees | `adaptive` | per-step topology of the underlying mode | Each worktree picks its own shape; chain is hierarchical. |
76
83
 
77
- **Anti-drift default** (Ruflo convention, descriptive only):
84
+ **Anti-drift default** (the external runtime convention, descriptive only):
78
85
  `hierarchical, 6–8 agents, raft consensus`. Consumers free to
79
86
  override per orchestration — the table is the **starting point**,
80
87
  not a constraint. Topology is metadata for capacity planning, not
@@ -158,7 +158,7 @@ Gate: a feature is not complete until a failing-then-passing test cycle ran for
158
158
 
159
159
  ## Provenance
160
160
 
161
- - Adopted from: `Microck/ordinary-claude-skills@8f5c83174f7aa683b4ddc7433150471983b93131:skills_all/testing-anti-patterns/SKILL.md` (MIT, © 2025 Microck).
161
+ - Adopted from: an external reference (MIT, © 2025 an external reference).
162
162
  - Cross-linked: [`pest-testing`](../pest-testing/SKILL.md), [`test-driven-development`](../test-driven-development/SKILL.md), [`judge-test-coverage`](../judge-test-coverage/SKILL.md).
163
163
  - Provenance registry: `agents/settings/contexts/skills-provenance.yml` (entry: `testing-anti-patterns`).
164
164
  - Iron-Law floor: `verify-before-complete`, `skill-quality`.
@@ -61,7 +61,7 @@ the rationalization, then reject it:
61
61
 
62
62
  ## Provenance
63
63
 
64
- - Adapted from `obra/superpowers@v5.1.0` `testing/anti-patterns.md`.
64
+ - Adapted from an external reference `testing/anti-patterns.md`.
65
65
  - Council convergence (anthropic/claude-sonnet-4-5 + openai/gpt-4o,
66
66
  2026-05-07): both members ADOPT — the catalogue surfaces specific
67
67
  rationalization patterns that would otherwise leak past code review.
@@ -80,7 +80,7 @@ INTENT
80
80
  | `agent-handoff` | `.claude/skills/agent-handoff/SKILL.md` | `handoff`, `fresh`, `chat`, `context` | Context envelope for fresh-chat continuation |
81
81
  | `direct-answers` | `.agent-src.uncondensed/rules/direct-answers.md` | `brevity`, `flattery`, `severity`, `tiered` | Iron-Law brevity floor (kernel) |
82
82
  | `markitdown` | upstream: github.com/microsoft/markitdown | `PDF`, `DOCX`, `HTML`, `convert` | Document → markdown converter (authoritative-link only) |
83
- | `/cost:report` | TBD — `road-to-ruflo-adoption.md § P1.2` | `cost`, `model spend`, `budget` | Per-session cost telemetry (planned) |
83
+ | `/cost:report` | TBD — an internal roadmap (local-only) | `cost`, `model spend`, `budget` | Per-session cost telemetry (planned) |
84
84
 
85
85
  ## Output format
86
86
 
@@ -11,6 +11,5 @@ agents/memory/intake/*.jsonl merge=union eol=lf
11
11
  agents/memory/ownership/*.yml text eol=lf
12
12
  agents/memory/historical-patterns/*.yml text eol=lf
13
13
  agents/memory/domain-invariants/*.yml text eol=lf
14
- agents/memory/architecture-decisions/*.yml text eol=lf
15
14
  agents/memory/incident-learnings/*.yml text eol=lf
16
15
  agents/memory/product-rules/*.yml text eol=lf
@@ -116,9 +116,9 @@ modules:
116
116
 
117
117
  # --- Memory layer (optional) ---
118
118
  #
119
- # Opt-in signal for the @event4u/agent-memory companion package and
120
- # the repo-shared curated-memory files. If omitted, memory features
121
- # stay inert — no writes, no reads, no nagging.
119
+ # Opt-in signal for the repo-shared, file-backed curated-memory files
120
+ # under `agents/memory/`. If omitted, memory features stay inert —
121
+ # no writes, no reads, no nagging.
122
122
  memory:
123
123
  # Enable curated memory files under `agents/memory/` as part of
124
124
  # this repo's dogfooding of its own memory conventions. Only flip
@@ -278,7 +278,7 @@ locked_keys: []
278
278
  # files live here when memory.dogfood is true. These paths are for
279
279
  # reference only — no enforcement is done from this file.
280
280
  references:
281
- architecture_decisions: agents/memory/architecture-decisions/
281
+ # Architecture decisions live in ADRs (docs/decisions/), not curated memory.
282
282
  domain_invariants: agents/memory/domain-invariants/
283
283
  incident_learnings: agents/memory/incident-learnings/
284
284
  product_rules: agents/memory/product-rules/
@@ -50,8 +50,7 @@ REQUIRED_KEYS = {
50
50
  VALID_STATUS = {"active", "deprecated", "archived"}
51
51
  VALID_CONFIDENCE = {"low", "medium", "high"}
52
52
  KNOWN_TYPES = {
53
- "domain-invariants", "architecture-decisions",
54
- "incident-learnings", "product-rules",
53
+ "domain-invariants", "incident-learnings", "product-rules",
55
54
  }
56
55
 
57
56
  # Redaction heuristics — plain-regex, deliberately conservative.
@@ -36,7 +36,7 @@ from typing import Any
36
36
  INTAKE_ROOT = Path("agents/memory/intake")
37
37
  VALID_TYPES = {
38
38
  "historical-patterns", "incident-learnings", "ownership",
39
- "domain-invariants", "architecture-decisions", "product-rules",
39
+ "domain-invariants", "product-rules",
40
40
  }
41
41
  REQUIRED_INTAKE = ("id", "entry_type", "path", "body")
42
42
  PATTERN_MIN_PATHS = 2