devrites 7.1.1 → 7.2.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 (440) hide show
  1. package/CHANGELOG.md +13 -0
  2. package/README.md +9 -4
  3. package/docs/dsh.md +46 -0
  4. package/engine/internal/devritespaths/paths.go +2 -0
  5. package/engine/internal/hostpack/hostpack.go +29 -5
  6. package/engine/internal/install/apply.go +14 -2
  7. package/engine/internal/install/install.go +7 -3
  8. package/engine/internal/install/merge.go +1 -0
  9. package/engine/internal/install/preflight.go +9 -2
  10. package/engine/internal/install/update.go +1 -1
  11. package/engine/internal/lib/dispatch_packet.go +1 -1
  12. package/pack/.claude/agents/devrites-upgrade-planner.md +12 -4
  13. package/pack/.claude/skills/devrites-debug-recovery/SKILL.md +21 -4
  14. package/pack/.claude/skills/devrites-debug-recovery/reference/cleanup-and-classify.md +10 -3
  15. package/pack/.claude/skills/devrites-debug-recovery/reference/regression-test.md +7 -4
  16. package/pack/.claude/skills/devrites-lib/reference/reply-contract.md +11 -11
  17. package/pack/.claude/skills/devrites-lib/reference/standards/afk-hitl.md +52 -56
  18. package/pack/.claude/skills/devrites-lib/reference/standards/agents.md +11 -1
  19. package/pack/.claude/skills/devrites-lib/reference/standards/core.md +41 -40
  20. package/pack/.claude/skills/rite-autocomplete/SKILL.md +12 -14
  21. package/pack/.claude/skills/rite-autocomplete/reference/loop.md +34 -38
  22. package/pack/.claude/skills/rite-autocomplete/reference/stop-conditions.md +38 -39
  23. package/pack/.claude/skills/rite-define/SKILL.md +28 -27
  24. package/pack/.claude/skills/rite-plan/SKILL.md +7 -2
  25. package/pack/.claude/skills/rite-plan/reference/replan-and-repair.md +5 -2
  26. package/pack/.claude/skills/rite-resolve/SKILL.md +17 -10
  27. package/pack/.claude/skills/rite-resolve/reference/answer-protocol.md +18 -6
  28. package/pack/.claude/skills/rite-review/SKILL.md +4 -4
  29. package/pack/.claude/skills/rite-review/reference/security-review.md +4 -2
  30. package/pack/.claude/skills/rite-seal/SKILL.md +28 -33
  31. package/pack/.claude/skills/rite-ship/SKILL.md +14 -7
  32. package/pack/.claude/skills/rite-temper/SKILL.md +18 -18
  33. package/pack/.claude/skills/rite-temper/reference/scope-modes.md +6 -7
  34. package/pack/.claude/skills/rite-upgrade/SKILL.md +7 -2
  35. package/pack/.claude/skills/rite-vet/SKILL.md +33 -34
  36. package/pack/generated/README.md +3 -1
  37. package/pack/generated/claude/agents/devrites-upgrade-planner.md +12 -4
  38. package/pack/generated/claude/skills/devrites-debug-recovery/SKILL.md +21 -4
  39. package/pack/generated/claude/skills/devrites-debug-recovery/reference/cleanup-and-classify.md +10 -3
  40. package/pack/generated/claude/skills/devrites-debug-recovery/reference/regression-test.md +7 -4
  41. package/pack/generated/claude/skills/devrites-lib/reference/reply-contract.md +11 -11
  42. package/pack/generated/claude/skills/devrites-lib/reference/standards/afk-hitl.md +52 -56
  43. package/pack/generated/claude/skills/devrites-lib/reference/standards/agents.md +11 -1
  44. package/pack/generated/claude/skills/devrites-lib/reference/standards/core.md +41 -40
  45. package/pack/generated/claude/skills/rite-autocomplete/SKILL.md +12 -14
  46. package/pack/generated/claude/skills/rite-autocomplete/reference/loop.md +34 -38
  47. package/pack/generated/claude/skills/rite-autocomplete/reference/stop-conditions.md +38 -39
  48. package/pack/generated/claude/skills/rite-define/SKILL.md +28 -27
  49. package/pack/generated/claude/skills/rite-plan/SKILL.md +7 -2
  50. package/pack/generated/claude/skills/rite-plan/reference/replan-and-repair.md +5 -2
  51. package/pack/generated/claude/skills/rite-resolve/SKILL.md +17 -10
  52. package/pack/generated/claude/skills/rite-resolve/reference/answer-protocol.md +18 -6
  53. package/pack/generated/claude/skills/rite-review/SKILL.md +4 -4
  54. package/pack/generated/claude/skills/rite-review/reference/security-review.md +4 -2
  55. package/pack/generated/claude/skills/rite-seal/SKILL.md +28 -33
  56. package/pack/generated/claude/skills/rite-ship/SKILL.md +14 -7
  57. package/pack/generated/claude/skills/rite-temper/SKILL.md +18 -18
  58. package/pack/generated/claude/skills/rite-temper/reference/scope-modes.md +6 -7
  59. package/pack/generated/claude/skills/rite-upgrade/SKILL.md +7 -2
  60. package/pack/generated/claude/skills/rite-vet/SKILL.md +33 -34
  61. package/pack/generated/codex/agents/devrites-upgrade-planner.toml +12 -4
  62. package/pack/generated/codex/skills/devrites-debug-recovery/SKILL.md +21 -4
  63. package/pack/generated/codex/skills/devrites-debug-recovery/reference/cleanup-and-classify.md +10 -3
  64. package/pack/generated/codex/skills/devrites-debug-recovery/reference/regression-test.md +7 -4
  65. package/pack/generated/codex/skills/devrites-lib/reference/reply-contract.md +11 -11
  66. package/pack/generated/codex/skills/devrites-lib/reference/standards/afk-hitl.md +52 -56
  67. package/pack/generated/codex/skills/devrites-lib/reference/standards/agents.md +11 -1
  68. package/pack/generated/codex/skills/devrites-lib/reference/standards/core.md +41 -40
  69. package/pack/generated/codex/skills/rite-autocomplete/SKILL.md +12 -14
  70. package/pack/generated/codex/skills/rite-autocomplete/reference/loop.md +34 -38
  71. package/pack/generated/codex/skills/rite-autocomplete/reference/stop-conditions.md +38 -39
  72. package/pack/generated/codex/skills/rite-define/SKILL.md +28 -27
  73. package/pack/generated/codex/skills/rite-plan/SKILL.md +7 -2
  74. package/pack/generated/codex/skills/rite-plan/reference/replan-and-repair.md +5 -2
  75. package/pack/generated/codex/skills/rite-resolve/SKILL.md +17 -10
  76. package/pack/generated/codex/skills/rite-resolve/reference/answer-protocol.md +18 -6
  77. package/pack/generated/codex/skills/rite-review/SKILL.md +4 -4
  78. package/pack/generated/codex/skills/rite-review/reference/security-review.md +4 -2
  79. package/pack/generated/codex/skills/rite-seal/SKILL.md +28 -33
  80. package/pack/generated/codex/skills/rite-ship/SKILL.md +14 -7
  81. package/pack/generated/codex/skills/rite-temper/SKILL.md +18 -18
  82. package/pack/generated/codex/skills/rite-temper/reference/scope-modes.md +6 -7
  83. package/pack/generated/codex/skills/rite-upgrade/SKILL.md +7 -2
  84. package/pack/generated/codex/skills/rite-vet/SKILL.md +33 -34
  85. package/pack/generated/devin/agents/devrites-upgrade-planner.md +12 -4
  86. package/pack/generated/devin/skills/devrites-debug-recovery/SKILL.md +21 -4
  87. package/pack/generated/devin/skills/devrites-debug-recovery/reference/cleanup-and-classify.md +10 -3
  88. package/pack/generated/devin/skills/devrites-debug-recovery/reference/regression-test.md +7 -4
  89. package/pack/generated/devin/skills/devrites-lib/reference/reply-contract.md +11 -11
  90. package/pack/generated/devin/skills/devrites-lib/reference/standards/afk-hitl.md +52 -56
  91. package/pack/generated/devin/skills/devrites-lib/reference/standards/agents.md +11 -1
  92. package/pack/generated/devin/skills/devrites-lib/reference/standards/core.md +41 -40
  93. package/pack/generated/devin/skills/rite-autocomplete/SKILL.md +12 -14
  94. package/pack/generated/devin/skills/rite-autocomplete/reference/loop.md +34 -38
  95. package/pack/generated/devin/skills/rite-autocomplete/reference/stop-conditions.md +38 -39
  96. package/pack/generated/devin/skills/rite-define/SKILL.md +28 -27
  97. package/pack/generated/devin/skills/rite-plan/SKILL.md +7 -2
  98. package/pack/generated/devin/skills/rite-plan/reference/replan-and-repair.md +5 -2
  99. package/pack/generated/devin/skills/rite-resolve/SKILL.md +17 -10
  100. package/pack/generated/devin/skills/rite-resolve/reference/answer-protocol.md +18 -6
  101. package/pack/generated/devin/skills/rite-review/SKILL.md +4 -4
  102. package/pack/generated/devin/skills/rite-review/reference/security-review.md +4 -2
  103. package/pack/generated/devin/skills/rite-seal/SKILL.md +28 -33
  104. package/pack/generated/devin/skills/rite-ship/SKILL.md +14 -7
  105. package/pack/generated/devin/skills/rite-temper/SKILL.md +18 -18
  106. package/pack/generated/devin/skills/rite-temper/reference/scope-modes.md +6 -7
  107. package/pack/generated/devin/skills/rite-upgrade/SKILL.md +7 -2
  108. package/pack/generated/devin/skills/rite-vet/SKILL.md +33 -34
  109. package/pack/generated/dsh/AGENTS.md +20 -0
  110. package/pack/generated/dsh/agents/devrites-code-reviewer.md +180 -0
  111. package/pack/generated/dsh/agents/devrites-devex-reviewer.md +137 -0
  112. package/pack/generated/dsh/agents/devrites-doubt-reviewer.md +100 -0
  113. package/pack/generated/dsh/agents/devrites-evidence-scout.md +93 -0
  114. package/pack/generated/dsh/agents/devrites-frontend-reviewer.md +139 -0
  115. package/pack/generated/dsh/agents/devrites-performance-reviewer.md +142 -0
  116. package/pack/generated/dsh/agents/devrites-plan-drafter.md +113 -0
  117. package/pack/generated/dsh/agents/devrites-plan-reviewer.md +167 -0
  118. package/pack/generated/dsh/agents/devrites-proof-runner.md +101 -0
  119. package/pack/generated/dsh/agents/devrites-retrospector.md +82 -0
  120. package/pack/generated/dsh/agents/devrites-security-auditor.md +146 -0
  121. package/pack/generated/dsh/agents/devrites-simplifier-reviewer.md +113 -0
  122. package/pack/generated/dsh/agents/devrites-slice-wright.md +240 -0
  123. package/pack/generated/dsh/agents/devrites-spec-reviewer.md +105 -0
  124. package/pack/generated/dsh/agents/devrites-strategy-reviewer.md +109 -0
  125. package/pack/generated/dsh/agents/devrites-test-analyst.md +110 -0
  126. package/pack/generated/dsh/agents/devrites-upgrade-planner.md +107 -0
  127. package/pack/generated/dsh/agents/fast-builder.md +92 -0
  128. package/pack/generated/dsh/agents/fast-checker.md +61 -0
  129. package/pack/generated/dsh/agents/fast-critic.md +71 -0
  130. package/pack/generated/dsh/agents/fast-planner.md +95 -0
  131. package/pack/generated/dsh/agents/overhaul-backend-engineer.md +70 -0
  132. package/pack/generated/dsh/agents/overhaul-boundary.md +64 -0
  133. package/pack/generated/dsh/agents/overhaul-craft.md +85 -0
  134. package/pack/generated/dsh/agents/overhaul-frontend-engineer.md +73 -0
  135. package/pack/generated/dsh/agents/overhaul-implementer.md +72 -0
  136. package/pack/generated/dsh/agents/overhaul-recon.md +77 -0
  137. package/pack/generated/dsh/agents/overhaul-specialist.md +67 -0
  138. package/pack/generated/dsh/agents/overhaul-verifier.md +73 -0
  139. package/pack/generated/dsh/runtime/cordis.patch.yml +1450 -0
  140. package/pack/generated/dsh/runtime/specialist.mjs +62 -0
  141. package/pack/generated/dsh/skills/devrites-api-interface/SKILL.md +65 -0
  142. package/pack/generated/dsh/skills/devrites-audit/SKILL.md +60 -0
  143. package/pack/generated/dsh/skills/devrites-browser-proof/SKILL.md +109 -0
  144. package/pack/generated/dsh/skills/devrites-browser-proof/reference/browser-performance.md +19 -0
  145. package/pack/generated/dsh/skills/devrites-browser-proof/reference/visual-verdict.md +38 -0
  146. package/pack/generated/dsh/skills/devrites-debug-recovery/SKILL.md +119 -0
  147. package/pack/generated/dsh/skills/devrites-debug-recovery/reference/build-the-loop.md +58 -0
  148. package/pack/generated/dsh/skills/devrites-debug-recovery/reference/cleanup-and-classify.md +41 -0
  149. package/pack/generated/dsh/skills/devrites-debug-recovery/reference/hypotheses.md +23 -0
  150. package/pack/generated/dsh/skills/devrites-debug-recovery/reference/instrumentation.md +21 -0
  151. package/pack/generated/dsh/skills/devrites-debug-recovery/reference/regression-test.md +33 -0
  152. package/pack/generated/dsh/skills/devrites-debug-recovery/reference/trace.md +25 -0
  153. package/pack/generated/dsh/skills/devrites-doubt/SKILL.md +83 -0
  154. package/pack/generated/dsh/skills/devrites-frontend-craft/SKILL.md +89 -0
  155. package/pack/generated/dsh/skills/devrites-frontend-craft/reference/craft.md +63 -0
  156. package/pack/generated/dsh/skills/devrites-frontend-craft/reference/design-references.md +120 -0
  157. package/pack/generated/dsh/skills/devrites-frontend-craft/reference/fullstack.md +46 -0
  158. package/pack/generated/dsh/skills/devrites-frontend-craft/reference/quality-standards.md +286 -0
  159. package/pack/generated/dsh/skills/devrites-frontend-craft/reference/reuse-first.md +53 -0
  160. package/pack/generated/dsh/skills/devrites-frontend-craft/reference/shape.md +61 -0
  161. package/pack/generated/dsh/skills/devrites-interview/SKILL.md +107 -0
  162. package/pack/generated/dsh/skills/devrites-lib/SKILL.md +98 -0
  163. package/pack/generated/dsh/skills/devrites-lib/reference/candidate-integrity.md +59 -0
  164. package/pack/generated/dsh/skills/devrites-lib/reference/intent-map.md +86 -0
  165. package/pack/generated/dsh/skills/devrites-lib/reference/orchestration-profiles.md +48 -0
  166. package/pack/generated/dsh/skills/devrites-lib/reference/parallel-dispatch.md +184 -0
  167. package/pack/generated/dsh/skills/devrites-lib/reference/reply-contract.md +123 -0
  168. package/pack/generated/dsh/skills/devrites-lib/reference/standards/README.md +70 -0
  169. package/pack/generated/dsh/skills/devrites-lib/reference/standards/acceptance-preserving-reslice.md +32 -0
  170. package/pack/generated/dsh/skills/devrites-lib/reference/standards/afk-hitl.md +467 -0
  171. package/pack/generated/dsh/skills/devrites-lib/reference/standards/agents.md +231 -0
  172. package/pack/generated/dsh/skills/devrites-lib/reference/standards/anti-patterns.md +50 -0
  173. package/pack/generated/dsh/skills/devrites-lib/reference/standards/architecture-health.md +64 -0
  174. package/pack/generated/dsh/skills/devrites-lib/reference/standards/assumption-checkpoints.md +42 -0
  175. package/pack/generated/dsh/skills/devrites-lib/reference/standards/audit-coverage.md +107 -0
  176. package/pack/generated/dsh/skills/devrites-lib/reference/standards/browser-proof-checklist.md +37 -0
  177. package/pack/generated/dsh/skills/devrites-lib/reference/standards/ci-cd.md +62 -0
  178. package/pack/generated/dsh/skills/devrites-lib/reference/standards/code-index.md +111 -0
  179. package/pack/generated/dsh/skills/devrites-lib/reference/standards/code-navigation.md +69 -0
  180. package/pack/generated/dsh/skills/devrites-lib/reference/standards/code-review.md +178 -0
  181. package/pack/generated/dsh/skills/devrites-lib/reference/standards/coding-style.md +53 -0
  182. package/pack/generated/dsh/skills/devrites-lib/reference/standards/context-hygiene.md +136 -0
  183. package/pack/generated/dsh/skills/devrites-lib/reference/standards/core.md +202 -0
  184. package/pack/generated/dsh/skills/devrites-lib/reference/standards/data-integrity.md +144 -0
  185. package/pack/generated/dsh/skills/devrites-lib/reference/standards/debug-recovery.md +42 -0
  186. package/pack/generated/dsh/skills/devrites-lib/reference/standards/definition-of-done.md +25 -0
  187. package/pack/generated/dsh/skills/devrites-lib/reference/standards/deprecation.md +49 -0
  188. package/pack/generated/dsh/skills/devrites-lib/reference/standards/developer-experience.md +128 -0
  189. package/pack/generated/dsh/skills/devrites-lib/reference/standards/development-workflow.md +31 -0
  190. package/pack/generated/dsh/skills/devrites-lib/reference/standards/documentation.md +55 -0
  191. package/pack/generated/dsh/skills/devrites-lib/reference/standards/duplicate-code.md +129 -0
  192. package/pack/generated/dsh/skills/devrites-lib/reference/standards/edge-case-trace.md +94 -0
  193. package/pack/generated/dsh/skills/devrites-lib/reference/standards/elicitation.md +114 -0
  194. package/pack/generated/dsh/skills/devrites-lib/reference/standards/error-handling.md +49 -0
  195. package/pack/generated/dsh/skills/devrites-lib/reference/standards/gates.md +159 -0
  196. package/pack/generated/dsh/skills/devrites-lib/reference/standards/git-workflow.md +51 -0
  197. package/pack/generated/dsh/skills/devrites-lib/reference/standards/glossary.md +40 -0
  198. package/pack/generated/dsh/skills/devrites-lib/reference/standards/hooks.md +41 -0
  199. package/pack/generated/dsh/skills/devrites-lib/reference/standards/integration-reliability.md +121 -0
  200. package/pack/generated/dsh/skills/devrites-lib/reference/standards/loop-operations.md +123 -0
  201. package/pack/generated/dsh/skills/devrites-lib/reference/standards/observability.md +90 -0
  202. package/pack/generated/dsh/skills/devrites-lib/reference/standards/one-shot-actions.md +105 -0
  203. package/pack/generated/dsh/skills/devrites-lib/reference/standards/patterns.md +70 -0
  204. package/pack/generated/dsh/skills/devrites-lib/reference/standards/performance.md +88 -0
  205. package/pack/generated/dsh/skills/devrites-lib/reference/standards/principles.md +56 -0
  206. package/pack/generated/dsh/skills/devrites-lib/reference/standards/prose-style.md +127 -0
  207. package/pack/generated/dsh/skills/devrites-lib/reference/standards/release/ship-checklist.md +12 -0
  208. package/pack/generated/dsh/skills/devrites-lib/reference/standards/repository-topology.md +82 -0
  209. package/pack/generated/dsh/skills/devrites-lib/reference/standards/review/README.md +28 -0
  210. package/pack/generated/dsh/skills/devrites-lib/reference/standards/review/ci-workflows.md +50 -0
  211. package/pack/generated/dsh/skills/devrites-lib/reference/standards/review/default.md +42 -0
  212. package/pack/generated/dsh/skills/devrites-lib/reference/standards/review/go.md +47 -0
  213. package/pack/generated/dsh/skills/devrites-lib/reference/standards/review/python.md +46 -0
  214. package/pack/generated/dsh/skills/devrites-lib/reference/standards/review/react.md +55 -0
  215. package/pack/generated/dsh/skills/devrites-lib/reference/standards/review/shell.md +40 -0
  216. package/pack/generated/dsh/skills/devrites-lib/reference/standards/review/stack-profile.md +155 -0
  217. package/pack/generated/dsh/skills/devrites-lib/reference/standards/review/ts-js.md +74 -0
  218. package/pack/generated/dsh/skills/devrites-lib/reference/standards/review-checklist.md +14 -0
  219. package/pack/generated/dsh/skills/devrites-lib/reference/standards/security-checklist.md +30 -0
  220. package/pack/generated/dsh/skills/devrites-lib/reference/standards/security.md +283 -0
  221. package/pack/generated/dsh/skills/devrites-lib/reference/standards/skill-authoring.md +269 -0
  222. package/pack/generated/dsh/skills/devrites-lib/reference/standards/spec-grammar.md +214 -0
  223. package/pack/generated/dsh/skills/devrites-lib/reference/standards/test-proof-checklist.md +18 -0
  224. package/pack/generated/dsh/skills/devrites-lib/reference/standards/testing.md +295 -0
  225. package/pack/generated/dsh/skills/devrites-lib/reference/standards/tooling.md +125 -0
  226. package/pack/generated/dsh/skills/devrites-lib/reference/standards/verification-methods.md +143 -0
  227. package/pack/generated/dsh/skills/devrites-lib/reference/standards/windows.md +60 -0
  228. package/pack/generated/dsh/skills/devrites-lib/reference/standards/workflow-artifacts.md +435 -0
  229. package/pack/generated/dsh/skills/devrites-lib/reference/visual-playbooks/code.md +44 -0
  230. package/pack/generated/dsh/skills/devrites-lib/reference/visual-playbooks/comparison.md +42 -0
  231. package/pack/generated/dsh/skills/devrites-lib/reference/visual-playbooks/diagram.md +51 -0
  232. package/pack/generated/dsh/skills/devrites-lib/reference/visual-playbooks/index.md +66 -0
  233. package/pack/generated/dsh/skills/devrites-lib/reference/visual-playbooks/input.md +46 -0
  234. package/pack/generated/dsh/skills/devrites-lib/reference/visual-playbooks/outline-template.md +106 -0
  235. package/pack/generated/dsh/skills/devrites-lib/reference/visual-playbooks/plan.md +48 -0
  236. package/pack/generated/dsh/skills/devrites-lib/reference/visual-playbooks/slides.md +40 -0
  237. package/pack/generated/dsh/skills/devrites-lib/reference/visual-playbooks/table.md +42 -0
  238. package/pack/generated/dsh/skills/devrites-lib/reference/workspace-artifact-schema.md +312 -0
  239. package/pack/generated/dsh/skills/devrites-prose-craft/SKILL.md +81 -0
  240. package/pack/generated/dsh/skills/devrites-prose-craft/reference/banned-phrases.md +132 -0
  241. package/pack/generated/dsh/skills/devrites-prose-craft/reference/examples.md +136 -0
  242. package/pack/generated/dsh/skills/devrites-prose-craft/reference/structures.md +196 -0
  243. package/pack/generated/dsh/skills/devrites-source-driven/SKILL.md +54 -0
  244. package/pack/generated/dsh/skills/devrites-ux-shape/SKILL.md +135 -0
  245. package/pack/generated/dsh/skills/devrites-ux-shape/reference/brief-template.md +108 -0
  246. package/pack/generated/dsh/skills/devrites-ux-shape/reference/visual-direction-probe.md +50 -0
  247. package/pack/generated/dsh/skills/overhaul/SKILL.md +221 -0
  248. package/pack/generated/dsh/skills/overhaul/references/audit-domains.md +390 -0
  249. package/pack/generated/dsh/skills/overhaul/references/lifecycle.md +314 -0
  250. package/pack/generated/dsh/skills/overhaul/references/orchestration.md +291 -0
  251. package/pack/generated/dsh/skills/overhaul/references/records.md +203 -0
  252. package/pack/generated/dsh/skills/overhaul/references/repair-and-measurement.md +310 -0
  253. package/pack/generated/dsh/skills/overhaul/references/review-and-report.md +139 -0
  254. package/pack/generated/dsh/skills/overhaul/references/scope-and-safety.md +233 -0
  255. package/pack/generated/dsh/skills/overhaul/references/scoring.md +261 -0
  256. package/pack/generated/dsh/skills/overhaul/references/stack-profiles.md +316 -0
  257. package/pack/generated/dsh/skills/rite/SKILL.md +157 -0
  258. package/pack/generated/dsh/skills/rite/reference/menu.md +49 -0
  259. package/pack/generated/dsh/skills/rite-adopt/SKILL.md +64 -0
  260. package/pack/generated/dsh/skills/rite-adopt/reference/adoption.md +25 -0
  261. package/pack/generated/dsh/skills/rite-adopt/reference/anti-patterns.md +19 -0
  262. package/pack/generated/dsh/skills/rite-autocomplete/SKILL.md +167 -0
  263. package/pack/generated/dsh/skills/rite-autocomplete/reference/decision-policy.md +44 -0
  264. package/pack/generated/dsh/skills/rite-autocomplete/reference/lookahead.md +50 -0
  265. package/pack/generated/dsh/skills/rite-autocomplete/reference/loop.md +164 -0
  266. package/pack/generated/dsh/skills/rite-autocomplete/reference/stop-conditions.md +118 -0
  267. package/pack/generated/dsh/skills/rite-build/SKILL.md +126 -0
  268. package/pack/generated/dsh/skills/rite-build/reference/afk-discipline.md +153 -0
  269. package/pack/generated/dsh/skills/rite-build/reference/anti-patterns.md +27 -0
  270. package/pack/generated/dsh/skills/rite-build/reference/checkpoint-protocol.md +115 -0
  271. package/pack/generated/dsh/skills/rite-build/reference/checkpoint.md +79 -0
  272. package/pack/generated/dsh/skills/rite-build/reference/frontend-trigger.md +39 -0
  273. package/pack/generated/dsh/skills/rite-build/reference/one-slice-cycle.md +57 -0
  274. package/pack/generated/dsh/skills/rite-build/reference/output.md +29 -0
  275. package/pack/generated/dsh/skills/rite-build/reference/parallel-batch.md +260 -0
  276. package/pack/generated/dsh/skills/rite-build/reference/phase-contract.md +130 -0
  277. package/pack/generated/dsh/skills/rite-build/reference/spec-drift-guard.md +91 -0
  278. package/pack/generated/dsh/skills/rite-build/reference/tdd.md +27 -0
  279. package/pack/generated/dsh/skills/rite-build/reference/wright-dispatch.md +198 -0
  280. package/pack/generated/dsh/skills/rite-clarify/SKILL.md +104 -0
  281. package/pack/generated/dsh/skills/rite-clarify/reference/anti-patterns.md +24 -0
  282. package/pack/generated/dsh/skills/rite-clarify/reference/decision-coverage.md +56 -0
  283. package/pack/generated/dsh/skills/rite-converge/SKILL.md +167 -0
  284. package/pack/generated/dsh/skills/rite-converge/reference/anti-patterns.md +35 -0
  285. package/pack/generated/dsh/skills/rite-converge/reference/convergence-assessment.md +70 -0
  286. package/pack/generated/dsh/skills/rite-customize/SKILL.md +64 -0
  287. package/pack/generated/dsh/skills/rite-define/SKILL.md +203 -0
  288. package/pack/generated/dsh/skills/rite-define/reference/anti-patterns.md +26 -0
  289. package/pack/generated/dsh/skills/rite-define/reference/gates.md +160 -0
  290. package/pack/generated/dsh/skills/rite-define/reference/plan-template.md +153 -0
  291. package/pack/generated/dsh/skills/rite-doctor/SKILL.md +107 -0
  292. package/pack/generated/dsh/skills/rite-dogfood/SKILL.md +57 -0
  293. package/pack/generated/dsh/skills/rite-explain/SKILL.md +154 -0
  294. package/pack/generated/dsh/skills/rite-explain/reference/intake.md +89 -0
  295. package/pack/generated/dsh/skills/rite-fast/SKILL.md +185 -0
  296. package/pack/generated/dsh/skills/rite-fast/reference/artifacts.md +107 -0
  297. package/pack/generated/dsh/skills/rite-fast/reference/check-and-triage.md +51 -0
  298. package/pack/generated/dsh/skills/rite-frame/SKILL.md +119 -0
  299. package/pack/generated/dsh/skills/rite-frame/reference/failure-modes.md +66 -0
  300. package/pack/generated/dsh/skills/rite-handoff/SKILL.md +117 -0
  301. package/pack/generated/dsh/skills/rite-handoff/reference/handoff-template.md +56 -0
  302. package/pack/generated/dsh/skills/rite-harness/SKILL.md +76 -0
  303. package/pack/generated/dsh/skills/rite-harness/reference/feature-map.md +60 -0
  304. package/pack/generated/dsh/skills/rite-learn/SKILL.md +107 -0
  305. package/pack/generated/dsh/skills/rite-plan/SKILL.md +215 -0
  306. package/pack/generated/dsh/skills/rite-plan/reference/anti-patterns.md +34 -0
  307. package/pack/generated/dsh/skills/rite-plan/reference/dependency-graph.md +48 -0
  308. package/pack/generated/dsh/skills/rite-plan/reference/replan-and-repair.md +114 -0
  309. package/pack/generated/dsh/skills/rite-plan/reference/slicing.md +187 -0
  310. package/pack/generated/dsh/skills/rite-plan/reference/task-breakdown.md +50 -0
  311. package/pack/generated/dsh/skills/rite-polish/SKILL.md +128 -0
  312. package/pack/generated/dsh/skills/rite-polish/reference/adr-promotion.md +11 -0
  313. package/pack/generated/dsh/skills/rite-polish/reference/anti-ai-slop.md +210 -0
  314. package/pack/generated/dsh/skills/rite-polish/reference/anti-patterns.md +30 -0
  315. package/pack/generated/dsh/skills/rite-polish/reference/backend-polish.md +80 -0
  316. package/pack/generated/dsh/skills/rite-polish/reference/browser-polish-evidence.md +33 -0
  317. package/pack/generated/dsh/skills/rite-polish/reference/code.md +87 -0
  318. package/pack/generated/dsh/skills/rite-polish/reference/design-memory.md +117 -0
  319. package/pack/generated/dsh/skills/rite-polish/reference/design-system-discovery.md +8 -0
  320. package/pack/generated/dsh/skills/rite-polish/reference/harden-checklist.md +110 -0
  321. package/pack/generated/dsh/skills/rite-polish/reference/ledger.md +67 -0
  322. package/pack/generated/dsh/skills/rite-polish/reference/ui.md +146 -0
  323. package/pack/generated/dsh/skills/rite-pov/SKILL.md +71 -0
  324. package/pack/generated/dsh/skills/rite-pr-feedback/SKILL.md +61 -0
  325. package/pack/generated/dsh/skills/rite-pressure-test/SKILL.md +76 -0
  326. package/pack/generated/dsh/skills/rite-prototype/SKILL.md +106 -0
  327. package/pack/generated/dsh/skills/rite-prove/SKILL.md +151 -0
  328. package/pack/generated/dsh/skills/rite-prove/reference/acceptance-proof.md +88 -0
  329. package/pack/generated/dsh/skills/rite-prove/reference/anti-patterns.md +25 -0
  330. package/pack/generated/dsh/skills/rite-prove/reference/browser-proof.md +51 -0
  331. package/pack/generated/dsh/skills/rite-prove/reference/failure-triage.md +53 -0
  332. package/pack/generated/dsh/skills/rite-prove/reference/proof-ladder.md +39 -0
  333. package/pack/generated/dsh/skills/rite-prove/reference/test-command-discovery.md +36 -0
  334. package/pack/generated/dsh/skills/rite-quick/SKILL.md +97 -0
  335. package/pack/generated/dsh/skills/rite-resolve/SKILL.md +113 -0
  336. package/pack/generated/dsh/skills/rite-resolve/reference/answer-protocol.md +129 -0
  337. package/pack/generated/dsh/skills/rite-review/SKILL.md +190 -0
  338. package/pack/generated/dsh/skills/rite-review/reference/anti-patterns.md +32 -0
  339. package/pack/generated/dsh/skills/rite-review/reference/cognitive-load.md +90 -0
  340. package/pack/generated/dsh/skills/rite-review/reference/feature-scoped-review.md +26 -0
  341. package/pack/generated/dsh/skills/rite-review/reference/five-axis-review.md +66 -0
  342. package/pack/generated/dsh/skills/rite-review/reference/nielsen-heuristics.md +126 -0
  343. package/pack/generated/dsh/skills/rite-review/reference/performance-checklist.md +99 -0
  344. package/pack/generated/dsh/skills/rite-review/reference/performance-review.md +14 -0
  345. package/pack/generated/dsh/skills/rite-review/reference/security-review.md +44 -0
  346. package/pack/generated/dsh/skills/rite-seal/SKILL.md +99 -0
  347. package/pack/generated/dsh/skills/rite-seal/reference/anti-patterns.md +29 -0
  348. package/pack/generated/dsh/skills/rite-seal/reference/final-evidence.md +41 -0
  349. package/pack/generated/dsh/skills/rite-seal/reference/go-no-go.md +32 -0
  350. package/pack/generated/dsh/skills/rite-seal/reference/output.md +5 -0
  351. package/pack/generated/dsh/skills/rite-seal/reference/phase-contract.md +56 -0
  352. package/pack/generated/dsh/skills/rite-seal/reference/risk-and-rollback.md +56 -0
  353. package/pack/generated/dsh/skills/rite-seal/reference/seal-template.md +32 -0
  354. package/pack/generated/dsh/skills/rite-ship/SKILL.md +101 -0
  355. package/pack/generated/dsh/skills/rite-ship/reference/anti-patterns.md +28 -0
  356. package/pack/generated/dsh/skills/rite-ship/reference/close-out.md +69 -0
  357. package/pack/generated/dsh/skills/rite-ship/reference/git-ship.md +128 -0
  358. package/pack/generated/dsh/skills/rite-ship/reference/rollout.md +62 -0
  359. package/pack/generated/dsh/skills/rite-ship/reference/ship-template.md +40 -0
  360. package/pack/generated/dsh/skills/rite-spec/SKILL.md +169 -0
  361. package/pack/generated/dsh/skills/rite-spec/reference/acceptance-criteria.md +31 -0
  362. package/pack/generated/dsh/skills/rite-spec/reference/ai-spec-template.md +40 -0
  363. package/pack/generated/dsh/skills/rite-spec/reference/anti-patterns.md +27 -0
  364. package/pack/generated/dsh/skills/rite-spec/reference/interview-patterns.md +56 -0
  365. package/pack/generated/dsh/skills/rite-spec/reference/investigation.md +83 -0
  366. package/pack/generated/dsh/skills/rite-spec/reference/question-protocol.md +36 -0
  367. package/pack/generated/dsh/skills/rite-spec/reference/references-intake.md +62 -0
  368. package/pack/generated/dsh/skills/rite-spec/reference/spec-checklists.md +89 -0
  369. package/pack/generated/dsh/skills/rite-spec/reference/spec-template.md +160 -0
  370. package/pack/generated/dsh/skills/rite-spec/reference/state-workspace.md +240 -0
  371. package/pack/generated/dsh/skills/rite-status/SKILL.md +74 -0
  372. package/pack/generated/dsh/skills/rite-temper/SKILL.md +137 -0
  373. package/pack/generated/dsh/skills/rite-temper/reference/anti-patterns.md +30 -0
  374. package/pack/generated/dsh/skills/rite-temper/reference/review-dimensions.md +66 -0
  375. package/pack/generated/dsh/skills/rite-temper/reference/scope-modes.md +52 -0
  376. package/pack/generated/dsh/skills/rite-temper/reference/significance.md +55 -0
  377. package/pack/generated/dsh/skills/rite-temper/reference/strategy-template.md +101 -0
  378. package/pack/generated/dsh/skills/rite-upgrade/SKILL.md +142 -0
  379. package/pack/generated/dsh/skills/rite-vet/SKILL.md +242 -0
  380. package/pack/generated/dsh/skills/rite-vet/reference/anti-patterns.md +43 -0
  381. package/pack/generated/dsh/skills/rite-vet/reference/artifacts.md +248 -0
  382. package/pack/generated/dsh/skills/rite-vet/reference/cross-model.md +19 -0
  383. package/pack/generated/dsh/skills/rite-vet/reference/depth.md +59 -0
  384. package/pack/generated/dsh/skills/rite-vet/reference/eng-lenses.md +48 -0
  385. package/pack/generated/dsh/skills/rite-vet/reference/review-axes.md +210 -0
  386. package/pack/generated/dsh/skills/rite-watch-pr/SKILL.md +87 -0
  387. package/pack/generated/dsh/skills/rite-zoom-out/SKILL.md +76 -0
  388. package/pack/generated/omp/agents/devrites-upgrade-planner.md +12 -4
  389. package/pack/generated/omp/skills/devrites-debug-recovery/SKILL.md +21 -4
  390. package/pack/generated/omp/skills/devrites-debug-recovery/reference/cleanup-and-classify.md +10 -3
  391. package/pack/generated/omp/skills/devrites-debug-recovery/reference/regression-test.md +7 -4
  392. package/pack/generated/omp/skills/devrites-lib/reference/reply-contract.md +11 -11
  393. package/pack/generated/omp/skills/devrites-lib/reference/standards/afk-hitl.md +52 -56
  394. package/pack/generated/omp/skills/devrites-lib/reference/standards/agents.md +11 -1
  395. package/pack/generated/omp/skills/devrites-lib/reference/standards/core.md +41 -40
  396. package/pack/generated/omp/skills/rite-autocomplete/SKILL.md +12 -14
  397. package/pack/generated/omp/skills/rite-autocomplete/reference/loop.md +34 -38
  398. package/pack/generated/omp/skills/rite-autocomplete/reference/stop-conditions.md +38 -39
  399. package/pack/generated/omp/skills/rite-define/SKILL.md +28 -27
  400. package/pack/generated/omp/skills/rite-plan/SKILL.md +7 -2
  401. package/pack/generated/omp/skills/rite-plan/reference/replan-and-repair.md +5 -2
  402. package/pack/generated/omp/skills/rite-resolve/SKILL.md +17 -10
  403. package/pack/generated/omp/skills/rite-resolve/reference/answer-protocol.md +18 -6
  404. package/pack/generated/omp/skills/rite-review/SKILL.md +4 -4
  405. package/pack/generated/omp/skills/rite-review/reference/security-review.md +4 -2
  406. package/pack/generated/omp/skills/rite-seal/SKILL.md +28 -33
  407. package/pack/generated/omp/skills/rite-ship/SKILL.md +14 -7
  408. package/pack/generated/omp/skills/rite-temper/SKILL.md +18 -18
  409. package/pack/generated/omp/skills/rite-temper/reference/scope-modes.md +6 -7
  410. package/pack/generated/omp/skills/rite-upgrade/SKILL.md +7 -2
  411. package/pack/generated/omp/skills/rite-vet/SKILL.md +33 -34
  412. package/pack/generated/pi/agents/devrites-upgrade-planner.md +12 -4
  413. package/pack/generated/pi/skills/devrites-debug-recovery/SKILL.md +21 -4
  414. package/pack/generated/pi/skills/devrites-debug-recovery/reference/cleanup-and-classify.md +10 -3
  415. package/pack/generated/pi/skills/devrites-debug-recovery/reference/regression-test.md +7 -4
  416. package/pack/generated/pi/skills/devrites-lib/reference/reply-contract.md +11 -11
  417. package/pack/generated/pi/skills/devrites-lib/reference/standards/afk-hitl.md +52 -56
  418. package/pack/generated/pi/skills/devrites-lib/reference/standards/agents.md +11 -1
  419. package/pack/generated/pi/skills/devrites-lib/reference/standards/core.md +41 -40
  420. package/pack/generated/pi/skills/rite-autocomplete/SKILL.md +12 -14
  421. package/pack/generated/pi/skills/rite-autocomplete/reference/loop.md +34 -38
  422. package/pack/generated/pi/skills/rite-autocomplete/reference/stop-conditions.md +38 -39
  423. package/pack/generated/pi/skills/rite-define/SKILL.md +28 -27
  424. package/pack/generated/pi/skills/rite-plan/SKILL.md +7 -2
  425. package/pack/generated/pi/skills/rite-plan/reference/replan-and-repair.md +5 -2
  426. package/pack/generated/pi/skills/rite-resolve/SKILL.md +17 -10
  427. package/pack/generated/pi/skills/rite-resolve/reference/answer-protocol.md +18 -6
  428. package/pack/generated/pi/skills/rite-review/SKILL.md +4 -4
  429. package/pack/generated/pi/skills/rite-review/reference/security-review.md +4 -2
  430. package/pack/generated/pi/skills/rite-seal/SKILL.md +28 -33
  431. package/pack/generated/pi/skills/rite-ship/SKILL.md +14 -7
  432. package/pack/generated/pi/skills/rite-temper/SKILL.md +18 -18
  433. package/pack/generated/pi/skills/rite-temper/reference/scope-modes.md +6 -7
  434. package/pack/generated/pi/skills/rite-upgrade/SKILL.md +7 -2
  435. package/pack/generated/pi/skills/rite-vet/SKILL.md +33 -34
  436. package/package.json +3 -1
  437. package/scripts/build-host-artifacts.sh +6 -2
  438. package/scripts/dsh-generate.py +135 -0
  439. package/scripts/dsh-specialist.mjs +62 -0
  440. package/scripts/install-lib.sh +3 -1
