@event4u/agent-config 14.23.0 → 15.0.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 (503) hide show
  1. package/.augment-plugin/marketplace.json +3 -3
  2. package/.augment-plugin/plugin.json +1 -1
  3. package/.claude-plugin/marketplace.json +1 -1
  4. package/CHANGELOG.md +198 -0
  5. package/README.md +1 -1
  6. package/dist/agent-src/commands/agent-handoff.md +8 -7
  7. package/dist/agent-src/commands/agents/init.md +1 -1
  8. package/dist/agent-src/commands/agents/user/accept.md +4 -4
  9. package/dist/agent-src/commands/agents/user/delete.md +2 -2
  10. package/dist/agent-src/commands/agents/user/init.md +3 -3
  11. package/dist/agent-src/commands/agents/user/review.md +3 -3
  12. package/dist/agent-src/commands/agents/user/show.md +3 -3
  13. package/dist/agent-src/commands/agents/user/update.md +2 -2
  14. package/dist/agent-src/commands/agents/user.md +6 -6
  15. package/dist/agent-src/commands/analytics/prune.md +1 -1
  16. package/dist/agent-src/commands/analytics/show.md +2 -2
  17. package/dist/agent-src/commands/analyze/decision.md +2 -2
  18. package/dist/agent-src/commands/analyze/inbox.md +5 -5
  19. package/dist/agent-src/commands/analyze/incident.md +3 -3
  20. package/dist/agent-src/commands/analyze/near-miss.md +3 -3
  21. package/dist/agent-src/commands/analyze/postmortem.md +4 -4
  22. package/dist/agent-src/commands/analyze/premortem.md +2 -2
  23. package/dist/agent-src/commands/analyze.md +2 -2
  24. package/dist/agent-src/commands/bug/fix.md +1 -1
  25. package/dist/agent-src/commands/bug/investigate.md +2 -2
  26. package/dist/agent-src/commands/cost/profile.md +3 -3
  27. package/dist/agent-src/commands/design.md +1 -1
  28. package/dist/agent-src/commands/feature/explore.md +1 -1
  29. package/dist/agent-src/commands/feature/plan.md +2 -2
  30. package/dist/agent-src/commands/feature/roadmap.md +2 -2
  31. package/dist/agent-src/commands/ghostwriter/fetch.md +4 -4
  32. package/dist/agent-src/commands/ghostwriter/list.md +1 -1
  33. package/dist/agent-src/commands/ghostwriter/show.md +1 -1
  34. package/dist/agent-src/commands/ghostwriter/write.md +9 -9
  35. package/dist/agent-src/commands/humanize.md +6 -6
  36. package/dist/agent-src/commands/jira-ticket.md +1 -1
  37. package/dist/agent-src/commands/judge/solo.md +1 -1
  38. package/dist/agent-src/commands/judge.md +1 -1
  39. package/dist/agent-src/commands/knowledge/cross-repo.md +1 -1
  40. package/dist/agent-src/commands/knowledge/forget.md +1 -1
  41. package/dist/agent-src/commands/knowledge/ingest.md +2 -2
  42. package/dist/agent-src/commands/knowledge/list.md +1 -1
  43. package/dist/agent-src/commands/memory/add.md +3 -3
  44. package/dist/agent-src/commands/memory/load.md +4 -4
  45. package/dist/agent-src/commands/memory/mine-session.md +1 -1
  46. package/dist/agent-src/commands/memory/promote.md +4 -4
  47. package/dist/agent-src/commands/memory/propose.md +2 -2
  48. package/dist/agent-src/commands/mode.md +5 -5
  49. package/dist/agent-src/commands/post-as/ghostwriter.md +3 -3
  50. package/dist/agent-src/commands/post-as/me.md +7 -7
  51. package/dist/agent-src/commands/pr/create.md +1 -1
  52. package/dist/agent-src/commands/pr/merge.md +1 -1
  53. package/dist/agent-src/commands/profile/activate.md +1 -1
  54. package/dist/agent-src/commands/profile/show.md +1 -1
  55. package/dist/agent-src/commands/research/deep.md +2 -2
  56. package/dist/agent-src/commands/research/report.md +2 -2
  57. package/dist/agent-src/commands/review/changes.md +1 -1
  58. package/dist/agent-src/commands/review/routing.md +1 -1
  59. package/dist/agent-src/commands/roadmap/create.md +1 -1
  60. package/dist/agent-src/commands/roadmap/materialize.md +2 -2
  61. package/dist/agent-src/commands/roadmap/next.md +1 -1
  62. package/dist/agent-src/commands/roadmap/process-full.md +2 -2
  63. package/dist/agent-src/commands/security-audit-config.md +3 -3
  64. package/dist/agent-src/commands/skill/preview.md +1 -1
  65. package/dist/agent-src/commands/skills/discover.md +1 -1
  66. package/dist/agent-src/commands/sync/agent-settings.md +2 -2
  67. package/dist/agent-src/commands/sync/gitignore/fix.md +1 -1
  68. package/dist/agent-src/commands/tests/create.md +1 -1
  69. package/dist/agent-src/commands/tests/e2e-heal.md +1 -1
  70. package/dist/agent-src/commands/tests/e2e-plan.md +1 -1
  71. package/dist/agent-src/contexts/authority/kernel-rule-edits.md +6 -6
  72. package/dist/agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md +1 -2
  73. package/dist/agent-src/contexts/communication/rules-auto/think-before-action-mechanics.md +2 -2
  74. package/dist/agent-src/contexts/communication/rules-auto/token-efficiency-mechanics.md +88 -1
  75. package/dist/agent-src/contexts/communication/rules-auto/user-interaction-mechanics.md +1 -1
  76. package/dist/agent-src/contexts/contracts/frugality-charter.md +1 -1
  77. package/dist/agent-src/contexts/execution/auto-dispatch-classification.md +1 -1
  78. package/dist/agent-src/contexts/execution/auto-orchestration-activation.md +1 -1
  79. package/dist/agent-src/contexts/execution/autonomy-mechanics.md +1 -1
  80. package/dist/agent-src/contexts/execution/cheap-question-mechanics.md +1 -1
  81. package/dist/agent-src/contexts/execution/contract-decision-sheet.md +3 -3
  82. package/dist/agent-src/contexts/execution/mandated-lines.md +1 -1
  83. package/dist/agent-src/contexts/execution/non-interactive-contract.md +1 -1
  84. package/dist/agent-src/contexts/execution/orchestration-telemetry.md +1 -1
  85. package/dist/agent-src/contexts/execution/plan-confidence-gate.md +5 -5
  86. package/dist/agent-src/contexts/execution/roadmap-execution-contract.md +1 -1
  87. package/dist/agent-src/contexts/execution/subagent-modes-detail.md +1 -1
  88. package/dist/agent-src/contexts/execution/subagent-routing.md +2 -2
  89. package/dist/agent-src/contexts/execution/subagent-spawn-contract.md +1 -1
  90. package/dist/agent-src/contexts/execution/user-memory-channels.md +3 -3
  91. package/dist/agent-src/contexts/execution/verification-mechanics.md +1 -1
  92. package/dist/agent-src/contexts/judges/persona-voice-rubric.md +2 -2
  93. package/dist/agent-src/guidelines/abstraction-thresholds.md +88 -0
  94. package/dist/agent-src/guidelines/agent-infra/5w2h-analysis.md +260 -0
  95. package/dist/agent-src/guidelines/agent-infra/active-remediation-mechanics.md +99 -0
  96. package/dist/agent-src/guidelines/agent-infra/agent-interaction-and-decision-quality.md +325 -0
  97. package/dist/agent-src/guidelines/agent-infra/api-cost-levers.md +177 -0
  98. package/dist/agent-src/guidelines/agent-infra/artifact-drafting-protocol-mechanics.md +222 -0
  99. package/dist/agent-src/guidelines/agent-infra/ask-when-uncertain-demos.md +134 -0
  100. package/dist/agent-src/guidelines/agent-infra/asking-and-brevity-examples.md +198 -0
  101. package/dist/agent-src/guidelines/agent-infra/break-glass-usage.md +113 -0
  102. package/dist/agent-src/guidelines/agent-infra/carve-out-predicates.md +17 -0
  103. package/dist/agent-src/guidelines/agent-infra/comparison-matrix.md +179 -0
  104. package/dist/agent-src/guidelines/agent-infra/context-hygiene-mechanics.md +165 -0
  105. package/dist/agent-src/guidelines/agent-infra/corpus-grounding-authoring.md +91 -0
  106. package/dist/agent-src/guidelines/agent-infra/critical-thinking.md +156 -0
  107. package/dist/agent-src/guidelines/agent-infra/cross-source-consistency-mechanics.md +109 -0
  108. package/dist/agent-src/guidelines/agent-infra/developer-judgment.md +82 -0
  109. package/dist/agent-src/guidelines/agent-infra/direct-answers-demos.md +142 -0
  110. package/dist/agent-src/guidelines/agent-infra/domain-adoption-gates.md +112 -0
  111. package/dist/agent-src/guidelines/agent-infra/domain-eval-anti-pattern.md +53 -0
  112. package/dist/agent-src/guidelines/agent-infra/domain-pack-architecture.md +56 -0
  113. package/dist/agent-src/guidelines/agent-infra/downstream-changes-mechanics.md +91 -0
  114. package/dist/agent-src/guidelines/agent-infra/emphasis-budget.md +45 -0
  115. package/dist/agent-src/guidelines/agent-infra/engineering-memory-data-format.md +210 -0
  116. package/dist/agent-src/guidelines/agent-infra/evaluator-independence-mechanics.md +92 -0
  117. package/dist/agent-src/guidelines/agent-infra/existence-question-verdicts.md +80 -0
  118. package/dist/agent-src/guidelines/agent-infra/failure-signatures.md +70 -0
  119. package/dist/agent-src/guidelines/agent-infra/false-green.md +233 -0
  120. package/dist/agent-src/guidelines/agent-infra/first-principles.md +192 -0
  121. package/dist/agent-src/guidelines/agent-infra/framework-neutrality-patterns.md +66 -0
  122. package/dist/agent-src/guidelines/agent-infra/frontier-reasoning-operating-profile.md +169 -0
  123. package/dist/agent-src/guidelines/agent-infra/gate-authoring.md +177 -0
  124. package/dist/agent-src/guidelines/agent-infra/guarded-baseline.md +39 -0
  125. package/dist/agent-src/guidelines/agent-infra/installed-tools-manifest.md +142 -0
  126. package/dist/agent-src/guidelines/agent-infra/inversion-thinking.md +388 -0
  127. package/dist/agent-src/guidelines/agent-infra/ios-simulator-guide.md +378 -0
  128. package/dist/agent-src/guidelines/agent-infra/language-and-tone-examples.md +141 -0
  129. package/dist/agent-src/guidelines/agent-infra/layered-settings.md +317 -0
  130. package/dist/agent-src/guidelines/agent-infra/linked-projects-onboarding-gate.md +80 -0
  131. package/dist/agent-src/guidelines/agent-infra/mcp-request-signing.md +197 -0
  132. package/dist/agent-src/guidelines/agent-infra/memory-access.md +149 -0
  133. package/dist/agent-src/guidelines/agent-infra/mental-models.md +314 -0
  134. package/dist/agent-src/guidelines/agent-infra/minimal-safe-diff-mechanics.md +241 -0
  135. package/dist/agent-src/guidelines/agent-infra/missing-tool-handling.md +66 -0
  136. package/dist/agent-src/guidelines/agent-infra/model-recommendation.md +101 -0
  137. package/dist/agent-src/guidelines/agent-infra/naming.md +69 -0
  138. package/dist/agent-src/guidelines/agent-infra/notes-horizon-mechanics.md +90 -0
  139. package/dist/agent-src/guidelines/agent-infra/output-patterns.md +117 -0
  140. package/dist/agent-src/guidelines/agent-infra/recurring-criticism-mechanics.md +96 -0
  141. package/dist/agent-src/guidelines/agent-infra/reuse-verdict-mechanics.md +71 -0
  142. package/dist/agent-src/guidelines/agent-infra/review-routing-data-format.md +143 -0
  143. package/dist/agent-src/guidelines/agent-infra/roadmap-deferred-resolution-provenance.md +54 -0
  144. package/dist/agent-src/guidelines/agent-infra/roadmap-progress-mechanics.md +274 -0
  145. package/dist/agent-src/guidelines/agent-infra/role-contracts.md +209 -0
  146. package/dist/agent-src/guidelines/agent-infra/role-mode-router.md +89 -0
  147. package/dist/agent-src/guidelines/agent-infra/rule-body-migration-inventory.md +241 -0
  148. package/dist/agent-src/guidelines/agent-infra/rule-type-governance.md +73 -0
  149. package/dist/agent-src/guidelines/agent-infra/runtime-layer.md +89 -0
  150. package/dist/agent-src/guidelines/agent-infra/scqa-framework.md +526 -0
  151. package/dist/agent-src/guidelines/agent-infra/security-lint-containment.md +121 -0
  152. package/dist/agent-src/guidelines/agent-infra/self-improvement-pipeline.md +134 -0
  153. package/dist/agent-src/guidelines/agent-infra/simplicity-and-goal-demos.md +211 -0
  154. package/dist/agent-src/guidelines/agent-infra/six-hats.md +353 -0
  155. package/dist/agent-src/guidelines/agent-infra/size-and-scope.md +229 -0
  156. package/dist/agent-src/guidelines/agent-infra/skill-quality-checklist.md +157 -0
  157. package/dist/agent-src/guidelines/agent-infra/source-confidentiality-mechanics.md +109 -0
  158. package/dist/agent-src/guidelines/agent-infra/symptom-driven-harvest-loop.md +104 -0
  159. package/dist/agent-src/guidelines/agent-infra/systems-thinking.md +220 -0
  160. package/dist/agent-src/guidelines/agent-infra/tool-description-as-policy.md +35 -0
  161. package/dist/agent-src/guidelines/agent-infra/tool-integration.md +73 -0
  162. package/dist/agent-src/guidelines/agent-infra/traceability-field-mechanics.md +50 -0
  163. package/dist/agent-src/guidelines/agent-infra/untrusted-input-spotlighting.md +166 -0
  164. package/dist/agent-src/guidelines/agent-infra/verify-before-complete-demos.md +128 -0
  165. package/dist/agent-src/guidelines/augment-portability-patterns.md +70 -0
  166. package/dist/agent-src/guidelines/code-clarity.md +350 -0
  167. package/dist/agent-src/guidelines/component-oriented-and-oop-development.md +189 -0
  168. package/dist/agent-src/guidelines/cross-role-handoff.md +127 -0
  169. package/dist/agent-src/guidelines/design-antipatterns-triggers.json +18 -0
  170. package/dist/agent-src/guidelines/design-antipatterns.md +327 -0
  171. package/dist/agent-src/guidelines/design-asset-discipline.md +38 -0
  172. package/dist/agent-src/guidelines/design-canon.md +63 -0
  173. package/dist/agent-src/guidelines/design-fidelity-mechanics.md +293 -0
  174. package/dist/agent-src/guidelines/design-fidelity-routing.md +78 -0
  175. package/dist/agent-src/guidelines/design-handover-extraction.md +117 -0
  176. package/dist/agent-src/guidelines/design-modes.md +143 -0
  177. package/dist/agent-src/guidelines/design-reconciliation.md +172 -0
  178. package/dist/agent-src/guidelines/docs/readme-size-and-splitting.md +209 -0
  179. package/dist/agent-src/guidelines/e2e/playwright.md +363 -0
  180. package/dist/agent-src/guidelines/gtm-handoff.md +114 -0
  181. package/dist/agent-src/guidelines/monorepo-antipatterns.md +141 -0
  182. package/dist/agent-src/guidelines/php/api-design.md +115 -0
  183. package/dist/agent-src/guidelines/php/artisan-commands.md +81 -0
  184. package/dist/agent-src/guidelines/php/blade-ui.md +78 -0
  185. package/dist/agent-src/guidelines/php/controllers.md +90 -0
  186. package/dist/agent-src/guidelines/php/database.md +194 -0
  187. package/dist/agent-src/guidelines/php/eloquent.md +208 -0
  188. package/dist/agent-src/guidelines/php/flux.md +80 -0
  189. package/dist/agent-src/guidelines/php/general.md +207 -0
  190. package/dist/agent-src/guidelines/php/git.md +164 -0
  191. package/dist/agent-src/guidelines/php/jobs.md +111 -0
  192. package/dist/agent-src/guidelines/php/livewire.md +71 -0
  193. package/dist/agent-src/guidelines/php/logging.md +79 -0
  194. package/dist/agent-src/guidelines/php/naming.md +89 -0
  195. package/dist/agent-src/guidelines/php/patterns/dependency-injection.md +57 -0
  196. package/dist/agent-src/guidelines/php/patterns/dtos.md +199 -0
  197. package/dist/agent-src/guidelines/php/patterns/events.md +67 -0
  198. package/dist/agent-src/guidelines/php/patterns/factory.md +53 -0
  199. package/dist/agent-src/guidelines/php/patterns/pipelines.md +66 -0
  200. package/dist/agent-src/guidelines/php/patterns/policies.md +66 -0
  201. package/dist/agent-src/guidelines/php/patterns/repositories.md +122 -0
  202. package/dist/agent-src/guidelines/php/patterns/service-layer.md +64 -0
  203. package/dist/agent-src/guidelines/php/patterns/strategy.md +247 -0
  204. package/dist/agent-src/guidelines/php/patterns.md +28 -0
  205. package/dist/agent-src/guidelines/php/performance.md +92 -0
  206. package/dist/agent-src/guidelines/php/php-coding-patterns.md +80 -0
  207. package/dist/agent-src/guidelines/php/resources.md +100 -0
  208. package/dist/agent-src/guidelines/php/security.md +110 -0
  209. package/dist/agent-src/guidelines/php/sql.md +97 -0
  210. package/dist/agent-src/guidelines/php/validations.md +119 -0
  211. package/dist/agent-src/guidelines/php/websocket.md +100 -0
  212. package/dist/agent-src/guidelines/prompt-templates.md +189 -0
  213. package/dist/agent-src/guidelines/redundancy-taxonomy.md +208 -0
  214. package/dist/agent-src/guidelines/wing4-handoff.md +127 -0
  215. package/dist/agent-src/personas/README.md +1 -1
  216. package/dist/agent-src/personas/_template-specialist/persona.md +1 -1
  217. package/dist/agent-src/personas/product-owner.md +1 -1
  218. package/dist/agent-src/rules/active-remediation.md +1 -1
  219. package/dist/agent-src/rules/architecture.md +2 -2
  220. package/dist/agent-src/rules/artifact-drafting-protocol.md +1 -1
  221. package/dist/agent-src/rules/ask-when-uncertain.md +2 -2
  222. package/dist/agent-src/rules/brand-source-of-truth.md +9 -7
  223. package/dist/agent-src/rules/code-comment-discipline.md +2 -2
  224. package/dist/agent-src/rules/code-provenance.md +1 -1
  225. package/dist/agent-src/rules/content-quoting-floor.md +1 -1
  226. package/dist/agent-src/rules/context-hygiene.md +5 -5
  227. package/dist/agent-src/rules/cross-source-consistency.md +1 -1
  228. package/dist/agent-src/rules/design-fidelity.md +36 -46
  229. package/dist/agent-src/rules/direct-answers.md +2 -2
  230. package/dist/agent-src/rules/domain-adoption-policy.md +1 -1
  231. package/dist/agent-src/rules/evaluator-independence.md +1 -1
  232. package/dist/agent-src/rules/framework-neutrality-in-generic-skills.md +1 -1
  233. package/dist/agent-src/rules/icon-consistency.md +5 -1
  234. package/dist/agent-src/rules/improve-before-implement.md +1 -1
  235. package/dist/agent-src/rules/language-and-tone.md +3 -3
  236. package/dist/agent-src/rules/minimal-safe-diff.md +1 -1
  237. package/dist/agent-src/rules/notes-first-reasoning.md +2 -2
  238. package/dist/agent-src/rules/recurring-criticism.md +1 -1
  239. package/dist/agent-src/rules/roadmap-progress-sync.md +1 -1
  240. package/dist/agent-src/rules/role-mode-adherence.md +2 -2
  241. package/dist/agent-src/rules/security-sensitive-stop.md +1 -1
  242. package/dist/agent-src/rules/size-enforcement.md +1 -1
  243. package/dist/agent-src/rules/source-confidentiality.md +2 -2
  244. package/dist/agent-src/rules/think-before-action.md +1 -1
  245. package/dist/agent-src/rules/token-efficiency.md +7 -5
  246. package/dist/agent-src/rules/ui-audit-gate.md +3 -2
  247. package/dist/agent-src/rules/untrusted-input-defense.md +3 -3
  248. package/dist/agent-src/skills/activation-design/SKILL.md +2 -2
  249. package/dist/agent-src/skills/adr-create/SKILL.md +5 -5
  250. package/dist/agent-src/skills/ai-council/SKILL.md +1 -1
  251. package/dist/agent-src/skills/ai-council/references/advanced-modes.md +1 -1
  252. package/dist/agent-src/skills/blade-ui/SKILL.md +1 -1
  253. package/dist/agent-src/skills/blast-radius-analyzer/SKILL.md +1 -1
  254. package/dist/agent-src/skills/brand-to-tokens/SKILL.md +24 -3
  255. package/dist/agent-src/skills/bug-analyzer/SKILL.md +1 -1
  256. package/dist/agent-src/skills/build-buy-partner/SKILL.md +1 -1
  257. package/dist/agent-src/skills/churn-prevention/SKILL.md +2 -2
  258. package/dist/agent-src/skills/code-refactoring/SKILL.md +3 -3
  259. package/dist/agent-src/skills/code-review/SKILL.md +3 -3
  260. package/dist/agent-src/skills/command-writing/SKILL.md +3 -3
  261. package/dist/agent-src/skills/comp-banding/SKILL.md +1 -1
  262. package/dist/agent-src/skills/competitive-moat-analysis/SKILL.md +1 -1
  263. package/dist/agent-src/skills/competitive-positioning/SKILL.md +2 -2
  264. package/dist/agent-src/skills/complexity-first-planning/SKILL.md +1 -1
  265. package/dist/agent-src/skills/condense-memory/SKILL.md +1 -1
  266. package/dist/agent-src/skills/content-funnel-design/SKILL.md +2 -2
  267. package/dist/agent-src/skills/contracts-cognition/SKILL.md +1 -1
  268. package/dist/agent-src/skills/copilot-agents-optimization/SKILL.md +2 -2
  269. package/dist/agent-src/skills/corpus-grounding/SKILL.md +2 -2
  270. package/dist/agent-src/skills/customer-research/SKILL.md +2 -2
  271. package/dist/agent-src/skills/dashboard-design/SKILL.md +1 -1
  272. package/dist/agent-src/skills/data-handling-judgment/SKILL.md +1 -1
  273. package/dist/agent-src/skills/deal-qualification-meddic/SKILL.md +2 -2
  274. package/dist/agent-src/skills/decision-record/SKILL.md +3 -3
  275. package/dist/agent-src/skills/decision-review/SKILL.md +8 -8
  276. package/dist/agent-src/skills/deep-reading-analyst/SKILL.md +22 -22
  277. package/dist/agent-src/skills/design-intelligence/SKILL.md +4 -4
  278. package/dist/agent-src/skills/design-intelligence/references/context-and-registers.md +2 -2
  279. package/dist/agent-src/skills/design-review/SKILL.md +4 -4
  280. package/dist/agent-src/skills/design-system-capture/references/design-system-json.md +20 -1
  281. package/dist/agent-src/skills/design-tokens/SKILL.md +17 -2
  282. package/dist/agent-src/skills/design-variations/SKILL.md +2 -2
  283. package/dist/agent-src/skills/developer-like-execution/SKILL.md +2 -2
  284. package/dist/agent-src/skills/discovery-interview/SKILL.md +2 -2
  285. package/dist/agent-src/skills/doc-coauthoring/SKILL.md +3 -3
  286. package/dist/agent-src/skills/editorial-calendar/SKILL.md +2 -2
  287. package/dist/agent-src/skills/existing-ui-audit/SKILL.md +44 -1
  288. package/dist/agent-src/skills/existing-ui-audit/references/anti-slop-cross-reference.md +2 -2
  289. package/dist/agent-src/skills/expansion-playbook/SKILL.md +2 -2
  290. package/dist/agent-src/skills/experiment-loop/SKILL.md +1 -1
  291. package/dist/agent-src/skills/experiment-loop/references/protocol.md +1 -1
  292. package/dist/agent-src/skills/fe-design/SKILL.md +3 -3
  293. package/dist/agent-src/skills/fe-design/references/design-patterns.md +1 -1
  294. package/dist/agent-src/skills/fe-design/references/design-read-and-memory.md +3 -3
  295. package/dist/agent-src/skills/fe-design/references/source-led-port.md +1 -1
  296. package/dist/agent-src/skills/feature-planning/SKILL.md +1 -1
  297. package/dist/agent-src/skills/flux/SKILL.md +1 -1
  298. package/dist/agent-src/skills/forecast-accuracy/SKILL.md +2 -2
  299. package/dist/agent-src/skills/forecasting/SKILL.md +2 -2
  300. package/dist/agent-src/skills/fundraising-narrative/SKILL.md +2 -2
  301. package/dist/agent-src/skills/funnel-analysis/SKILL.md +2 -2
  302. package/dist/agent-src/skills/gtm-launch/SKILL.md +2 -2
  303. package/dist/agent-src/skills/hiring-loop-design/SKILL.md +1 -1
  304. package/dist/agent-src/skills/html-deck/SKILL.md +5 -5
  305. package/dist/agent-src/skills/humanizer/SKILL.md +1 -1
  306. package/dist/agent-src/skills/humanizer/data/patterns.md +1 -1
  307. package/dist/agent-src/skills/iconography/SKILL.md +3 -3
  308. package/dist/agent-src/skills/judge-synthesis/SKILL.md +1 -1
  309. package/dist/agent-src/skills/laravel-api-endpoint/SKILL.md +2 -2
  310. package/dist/agent-src/skills/launch-readiness/SKILL.md +3 -3
  311. package/dist/agent-src/skills/learning-to-rule-or-skill/SKILL.md +6 -6
  312. package/dist/agent-src/skills/livewire/SKILL.md +1 -1
  313. package/dist/agent-src/skills/market-entry-analysis/SKILL.md +1 -1
  314. package/dist/agent-src/skills/mcp-builder/SKILL.md +1 -1
  315. package/dist/agent-src/skills/memory-consolidation/SKILL.md +3 -3
  316. package/dist/agent-src/skills/messaging-architecture/SKILL.md +2 -2
  317. package/dist/agent-src/skills/monorepo-workspace/SKILL.md +1 -1
  318. package/dist/agent-src/skills/onboarding-design/SKILL.md +2 -2
  319. package/dist/agent-src/skills/onboarding-program/SKILL.md +1 -1
  320. package/dist/agent-src/skills/one-on-one-cadence/SKILL.md +1 -1
  321. package/dist/agent-src/skills/org-design/SKILL.md +1 -1
  322. package/dist/agent-src/skills/overbuild-review-lens/SKILL.md +3 -3
  323. package/dist/agent-src/skills/override-management/SKILL.md +1 -1
  324. package/dist/agent-src/skills/perf-feedback-craft/SKILL.md +1 -1
  325. package/dist/agent-src/skills/persona-writing/SKILL.md +1 -1
  326. package/dist/agent-src/skills/php-coder/SKILL.md +1 -1
  327. package/dist/agent-src/skills/pipeline-strategy/SKILL.md +2 -2
  328. package/dist/agent-src/skills/playwright-testing/SKILL.md +3 -3
  329. package/dist/agent-src/skills/po-discovery/SKILL.md +1 -1
  330. package/dist/agent-src/skills/positioning-strategy/SKILL.md +2 -2
  331. package/dist/agent-src/skills/privacy-review/SKILL.md +1 -1
  332. package/dist/agent-src/skills/prompt-optimizer/SKILL.md +3 -3
  333. package/dist/agent-src/skills/react-shadcn-ui/SKILL.md +1 -1
  334. package/dist/agent-src/skills/reasoning-orchestrator/SKILL.md +2 -2
  335. package/dist/agent-src/skills/receiving-code-review/SKILL.md +1 -1
  336. package/dist/agent-src/skills/refine-ticket/SKILL.md +2 -2
  337. package/dist/agent-src/skills/release-comms/SKILL.md +2 -2
  338. package/dist/agent-src/skills/retention-loops/SKILL.md +2 -2
  339. package/dist/agent-src/skills/review-routing/SKILL.md +2 -2
  340. package/dist/agent-src/skills/roadmap-management/SKILL.md +1 -1
  341. package/dist/agent-src/skills/roadmap-management/references/archival.md +1 -1
  342. package/dist/agent-src/skills/roadmap-writing/SKILL.md +5 -5
  343. package/dist/agent-src/skills/rule-writing/SKILL.md +6 -6
  344. package/dist/agent-src/skills/runway-cognition/SKILL.md +2 -2
  345. package/dist/agent-src/skills/scenario-modeling/SKILL.md +2 -2
  346. package/dist/agent-src/skills/skill-writing/SKILL.md +2 -2
  347. package/dist/agent-src/skills/skill-writing/references/procedure.md +1 -1
  348. package/dist/agent-src/skills/skill-writing/references/section-patterns.md +3 -3
  349. package/dist/agent-src/skills/spreadsheet-authoring/SKILL.md +1 -1
  350. package/dist/agent-src/skills/stakeholder-tradeoff/SKILL.md +3 -3
  351. package/dist/agent-src/skills/subagent-orchestration/SKILL.md +1 -1
  352. package/dist/agent-src/skills/supply-chain-intake/SKILL.md +1 -1
  353. package/dist/agent-src/skills/systematic-debugging/SKILL.md +2 -2
  354. package/dist/agent-src/skills/tailwind-engineer/SKILL.md +11 -5
  355. package/dist/agent-src/skills/throughput-vs-morale-tradeoff/SKILL.md +1 -1
  356. package/dist/agent-src/skills/token-optimizer/SKILL.md +1 -1
  357. package/dist/agent-src/skills/typography-system/SKILL.md +2 -2
  358. package/dist/agent-src/skills/ui-component-architect/SKILL.md +28 -8
  359. package/dist/agent-src/skills/unit-economics-modeling/SKILL.md +2 -2
  360. package/dist/agent-src/skills/upstream-contribute/SKILL.md +1 -1
  361. package/dist/agent-src/skills/validate-feature-fit/SKILL.md +2 -2
  362. package/dist/agent-src/skills/verify-repair-loop/SKILL.md +2 -2
  363. package/dist/agent-src/skills/vision-articulation/SKILL.md +1 -1
  364. package/dist/agent-src/skills/voc-extract/SKILL.md +2 -2
  365. package/dist/agent-src/skills/voice-and-tone-design/SKILL.md +2 -2
  366. package/dist/agent-src/skills/wireframe/SKILL.md +1 -1
  367. package/dist/agent-src/skills/workspace-link/SKILL.md +1 -1
  368. package/dist/agent-src/templates/agent-settings.md +6 -6
  369. package/dist/agent-src/templates/agents/agent-project-settings.example.yml +1 -1
  370. package/dist/agent-src/templates/contexts/knowledge-pages.md +2 -3
  371. package/dist/agent-src/templates/copilot-instructions.md +1 -1
  372. package/dist/agent-src/templates/roadmaps.md +1 -1
  373. package/dist/agent-src/templates/scripts/README.md +2 -2
  374. package/dist/agent-src/user-types/_template/user-type.md +1 -1
  375. package/dist/cli-delegate/check_update_banner.js +12 -1
  376. package/dist/cli-delegate/{chunk-NLP54U3J.js → chunk-2XY7ILBT.js} +13 -1
  377. package/dist/cli-delegate/{chunk-IAI3XL43.js → chunk-3FKR64R5.js} +22 -6
  378. package/dist/cli-delegate/{chunk-J3RFNKG4.js → chunk-55ACLDUE.js} +2 -2
  379. package/dist/cli-delegate/{chunk-PKOBQADP.js → chunk-57PN4GYJ.js} +1 -1
  380. package/dist/cli-delegate/{chunk-KCNTUSPI.js → chunk-AK6HODNQ.js} +4 -4
  381. package/dist/cli-delegate/{chunk-2FTMENJL.js → chunk-GYC3VRYN.js} +1 -1
  382. package/dist/cli-delegate/{chunk-LWTYTX6F.js → chunk-HZ52BRGG.js} +24 -18
  383. package/dist/cli-delegate/{chunk-6RJA2F5A.js → chunk-IVBPRCQO.js} +1 -1
  384. package/dist/cli-delegate/{chunk-I6RHFQEG.js → chunk-YUM5KURG.js} +17 -1
  385. package/dist/cli-delegate/cmd_analyze_session.js +1 -1
  386. package/dist/cli-delegate/cmd_brand_status.js +1 -1
  387. package/dist/cli-delegate/cmd_conformance.js +3 -3
  388. package/dist/cli-delegate/cmd_doctor.js +3 -3
  389. package/dist/cli-delegate/cmd_explain.js +2 -2
  390. package/dist/cli-delegate/cmd_export.js +4 -4
  391. package/dist/cli-delegate/cmd_handoff.js +4 -4
  392. package/dist/cli-delegate/cmd_mcp_available.js +1 -1
  393. package/dist/cli-delegate/cmd_memory_get.js +1 -1
  394. package/dist/cli-delegate/cmd_migrate.js +2 -2
  395. package/dist/cli-delegate/cmd_packs_active.js +2 -2
  396. package/dist/cli-delegate/cmd_prune.js +4 -4
  397. package/dist/cli-delegate/cmd_route_audit.js +3 -3
  398. package/dist/cli-delegate/cmd_route_explain.js +1 -1
  399. package/dist/cli-delegate/cmd_session_recycle.js +1 -1
  400. package/dist/cli-delegate/cmd_settings_get.js +15 -9
  401. package/dist/cli-delegate/cmd_settings_migrate.js +4 -4
  402. package/dist/cli-delegate/cmd_settings_set.js +41 -11
  403. package/dist/cli-delegate/cmd_sync.js +4 -4
  404. package/dist/cli-delegate/cmd_uninstall.js +4 -4
  405. package/dist/cli-delegate/cmd_update.js +1 -1
  406. package/dist/cli-delegate/cmd_upgrade.js +1 -1
  407. package/dist/cli-delegate/cmd_validate.js +4 -4
  408. package/dist/cli-delegate/cmd_versions.js +1 -1
  409. package/dist/discovery/deprecation-report.md +1 -1
  410. package/dist/discovery/discovery-manifest.json +22 -75
  411. package/dist/discovery/discovery-manifest.json.sha256 +1 -1
  412. package/dist/discovery/discovery-manifest.summary.md +3 -3
  413. package/dist/discovery/dormancy-report.md +1 -1
  414. package/dist/discovery/orphan-report.md +1 -1
  415. package/dist/discovery/packs.json +5 -7
  416. package/dist/discovery/trust-report.md +2 -2
  417. package/dist/discovery/workspaces.json +4 -6
  418. package/dist/hooks/dispatch.js +8607 -8930
  419. package/dist/install/install.mjs +35 -8
  420. package/dist/mcp/registry-manifest.json +3 -3
  421. package/dist/mcp/server.json +2 -2
  422. package/dist/mcp/server.mjs +1433 -1342
  423. package/dist/router.json +1 -1
  424. package/dist/scripts/_lib/agent_settings.js +73 -0
  425. package/dist/scripts/_lib/agent_src.js +20 -0
  426. package/dist/scripts/_lib/guidelines_lane.js +158 -0
  427. package/dist/scripts/condense.js +2 -5
  428. package/dist/server/io/yamlIO.js +125 -17
  429. package/dist/server/schemas/settings.js +18 -4
  430. package/dist/shared/settingsSurface.js +6 -1
  431. package/docs/contracts/settings-classes.md +18 -9
  432. package/docs/guidelines/abstraction-thresholds.md +35 -0
  433. package/docs/guidelines/agent-infra/active-remediation-mechanics.md +3 -3
  434. package/docs/guidelines/agent-infra/false-green.md +2 -2
  435. package/docs/guidelines/agent-infra/roadmap-progress-mechanics.md +1 -1
  436. package/docs/guidelines/agent-infra/skill-quality-checklist.md +1 -1
  437. package/docs/guidelines/design-fidelity-mechanics.md +4 -0
  438. package/docs/guidelines/design-fidelity-routing.md +78 -0
  439. package/docs/guidelines/design-reconciliation.md +172 -0
  440. package/docs/guidelines/gtm-handoff.md +2 -2
  441. package/docs/guidelines/wing4-handoff.md +2 -2
  442. package/package.json +7 -3
  443. package/src/config/agent-settings.template.yml +55 -8
  444. package/src/config/ci-local-parity.yml +34 -0
  445. package/src/config/continuity-surface.json +4 -32
  446. package/src/config/gate-coverage.yml +31 -8
  447. package/src/config/gate-reachability-exemptions.json +1 -0
  448. package/src/config/gate-violation-baselines.json +3 -3
  449. package/src/config/hook-token-budget.json +1 -1
  450. package/src/config/host-injection-effect.json +2 -2
  451. package/src/config/pack-size-budget.json +55 -4
  452. package/src/config/platform-anchor.json +47 -0
  453. package/src/config/preamble-payload-budget.json +2 -3
  454. package/src/config/publish-surface.json +4 -2
  455. package/src/config/ratification-policy.json +7 -0
  456. package/src/config/rule-stub-ceilings.json +16 -9
  457. package/src/scripts/_cli/cmd_settings_get.ts +22 -7
  458. package/src/scripts/_lib/agent_settings.ts +85 -0
  459. package/src/scripts/_lib/agent_src.ts +21 -0
  460. package/src/scripts/_lib/artifact_maturity.ts +242 -0
  461. package/src/scripts/_lib/conformance_report.ts +403 -0
  462. package/src/scripts/_lib/continuity_writer.ts +72 -13
  463. package/src/scripts/_lib/design_system_import.ts +20 -0
  464. package/src/scripts/_lib/design_tolerance.ts +281 -0
  465. package/src/scripts/_lib/guidelines_lane.ts +164 -0
  466. package/src/scripts/_lib/obligation_frequency.ts +2 -3
  467. package/src/scripts/_lib/platform_anchor.ts +1053 -0
  468. package/src/scripts/_lib/ratification_artifact.ts +278 -0
  469. package/src/scripts/_lib/security_lint.ts +23 -2
  470. package/src/scripts/_lib/self_repair.ts +21 -0
  471. package/src/scripts/_lib/session_index_trust.ts +42 -1
  472. package/src/scripts/_lib/standing_bound_ratchet.ts +103 -37
  473. package/src/scripts/_lib/tolerance_shadow.ts +177 -0
  474. package/src/scripts/ai_council/redact_low_impact_entry.ts +8 -0
  475. package/src/scripts/autonomy_friction_traffic.ts +379 -0
  476. package/src/scripts/check_kernel_edit_ratified.ts +462 -0
  477. package/src/scripts/check_loss_class_declared.ts +793 -46
  478. package/src/scripts/check_platform_anchor.ts +390 -0
  479. package/src/scripts/check_preamble_payload_budget.ts +292 -4
  480. package/src/scripts/check_projected_rule_routes.ts +395 -0
  481. package/src/scripts/code_graph/cli.ts +6 -0
  482. package/src/scripts/condense.ts +2 -6
  483. package/src/scripts/generate_host_cost_table.ts +354 -0
  484. package/src/scripts/hook_manifest.json +1 -1
  485. package/src/scripts/hook_manifest.yaml +35 -27
  486. package/src/scripts/hooks/category_a.ts +1 -1
  487. package/src/scripts/hooks/chain_nudge_hook.ts +311 -25
  488. package/src/scripts/hooks/session_eol_hook.ts +68 -154
  489. package/src/scripts/hooks/source_first_gate_hook.ts +12 -0
  490. package/src/scripts/hooks/ui_route_nudge_hook.ts +52 -15
  491. package/src/scripts/hot_context_hook.ts +41 -401
  492. package/src/scripts/lint_evidence_artifacts.ts +1 -0
  493. package/src/scripts/lint_knowledge_scale.ts +0 -26
  494. package/src/scripts/memory_lookup.ts +9 -9
  495. package/src/scripts/report_standing_payload_by_host.ts +7 -7
  496. package/src/scripts/session_memory_index.ts +5 -0
  497. package/src/scripts/sync_agent_settings.ts +270 -10
  498. package/src/server/io/yamlIO.ts +127 -17
  499. package/src/server/schemas/settings.ts +25 -5
  500. package/src/shared/settingsSurface.ts +13 -2
  501. package/src/templates/compact-instructions.md +8 -3
  502. package/dist/agent-src/commands/chat-history/import.md +0 -170
  503. package/dist/agent-src/commands/chat-history.md +0 -63
