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
@@ -2,14 +2,12 @@
2
2
 
3
3
  > Applies when: always; every workspace rite reads it first.
4
4
 
5
- Each workspace rite reads core first. Its `loads:` manifest `always` set is its required
6
- read-set (`devrites-engine context --skills-root .pi/skills <slug> --skill <name>` where a workspace exists, else
7
- read the listed files); a trigger's files load when its named condition holds. Load any
8
- other rule file from `README.md` on demand.
5
+ Read core first, then the `loads:` manifest `always` set (via
6
+ `devrites-engine context --skills-root .pi/skills <slug> --skill <name>` with a workspace, else listed files).
7
+ Load trigger files when their named condition holds; other `README.md` rules on demand.
9
8
 
10
- Rules are cited as `core.md #N` (CORE-N). Numbering is stable: text may be
11
- reworded, an ID never changes meaning. Other files name the ID instead of
12
- repeating the rule.
9
+ Cite rules as `core.md #N` (CORE-N), not repeated text. IDs keep their meaning
10
+ even when reworded.
13
11
 
14
12
  Uppercase MUST/MUST NOT/SHOULD/SHOULD NOT/MAY carry RFC 2119 meaning: MUST is a gate;
15
13
  a SHOULD deviation records its reason in `decisions.md` (the exception procedure); MAY