@@ -1,7 +1,6 @@
1
1
  # The autocomplete loop: arm AFK, drive every phase
2
2
 
3
- Autocomplete sequences existing `/rite-*` workflows without pausing between
4
- routine phases. Acceptance-preserving Reslice authority is
3
+ Autocomplete chains existing `/rite-*` workflows without routine-phase pauses. Acceptance-preserving Reslice authority is
5
4
  `.agents/skills/devrites-lib/reference/standards/acceptance-preserving-reslice.md`.
6
5
 
7
6
  <!-- BEGIN RESLICE ROUTE-TO-ACTION -->
@@ -23,7 +22,7 @@ allow_gates: [advisory, validating]
23
22
  # notify: "<cmd>"
24
23
  ```
25
24
 
26
- Read an existing sentinel first. Preserve it byte-for-byte when valid, except
25
+ Read existing sentinel first. Preserve valid bytes, except
27
26
  when this invocation contains `--parallel N`: then write or replace only
28
27
  `max_parallel: N` and leave every other key unchanged. Stop if the sentinel is
29
28
  malformed. Do not stop because it names `max_slices` / `max_agents` /
@@ -41,10 +40,9 @@ remaining. AFK configuration itself stays unchanged.
41
40
 
42
41
  ### Admit each unattended cycle
43
42
 
44
- Before every phase, review fan-out, recovery, or writer dispatch: cheapest
43
+ Before each phase, review fan-out, recovery, or writer dispatch: cheapest
45
44
  readiness check first; reject overlap. Do not stop on `max_agents`,
46
- `max_minutes`, or `max_review_queue`. Count every leaf result. A new activation
47
- gets fresh activation-local counters but retains durable slice/recovery state.
45
+ `max_minutes`, or `max_review_queue`. Count every leaf result. New activations reset activation-local counters, retaining durable slice/recovery state.
48
46
 
49
47
  [Build return](../../rite-build/reference/output.md#caller-owned-continuation).
50
48
  Pass `--parallel N`; ignore leftover cap/headroom, remaining-0,
@@ -57,7 +55,7 @@ without recommendations, and Seal judgment (`slice: seal`) still pause.
57
55
 
58
56
  ## Phase arc
59
57
 
60
- Workspace files carry state; chat does not. Read and execute each phase skill:
58
+ Workspace files, not chat, carry state. Read/execute each phase skill:
61
59
 
62
60
  | Step | Phase | Completion / edge |
63
61
  | --- | --- | --- |
@@ -73,9 +71,8 @@ Workspace files carry state; chat does not. Read and execute each phase skill:
73
71
  | 10 | `$rite-seal` | GO/NO-GO; no Git |
74
72
  | 11 | `$rite-ship` | only after GO; `--ship` never authorizes Git; stop at literal-GO/native approval |
75
73
 
76
- Before advancing, check
77
- [stop-conditions.md](stop-conditions.md). After source edits, discard stale pass
78
- evidence. Re-read the active workspace before each phase. On a cold resume or
74
+ Check [stop-conditions.md](stop-conditions.md) before advancing. Discard stale
75
+ pass evidence after source edits. Re-read active workspace before each phase. On a cold resume or
79
76
  new activation, run `devrites-engine check regression <slug>`: `BLOCKED` names a
80
77
  durable fact lost since the last checkpoint — restore or route it through its
81
78
  owning phase before continuing; `unproven` does not block. After each phase's
@@ -92,37 +89,35 @@ step 10 does not end the run: leave the sealed workspace unshipped with its
92
89
  (`$rite-spec <parent>-<n> "<objective>"` from the parent's `decisions.md` sequence)
93
90
  and re-enter step 1. Spend one workspace per opened continuation.
94
91
 
95
- When that workspace already exists because a [lookahead](lookahead.md) session
96
- planned it, do not specify it again. Wait while `devrites-engine claim check
97
- --workspace <child>` exits 3 (a live lookahead holds it), then set
98
- `.devrites/ACTIVE` to the child and resume from its cursor at step 1. A
99
- predecessor replan since its Vet blocks the child's readiness with
100
- `DRV-GATE-READINESS-STALE`; route that to `$rite-vet` before Build.
101
-
102
- Spend accounting is durable in `state.md` cursors, not chat. Before invoking the
103
- continuation, ensure the current workspace's `sequence_workspaces_remaining` is
104
- set — absent, write `max_workspaces - 1` and `sequence_position: 1` first — and
105
- `> 0`. `$rite-spec` seeds the child's sequence cursor at creation per the
92
+ For a child already planned by [lookahead](lookahead.md), do not re-specify.
93
+ Wait while `devrites-engine claim check --workspace <child>` exits 3 (live
94
+ lookahead), then set `.devrites/ACTIVE` to the child and resume its cursor at
95
+ step 1. A predecessor replan since its Vet blocks child readiness with
96
+ `DRV-GATE-READINESS-STALE`; route to `$rite-vet` before Build.
97
+
98
+ Before invoking a continuation, require durable `state.md`
99
+ `sequence_workspaces_remaining > 0`; if absent, first write
100
+ `max_workspaces - 1` and `sequence_position: 1`. `$rite-spec` seeds the child's sequence cursor at creation per the
106
101
  [continuation contract](../../rite-plan/reference/slicing.md#continuation-workspaces);
107
- after the child's `state.md` exists, verify it — `sequence_parent` = the current
108
- slug, `sequence_position` = parent position + 1,
102
+ verify the created child's `state.md`: `sequence_parent` = current slug,
103
+ `sequence_position` = parent position + 1,
109
104
  `sequence_workspaces_remaining` = parent remaining − 1, and — when the recorded
110
105
  entry is the sequence's release milestone — `sequence_role: release` (gates then
111
- require the union manifest). On resume, a child whose
112
- fields are missing is re-seeded from its `brief.md` parent/position and the
113
- parent's counter (same values, never a second charge); a child with no recorded
114
- parent/position is not a sequence member and the chain stops.
115
-
116
- Stop instead when: no recorded next entry; the cap or review-queue bound is
117
- reached; a human-owned, safety, access, or parked-recovery stop fires; or Seal returns
118
- `NO-GO`. On stop, report the sequence position, the sealed-but-unshipped workspaces, and
119
- the single release command (`$rite-autocomplete <release milestone> --ship`, or
106
+ require the union manifest). On resume, re-seed missing child fields from its `brief.md` parent/position and
107
+ parent counter (same values, no second charge). No recorded parent/position
108
+ means no sequence membership: stop the chain.
109
+
110
+ Stop sequence continuation when: `continue_sequence: false`; no recorded next
111
+ entry (the final milestone); the `max_workspaces` cap is reached; or a genuine
112
+ human-owned, safety, access, or parked-recovery stop fires. `max_review_queue`
113
+ never stops Autocomplete; agent-owned Seal `NO-GO` enters recovery, not a handoff.
114
+ Intermediate sealed milestones continue without `--ship` and without Git mutation. On stop, report sequence position, sealed/unshipped workspaces, and
115
+ one release command (`$rite-autocomplete <release milestone> --ship`, or
120
116
  `$rite-ship` for the current sealed workspace when the sequence is complete).
121
117
 
122
118
  ## Backtrack without handing off
123
119
 
124
- The active Autocomplete root remains caller whenever a later phase exposes an
125
- agent-owned earlier-phase gap:
120
+ Autocomplete remains caller for agent-owned earlier-phase gaps:
126
121
 
127
122
  1. Save the originating phase/action unless a valid native return cursor exists.
128
123
  2. On cold resume, reconcile the terminal cursor against durable fingerprint
@@ -152,6 +147,8 @@ and park it after three escalations while independent work continues.
152
147
 
153
148
  ## Continuous caller obligation
154
149
 
150
+ Green slice/phase checkpoints consume their recorded `next_action` internally;
151
+ only the caller replies finally at completion or a genuine stop.
155
152
  No user-facing reply is permitted while durable state contains agent-owned
156
153
  `NEEDS_REPLAN`, an intermediate Plan/Vet action, a distinct retained
157
154
  Critical/Important fingerprint below its cap or with an escalation left, runnable
@@ -162,7 +159,6 @@ already names a ranked recommended option. Invoke the next internal repair or
162
159
  `state resolve` exits 1 on every call and the loop re-invokes it without end. A narrow reviewer closing one finding and exposing another
163
160
  Critical/Important invariant is progress, not exhaustion.
164
161
 
165
- The number of completed repair/Vet cycles is not a stop condition. Context
166
- pressure, compaction, session duration, and nested completion do not convert an
167
- internal checkpoint into a handoff. Persist it and resume until the requested
168
- rest point or a shared human/safety/access/parked-recovery condition.
162
+ The number of completed repair/Vet cycles, context pressure, compaction, session
163
+ duration, and nested completion never turn checkpoints into handoffs. Persist and
164
+ resume to the requested rest point or shared human/safety/access/parked-recovery stop.
@@ -1,9 +1,8 @@
1
1
  # Stop conditions: when autocomplete pauses
2
2
 
3
- On a real stop, write `state.md` as `awaiting_human` or `blocked`, persist the
4
- reason, and include one resume command. Agent-owned recovery never ends the run:
5
- a spent strategy escalates and a fully escalated fingerprint parks while other
6
- work continues ([retry contract](../../devrites-lib/reference/standards/afk-hitl.md#retry-cap-no-progress-loops-and-self-resolve)).
3
+ On real stops, persist `state.md` `awaiting_human` or `blocked`, reason, and one
4
+ resume command. Agent-owned recovery never ends the run: spent strategies
5
+ escalate; fully escalated fingerprints park while other work continues ([retry contract](../../devrites-lib/reference/standards/afk-hitl.md#retry-cap-no-progress-loops-and-self-resolve)).
7
6
  `--ship` never bypasses a stop.
8
7
 
9
8
  Authority: `.agents/skills/devrites-lib/reference/standards/acceptance-preserving-reslice.md`.
@@ -16,7 +15,7 @@ Authority: `.agents/skills/devrites-lib/reference/standards/acceptance-preservin
16
15
 