@@ -0,0 +1,229 @@
1
+ # size-and-scope-guidelines
2
+
3
+ ## Purpose
4
+
5
+ Ensure all system components stay:
6
+
7
+ - readable
8
+ - maintainable
9
+ - executable
10
+ - non-redundant
11
+
12
+ Prevent:
13
+ - oversized rules
14
+ - bloated skills
15
+ - command overreach
16
+ - duplicated knowledge
17
+
18
+ ---
19
+
20
+ # Core principle
21
+
22
+ > Split by responsibility, NOT by length.
23
+
24
+ Size is a signal — not the goal.
25
+
26
+ ---
27
+
28
+ # Golden size rules
29
+
30
+ ## Rules & system instructions
31
+
32
+ - Ideal: **< 60 lines**
33
+ - Acceptable: **< 100–120 lines**
34
+ - Hard limit: **< 200 lines**
35
+
36
+ Linter (structural model, 2026-05-08 — see
37
+ [`docs/contracts/linter-structural-model.md`](../../contracts/linter-structural-model.md)):
38
+ the long-rule warning fires only when the rule is **> 60 non-empty
39
+ lines AND density < 0.50 AND ships no Iron-Law block**. Rules whose
40
+ body is a verbatim ALL-CAPS imperative (`commit-policy`,
41
+ `ask-when-uncertain`, `direct-answers`) are auto-exempt — no
42
+ frontmatter flag required. The 200-line hard error stays
43
+ unconditional.
44
+
45
+ Reason:
46
+ - Loaded frequently
47
+ - Must be reliably followed
48
+ - Large files get partially ignored
49
+
50
+ ---
51
+
52
+ ## Skills
53
+
54
+ - Target: **300–900 words**
55
+ - Warning: **> 400 lines AND (density < 0.60 OR ≥ 2 `## Procedure`
56
+ blocks)** — structural model, 2026-05-08
57
+ - Reference-rich skills with high density (`quality-tools` at 0.83,
58
+ catalogue-style skills) pass without splitting; the multi-procedure
59
+ trigger flags genuine cluster-split candidates regardless of size
60
+
61
+ Focus:
62
+ - scanability
63
+ - one responsibility
64
+ - executable workflow
65
+
66
+ ---
67
+
68
+ ## Commands
69
+
70
+ - Target: **200–600 words**
71
+ - Acceptable: **up to ~1000 words**
72
+ - Warning: **> 1000 words AND no delegation signal AND density < 0.65**
73
+ — structural model, 2026-05-08. A delegation signal is either
74
+ frontmatter (`cluster:` / `routes_to:`) OR ≥ 3 markdown links to
75
+ other `.md` files. Well-factored orchestrators pass automatically;
76
+ inlined logic in a non-orchestrator command warns.
77
+
78
+ Commands orchestrate — not implement.
79
+
80
+ ---
81
+
82
+ ## AGENTS.md
83
+
84
+ - Enforced budget: **character caps** via `lint_agents_md.ts` — package
85
+ root fails at **3,000 chars** (warns 2,800); consumer template fails at
86
+ **2,500 chars** (warns 2,300).
87
+ - Word guidance: aim for **≤ ~450 words** — that is roughly what fits
88
+ under the 3,000-char cap.
89
+
90
+ High-level only.
91
+
92
+ ---
93
+
94
+ ## copilot-instructions.md
95
+
96
+ - Ideal: **< 60 lines**
97
+ - Acceptable: **< 100–150 lines**
98
+ - Note: Copilot Code Review reads only the **first 4,000 characters**
99
+ (see `src/agent-src/templates/copilot-instructions.md`), so the
100
+ effective cap is character-based — highest-priority rules go up top.
101
+
102
+ Must stay lightweight.
103
+
104
+ ---
105
+
106
+ ## Guidelines
107
+
108
+ - Target: **400–1500 words**
109
+ - Can exceed if needed
110
+
111
+ Guidelines are reference — not execution.
112
+
113
+ ---
114
+
115
+ ## Knowledge cards
116
+
117
+ Committed knowledge cards (`agents/knowledge/<source>.md`) are a size-bounded,
118
+ evidence-disciplined context type:
119
+
120
+ - Hard bound: **≤ 150 lines** — a card is a thin distillation, never a mirror.
121
+ - **Mandatory** `links.authoritative` pointer (path or URL).
122
+ - Enforced by `check_knowledge_cards.ts` (pointer-resolution CI + size +
123
+ trust-tag + multi-evidence git-ancestry consistency; `--strict` adds a
124
+ content-compare). Durable content = negative facts + pointers; positive
125
+ structure is a per-line, last-verified hypothesis.
126
+
127
+ See [`source-discovery`](../../skills/source-discovery/SKILL.md) and the
128
+ `evidence-discipline` context for the full model.
129
+
130
+ ---
131
+
132
+ # Component responsibilities
133
+
134
+ ## Rules
135
+
136
+ - constraints only
137
+ - no workflows
138
+ - no long explanations
139
+
140
+ ---
141
+
142
+ ## Skills
143
+
144
+ Must contain:
145
+
146
+ - When to use
147
+ - Procedure
148
+ - Validation
149
+ - Output format
150
+ - Gotchas
151
+ - Do NOT
152
+
153
+ ---
154
+
155
+ ## Commands
156
+
157
+ - orchestrate workflows
158
+ - delegate to skills
159
+ - do not contain deep logic
160
+
161
+ ---
162
+
163
+ ## Guidelines
164
+
165
+ - define conventions
166
+ - support skills
167
+ - must NOT replace workflows
168
+
169
+ ---
170
+
171
+ ## AGENTS.md
172
+
173
+ - entrypoint
174
+ - system overview
175
+ - interaction model
176
+
177
+ ---
178
+
179
+ ## copilot-instructions.md
180
+
181
+ - behavioral hints
182
+ - style guidance
183
+
184
+ ---
185
+
186
+ # Anti-patterns
187
+
188
+ ## Too large
189
+
190
+ - skill solves multiple problems
191
+ - rule explains instead of constraining
192
+ - command contains implementation
193
+ - AGENTS.md becomes documentation dump
194
+
195
+ ---
196
+
197
+ ## Too small
198
+
199
+ - skill has no real workflow
200
+ - rule is just a suggestion
201
+ - command adds no value
202
+
203
+ ---
204
+
205
+ # Boundary rule (critical)
206
+
207
+ > A skill must remain usable WITHOUT opening a guideline.
208
+
209
+ If not → the skill is too weak.
210
+
211
+ ---
212
+
213
+ # Decision checklist
214
+
215
+ Before creating or modifying:
216
+
217
+ 1. Is this a constraint → Rule
218
+ 2. Is this a workflow → Skill
219
+ 3. Is this orchestration → Command
220
+ 4. Is this reference → Guideline
221
+ 5. Is this entrypoint → AGENTS.md
222
+ 6. Is this behavior hint → copilot-instructions.md
223
+
224
+ ---
225
+
226
+ # Final principle
227
+
228
+ > Small enough to understand quickly
229
+ > Large enough to be useful
@@ -0,0 +1,157 @@
1
+ # Skill Quality
2
+
3
+ > Creating, editing, or reviewing skills — minimum quality standard, every skill must be executable, validated, and self-contained
4
+
5
+ _Origin: migrated from `.agent-src.uncondensed/rules/skill-quality.md` per P4.2 of `road-to-kernel-and-router.md`._
6
+
7
+ # Skill Quality
8
+
9
+ ## Minimum Sharpness
10
+
11
+ Every skill must answer four questions. If ANY answer is weak, the skill is not done.
12
+
13
+ | # | Question | Section | Standard |
14
+ |---|---|---|---|
15
+ | 1 | When should I use this? | `When to use` | Concrete trigger, not generic |
16
+ | 2 | What exactly do I do? | `Procedure` | Executable steps with decisions |
17
+ | 3 | How do I verify it worked? | `Procedure` (validation step) | Concrete checks, not "verify it works" |
18
+ | 4 | What common failure must I avoid? | `Gotcha` + `Do NOT` | Real failure patterns, not platitudes |
19
+
20
+ ## Register — explain the trade-off, except in the safety kernel
21
+
22
+ Two registers, chosen by artifact class (U4, ecosystem harvest 2026-07-13):
23
+
24
+ - **Capability skills** (workflows, analyses, generators) **explain the
25
+ trade-off** — say *why* the recommended path beats the alternative instead of
26
+ shouting ALL-CAPS MUSTs; an agent that understands the why generalizes to
27
+ cases the skill never enumerated.
28
+ - **The safety kernel keeps its imperative Iron-Law register** — kernel rules,
29
+ safety floors (`*-safety-floor`), and Hard-Floor surfaces stay ALL-CAPS
30
+ fenced-law imperative, non-negotiable (`preservation-guard` enforces the
31
+ byte-level protection). Never downgrade an Iron Law to friendly prose.
32
+
33
+ ## Required Sections
34
+
35
+ Every skill MUST have: `When to use`, `Procedure`, `Gotcha`, `Output format`, `Do NOT`.
36
+
37
+ ## Frontmatter Contract
38
+
39
+ Every skill's YAML frontmatter MUST validate against `scripts/schemas/skill.schema.json`.
40
+ Violations are reported by `scripts/skill_linter.ts` as `schema_<rule>` errors
41
+ and fail `./scripts-run src/scripts/validate_frontmatter` and the full CI pipeline.
42
+
43
+ ### Omit fields equal to their schema default
44
+
45
+ ```
46
+ NEVER write a frontmatter field whose value equals its schema `default`.
47
+ OMIT IT — the loader injects the default at read time.
48
+ ```
49
+
50
+ A field that carries the schema `default` (e.g. `trust.level: core`,
51
+ `install.default: true`, `lifecycle: active`, `source: package`,
52
+ `command.disable-model-invocation: true`) is redundant:
53
+ `validate_frontmatter.apply_schema_defaults` injects it transparently for
54
+ every consumer (validator, discovery manifest, drift checksum). Writing it
55
+ anyway is boilerplate that `scripts/lint_frontmatter_boilerplate.ts` rejects
56
+ (wired into this repository's `ci-fast` task). To strip it across the tree, run
57
+ `./scripts-run src/scripts/migrate_frontmatter_defaults`. Background:
58
+ `road-to-abstraction-reduction.md` +
59
+ `agents/evidence/analysis/abstraction-reduction-preflight.md`.
60
+
61
+ > **Changing a default is a breaking change.** The schema `default` is a
62
+ > contract: artefacts that omit the field inherit whatever the default *is at
63
+ > read time*. Flipping a default value (e.g. `lifecycle: active → deprecated`)
64
+ > silently re-defaults every artefact that omits the field — so a default
65
+ > change must pair with a re-run of `migrate_frontmatter_defaults.ts` and an
66
+ > explicit review of the affected artefacts.
67
+
68
+ ## Description Triggering
69
+
70
+ Claude routes skills by their frontmatter `description`. Pushy,
71
+ trigger-rich descriptions are required — polite or hedged ones cause
72
+ undertriggering. The full recipe (concrete verb phrase, ≥2 triggers,
73
+ `even if they don't explicitly ask for …` tail, ≤200 chars,
74
+ litmus test) lives in
75
+ [`contexts/communication/rules-auto/skill-quality-mechanics.md`](../../contexts/communication/rules-auto/skill-quality-mechanics.md)
76
+ § Description Triggering.
77
+
78
+ ## Skill Independence
79
+
80
+ ```
81
+ If a skill is not executable without opening a guideline, it is broken.
82
+ ```
83
+
84
+ - Skills MAY reference guidelines for detailed conventions
85
+ - Skills MUST NOT outsource their core workflow to guidelines
86
+ - If removing guideline references makes the skill useless → the skill is too weak
87
+
88
+ **Litmus test:** Cover all guideline references in the Procedure. Is it still executable?
89
+ If not → the skill needs more own steps, decisions, and validation — not more guideline links.
90
+
91
+ ## Merge & Condensation Preservation
92
+
93
+ When merging or condensing skills, the result MUST preserve the
94
+ strongest validation, strongest examples, all anti-patterns, all
95
+ decision criteria, and trigger quality. Full preservation invariants
96
+ and "merge is invalid if …" / "condensation may remove …" lists in
97
+ [`contexts/communication/rules-auto/skill-quality-mechanics.md`](../../contexts/communication/rules-auto/skill-quality-mechanics.md)
98
+ § Merge Preservation and § Condensation Preservation.
99
+
100
+ ## Refactor Safety
101
+
102
+ When refactoring or optimizing skills:
103
+
104
+ - NEVER weaken validation to pass linter
105
+ - NEVER remove anti-patterns to reduce size
106
+ - NEVER replace concrete checks with "verify it works"
107
+ - NEVER merge skills if the result is broader than either source
108
+ - ALWAYS run linter before and after — fail count must not increase
109
+
110
+ ## Senior-Tier Required Structure
111
+
112
+ Skills with `tier: senior` in YAML frontmatter MUST carry four named
113
+ blocks beyond the standard required sections:
114
+
115
+ | # | Block | Heading / Location | Standard |
116
+ |---|---|---|---|
117
+ | 1 | Context-First lead | Frontmatter `description` | First sentence anchors the cognition cluster (domain + senior role); second sentence names the trigger. |
118
+ | 2 | Related Skills | `## Related Skills` | Two-list pattern — `**WHEN to use this**` (situations this skill resolves) + `**WHEN NOT to use this**` (route-elsewhere peers, named). |
119
+ | 3 | Proactive Triggers | `## When the agent should load this` | 3–5 concrete user-prompt patterns (paraphrases users actually type), not abstract categories. |
120
+ | 4 | Output Artifacts | `## Output` | 1–4 named artifacts with shape (file path, table, markdown structure) — orchestrator-citable identifier each. |
121
+
122
+ **Forward-only.** `scripts/skill_linter.ts` enforces these blocks for
123
+ `tier: senior` skills only; mid-tier and untiered skills skip the
124
+ check. No retrofit pass on existing Wing-1 skills.
125
+
126
+ Subsection specs (≤ 6-line spec + 1 reference example each), good /
127
+ bad pattern pairs, and the WHEN-NOT routing peer rules live in
128
+ [`contexts/communication/rules-auto/skill-quality-mechanics.md`](../../contexts/communication/rules-auto/skill-quality-mechanics.md)
129
+ § Senior-tier patterns.
130
+
131
+ ## Structural Malice Floor
132
+
133
+ `scripts/skill_linter.ts` runs five regex patterns against every
134
+ skill / rule / command body — credential exfiltration, remote
135
+ execution, force-push to a protected ref, world-readable secret
136
+ files, and shell-injection in subprocess calls. A match emits
137
+ ``Issue("error", "malice:<pattern>", "<line>:<matched>")`` and the
138
+ linter exits with code **3** (security-failure), distinct from
139
+ exit 2 (build-failure) so CI surfaces can split the two.
140
+
141
+ The check is **structural**, not semantic — it catches the shapes
142
+ the [`tool-safety`](../../rules/tool-safety.md) rule denies in prose: hidden
143
+ credentials, arbitrary execution, write-without-approval. Fixtures
144
+ and the exit-code-3 contract live in
145
+ [`tests/test_skill_linter_malice.py`](../../../tests/scripts/skill_linter.test.ts).
146
+
147
+ ## Confidence Tagging
148
+
149
+ Senior-tier procedure steps MAY append `[CONFIDENCE: high|medium|low]`
150
+ at the end of multi-step chains where the agent's evidence varies
151
+ across steps. Optional but recommended when a step's output feeds a
152
+ downstream decision.
153
+
154
+ Text-tag form is deliberate. Emoji 🟢 / 🟡 / 🔴 is **not** allowed —
155
+ collides with [`direct-answers`](../../rules/direct-answers.md) § Emoji scope
156
+ (functional markers only). Linter does not enforce the tag itself;
157
+ the rule documents the placement so authors converge on one form.
@@ -0,0 +1,109 @@
1
+ # Source confidentiality — mechanics
2
+
3
+ Migrated out of [`source-confidentiality`](../../rules/source-confidentiality.md)
4
+ on 2026-08-29. The rule is delivered on **every subagent spawn**, so its body is
5
+ paid per spawn; this material is reference read on demand. Nothing was dropped —
6
+ the three sections below are the rule's own text, verbatim, and the rule keeps
7
+ its Iron Laws and points here.
8
+
9
+ ### What "source-anonymous" claims, and what it explicitly does not
10
+
11
+ ```
12
+ THE CLAIM IS ABOUT WHAT IS WRITTEN NEXT, NEVER ABOUT WHAT IS ALREADY RECORDED.
13
+ NEVER DESCRIBE THIS AS ERADICATION, REMOVAL FROM HISTORY, OR A CLEAN REPOSITORY.
14
+ COMMIT MESSAGES, MERGED PR BODIES AND OLD DIFFS REMAIN RECOVERABLE BY ANYONE
15
+ WITH REPOSITORY ACCESS, AND NO PHASE OF THIS PROGRAMME CHANGES THAT.
16
+ ```
17
+
18
+ The `whether-history-gets-rewritten` decision resolved **no rewrite** (AI
19
+ council 2026-08-28, 2/2): the evidence estate rests on stable commit pins, and a
20
+ `git filter-repo` would convert every past `reproduced at <sha>` into an
21
+ unverifiable claim — a larger loss than the residual it removes, and one that
22
+ would still not reach a pre-rewrite clone, a fork or a PR mirror. So the
23
+ residual is **counted, not hidden**: the census artefact
24
+ (`agents/evidence/reports/source-attribution-census.md`) carries a `residual:`
25
+ field for the immutable surfaces, and "clean" always means "clean minus the
26
+ recorded residual".
27
+
28
+ ### The two classes are opposites, and only one of them is a leak
29
+
30
+ ```
31
+ HARVEST ATTRIBUTION IS PROHIBITED EVERYWHERE.
32
+ LICENSE-REQUIRED ATTRIBUTION IS MANDATORY, AND LIVES ONLY IN THE LICENSE SURFACES.
33
+ CONFLATING THEM IN EITHER DIRECTION IS A DEFECT: SCRUBBING A LICENSE NOTICE
34
+ BREAKS A LEGAL OBLIGATION, AND HIDING A HARVEST BEHIND ONE IS THE LEAK.
35
+ ```
36
+
37
+ The three license surfaces, by path — no others:
38
+
39
+ - `CREDITS.md`
40
+ - `docs/THIRD-PARTY-NOTICES.md`
41
+ - `provenance/borrows.jsonl`
42
+
43
+ An upstream name there is required by the license or by
44
+ [`code-provenance`](code-provenance.md) and is never scrubbed. The same name in
45
+ a roadmap, skill, rule, ADR or commit message is harvest attribution and is a
46
+ defect. Every other `skip_paths` entry is a gate-own file or a vendored-cluster
47
+ member carrying its own notice.
48
+
49
+ ## The gate also checks SHAPE, not only names
50
+
51
+ A deny list can only catch a name somebody already wrote down; the next unknown
52
+ source walks straight through it. `check_no_external_sources` therefore also
53
+ flags attribution by **form** — a `> **Source:**` header whose value is neither
54
+ an opaque round identifier nor an `ENC1:` token, a quoted
55
+ `agents/tmp(.old)/<name>/` directory whose name is not opaque, and an
56
+ un-allowlisted `github.com/<owner>/<repo>` URL — and it matches tracked **paths**
57
+ against the deny set, not only file contents.
58
+
59
+ Tiering, per the resolved `how-loud-the-slug-heuristic-is` decision (AI council
60
+ 2026-08-28, 2/2): **block inside `agents/**`, warn elsewhere** — slugs are
61
+ ordinary content in integration code and docs, where blocking globally would
62
+ drive the broad allowlisting that is worse than the gap it closes. The warn tier
63
+ is written to a retained CI report (`--report <path>`), not merely printed, so
64
+ it stays auditable. Pre-existing occurrences are a **shrink-only count** in
65
+ `src/config/gate-violation-baselines.json`, never an allowlist: nothing is
66
+ excused and a new occurrence fails immediately.
67
+
68
+ ## Why these four rules are unconditional
69
+
70
+ Under ADR-236 (`docs/decisions/ADR-236-one-artefact-one-layer.md`) this rule is
71
+ delivered by the PROJECT layer only — it exists to maintain this package, so the
72
+ global layer no longer carries an unscoped twin of it. A `paths:`-scoped rule is
73
+ **not re-injected after `/compact`** (ADR-227:79-80), so scoping it would mean the
74
+ obligation silently disappears mid-session with nothing left to reload it.
75
+
76
+ It is therefore delivered unconditionally, and the path triggers were removed
77
+ rather than worked around. **This section is the shared record for all four such
78
+ rules** — `no-roadmap-references`, `rule-type-governance` and `skill-quality` carry
79
+ the same change and no note of their own. Two reasons: four copies of the rationale
80
+ cost more standing context than the decision they explain, and the other three are
81
+ migrated POINTER stubs held at their pointer's size by
82
+ `check_rule_stub_ceiling` — prose added there is prose in the wrong place by that
83
+ gate's own contract, which is what caught the first attempt to duplicate it.
84
+
85
+ AI council 2026-08-20, 2/2 convergent on this option over three alternatives, with
86
+ two independent decisive arguments. First: the obligation governs an **authoring
87
+ decision**, which happens before any file exists for a path trigger to match — so
88
+ path-scoping fails at greenfield creation whether or not a compaction ever occurs.
89
+ Second: the measured cost is small against what the partition returns. Keeping an
90
+ unscoped global copy was rejected because it re-creates the duplication the
91
+ partition exists to remove; splitting the four by "has a CI gate" was rejected by
92
+ both seats as the wrong axis — a validator observes an outcome, it does not hold an
93
+ obligation during the session, and `rule-type-governance` has no gate at all.
94
+
95
+ **Cost, measured and corrected.** An earlier revision of this note claimed 1,754
96
+ tokens (1.8 % of the partition's 96,584-token saving). That figure was a
97
+ `chars / 4` proxy over the projected files and **understated the real cost by about
98
+ half**: `check_rule_activation_census`, which counts with the exact BPE tokenizer,
99
+ measures the unconditional corpus growing **108,130 → 111,642, i.e. +3,512 tokens
100
+ (3.6 %)** — and that number includes this rationale, which is why it lives in one
101
+ place instead of four. The verdict does not depend on the figure: one seat argued
102
+ the token axis was the wrong one entirely, the other that cost is a legitimate axis
103
+ which simply loses this particular comparison. Both readings survive 3.6 %.
104
+
105
+ ## See also
106
+
107
+ - [`source-confidentiality`](../../rules/source-confidentiality.md) — the rule these mechanics belong to.
108
+ - [`code-provenance`](../../rules/code-provenance.md) — the license-required-attribution obligation the two-class split defers to.
109
+ - `src/scripts/check_no_external_sources.ts` — the gate that implements the shape checks.
@@ -0,0 +1,104 @@
1
+ # Symptom-driven harvest loop
2
+
3
+ > The procedure that turns an **operator's production symptom** into a roadmap
4
+ > this repository can execute. It is the inverse of the source-driven harvest:
5
+ > that one starts from external material pushed onto the repo and asks what is
6
+ > worth adopting; this one starts from a failure someone hit in production and
7
+ > pulls external material in **per confirmed defect**.
8
+ >
9
+ > Body of `road-to-symptom-driven-harvest-loop` Phase 2. It lives here rather
10
+ > than inline in [`roadmap-writing`](../../skills/roadmap-writing/SKILL.md)
11
+ > because that skill is already ~4.8k tokens — well past the 3,500-token band —
12
+ > and a procedure needed a few times a quarter should not be paid for on every
13
+ > roadmap-authoring turn. The skill carries the pointer.
14
+
15
+ ## When this applies
16
+
17
+ An operator reports a failure in their own words — "runs never end", "the agent
18
+ screenshots instead of reading the code" — rather than a defect with a file and
19
+ a line. File it first under [`agents/tickets/symptoms/`](../../../agents/tickets/symptoms/README.md);
20
+ that entry is what this loop resolves.
21
+
22
+ Not this loop: a defect already traced to a file (that is a roadmap item), a
23
+ feature request (roadmap or ticket), or external material arriving unprompted
24
+ (the source-driven harvest family).
25
+
26
+ ## The four steps
27
+
28
+ **1. Confirm against the live tree, at a pinned commit, before any external
29
+ search.** One `file:line` per claim, and the pin recorded next to it. The
30
+ ordering is the load-bearing part: searching externally first produces a plan
31
+ about the ecosystem's problems rather than this tree's, and every subsequent
32
+ round inherits that frame. A symptom that does not reproduce as a confirmed
33
+ defect gets a `null:` block and stops here — that is a result.
34
+
35
+ **2. Triangulate externally, per confirmed defect, never additively.** For each
36
+ defect, and only for each defect: the host tool's own issue tracker, its official
37
+ docs **fetched fresh**, and practitioner reports. Inverted form throughout — the
38
+ defect is the anchor, the source is drawn in to explain or bound it. A source
39
+ that matches no confirmed defect is not evidence for this roadmap; note it and
40
+ drop it.
41
+
42
+ **3. Iterate at least two further rounds, each stating its delta.** A round that
43
+ changes nothing ends the loop early and says so. This is the step that is
44
+ skipped under time pressure and the step that pays: on the first run of this
45
+ loop, round 2 refuted a standing repo blocker from the official payload spec,
46
+ imported a constraint that reshaped a whole phase from "block on invalid" to
47
+ "command-hook, disk-fallback, block-once", and round 3 found a reopen-clause
48
+ deadlock that was the *only* argument for reopening cancelled work at all. A
49
+ one-pass version would have shipped a roadmap re-proposing cancelled items with
50
+ no reopening argument and a mechanism the host would have broken.
51
+
52
+ **4. Emit with a symptom→defect map and per-phase falsifiers.** The map is the
53
+ artifact the operator can read: their words in one column, confirmed defects with
54
+ anchors in the next, owning phase in the third. Every phase carries the
55
+ measurement that would delete it.
56
+
57
+ ## Step 5, added by the first three runs: re-verify at adoption
58
+
59
+ A roadmap drafted at a pin and adopted later is a **snapshot of an opinion about
60
+ a tree that has since moved**. Before adopting, re-verify every repo claim at the
61
+ current tip and record the deltas.
62
+
63
+ This is not ceremony. Adopting the first three runs of this loop, 81 commits
64
+ past their shared pin, re-verification found 32 of 36 claims still true — and:
65
+
66
+ - one defect had **fixed itself** (a function measured as having zero production
67
+ callers had acquired one), which deleted a roadmap step before anyone built it;
68
+ - one claim was **wrong at the pin too** (a count stated as six where the tree
69
+ binds seven), which no amount of re-reading the draft would have surfaced;
70
+ - three anchors had **drifted** to new line numbers while their content held;
71
+ - one cross-cutting conflict was invisible until two drafts were read together
72
+ (a proposed "adopt the artifact's code" duty against an existing
73
+ `NEVER ADOPT EXTERNAL CODE VERBATIM` Iron Law).
74
+
75
+ The cheapest of those to find was the already-fixed one, and it was worth the
76
+ most: an item prevented costs nothing to maintain.
77
+
78
+ ## Worked example — why round 2 is mandatory
79
+
80
+ `hook_manifest.yaml` carried a comment stating that in-process subagents "inherit
81
+ the host process env and cannot be marked per-spawn", and that comment had stood
82
+ for months as a recorded blocker on a whole design axis. It was true about the
83
+ mechanism it named — the env var — and false about the conclusion.
84
+
85
+ Round 2 fetched the host's current payload specification, which states that tool
86
+ events inside a subagent carry `agent_id` and `agent_type` precisely so
87
+ subagent calls can be distinguished from main-thread ones. The env cannot mark a
88
+ spawn; the payload already did. One fetch refuted a months-old blocker, and the
89
+ axis it had closed reopened.
90
+
91
+ The general shape: **a repo comment records what was tried, not what is
92
+ possible.** Round 1 finds the comment and believes it, because it is this tree's
93
+ own evidence. Only an external round can date it.
94
+
95
+ ## See also
96
+
97
+ - [`roadmap-writing`](../../skills/roadmap-writing/SKILL.md) — the authoring
98
+ skill this procedure extends; it owns phases, falsifiers, and the output format.
99
+ - [`agents/tickets/symptoms/README.md`](../../../agents/tickets/symptoms/README.md) —
100
+ the intake convention and the two resolution blocks.
101
+ - [`source-discovery-gate`](../../rules/source-discovery-gate.md) — the
102
+ no-structural-claim-without-evidence rule step 1 is an application of.
103
+ - [`external-reference-deep-dive`](../../rules/external-reference-deep-dive.md) —
104
+ how to read a named external source properly in step 2.