@@ -20,9 +18,9 @@ Repository conventions follow [Precedence](#precedence).
20
18
 
21
19
  ## Operating rules (every phase)
22
20
 
23
- 1. **Right step, right time:** use the smallest workflow and load only relevant
24
- files. Batch independent reads and cover the relevant code, not just the first
25
- match. Prefer an available code index for structure; see
21
+ 1. **Right step, right time:** use the smallest workflow/relevant read-set. Batch
22
+ independent reads; cover relevant code beyond the first match. Prefer an
23
+ available structural code index; see
26
24
  [`tooling.md`](tooling.md) and [`code-index.md`](code-index.md).
27
25
  2. **No silent assumptions:** surface material assumptions; ask when the answer
28
26
  changes scope, architecture, data model, UX, security, migration risk, or
@@ -32,12 +30,14 @@ Repository conventions follow [Precedence](#precedence).
32
30
  when the answer changes the product.
33
31
  4. **Keep the spec current:** change spec / plan only through the Spec Drift Guard;
34
32
  never code against a known-wrong plan. A later phase MUST NOT rewrite a sealed
35
- artifact in place so the code "matches." Append a dated delta through the
36
- owning rite, or record drift. **Failing case:** Build edits `spec.md`
33
+ artifact so the code "matches." Record drift and route to the owning rite;
34
+ an authorized owner repair reconciles the current owning clause in place and
35
+ preserves rationale/history in `decisions.md`, not an adjacent dated delta. **Failing case:** Build edits `spec.md`
37
36
  acceptance criteria to fit the implementation.
38
- 5. **One slice at a time:** leave one vertical slice working and proven, then
39
- stop. HITL never auto-continues; AFK runs to its slice budget
40
- ([`afk-hitl.md`](afk-hitl.md)).
37
+ 5. **One slice at a time:** prove each vertical slice working.
38
+ Standalone HITL stops after one slice; standalone AFK runs to its slice budget
39
+ ([`afk-hitl.md`](afk-hitl.md)). Active `/rite-autocomplete` returns green
40
+ checkpoints internally and continues the lifecycle to completion or a genuine stop.
41
41
  6. **Evidence over confidence:** tests, builds, runtime, screenshots beat
42
42
  assertions; record commands and output. Tag how each claim was known:
43
43
  `observed` (you ran or read the evidence), `inferred` (deduced — name the
@@ -69,51 +69,50 @@ Each gate is declared as **Name · Precondition · Satisfying observation (exact
69
69
 
70
70
  Verdict discipline — no vacuous verdicts:
71
71
 
72
- - The precondition asserts the artifact **exists and is non-empty**, not merely that its
73
- path resolves. **Failing case:** a phase passes its prerequisite gate, then dies
74
- mid-analysis reading a missing spec.
72
+ - The precondition asserts the artifact **exists and is non-empty**, not just a
73
+ resolved path. **Failing case:** prerequisite passes, analysis dies on a missing spec.
75
74
  - A verdict is **PASS**, **FAIL**, or **NOT-RUN**. A NOT-RUN carries its named marker
76
75
  (`unavailable: <reason>`, `unproven`, `partial: <what ran>`) in the consuming artifact;
77
76
  it never renders as clean and never goes silent. **Failing case:** a review sub-step
78
77
  that never ran is simply omitted from the summary, which reads as a clean run.
79
- - A PASS is valid only when the observation states a **positive count of items actually
80
- checked**; zero checked items is FAIL. **Failing case:** an unparseable checklist yields
81
- an empty result set and a green verdict over zero evidence.
78
+ - PASS needs a **positive count of items actually checked**; zero is FAIL.
79
+ **Failing case:** an unparseable checklist produces an empty green result.
82
80
  - Scope-bearing gates name their **baseline** and fail only on issues attributable to the
83
81
  change; "could not run" (timeout, unreachable, parse failure) is never recorded as
84
82
  "failed". **Failing case:** a dependency gate reddens on a pre-existing advisory
85
83
  unrelated to the diff.
86
- - Failure behavior is **abort** (stop; the blocked step is named) or **record-and-continue**
87
- (the FAIL/NOT-RUN is recorded with its marker and the run proceeds). Both are legal;
88
- silent is not.
84
+ - Failure behavior is **abort** (name blocked step and stop) or **record-and-continue**
85
+ (record FAIL/NOT-RUN with its marker, proceed). Never silent.
89
86
 
90
87
  <!-- root-only -->
91
88
  ## Caller-owned technical backtracking
92
89
 
93
90
  When a rite invokes an earlier rite inline to repair an agent-owned technical gap, the original rite stays the controlling caller: a nested `STOP` is a phase boundary, not user-facing. The caller re-reads `state.md`, follows the return cursor/`next_action`, and resumes unless a human-owned, safety, access, budget, or parked-recovery stop is active ([Persistence before stopping](#persistence-before-stopping-handoff-discipline)). Derive `parked-recovery` from the fingerprint's recorded no-progress attempts and escalations, not from a stale `state.md` label; one consumed authorization doesn't exhaust offline recovery from retained new evidence.
94
91
 
95
- An intermediate `Next step` is cold-resume metadata. Do not ask the human to
96
- copy routine `/rite-plan repair`, `/rite-vet`, `/rite-build`, or proof-rerun
97
- commands during the active recovery chain. Only the controlling caller emits
98
- the final response; standalone phase invocations still stop normally.
92
+ Under active `/rite-autocomplete`, green slice/phase checkpoints and their recorded
93
+ `next_action` are internal continuation edges, not final replies. Consume them and
94
+ technical backtracking until requested completion or a genuine stop; tool progress never yields control.
95
+
96
+ Intermediate `Next step` is cold-resume metadata, not a human copy/paste request
97
+ for routine `/rite-plan repair`, `/rite-vet`, `/rite-build`, or proof reruns during
98
+ active recovery. Only the caller emits the final response; standalone phases stop normally.
99
99
  <!-- /root-only -->
100
100
 
101
101
  <!-- root-only -->
102
102
  ## Final response
103
103
 
104
- Immediately before its final response, each rite loads
105
- [`reply-contract.md`](../reply-contract.md) then uses the compact form: evidenced
106
- claims plus one next action.
104
+ Immediately before its final response, the controlling caller or standalone rite loads
105
+ [`reply-contract.md`](../reply-contract.md): compact evidenced claims, one next action.
107
106
  <!-- /root-only -->
108
107
 
109
108
  ## Rationalization guard
110
109
 
111
- On an excuse, apply its matching
112
- [`anti-patterns.md` rebuttal](anti-patterns.md#universal-rationalizations) before continuing.
110
+ Before continuing on an excuse, apply its
111
+ [`anti-patterns.md` rebuttal](anti-patterns.md#universal-rationalizations).
113
112
 
114
113
  ## Rule summary (load the full file when in scope)
115
114
 
116
- These universal musts link to their full rules; load depth only when needed.
115
+ Universal musts; load linked rules when needed.
117
116
 
118
117
  - **Fail fast, no silent catches.** Validate early; catch narrow, recover or
119
118
  rethrow with context; fail closed on auth/permission/transaction. →
@@ -136,7 +135,7 @@ These universal musts link to their full rules; load depth only when needed.
136
135
  - **Measure before you optimize.** An optimisation without a measurement is a
137
136
  guess that adds complexity. → [`performance.md`](performance.md)
138
137
  - **Names reveal intent.** No `process()` / `handle()` / `data` / `temp`.
139
- One concept, one word, across the codebase. → [`coding-style.md`](coding-style.md)
138
+ One word per concept codebase-wide. → [`coding-style.md`](coding-style.md)
140
139
  - **Comments explain *why*, not *what*.** Rename before you comment; delete
141
140
  commented-out code. → [`coding-style.md`](coding-style.md)
142
141
  - **Write like a human, not a model.** Cut filler, fake contrast/profundity,
@@ -167,19 +166,21 @@ Before any `rite-*` skill stops:
167
166
  [--unset key]`; a new ledger section via `state append <slug> <ledger> --heading "<id>"
168
167
  --body-file <path|->`. Never splice workspace Markdown with an ad-hoc script or regex.
169
168
 
170
- A skill that stops without doing this leaves the workspace incomplete.
169
+ Stopping without this leaves an incomplete workspace.
171
170
  <!-- /root-only -->
172
171
 
173
172
  ## Context hygiene (end of every phase)
174
173
 
175
174
  Long contexts degrade reasoning quality. Act on context at **50-70% used, not 95%**.
176
175
 
177
- Read the engine `context` bundle once per phase instead of re-reading the files it
178
- contains; after compaction re-read the bundle, not its sources.
176
+ Read the engine `context` bundle once per phase, not its sources; after compaction
177
+ re-read the bundle.
179
178
 
180
179
  <!-- root-only -->
181
- Every rite names the single resume command on its action line; a `↻ Hygiene:` footer
182
- advises `/clear`, `/compact`, or `/rite-handoff` and never a competing command. Full phase-by-phase guidance:
180
+ Only controlling-caller final replies or standalone rites name a resume command
181
+ on the action line; nested phases persist it internally, not as a handoff.
182
+ A `↻ Hygiene:` footer advises `/clear`, `/compact`, or `/rite-handoff`, never a
183
+ competing command. Phase guidance:
183
184
  [`context-hygiene.md`](context-hygiene.md).
184
185
  <!-- /root-only -->
185
186
 
@@ -140,30 +140,28 @@ next sequence continuation through Vet in a second session, then stop.
140
140
  product scope is never auto-resolved by a recommended option; it stops for a human.
141
141
  A spent strategy escalates; parked recovery records
142
142
  `Next step: /rite-autocomplete`, never a routine phase command. **Completion:** no stop is active, or its cursor and reason are durable.
143
- 6. **Seal boundary.** Without a ship flag, leave the sealed workspace unshipped and
144
- open the next recorded continuation
143
+ 6. **Seal boundary.** With or without a ship flag, leave intermediate sealed
144
+ workspaces unshipped and open the next recorded continuation
145
145
  ([loop.md § Sequence continuation](reference/loop.md#sequence-continuation))
146
146
  unless `continue_sequence: false`, the sequence budget is spent, or no entry
147
- remains; then stop at Seal GO with `/rite-ship`. Report the sequence position on
148
- every stop.
149
- With a ship flag, perform Ship preflight, disclose the exact Git plan, and stop for
150
- fresh literal `GO` plus native approval. **Completion:** performed no Git action before fresh literal `GO` plus native approval.
147
+ remains. At that boundary without a ship flag, stop at Seal GO with `/rite-ship`.
148
+ Report sequence position at every stop. Only at that boundary, with a ship flag, perform Ship preflight,
149
+ disclose the exact Git plan, and stop for fresh literal `GO` plus native approval. **Completion:** performed no Git action before fresh literal `GO` plus native approval.
151
150
 
152
151
  ## Reply and resume
153
152
 
154
- HITL Build returns after one slice; Autocomplete ignores `--max-slices` and
155
- keeps chaining pending slices. One Autocomplete invocation owns all internal
156
- backtracking. Context pressure, compaction, or a nested completion footer does
153
+ HITL Build returns after one slice; Autocomplete ignores `--max-slices`, chaining
154
+ pending slices. Each Autocomplete invocation owns internal backtracking. Context pressure, compaction, or a nested completion footer does
157
155
  not create a stop; persist and resume the cursor.
158
156
 
159
- Reply only at a final state, never as mid-run progress: a text-only turn ends
160
- the run, so after a compaction or phase change keep calling tools. Use one terse line:
157
+ Reply only at final state: text-only turns end the run. Keep
158
+ calling tools after compaction or phase changes. Use one line:
161
159
 
162
160
  ```text
163
161
  Autocomplete: <slug>
164
162
  spec <done|stopped> · clarify <clear|stopped> · temper <done|stopped> · define <done|stopped> · vet <ready|stopped> · build <n/N|stopped> · prove <done|stopped> · polish <done|stopped> · review <done|stopped> · seal <GO|NO-GO|stopped>
165
163
  ```
166
164
 
167
- Final state is `Shipped`, `Stopped`, `Awaiting human`, `NO-GO`, or `GO`; do not
168
- write a narrative recap. Require a clean or accepted baseline, land a local
169
- unpushed checkpoint after each green check, and never auto-pass a red gate.
165
+ Final state: `Shipped`, `Stopped`, `Awaiting human`, `NO-GO`, or `GO`; no narrative
166
+ recap. Require clean or accepted baseline; land local unpushed checkpoints after
167
+ each green check; never auto-pass red gates.
@@ -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
  `.pi/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: `.pi/skills/devrites-lib/reference/standards/acceptance-preserving-reslice.md`.
@@ -16,7 +15,7 @@ Authority: `.pi/skills/devrites-lib/reference/standards/acceptance-preserving-re
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 `.pi/skills/devrites-lib/reference/standard
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