17
16
  ## Always stop
18
17
 
19
- Regardless of flags or AFK ceiling:
18
+ Flags/AFK ceiling never override:
20
19
 
21
20
  - destructive data migration;
22
21
  - auth/authz boundary change;
@@ -24,8 +23,8 @@ Regardless of flags or AFK ceiling:
24
23
  - external-service contract change; or
25
24
  - filesystem destruction outside the workspace.
26
25
 
27
- Red proof cannot advance. Run bounded Debug Recovery and escalate spent
28
- strategies; a fully escalated fingerprint parks unless the remaining owner is human.
26
+ Red proof cannot advance. Run bounded Debug Recovery; escalate spent strategies.
27
+ Fully escalated fingerprints park unless remaining owner is human.
29
28
 
30
29
  ## Not stops: internal technical routing
31
30
 
@@ -34,13 +33,12 @@ forward work, persists the return cursor, and invokes Plan repair plus Recovery
34
33
  Vet inline. The same applies to nested `STOP`/`Next step` when its decision is
35
34
  agent-owned.
36
35
 
37
- Agent-owned backtracking is not a stop condition while the exact causal
38
- fingerprint has budget. Invoke the earlier phase, affected Vet, remediation, and
39
- proof; then resume the origin. Three no-progress corrections of that exact
40
- fingerprint spend only its current strategy: escalate to the next correction
41
- class inline (shared root cause, diagnostic amplification, boundary redesign)
42
- with a fresh budget, never asking permission. After three escalations in this
43
- activation the fingerprint parks; finish all independent work, then stop once.
36
+ Agent-owned backtracking is not a stop condition while its exact causal
37
+ fingerprint has budget: invoke earlier phase, affected Vet, remediation, proof;
38
+ resume origin. Three no-progress corrections spend only that fingerprint's current
39
+ strategy: escalate inline to the next class (shared root cause, diagnostic
40
+ amplification, boundary redesign) with fresh budget, without permission. After
41
+ three escalations per activation it parks; finish independent work, then stop once.
44
42
  Preserve reproduction, attempts, and dead ends; never offer `$rite-plan unblock`
45
43
  or another routine phase command. A new user-issued `$rite-autocomplete`
46
44
  reopens parked fingerprints with fresh escalation; wakes and compaction do not.
@@ -52,11 +50,10 @@ It blocks another execution; retained new Critical/Important evidence still
52
50
  enters offline recovery. After affected Vet is READY, pause for fresh action
53
51
  authorization and never reuse old GO.
54
52
 
55
- Past evidence being irretrievable is not by itself terminal. If an in-scope
56
- trusted seam can uniquely discriminate the next failure, run diagnostic-
57
- amplification Plan repair and narrow Vet inline, then pause for fresh GO before
58
- one evidence-acquisition attempt. Without a safe seam, escalate to the next
59
- class or park; only a real human/risk/scope gate stops for a human.
53
+ Past evidence being irretrievable is not by itself terminal. If an in-scope trusted seam
54
+ uniquely discriminates the next failure, run diagnostic-amplification Plan repair
55
+ and narrow Vet inline; pause for fresh GO before one evidence-acquisition attempt.
56
+ Without a safe seam, escalate or park; only a real human/risk/scope gate stops for a human.
60
57
 
61
58
  <!-- workflow-artifact-adapter: {"module":"devrites-lib/reference/standards/workflow-artifacts.md","entry":"classifier returns owner-busy, exhausted, or existing hard gate","action":"escalate BLOCKED_EXHAUSTED; on WAIT_ACTIVE_OWNER run independent work and recheck; stop on exact BLOCKED_GATE result","return":"unchanged cursor plus fixed route-owned output"} -->
62
59
  ## Other stop classes
@@ -76,10 +73,9 @@ class or park; only a real human/risk/scope gate stops for a human.
76
73
  - **Clarify:** material `open`/unowned decision coverage or a
77
74
  low-confidence high-consequence assumption. Continue the initial interview;
78
75
  never arm AFK early.
79
- - **Seal:** remaining NO-GO after recommended-option questions are closed, with
80
- every remaining blocker and fix direction. Never round up to GO. An open
81
- recommended-option blocking question is not a Seal stop: resolve it, recover
82
- agent-owned findings, then re-enter Seal. A first NO-GO is not a stop either:
76
+ - **Seal:** report remaining NO-GO with every blocker/fix direction; never round
77
+ up to GO. Resolve recommended-option blocking questions internally; recover
78
+ agent-owned findings and re-enter Seal. A first NO-GO is not a stop:
83
79
  recover every agent-owned blocker (missing or unbound proof, a reviewer gap root
84
80
  can close, a finding with a fix direction, a missing `review.md` verdict), then
85
81
  re-enter Seal. The unattended `N` to accepting Important risks means repair, not
@@ -97,23 +93,26 @@ class or park; only a real human/risk/scope gate stops for a human.
97
93
  - **Resource envelope:** overlapping run or missing AFK after arm still stops.
98
94
  Do not stop on `--max-slices`, `max_agents`, `max_minutes`, or `max_review_queue`.
99
95
  - **Confidence:** intent still cannot become testable acceptance after interview.
100
- - **Repeated failure:** not a stop. Escalate; a fully escalated fingerprint parks,
101
- and the run stops only once no independent work remains.
102
- - **Resolver failure:** `devrites-engine state resolve` not found, or nonzero exit.
103
- Never hand-edit `questions.md`/`state.md` in its place. Not found stops at once;
104
- nonzero allows one identical re-run (the fingerprint is command + exit code +
105
- decisive stderr line; an unchanged re-run is not a correction, so no further
106
- attempts). Then stop `blocked` with the exact command, exit code, and stderr line,
107
- and resume action `$rite-doctor`.
96
+ - **Repeated failure:** not a stop. Escalate; fully escalated fingerprints park.
97
+ Stop only when no independent work remains.
98
+ - **Resolver failure:** `devrites-engine state resolve` missing or nonzero.
99
+ Never hand-edit `questions.md`/`state.md` instead. Missing stops immediately;
100
+ nonzero permits one identical re-run (fingerprint: command + exit code + decisive
101
+ stderr line; unchanged re-run is no correction, no further attempts). Then stop
102
+ `blocked`: exact command, exit code, stderr line; resume via `$rite-doctor`.
108
103
 
109
104
  ## Final GO and durable stop
110
105
 
111
- `--ship`/`--yolo` never authorizes Git. With a flag, complete Ship preflight,
112
- disclose the exact plan, and stop for literal `GO` plus native approval. Without
113
- one, stop at Seal GO with `$rite-ship`. Seal GO, AFK, prior approval, and flags
114
- never satisfy Ship approval.
106
+ With a recorded continuation, no opt-out, and workspace budget, Seal GO stays
107
+ internal: continue without `--ship`, leaving milestones sealed/unshipped. Only the
108
+ final milestone, explicit `continue_sequence: false`, or exhausted sequence cap
109
+ ends green sequence continuation.
115
110
 
116
- A cold-resumable stop records `state.md` status, exact reason, and one resume
117
- action: the human-owned action, or `$rite-autocomplete` to reopen parked
118
- fingerprints; the owning question/drift/seal entry explains it. The user-facing line says what stopped
119
- and, only when applicable, what human action resumes it.
111
+ There, `--ship`/`--yolo` requires [Ship preflight](../../rite-ship/reference/git-ship.md#before-type-go):
112
+ disclose exact plan; stop for fresh literal `GO` plus native approval.
113
+ Without flags, stop at Seal GO with `$rite-ship`. Seal GO never authorizes Git
114
+ or satisfies Ship approval; neither do AFK, prior approval, or flags.
115
+
116
+ Record cold-resumable `state.md` stops: status, exact reason, one resume action
117
+ (human-owned or `$rite-autocomplete` to reopen parked fingerprints). Explain in
118
+ owning question/drift/seal entry. Tell user what stopped and any required human action.
@@ -147,21 +147,18 @@ Pull these via `Read` when shaping the plan:
147
147
  cross-slice boundary names producer, consumer, invariant, integration step, and proof.
148
148
  Map each applicable topology/data/integration risk to a slice, failure/recovery path,
149
149
  and discriminating proof; a risk cannot live only in the architecture narrative.
150
- 4a. **Persist traceability natively.** The drafter proposes and root writes
150
+ 4a. **Persist traceability natively.** Drafter proposes; root writes
151
151
  `traceability.md` (`AC/REQ ID → slice → proof → evidence ID → files → status`).
152
- Re-read spec, tasks, and proof fields: every ID must exist and every mapping
153
- preserve meaning, not just labels. Reject orphans, inventions, and false mappings;
154
- `$rite-prove` and `$rite-seal` read this file directly. Reference the plan's
155
- `Shared contract proof` rows from existing slice/proof mappings; do not create a second
156
- traceability system.
157
- 5. **Complexity and deviations gate:** justify anything outside DevRites defaults (new dep,
158
- extra abstraction, second design system) in the plan; if you can't justify it, simplify.
159
- **Principles conformance:** read `.devrites/principles.md` (if present) and confirm the
160
- approach honors every declared invariant. A plan that conflicts with one is not "a deviation
161
- to justify away": either reshape the approach to conform, or, when the conflict is genuine and
162
- intended, route it through the Spec Drift Guard plus a recorded decision and a scoped principle
163
- exception a human approves. Never ready a plan that silently violates an invariant. (Re-scored
164
- as a blocking gate at `$rite-vet`; no file → none declared → nothing to check.)
152
+ Re-read spec/tasks/proof: require real IDs, meaning-preserving mappings, not
153
+ just labels. Reject orphans/inventions/false mappings. `$rite-prove` and
154
+ `$rite-seal` read it directly. Reference plan `Shared contract proof` rows from
155
+ existing slice/proof mappings; never create a second traceability system.
156
+ 5. **Complexity and deviations gate:** justify deviations from DevRites defaults
157
+ (new dep, extra abstraction, second design system) in plan; else simplify.
158
+ **Principles conformance:** honor all `.devrites/principles.md` invariants
159
+ (absent → none). Reshape conflicts; intended genuine conflicts need Spec Drift
160
+ Guard, a recorded decision, and a human-approved scoped principle exception.
161
+ Never ready silent violations; `$rite-vet` re-scores this blocking gate.
165
162
  6. **Write** `architecture.md`, `plan.md`, `tasks.md`, and `traceability.md` — save the
166
163
  accepted bundle under `packets/` and apply it with `devrites-engine state
167
164
  apply-bundle <slug> <bundle.json>` before root reconciliation edits; update
@@ -169,27 +166,31 @@ Pull these via `Read` when shaping the plan:
169
166
  `flows.md` (**Mermaid-first**). If a richer reviewable visual earns it, emit
170
167
  `visual/<flow>.html` + `visual/<flow>.outline.md` after loading matching playbooks from
171
168
  [`../devrites-lib/reference/visual-playbooks/index.md`](../devrites-lib/reference/visual-playbooks/index.md)
172
- (progressive; never preload all seven), link the pair from `flows.md`, treat outline as
173
- SSOT (outline wins), and never require Lavish or a new phase.
174
- 6a. **Cross-artifact gate.** Read spec, tasks, and traceability together: every
175
- buildable AC/REQ maps to an existing slice/proof, every slice maps to real
176
- acceptance, and names/prose agree. Missing, duplicate, contradictory, or
177
- meaning-changing mappings block. Then run
169
+ (progressive; never preload all seven), link both from `flows.md`; outline is
170
+ SSOT (wins). No Lavish or new phase required.
171
+ 6a. **Cross-artifact gate.** Read spec/tasks/traceability together: each buildable
172
+ AC/REQ maps to existing slice/proof; each slice maps to real acceptance;
173
+ names/prose agree. Missing, duplicate, contradictory, or meaning-changing
174
+ mappings block. Run
178
175
  `devrites-engine check task-graph <slug> --strict`; a malformed dependency graph, or a
179
176
  shared path written by `hubAdvisoryMin`+ slices with no `Serial rationale:`, blocks
180
- before Vet rather than spending a reviewer context on invalid tasks. Resolve each
177
+ before Vet; no reviewer context for invalid tasks. Resolve each
181
178
  `ADVISORY size:`/`hub:`/`chain:` line now (split or seam slice, or a rationale);
182
179
  `--strict` refuses the contended plan, the default run only advises.
183
180
  7. **Readiness gate** (`plan-template.md`): require CLEAR coverage; complete acceptance,
184
181
  wiring, shared-contract proof, applicable outputs, and rollback; risk-first acyclic order;
185
182
  justified deviations; and every horizon item present, with blockers resolved, planning
186
183
  items resolved/validly spiked, and local/action entries bounded and owned.
187
- **Stop and confirm** before code. Render the review-before-code
188
- digest first: `Intent` (one sentence from the spec), `Done means` (acceptance coverage x/y),
189
- `Plan sanity` (slice count + riskiest boundary/gate), `Expected build interruptions`
190
- (`none` or only justified action-time gates), and `Build exactly this?` (yes → approve;
191
- no → `$rite-plan revise`). When the human confirms the plan, write `Plan approved: <iso>` to
192
- `state.md` (see [state-workspace](../rite-spec/reference/state-workspace.md)).
184
+ **Standalone: stop and confirm** before code. Render digest: `Intent` (one
185
+ spec sentence), `Done means` (AC coverage x/y), `Plan sanity` (slice count +
186
+ riskiest boundary/gate), `Expected build interruptions` (`none` or justified
187
+ action-time gates), `Build exactly this?` (yes → approve; no → `$rite-plan revise`).
188
+ Human confirmation writes `Plan approved: <iso>` to `state.md`
189
+ ([state-workspace](../rite-spec/reference/state-workspace.md)).
190
+ Under active `$rite-autocomplete`, once this readiness gate is green and no
191
+ unresolved human-owned decision, irreversible-risk, scope, or access gate remains,
192
+ root writes autonomous approval to existing `Plan approved: <iso>` cursor and records Autocomplete provenance and rationale in `decisions.md`;
193
+ never claim human approval. Return internally for `$rite-vet`. Plan approval grants no protected-path, Git, or safety authority.
193
194
 
194
195
  ## tasks.md slice format
195
196
 
@@ -172,8 +172,13 @@ Before classifying any Reslice, read `.agents/skills/devrites-lib/reference/stan
172
172
  the previous vet verdict: set `Phase: plan`, `Next step: $rite-vet`, and, when
173
173
  `eng-review.md` exists, set `Implementation readiness: NEEDS REPLAN`. Never retain READY
174
174
  across changed planning inputs. Preserve `Plan approved` only for behavior/acceptance-neutral
175
- technical repair; clear it for a contract-changing or newly blocking horizon item and
176
- reconfirm only after Clarify and Vet close it. If you stopped for drift,
175
+ technical repair; clear it for a contract-changing or newly blocking horizon item.
176
+ Settle human decisions and restore current `CLEAR` coverage through Clarify,
177
+ then obtain renewed Plan approval BEFORE Vet using only
178
+ [`rite-define`'s readiness/approval rule](../rite-define/SKILL.md), not its initial
179
+ decomposition. Under active Autocomplete, retain that rule's explicit autonomous
180
+ provenance in `decisions.md` — never claim human approval. Approval grants no
181
+ protected-path, Git, or safety authority. If you stopped for drift,
177
182
  mark the `drift.md` entry resolved. Never remove or overwrite a valid caller
178
183
  return cursor while writing the Plan checkpoint.
179
184
  6. After editing `brief.md`, `spec.md`, `decisions.md`, `assumptions.md`, or `questions.md`,
@@ -19,8 +19,11 @@ First (or fresh) breakdown into vertical slices. Use `task-breakdown.md` +
19
19
 
20
20
  A slice proved too large (couldn't build+prove in one cycle, or its goal has multiple
21
21
  "and"s). Split into thinner end-to-end slices, preserving acceptance coverage: split
22
- **by the sizing rule, not to a target count**. Update `tasks.md`; renumber; fix
23
- dependency edges.
22
+ **by the sizing rule, not to a target count**. Update `tasks.md` under the canonical
23
+ [ID contract](../../devrites-lib/reference/workspace-artifact-schema.md#id-contract):
24
+ preserve unaffected IDs; never renumber or fill retired gaps. New meanings get the
25
+ next unused IDs; record relationships in `decisions.md` or `drift.md` before updating
26
+ downstream dependency edges and traceability.
24
27
 
25
28
  ## repair (after Spec Drift Guard)
26
29
 
@@ -39,9 +39,11 @@ Pull these via `Read` when shaping the resolve:
39
39
  - **Never overwrite an answered question.** If the qid's `status` is `answered` or
40
40
  `dropped`, refuse with the existing answer; ask the user to open a new qid that
41
41
  references the old one (the file is the audit trail).
42
- - **If the answer materially changes scope, architecture, or acceptance**, route it
43
- through the Spec Drift Guard (`$rite-plan repair`) **after** writing the answer: do
44
- not modify `spec.md` / `plan.md` inside this skill.
42
+ - **Phase-aware handoff after writing the answer:** before planning artifacts exist,
43
+ recommend the current phase owner's action emitted by `state resolve` (for example,
44
+ `$rite-spec`), not Plan repair. Once a plan exists, material scope, architecture,
45
+ or acceptance changes route through the Spec Drift Guard (`$rite-plan repair`).
46
+ Never modify `spec.md` / `plan.md` inside this skill.
45
47
  - **The script is the source of truth.** Always invoke
46
48
  `devrites-engine state resolve`. It keeps `questions.md` + `state.md` consistent and emits the
47
49
  next-action recommendation. The one `state.md` field this skill may write by hand is the
@@ -66,8 +68,9 @@ Pull these via `Read` when shaping the resolve:
66
68
  - `--batch <plain-text-file>`: bulk resolve, one entry per qid (see
67
69
  [`reference/answer-protocol.md`](reference/answer-protocol.md) for the batch
68
70
  format).
69
- 2. **Load context.** Read `state.md`, `questions.md`, and the relevant slice from
70
- `tasks.md`. Confirm the qid is `status: open`. If `state.md` `Status` is not
71
+ 2. **Load context.** Read `state.md` and `questions.md`; require the relevant slice
72
+ from `tasks.md` only for an actual `SLICE-###` question, not `slice: spec | plan`.
73
+ Confirm the qid is `status: open`. If `state.md` `Status` is not
71
74
  `awaiting_human` and the question's `gate` is `blocking`, surface the inconsistency
72
75
  before proceeding (don't auto-repair: flag it).
73
76
  3. **Apply explicit consent.** Supplying `<qid> "<answer>"`, `--drop`, or `--batch` is the
@@ -86,13 +89,16 @@ Pull these via `Read` when shaping the resolve:
86
89
  writer left them.
87
90
  **Completion:** zero exit, or the failure reported with no hand edit.
88
91
 
89
- On resume, and only after a zero exit, also clear or update the unblocked slice's `Slice mode` in `state.md`: if
92
+ On resume, only for an actual `SLICE-###` question and after a zero exit, clear or
93
+ update the unblocked slice's `Slice mode` in `state.md`: if
90
94
  the answer lets the slice proceed, drop the pause-time `Slice mode` so `$rite-build`
91
95
  re-derives it on the next selection; if the answer re-shapes how the slice should be
92
96
  built, set `Slice mode` to match.
93
- 5. **Post-resolve hand-off.** If the answer changes product behavior or acceptance →
94
- recommend `$rite-plan repair`. Otherwise → recommend the slice's natural next action
95
- (typically `$rite-build` for the slice that was awaiting).
97
+ 5. **Post-resolve hand-off.** Before planning artifacts exist, recommend the emitted
98
+ phase-native next action (for example, `$rite-spec`); do not require or create a plan.
99
+ Once a plan exists, material scope, architecture, behavior, or acceptance changes →
100
+ recommend `$rite-plan repair` through the Spec Drift Guard. Otherwise → recommend
101
+ the emitted phase-native next action (typically `$rite-build` for a waiting slice).
96
102
  **Completion:** the resolved state contains exactly one next command.
97
103
  6. **STOP.** User-invoked `$rite-resolve` does not run `$rite-build` itself: the
98
104
  user re-enters the workflow explicitly. A controlling `$rite-autocomplete`
@@ -101,6 +107,7 @@ Pull these via `Read` when shaping the resolve:
101
107
  already names a ranked recommended option.
102
108
 
103
109
  > **Mid-flight discipline.** Don't edit `spec.md` / `plan.md` to "incorporate" the
104
- > answer. That's `$rite-plan repair`. Don't silently retry a build after the answer
110
+ > answer. Before planning artifacts exist, return to the emitted current phase owner;
111
+ > once a plan exists, material changes need `$rite-plan repair`. Don't silently retry a build after the answer
105
112
  > lands: the user types the next command. Don't merge two open questions into one
106
113
  > answered entry: each question is independently auditable.
@@ -87,12 +87,23 @@ writes one block at a time and pauses. When `$rite-resolve` matches the block's
87
87
 
88
88
  If `state.md`'s `Status` is `awaiting_human` but no `Awaiting human` block matches the
89
89
  qid (drift between the two files), `$rite-resolve` flags the inconsistency and refuses
90
- to silently fix it. Use `$rite-plan repair` to reconcile.
90
+ to silently fix it. Report it to the current phase owner; once a plan exists,
91
+ reconciliation uses `$rite-plan repair`.
92
+
93
+ ## Phase-aware handoff and slice context
94
+
95
+ Read `tasks.md` and update `Slice mode` only for an actual `SLICE-###` question,
96
+ never for `slice: spec | plan`; the update is allowed only after the writer exits zero.
97
+ Before planning artifacts exist, recommend the current phase owner's action emitted
98
+ by `state resolve` (for example, `$rite-spec`), not Plan repair. Never create planning
99
+ artifacts as part of Resolve.
91
100
 
92
101
  If the answer materially changes spec/plan, **do not** edit `spec.md` or `plan.md` inside
93
- `$rite-resolve`. That's `$rite-plan repair`'s job. The skill's post-resolve hand-off
94
- recommends `$rite-plan repair` whenever the answer touches acceptance criteria, scope,
95
- or architecture.
102
+ `$rite-resolve`. Once a plan exists, material acceptance, behavior, scope, or architecture
103
+ changes route through the Spec Drift Guard (`$rite-plan repair`); otherwise retain the
104
+ emitted phase-native next action. User-invoked resolutions use `state resolve --human`;
105
+ an internal Autocomplete caller uses the same writer without `--human` and continues.
106
+ Resolve itself never auto-runs the recommended phase owner.
96
107
 
97
108
  ## Multi-question awaiting
98
109
 
@@ -109,8 +120,9 @@ This shape is reserved: current `$rite-build` writes one question per pause.
109
120
 
110
121
  The user types the next command explicitly. Reasons:
111
122
 
112
- 1. The answer may need a `$rite-plan repair` first; auto-continuing would build against
113
- a stale plan.
123
+ 1. Before planning artifacts exist, the emitted current phase owner must resume;
124
+ once a plan exists, material changes may need `$rite-plan repair` first.
125
+ Auto-continuing a build would skip that owner or use a stale plan.
114
126
  2. The user may want to `$rite-status` before resuming.
115
127
  3. Atomicity: one verb, one mutation. Chaining is a hidden side-effect that hides bugs.
116
128
 
@@ -32,7 +32,7 @@ Pull these via `Read` when the diff demands them:
32
32
  - [`principles.md`](../devrites-lib/reference/standards/principles.md): declared project invariants (`.devrites/principles.md`); a diff that violates one with no recorded exception is a Critical, blocking finding.
33
33
  - [`testing.md`](../devrites-lib/reference/standards/testing.md): confirm that passing tests actually prove the spec.
34
34
  - [`agents.md`](../devrites-lib/reference/standards/agents.md): when to fan out to which review subagent.
35
- - [`security.md`](../devrites-lib/reference/standards/security.md): when input / auth / data / integrations / secrets are in scope.
35
+ - [`security.md`](../devrites-lib/reference/standards/security.md): when the shared [`parallel-dispatch.md`](../devrites-lib/reference/parallel-dispatch.md#roster) roster triggers the security auditor.
36
36
  - [`security-checklist.md`](../devrites-lib/reference/standards/security-checklist.md): for the same security-sensitive scope, the compact trust-boundary sweep.
37
37
  - [`repository-topology.md`](../devrites-lib/reference/standards/repository-topology.md), [`data-integrity.md`](../devrites-lib/reference/standards/data-integrity.md), [`integration-reliability.md`](../devrites-lib/reference/standards/integration-reliability.md): only
38
38
  when the spec applicability map or final diff triggers their ownership/failure/proof checks.
@@ -139,9 +139,9 @@ Pull these via `Read` when the diff demands them:
139
139
  [performance-checklist](reference/performance-checklist.md)). No UI/route/style
140
140
  paths: record `Not-applicable: no relevant paths in diff`.
141
141
  5. **Security:** `devrites-security-auditor`
142
- ([security-review](reference/security-review.md)) joins the step-3 cohort when
143
- input, auth, data,
144
- secrets, or permissions are in the diff; else `Not-applicable: no relevant paths in diff`.
142
+ ([security-review](reference/security-review.md)) joins the step-3 cohort under the
143
+ canonical [parallel-dispatch roster trigger](../devrites-lib/reference/parallel-dispatch.md#roster),
144
+ including a dependency-only diff; else `Not-applicable: no relevant paths in diff`.
145
145
  6. **Performance:** `devrites-performance-reviewer`
146
146
  ([performance-review](reference/performance-review.md),
147
147
  [performance-checklist](reference/performance-checklist.md)) joins the step-3 cohort
@@ -1,7 +1,9 @@
1
1
  # Security review (feature-scoped)
2
2
 
3
- Apply when the feature involves user input, auth/authz, data storage, external
4
- integrations, secrets, or permissions. Delegates to `devrites-audit security`.
3
+ Use the canonical [parallel-dispatch roster trigger](../../devrites-lib/reference/parallel-dispatch.md#roster),
4
+ including dependency and integration changes. A dependency-only diff still requires
5
+ `devrites-security-auditor`; a docs-only diff with no matching surfaces records
6
+ `Not-applicable: no relevant paths in diff`. Delegates to `devrites-audit security`.
5
7
 
6
8
  ## OWASP-Top-10-oriented checks
7
9