devrites 6.10.0 → 7.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (641) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/README.md +8 -4
  3. package/SECURITY.md +1 -1
  4. package/docs/adr/0038-engine-flags-unattributed-root-edits.md +67 -0
  5. package/docs/adr/README.md +2 -1
  6. package/docs/cli.md +19 -6
  7. package/docs/command-map.md +21 -19
  8. package/docs/engine/commands.md +22 -15
  9. package/docs/usage.md +3 -3
  10. package/engine/commands.go +8 -3
  11. package/engine/help.go +43 -16
  12. package/engine/internal/acceptance/approve.go +46 -7
  13. package/engine/internal/acceptance/cli.go +102 -0
  14. package/engine/internal/acceptance/exec.go +8 -6
  15. package/engine/internal/acceptance/ledger.go +16 -1
  16. package/engine/internal/acceptance/lint.go +9 -1
  17. package/engine/internal/acceptance/preconditions.go +201 -0
  18. package/engine/internal/anchor/anchor.go +76 -0
  19. package/engine/internal/gate/drivers.go +144 -0
  20. package/engine/internal/gate/gate.go +49 -13
  21. package/engine/internal/gate/preconditions.go +121 -0
  22. package/engine/internal/lib/anchors.go +270 -0
  23. package/engine/internal/lib/apply_bundle.go +2 -1
  24. package/engine/internal/lib/candidate.go +17 -8
  25. package/engine/internal/lib/claims.go +48 -33
  26. package/engine/internal/lib/context.go +337 -22
  27. package/engine/internal/lib/diffscope.go +201 -12
  28. package/engine/internal/lib/dispatch.go +393 -21
  29. package/engine/internal/lib/dispatch_contract.go +82 -2
  30. package/engine/internal/lib/dispatch_packet.go +224 -8
  31. package/engine/internal/lib/environment_report.go +2 -3
  32. package/engine/internal/lib/handoff.go +33 -3
  33. package/engine/internal/lib/metrics.go +119 -11
  34. package/engine/internal/lib/next.go +45 -5
  35. package/engine/internal/lib/observe_summary.go +2 -4
  36. package/engine/internal/lib/packet.go +319 -0
  37. package/engine/internal/lib/packet_freeze.go +227 -0
  38. package/engine/internal/lib/perturb.go +403 -0
  39. package/engine/internal/lib/questions_lint.go +99 -0
  40. package/engine/internal/lib/state_edit.go +396 -0
  41. package/engine/internal/lib/taskgraph.go +166 -0
  42. package/engine/internal/lib/treebaseline.go +331 -0
  43. package/engine/internal/lib/triggers.go +19 -0
  44. package/engine/internal/lib/windows.go +110 -5
  45. package/engine/internal/overhaul/admit/run.go +7 -30
  46. package/engine/internal/parallel/cli.go +27 -33
  47. package/engine/internal/parallel/git.go +10 -0
  48. package/engine/internal/parallel/select.go +36 -0
  49. package/engine/internal/state/budgets.go +60 -13
  50. package/engine/internal/state/observation.go +1 -1
  51. package/engine/main.go +61 -14
  52. package/pack/.claude/agents/devrites-code-reviewer.md +9 -5
  53. package/pack/.claude/agents/devrites-devex-reviewer.md +5 -4
  54. package/pack/.claude/agents/devrites-doubt-reviewer.md +4 -4
  55. package/pack/.claude/agents/devrites-evidence-scout.md +3 -2
  56. package/pack/.claude/agents/devrites-frontend-reviewer.md +5 -4
  57. package/pack/.claude/agents/devrites-performance-reviewer.md +5 -5
  58. package/pack/.claude/agents/devrites-plan-drafter.md +4 -2
  59. package/pack/.claude/agents/devrites-plan-reviewer.md +5 -5
  60. package/pack/.claude/agents/devrites-proof-runner.md +1 -1
  61. package/pack/.claude/agents/devrites-retrospector.md +1 -1
  62. package/pack/.claude/agents/devrites-security-auditor.md +4 -4
  63. package/pack/.claude/agents/devrites-simplifier-reviewer.md +5 -4
  64. package/pack/.claude/agents/devrites-slice-wright.md +18 -9
  65. package/pack/.claude/agents/devrites-spec-reviewer.md +4 -4
  66. package/pack/.claude/agents/devrites-strategy-reviewer.md +5 -6
  67. package/pack/.claude/agents/devrites-test-analyst.md +7 -4
  68. package/pack/.claude/agents/devrites-upgrade-planner.md +1 -1
  69. package/pack/.claude/agents/fast-builder.md +4 -2
  70. package/pack/.claude/agents/fast-checker.md +3 -2
  71. package/pack/.claude/agents/fast-critic.md +3 -2
  72. package/pack/.claude/agents/fast-planner.md +3 -3
  73. package/pack/.claude/agents/overhaul-recon.md +5 -4
  74. package/pack/.claude/settings.json +19 -7
  75. package/pack/.claude/skills/devrites-api-interface/SKILL.md +1 -1
  76. package/pack/.claude/skills/devrites-audit/SKILL.md +1 -1
  77. package/pack/.claude/skills/devrites-debug-recovery/SKILL.md +1 -1
  78. package/pack/.claude/skills/devrites-doubt/SKILL.md +5 -5
  79. package/pack/.claude/skills/devrites-frontend-craft/reference/reuse-first.md +3 -3
  80. package/pack/.claude/skills/devrites-interview/SKILL.md +1 -1
  81. package/pack/.claude/skills/devrites-lib/SKILL.md +11 -6
  82. package/pack/.claude/skills/devrites-lib/reference/orchestration-profiles.md +2 -0
  83. package/pack/.claude/skills/devrites-lib/reference/parallel-dispatch.md +25 -14
  84. package/pack/.claude/skills/devrites-lib/reference/standards/README.md +2 -1
  85. package/pack/.claude/skills/devrites-lib/reference/standards/afk-hitl.md +11 -3
  86. package/pack/.claude/skills/devrites-lib/reference/standards/agents.md +43 -19
  87. package/pack/.claude/skills/devrites-lib/reference/standards/architecture-health.md +1 -1
  88. package/pack/.claude/skills/devrites-lib/reference/standards/code-index.md +111 -0
  89. package/pack/.claude/skills/devrites-lib/reference/standards/code-navigation.md +13 -63
  90. package/pack/.claude/skills/devrites-lib/reference/standards/context-hygiene.md +8 -9
  91. package/pack/.claude/skills/devrites-lib/reference/standards/core.md +14 -1
  92. package/pack/.claude/skills/devrites-lib/reference/standards/deprecation.md +1 -1
  93. package/pack/.claude/skills/devrites-lib/reference/standards/gates.md +10 -1
  94. package/pack/.claude/skills/devrites-lib/reference/standards/security.md +4 -0
  95. package/pack/.claude/skills/devrites-lib/reference/standards/testing.md +3 -1
  96. package/pack/.claude/skills/devrites-lib/reference/standards/tooling.md +9 -8
  97. package/pack/.claude/skills/devrites-lib/reference/standards/windows.md +3 -2
  98. package/pack/.claude/skills/devrites-lib/reference/standards/workflow-artifacts.md +2 -0
  99. package/pack/.claude/skills/devrites-lib/reference/workspace-artifact-schema.md +16 -16
  100. package/pack/.claude/skills/devrites-ux-shape/SKILL.md +1 -1
  101. package/pack/.claude/skills/overhaul/references/orchestration.md +3 -2
  102. package/pack/.claude/skills/rite/SKILL.md +1 -1
  103. package/pack/.claude/skills/rite-adopt/SKILL.md +1 -1
  104. package/pack/.claude/skills/rite-adopt/reference/adoption.md +1 -1
  105. package/pack/.claude/skills/rite-autocomplete/SKILL.md +5 -4
  106. package/pack/.claude/skills/rite-build/SKILL.md +4 -3
  107. package/pack/.claude/skills/rite-build/reference/afk-discipline.md +2 -0
  108. package/pack/.claude/skills/rite-build/reference/checkpoint-protocol.md +4 -1
  109. package/pack/.claude/skills/rite-build/reference/checkpoint.md +2 -0
  110. package/pack/.claude/skills/rite-build/reference/one-slice-cycle.md +1 -1
  111. package/pack/.claude/skills/rite-build/reference/output.md +2 -0
  112. package/pack/.claude/skills/rite-build/reference/parallel-batch.md +22 -12
  113. package/pack/.claude/skills/rite-build/reference/phase-contract.md +13 -3
  114. package/pack/.claude/skills/rite-build/reference/wright-dispatch.md +42 -25
  115. package/pack/.claude/skills/rite-clarify/SKILL.md +1 -1
  116. package/pack/.claude/skills/rite-converge/SKILL.md +4 -4
  117. package/pack/.claude/skills/rite-converge/reference/convergence-assessment.md +3 -3
  118. package/pack/.claude/skills/rite-define/SKILL.md +10 -5
  119. package/pack/.claude/skills/rite-doctor/SKILL.md +17 -2
  120. package/pack/.claude/skills/rite-dogfood/SKILL.md +1 -1
  121. package/pack/.claude/skills/rite-explain/SKILL.md +1 -1
  122. package/pack/.claude/skills/rite-explain/reference/intake.md +1 -1
  123. package/pack/.claude/skills/rite-fast/SKILL.md +1 -1
  124. package/pack/.claude/skills/rite-handoff/SKILL.md +3 -3
  125. package/pack/.claude/skills/rite-handoff/reference/handoff-template.md +1 -1
  126. package/pack/.claude/skills/rite-plan/SKILL.md +4 -4
  127. package/pack/.claude/skills/rite-plan/reference/slicing.md +3 -2
  128. package/pack/.claude/skills/rite-polish/SKILL.md +6 -3
  129. package/pack/.claude/skills/rite-prove/SKILL.md +1 -1
  130. package/pack/.claude/skills/rite-quick/SKILL.md +1 -1
  131. package/pack/.claude/skills/rite-resolve/SKILL.md +1 -1
  132. package/pack/.claude/skills/rite-review/SKILL.md +4 -4
  133. package/pack/.claude/skills/rite-seal/SKILL.md +2 -2
  134. package/pack/.claude/skills/rite-ship/SKILL.md +1 -1
  135. package/pack/.claude/skills/rite-spec/SKILL.md +1 -1
  136. package/pack/.claude/skills/rite-spec/reference/investigation.md +5 -5
  137. package/pack/.claude/skills/rite-spec/reference/spec-template.md +1 -1
  138. package/pack/.claude/skills/rite-spec/reference/state-workspace.md +6 -4
  139. package/pack/.claude/skills/rite-status/SKILL.md +1 -1
  140. package/pack/.claude/skills/rite-temper/SKILL.md +1 -1
  141. package/pack/.claude/skills/rite-temper/reference/review-dimensions.md +2 -2
  142. package/pack/.claude/skills/rite-temper/reference/scope-modes.md +2 -2
  143. package/pack/.claude/skills/rite-temper/reference/significance.md +2 -2
  144. package/pack/.claude/skills/rite-vet/SKILL.md +8 -4
  145. package/pack/.claude/skills/rite-vet/reference/artifacts.md +10 -3
  146. package/pack/.claude/skills/rite-vet/reference/depth.md +2 -2
  147. package/pack/.claude/skills/rite-vet/reference/review-axes.md +2 -2
  148. package/pack/.claude/skills/rite-zoom-out/SKILL.md +6 -6
  149. package/pack/generated/claude/agents/devrites-code-reviewer.md +9 -5
  150. package/pack/generated/claude/agents/devrites-devex-reviewer.md +5 -4
  151. package/pack/generated/claude/agents/devrites-doubt-reviewer.md +4 -4
  152. package/pack/generated/claude/agents/devrites-evidence-scout.md +3 -2
  153. package/pack/generated/claude/agents/devrites-frontend-reviewer.md +5 -4
  154. package/pack/generated/claude/agents/devrites-performance-reviewer.md +5 -5
  155. package/pack/generated/claude/agents/devrites-plan-drafter.md +4 -2
  156. package/pack/generated/claude/agents/devrites-plan-reviewer.md +5 -5
  157. package/pack/generated/claude/agents/devrites-proof-runner.md +1 -1
  158. package/pack/generated/claude/agents/devrites-retrospector.md +1 -1
  159. package/pack/generated/claude/agents/devrites-security-auditor.md +4 -4
  160. package/pack/generated/claude/agents/devrites-simplifier-reviewer.md +5 -4
  161. package/pack/generated/claude/agents/devrites-slice-wright.md +18 -9
  162. package/pack/generated/claude/agents/devrites-spec-reviewer.md +4 -4
  163. package/pack/generated/claude/agents/devrites-strategy-reviewer.md +5 -6
  164. package/pack/generated/claude/agents/devrites-test-analyst.md +7 -4
  165. package/pack/generated/claude/agents/devrites-upgrade-planner.md +1 -1
  166. package/pack/generated/claude/agents/fast-builder.md +4 -2
  167. package/pack/generated/claude/agents/fast-checker.md +3 -2
  168. package/pack/generated/claude/agents/fast-critic.md +3 -2
  169. package/pack/generated/claude/agents/fast-planner.md +3 -3
  170. package/pack/generated/claude/agents/overhaul-recon.md +5 -4
  171. package/pack/generated/claude/settings.json +19 -7
  172. package/pack/generated/claude/skills/devrites-api-interface/SKILL.md +1 -1
  173. package/pack/generated/claude/skills/devrites-audit/SKILL.md +1 -1
  174. package/pack/generated/claude/skills/devrites-debug-recovery/SKILL.md +1 -1
  175. package/pack/generated/claude/skills/devrites-doubt/SKILL.md +5 -5
  176. package/pack/generated/claude/skills/devrites-frontend-craft/reference/reuse-first.md +3 -3
  177. package/pack/generated/claude/skills/devrites-interview/SKILL.md +1 -1
  178. package/pack/generated/claude/skills/devrites-lib/SKILL.md +11 -6
  179. package/pack/generated/claude/skills/devrites-lib/reference/orchestration-profiles.md +2 -0
  180. package/pack/generated/claude/skills/devrites-lib/reference/parallel-dispatch.md +25 -14
  181. package/pack/generated/claude/skills/devrites-lib/reference/standards/README.md +2 -1
  182. package/pack/generated/claude/skills/devrites-lib/reference/standards/afk-hitl.md +11 -3
  183. package/pack/generated/claude/skills/devrites-lib/reference/standards/agents.md +43 -19
  184. package/pack/generated/claude/skills/devrites-lib/reference/standards/architecture-health.md +1 -1
  185. package/pack/generated/claude/skills/devrites-lib/reference/standards/code-index.md +111 -0
  186. package/pack/generated/claude/skills/devrites-lib/reference/standards/code-navigation.md +13 -63
  187. package/pack/generated/claude/skills/devrites-lib/reference/standards/context-hygiene.md +8 -9
  188. package/pack/generated/claude/skills/devrites-lib/reference/standards/core.md +14 -1
  189. package/pack/generated/claude/skills/devrites-lib/reference/standards/deprecation.md +1 -1
  190. package/pack/generated/claude/skills/devrites-lib/reference/standards/gates.md +10 -1
  191. package/pack/generated/claude/skills/devrites-lib/reference/standards/security.md +4 -0
  192. package/pack/generated/claude/skills/devrites-lib/reference/standards/testing.md +3 -1
  193. package/pack/generated/claude/skills/devrites-lib/reference/standards/tooling.md +9 -8
  194. package/pack/generated/claude/skills/devrites-lib/reference/standards/windows.md +3 -2
  195. package/pack/generated/claude/skills/devrites-lib/reference/standards/workflow-artifacts.md +2 -0
  196. package/pack/generated/claude/skills/devrites-lib/reference/workspace-artifact-schema.md +16 -16
  197. package/pack/generated/claude/skills/devrites-ux-shape/SKILL.md +1 -1
  198. package/pack/generated/claude/skills/overhaul/references/orchestration.md +3 -2
  199. package/pack/generated/claude/skills/rite/SKILL.md +1 -1
  200. package/pack/generated/claude/skills/rite-adopt/SKILL.md +1 -1
  201. package/pack/generated/claude/skills/rite-adopt/reference/adoption.md +1 -1
  202. package/pack/generated/claude/skills/rite-autocomplete/SKILL.md +5 -4
  203. package/pack/generated/claude/skills/rite-build/SKILL.md +4 -3
  204. package/pack/generated/claude/skills/rite-build/reference/afk-discipline.md +2 -0
  205. package/pack/generated/claude/skills/rite-build/reference/checkpoint-protocol.md +4 -1
  206. package/pack/generated/claude/skills/rite-build/reference/checkpoint.md +2 -0
  207. package/pack/generated/claude/skills/rite-build/reference/one-slice-cycle.md +1 -1
  208. package/pack/generated/claude/skills/rite-build/reference/output.md +2 -0
  209. package/pack/generated/claude/skills/rite-build/reference/parallel-batch.md +22 -12
  210. package/pack/generated/claude/skills/rite-build/reference/phase-contract.md +13 -3
  211. package/pack/generated/claude/skills/rite-build/reference/wright-dispatch.md +42 -25
  212. package/pack/generated/claude/skills/rite-clarify/SKILL.md +1 -1
  213. package/pack/generated/claude/skills/rite-converge/SKILL.md +4 -4
  214. package/pack/generated/claude/skills/rite-converge/reference/convergence-assessment.md +3 -3
  215. package/pack/generated/claude/skills/rite-define/SKILL.md +10 -5
  216. package/pack/generated/claude/skills/rite-doctor/SKILL.md +17 -2
  217. package/pack/generated/claude/skills/rite-dogfood/SKILL.md +1 -1
  218. package/pack/generated/claude/skills/rite-explain/SKILL.md +1 -1
  219. package/pack/generated/claude/skills/rite-explain/reference/intake.md +1 -1
  220. package/pack/generated/claude/skills/rite-fast/SKILL.md +1 -1
  221. package/pack/generated/claude/skills/rite-handoff/SKILL.md +3 -3
  222. package/pack/generated/claude/skills/rite-handoff/reference/handoff-template.md +1 -1
  223. package/pack/generated/claude/skills/rite-plan/SKILL.md +4 -4
  224. package/pack/generated/claude/skills/rite-plan/reference/slicing.md +3 -2
  225. package/pack/generated/claude/skills/rite-polish/SKILL.md +6 -3
  226. package/pack/generated/claude/skills/rite-prove/SKILL.md +1 -1
  227. package/pack/generated/claude/skills/rite-quick/SKILL.md +1 -1
  228. package/pack/generated/claude/skills/rite-resolve/SKILL.md +1 -1
  229. package/pack/generated/claude/skills/rite-review/SKILL.md +4 -4
  230. package/pack/generated/claude/skills/rite-seal/SKILL.md +2 -2
  231. package/pack/generated/claude/skills/rite-ship/SKILL.md +1 -1
  232. package/pack/generated/claude/skills/rite-spec/SKILL.md +1 -1
  233. package/pack/generated/claude/skills/rite-spec/reference/investigation.md +5 -5
  234. package/pack/generated/claude/skills/rite-spec/reference/spec-template.md +1 -1
  235. package/pack/generated/claude/skills/rite-spec/reference/state-workspace.md +6 -4
  236. package/pack/generated/claude/skills/rite-status/SKILL.md +1 -1
  237. package/pack/generated/claude/skills/rite-temper/SKILL.md +1 -1
  238. package/pack/generated/claude/skills/rite-temper/reference/review-dimensions.md +2 -2
  239. package/pack/generated/claude/skills/rite-temper/reference/scope-modes.md +2 -2
  240. package/pack/generated/claude/skills/rite-temper/reference/significance.md +2 -2
  241. package/pack/generated/claude/skills/rite-vet/SKILL.md +8 -4
  242. package/pack/generated/claude/skills/rite-vet/reference/artifacts.md +10 -3
  243. package/pack/generated/claude/skills/rite-vet/reference/depth.md +2 -2
  244. package/pack/generated/claude/skills/rite-vet/reference/review-axes.md +2 -2
  245. package/pack/generated/claude/skills/rite-zoom-out/SKILL.md +6 -6
  246. package/pack/generated/codex/agents/devrites-code-reviewer.toml +8 -4
  247. package/pack/generated/codex/agents/devrites-devex-reviewer.toml +4 -3
  248. package/pack/generated/codex/agents/devrites-doubt-reviewer.toml +3 -3
  249. package/pack/generated/codex/agents/devrites-evidence-scout.toml +2 -1
  250. package/pack/generated/codex/agents/devrites-frontend-reviewer.toml +4 -3
  251. package/pack/generated/codex/agents/devrites-performance-reviewer.toml +4 -4
  252. package/pack/generated/codex/agents/devrites-plan-drafter.toml +3 -1
  253. package/pack/generated/codex/agents/devrites-plan-reviewer.toml +4 -4
  254. package/pack/generated/codex/agents/devrites-security-auditor.toml +3 -3
  255. package/pack/generated/codex/agents/devrites-simplifier-reviewer.toml +4 -3
  256. package/pack/generated/codex/agents/devrites-slice-wright.toml +17 -8
  257. package/pack/generated/codex/agents/devrites-spec-reviewer.toml +3 -3
  258. package/pack/generated/codex/agents/devrites-strategy-reviewer.toml +4 -5
  259. package/pack/generated/codex/agents/devrites-test-analyst.toml +6 -3
  260. package/pack/generated/codex/agents/fast-builder.toml +3 -1
  261. package/pack/generated/codex/agents/fast-checker.toml +2 -1
  262. package/pack/generated/codex/agents/fast-critic.toml +2 -1
  263. package/pack/generated/codex/agents/fast-planner.toml +2 -2
  264. package/pack/generated/codex/agents/overhaul-recon.toml +5 -4
  265. package/pack/generated/codex/skills/devrites-api-interface/SKILL.md +1 -1
  266. package/pack/generated/codex/skills/devrites-audit/SKILL.md +1 -1
  267. package/pack/generated/codex/skills/devrites-debug-recovery/SKILL.md +1 -1
  268. package/pack/generated/codex/skills/devrites-doubt/SKILL.md +5 -5
  269. package/pack/generated/codex/skills/devrites-frontend-craft/reference/reuse-first.md +3 -3
  270. package/pack/generated/codex/skills/devrites-interview/SKILL.md +1 -1
  271. package/pack/generated/codex/skills/devrites-lib/SKILL.md +11 -6
  272. package/pack/generated/codex/skills/devrites-lib/reference/orchestration-profiles.md +2 -0
  273. package/pack/generated/codex/skills/devrites-lib/reference/parallel-dispatch.md +25 -14
  274. package/pack/generated/codex/skills/devrites-lib/reference/standards/README.md +2 -1
  275. package/pack/generated/codex/skills/devrites-lib/reference/standards/afk-hitl.md +11 -3
  276. package/pack/generated/codex/skills/devrites-lib/reference/standards/agents.md +43 -19
  277. package/pack/generated/codex/skills/devrites-lib/reference/standards/architecture-health.md +1 -1
  278. package/pack/generated/codex/skills/devrites-lib/reference/standards/code-index.md +111 -0
  279. package/pack/generated/codex/skills/devrites-lib/reference/standards/code-navigation.md +13 -63
  280. package/pack/generated/codex/skills/devrites-lib/reference/standards/context-hygiene.md +8 -9
  281. package/pack/generated/codex/skills/devrites-lib/reference/standards/core.md +14 -1
  282. package/pack/generated/codex/skills/devrites-lib/reference/standards/deprecation.md +1 -1
  283. package/pack/generated/codex/skills/devrites-lib/reference/standards/gates.md +10 -1
  284. package/pack/generated/codex/skills/devrites-lib/reference/standards/security.md +4 -0
  285. package/pack/generated/codex/skills/devrites-lib/reference/standards/testing.md +3 -1
  286. package/pack/generated/codex/skills/devrites-lib/reference/standards/tooling.md +9 -8
  287. package/pack/generated/codex/skills/devrites-lib/reference/standards/windows.md +3 -2
  288. package/pack/generated/codex/skills/devrites-lib/reference/standards/workflow-artifacts.md +2 -0
  289. package/pack/generated/codex/skills/devrites-lib/reference/workspace-artifact-schema.md +16 -16
  290. package/pack/generated/codex/skills/devrites-ux-shape/SKILL.md +1 -1
  291. package/pack/generated/codex/skills/overhaul/references/orchestration.md +3 -2
  292. package/pack/generated/codex/skills/rite/SKILL.md +1 -1
  293. package/pack/generated/codex/skills/rite-adopt/SKILL.md +1 -1
  294. package/pack/generated/codex/skills/rite-adopt/reference/adoption.md +1 -1
  295. package/pack/generated/codex/skills/rite-autocomplete/SKILL.md +5 -4
  296. package/pack/generated/codex/skills/rite-build/SKILL.md +4 -3
  297. package/pack/generated/codex/skills/rite-build/reference/afk-discipline.md +2 -0
  298. package/pack/generated/codex/skills/rite-build/reference/checkpoint-protocol.md +4 -1
  299. package/pack/generated/codex/skills/rite-build/reference/checkpoint.md +2 -0
  300. package/pack/generated/codex/skills/rite-build/reference/one-slice-cycle.md +1 -1
  301. package/pack/generated/codex/skills/rite-build/reference/output.md +2 -0
  302. package/pack/generated/codex/skills/rite-build/reference/parallel-batch.md +22 -12
  303. package/pack/generated/codex/skills/rite-build/reference/phase-contract.md +13 -3
  304. package/pack/generated/codex/skills/rite-build/reference/wright-dispatch.md +42 -25
  305. package/pack/generated/codex/skills/rite-clarify/SKILL.md +1 -1
  306. package/pack/generated/codex/skills/rite-converge/SKILL.md +4 -4
  307. package/pack/generated/codex/skills/rite-converge/reference/convergence-assessment.md +3 -3
  308. package/pack/generated/codex/skills/rite-define/SKILL.md +10 -5
  309. package/pack/generated/codex/skills/rite-doctor/SKILL.md +17 -2
  310. package/pack/generated/codex/skills/rite-dogfood/SKILL.md +1 -1
  311. package/pack/generated/codex/skills/rite-explain/SKILL.md +1 -1
  312. package/pack/generated/codex/skills/rite-explain/reference/intake.md +1 -1
  313. package/pack/generated/codex/skills/rite-fast/SKILL.md +1 -1
  314. package/pack/generated/codex/skills/rite-handoff/SKILL.md +3 -3
  315. package/pack/generated/codex/skills/rite-handoff/reference/handoff-template.md +1 -1
  316. package/pack/generated/codex/skills/rite-plan/SKILL.md +4 -4
  317. package/pack/generated/codex/skills/rite-plan/reference/slicing.md +3 -2
  318. package/pack/generated/codex/skills/rite-polish/SKILL.md +6 -3
  319. package/pack/generated/codex/skills/rite-prove/SKILL.md +1 -1
  320. package/pack/generated/codex/skills/rite-quick/SKILL.md +1 -1
  321. package/pack/generated/codex/skills/rite-resolve/SKILL.md +1 -1
  322. package/pack/generated/codex/skills/rite-review/SKILL.md +4 -4
  323. package/pack/generated/codex/skills/rite-seal/SKILL.md +2 -2
  324. package/pack/generated/codex/skills/rite-ship/SKILL.md +1 -1
  325. package/pack/generated/codex/skills/rite-spec/SKILL.md +1 -1
  326. package/pack/generated/codex/skills/rite-spec/reference/investigation.md +5 -5
  327. package/pack/generated/codex/skills/rite-spec/reference/spec-template.md +1 -1
  328. package/pack/generated/codex/skills/rite-spec/reference/state-workspace.md +6 -4
  329. package/pack/generated/codex/skills/rite-status/SKILL.md +1 -1
  330. package/pack/generated/codex/skills/rite-temper/SKILL.md +1 -1
  331. package/pack/generated/codex/skills/rite-temper/reference/review-dimensions.md +2 -2
  332. package/pack/generated/codex/skills/rite-temper/reference/scope-modes.md +2 -2
  333. package/pack/generated/codex/skills/rite-temper/reference/significance.md +2 -2
  334. package/pack/generated/codex/skills/rite-vet/SKILL.md +8 -4
  335. package/pack/generated/codex/skills/rite-vet/reference/artifacts.md +10 -3
  336. package/pack/generated/codex/skills/rite-vet/reference/depth.md +2 -2
  337. package/pack/generated/codex/skills/rite-vet/reference/review-axes.md +2 -2
  338. package/pack/generated/codex/skills/rite-zoom-out/SKILL.md +6 -6
  339. package/pack/generated/devin/agents/devrites-code-reviewer.md +8 -4
  340. package/pack/generated/devin/agents/devrites-devex-reviewer.md +4 -3
  341. package/pack/generated/devin/agents/devrites-doubt-reviewer.md +3 -3
  342. package/pack/generated/devin/agents/devrites-evidence-scout.md +2 -1
  343. package/pack/generated/devin/agents/devrites-frontend-reviewer.md +4 -3
  344. package/pack/generated/devin/agents/devrites-performance-reviewer.md +4 -4
  345. package/pack/generated/devin/agents/devrites-plan-drafter.md +3 -1
  346. package/pack/generated/devin/agents/devrites-plan-reviewer.md +4 -4
  347. package/pack/generated/devin/agents/devrites-security-auditor.md +3 -3
  348. package/pack/generated/devin/agents/devrites-simplifier-reviewer.md +4 -3
  349. package/pack/generated/devin/agents/devrites-slice-wright.md +17 -8
  350. package/pack/generated/devin/agents/devrites-spec-reviewer.md +3 -3
  351. package/pack/generated/devin/agents/devrites-strategy-reviewer.md +4 -5
  352. package/pack/generated/devin/agents/devrites-test-analyst.md +6 -3
  353. package/pack/generated/devin/agents/fast-builder.md +3 -1
  354. package/pack/generated/devin/agents/fast-checker.md +2 -1
  355. package/pack/generated/devin/agents/fast-critic.md +2 -1
  356. package/pack/generated/devin/agents/fast-planner.md +2 -2
  357. package/pack/generated/devin/agents/overhaul-recon.md +5 -4
  358. package/pack/generated/devin/skills/devrites-api-interface/SKILL.md +1 -1
  359. package/pack/generated/devin/skills/devrites-audit/SKILL.md +1 -1
  360. package/pack/generated/devin/skills/devrites-debug-recovery/SKILL.md +1 -1
  361. package/pack/generated/devin/skills/devrites-doubt/SKILL.md +5 -5
  362. package/pack/generated/devin/skills/devrites-frontend-craft/reference/reuse-first.md +3 -3
  363. package/pack/generated/devin/skills/devrites-interview/SKILL.md +1 -1
  364. package/pack/generated/devin/skills/devrites-lib/SKILL.md +11 -6
  365. package/pack/generated/devin/skills/devrites-lib/reference/orchestration-profiles.md +2 -0
  366. package/pack/generated/devin/skills/devrites-lib/reference/parallel-dispatch.md +25 -14
  367. package/pack/generated/devin/skills/devrites-lib/reference/standards/README.md +2 -1
  368. package/pack/generated/devin/skills/devrites-lib/reference/standards/afk-hitl.md +11 -3
  369. package/pack/generated/devin/skills/devrites-lib/reference/standards/agents.md +43 -19
  370. package/pack/generated/devin/skills/devrites-lib/reference/standards/architecture-health.md +1 -1
  371. package/pack/generated/devin/skills/devrites-lib/reference/standards/code-index.md +111 -0
  372. package/pack/generated/devin/skills/devrites-lib/reference/standards/code-navigation.md +13 -63
  373. package/pack/generated/devin/skills/devrites-lib/reference/standards/context-hygiene.md +8 -9
  374. package/pack/generated/devin/skills/devrites-lib/reference/standards/core.md +14 -1
  375. package/pack/generated/devin/skills/devrites-lib/reference/standards/deprecation.md +1 -1
  376. package/pack/generated/devin/skills/devrites-lib/reference/standards/gates.md +10 -1
  377. package/pack/generated/devin/skills/devrites-lib/reference/standards/security.md +4 -0
  378. package/pack/generated/devin/skills/devrites-lib/reference/standards/testing.md +3 -1
  379. package/pack/generated/devin/skills/devrites-lib/reference/standards/tooling.md +9 -8
  380. package/pack/generated/devin/skills/devrites-lib/reference/standards/windows.md +3 -2
  381. package/pack/generated/devin/skills/devrites-lib/reference/standards/workflow-artifacts.md +2 -0
  382. package/pack/generated/devin/skills/devrites-lib/reference/workspace-artifact-schema.md +16 -16
  383. package/pack/generated/devin/skills/devrites-ux-shape/SKILL.md +1 -1
  384. package/pack/generated/devin/skills/overhaul/references/orchestration.md +3 -2
  385. package/pack/generated/devin/skills/rite/SKILL.md +1 -1
  386. package/pack/generated/devin/skills/rite-adopt/SKILL.md +1 -1
  387. package/pack/generated/devin/skills/rite-adopt/reference/adoption.md +1 -1
  388. package/pack/generated/devin/skills/rite-autocomplete/SKILL.md +5 -4
  389. package/pack/generated/devin/skills/rite-build/SKILL.md +4 -3
  390. package/pack/generated/devin/skills/rite-build/reference/afk-discipline.md +2 -0
  391. package/pack/generated/devin/skills/rite-build/reference/checkpoint-protocol.md +4 -1
  392. package/pack/generated/devin/skills/rite-build/reference/checkpoint.md +2 -0
  393. package/pack/generated/devin/skills/rite-build/reference/one-slice-cycle.md +1 -1
  394. package/pack/generated/devin/skills/rite-build/reference/output.md +2 -0
  395. package/pack/generated/devin/skills/rite-build/reference/parallel-batch.md +22 -12
  396. package/pack/generated/devin/skills/rite-build/reference/phase-contract.md +13 -3
  397. package/pack/generated/devin/skills/rite-build/reference/wright-dispatch.md +42 -25
  398. package/pack/generated/devin/skills/rite-clarify/SKILL.md +1 -1
  399. package/pack/generated/devin/skills/rite-converge/SKILL.md +4 -4
  400. package/pack/generated/devin/skills/rite-converge/reference/convergence-assessment.md +3 -3
  401. package/pack/generated/devin/skills/rite-define/SKILL.md +10 -5
  402. package/pack/generated/devin/skills/rite-doctor/SKILL.md +17 -2
  403. package/pack/generated/devin/skills/rite-dogfood/SKILL.md +1 -1
  404. package/pack/generated/devin/skills/rite-explain/SKILL.md +1 -1
  405. package/pack/generated/devin/skills/rite-explain/reference/intake.md +1 -1
  406. package/pack/generated/devin/skills/rite-fast/SKILL.md +1 -1
  407. package/pack/generated/devin/skills/rite-handoff/SKILL.md +3 -3
  408. package/pack/generated/devin/skills/rite-handoff/reference/handoff-template.md +1 -1
  409. package/pack/generated/devin/skills/rite-plan/SKILL.md +4 -4
  410. package/pack/generated/devin/skills/rite-plan/reference/slicing.md +3 -2
  411. package/pack/generated/devin/skills/rite-polish/SKILL.md +6 -3
  412. package/pack/generated/devin/skills/rite-prove/SKILL.md +1 -1
  413. package/pack/generated/devin/skills/rite-quick/SKILL.md +1 -1
  414. package/pack/generated/devin/skills/rite-resolve/SKILL.md +1 -1
  415. package/pack/generated/devin/skills/rite-review/SKILL.md +4 -4
  416. package/pack/generated/devin/skills/rite-seal/SKILL.md +2 -2
  417. package/pack/generated/devin/skills/rite-ship/SKILL.md +1 -1
  418. package/pack/generated/devin/skills/rite-spec/SKILL.md +1 -1
  419. package/pack/generated/devin/skills/rite-spec/reference/investigation.md +5 -5
  420. package/pack/generated/devin/skills/rite-spec/reference/spec-template.md +1 -1
  421. package/pack/generated/devin/skills/rite-spec/reference/state-workspace.md +6 -4
  422. package/pack/generated/devin/skills/rite-status/SKILL.md +1 -1
  423. package/pack/generated/devin/skills/rite-temper/SKILL.md +1 -1
  424. package/pack/generated/devin/skills/rite-temper/reference/review-dimensions.md +2 -2
  425. package/pack/generated/devin/skills/rite-temper/reference/scope-modes.md +2 -2
  426. package/pack/generated/devin/skills/rite-temper/reference/significance.md +2 -2
  427. package/pack/generated/devin/skills/rite-vet/SKILL.md +8 -4
  428. package/pack/generated/devin/skills/rite-vet/reference/artifacts.md +10 -3
  429. package/pack/generated/devin/skills/rite-vet/reference/depth.md +2 -2
  430. package/pack/generated/devin/skills/rite-vet/reference/review-axes.md +2 -2
  431. package/pack/generated/devin/skills/rite-zoom-out/SKILL.md +6 -6
  432. package/pack/generated/omp/agents/devrites-code-reviewer.md +9 -5
  433. package/pack/generated/omp/agents/devrites-devex-reviewer.md +5 -4
  434. package/pack/generated/omp/agents/devrites-doubt-reviewer.md +4 -4
  435. package/pack/generated/omp/agents/devrites-evidence-scout.md +3 -2
  436. package/pack/generated/omp/agents/devrites-frontend-reviewer.md +5 -4
  437. package/pack/generated/omp/agents/devrites-performance-reviewer.md +5 -5
  438. package/pack/generated/omp/agents/devrites-plan-drafter.md +4 -2
  439. package/pack/generated/omp/agents/devrites-plan-reviewer.md +5 -5
  440. package/pack/generated/omp/agents/devrites-proof-runner.md +1 -1
  441. package/pack/generated/omp/agents/devrites-retrospector.md +1 -1
  442. package/pack/generated/omp/agents/devrites-security-auditor.md +4 -4
  443. package/pack/generated/omp/agents/devrites-simplifier-reviewer.md +5 -4
  444. package/pack/generated/omp/agents/devrites-slice-wright.md +18 -9
  445. package/pack/generated/omp/agents/devrites-spec-reviewer.md +4 -4
  446. package/pack/generated/omp/agents/devrites-strategy-reviewer.md +5 -6
  447. package/pack/generated/omp/agents/devrites-test-analyst.md +7 -4
  448. package/pack/generated/omp/agents/devrites-upgrade-planner.md +1 -1
  449. package/pack/generated/omp/agents/fast-builder.md +4 -2
  450. package/pack/generated/omp/agents/fast-checker.md +3 -2
  451. package/pack/generated/omp/agents/fast-critic.md +3 -2
  452. package/pack/generated/omp/agents/fast-planner.md +3 -3
  453. package/pack/generated/omp/agents/overhaul-backend-engineer.md +1 -1
  454. package/pack/generated/omp/agents/overhaul-boundary.md +1 -1
  455. package/pack/generated/omp/agents/overhaul-craft.md +1 -1
  456. package/pack/generated/omp/agents/overhaul-frontend-engineer.md +1 -1
  457. package/pack/generated/omp/agents/overhaul-implementer.md +1 -1
  458. package/pack/generated/omp/agents/overhaul-recon.md +6 -5
  459. package/pack/generated/omp/agents/overhaul-specialist.md +1 -1
  460. package/pack/generated/omp/agents/overhaul-verifier.md +1 -1
  461. package/pack/generated/omp/skills/devrites-api-interface/SKILL.md +1 -1
  462. package/pack/generated/omp/skills/devrites-audit/SKILL.md +1 -1
  463. package/pack/generated/omp/skills/devrites-debug-recovery/SKILL.md +1 -1
  464. package/pack/generated/omp/skills/devrites-doubt/SKILL.md +5 -5
  465. package/pack/generated/omp/skills/devrites-frontend-craft/reference/reuse-first.md +3 -3
  466. package/pack/generated/omp/skills/devrites-interview/SKILL.md +1 -1
  467. package/pack/generated/omp/skills/devrites-lib/SKILL.md +11 -6
  468. package/pack/generated/omp/skills/devrites-lib/reference/orchestration-profiles.md +2 -0
  469. package/pack/generated/omp/skills/devrites-lib/reference/parallel-dispatch.md +25 -14
  470. package/pack/generated/omp/skills/devrites-lib/reference/standards/README.md +2 -1
  471. package/pack/generated/omp/skills/devrites-lib/reference/standards/afk-hitl.md +11 -3
  472. package/pack/generated/omp/skills/devrites-lib/reference/standards/agents.md +43 -19
  473. package/pack/generated/omp/skills/devrites-lib/reference/standards/architecture-health.md +1 -1
  474. package/pack/generated/omp/skills/devrites-lib/reference/standards/code-index.md +111 -0
  475. package/pack/generated/omp/skills/devrites-lib/reference/standards/code-navigation.md +13 -63
  476. package/pack/generated/omp/skills/devrites-lib/reference/standards/context-hygiene.md +8 -9
  477. package/pack/generated/omp/skills/devrites-lib/reference/standards/core.md +14 -1
  478. package/pack/generated/omp/skills/devrites-lib/reference/standards/deprecation.md +1 -1
  479. package/pack/generated/omp/skills/devrites-lib/reference/standards/gates.md +10 -1
  480. package/pack/generated/omp/skills/devrites-lib/reference/standards/security.md +4 -0
  481. package/pack/generated/omp/skills/devrites-lib/reference/standards/testing.md +3 -1
  482. package/pack/generated/omp/skills/devrites-lib/reference/standards/tooling.md +9 -8
  483. package/pack/generated/omp/skills/devrites-lib/reference/standards/windows.md +3 -2
  484. package/pack/generated/omp/skills/devrites-lib/reference/standards/workflow-artifacts.md +2 -0
  485. package/pack/generated/omp/skills/devrites-lib/reference/workspace-artifact-schema.md +16 -16
  486. package/pack/generated/omp/skills/devrites-ux-shape/SKILL.md +1 -1
  487. package/pack/generated/omp/skills/overhaul/references/orchestration.md +3 -2
  488. package/pack/generated/omp/skills/rite/SKILL.md +1 -1
  489. package/pack/generated/omp/skills/rite-adopt/SKILL.md +1 -1
  490. package/pack/generated/omp/skills/rite-adopt/reference/adoption.md +1 -1
  491. package/pack/generated/omp/skills/rite-autocomplete/SKILL.md +5 -4
  492. package/pack/generated/omp/skills/rite-build/SKILL.md +4 -3
  493. package/pack/generated/omp/skills/rite-build/reference/afk-discipline.md +2 -0
  494. package/pack/generated/omp/skills/rite-build/reference/checkpoint-protocol.md +4 -1
  495. package/pack/generated/omp/skills/rite-build/reference/checkpoint.md +2 -0
  496. package/pack/generated/omp/skills/rite-build/reference/one-slice-cycle.md +1 -1
  497. package/pack/generated/omp/skills/rite-build/reference/output.md +2 -0
  498. package/pack/generated/omp/skills/rite-build/reference/parallel-batch.md +22 -12
  499. package/pack/generated/omp/skills/rite-build/reference/phase-contract.md +13 -3
  500. package/pack/generated/omp/skills/rite-build/reference/wright-dispatch.md +42 -25
  501. package/pack/generated/omp/skills/rite-clarify/SKILL.md +1 -1
  502. package/pack/generated/omp/skills/rite-converge/SKILL.md +4 -4
  503. package/pack/generated/omp/skills/rite-converge/reference/convergence-assessment.md +3 -3
  504. package/pack/generated/omp/skills/rite-define/SKILL.md +10 -5
  505. package/pack/generated/omp/skills/rite-doctor/SKILL.md +17 -2
  506. package/pack/generated/omp/skills/rite-dogfood/SKILL.md +1 -1
  507. package/pack/generated/omp/skills/rite-explain/SKILL.md +1 -1
  508. package/pack/generated/omp/skills/rite-explain/reference/intake.md +1 -1
  509. package/pack/generated/omp/skills/rite-fast/SKILL.md +1 -1
  510. package/pack/generated/omp/skills/rite-handoff/SKILL.md +3 -3
  511. package/pack/generated/omp/skills/rite-handoff/reference/handoff-template.md +1 -1
  512. package/pack/generated/omp/skills/rite-plan/SKILL.md +4 -4
  513. package/pack/generated/omp/skills/rite-plan/reference/slicing.md +3 -2
  514. package/pack/generated/omp/skills/rite-polish/SKILL.md +6 -3
  515. package/pack/generated/omp/skills/rite-prove/SKILL.md +1 -1
  516. package/pack/generated/omp/skills/rite-quick/SKILL.md +1 -1
  517. package/pack/generated/omp/skills/rite-resolve/SKILL.md +1 -1
  518. package/pack/generated/omp/skills/rite-review/SKILL.md +4 -4
  519. package/pack/generated/omp/skills/rite-seal/SKILL.md +2 -2
  520. package/pack/generated/omp/skills/rite-ship/SKILL.md +1 -1
  521. package/pack/generated/omp/skills/rite-spec/SKILL.md +1 -1
  522. package/pack/generated/omp/skills/rite-spec/reference/investigation.md +5 -5
  523. package/pack/generated/omp/skills/rite-spec/reference/spec-template.md +1 -1
  524. package/pack/generated/omp/skills/rite-spec/reference/state-workspace.md +6 -4
  525. package/pack/generated/omp/skills/rite-status/SKILL.md +1 -1
  526. package/pack/generated/omp/skills/rite-temper/SKILL.md +1 -1
  527. package/pack/generated/omp/skills/rite-temper/reference/review-dimensions.md +2 -2
  528. package/pack/generated/omp/skills/rite-temper/reference/scope-modes.md +2 -2
  529. package/pack/generated/omp/skills/rite-temper/reference/significance.md +2 -2
  530. package/pack/generated/omp/skills/rite-vet/SKILL.md +8 -4
  531. package/pack/generated/omp/skills/rite-vet/reference/artifacts.md +10 -3
  532. package/pack/generated/omp/skills/rite-vet/reference/depth.md +2 -2
  533. package/pack/generated/omp/skills/rite-vet/reference/review-axes.md +2 -2
  534. package/pack/generated/omp/skills/rite-zoom-out/SKILL.md +6 -6
  535. package/pack/generated/pi/agents/devrites-code-reviewer.md +9 -5
  536. package/pack/generated/pi/agents/devrites-devex-reviewer.md +5 -4
  537. package/pack/generated/pi/agents/devrites-doubt-reviewer.md +4 -4
  538. package/pack/generated/pi/agents/devrites-evidence-scout.md +3 -2
  539. package/pack/generated/pi/agents/devrites-frontend-reviewer.md +5 -4
  540. package/pack/generated/pi/agents/devrites-performance-reviewer.md +5 -5
  541. package/pack/generated/pi/agents/devrites-plan-drafter.md +4 -2
  542. package/pack/generated/pi/agents/devrites-plan-reviewer.md +5 -5
  543. package/pack/generated/pi/agents/devrites-proof-runner.md +1 -1
  544. package/pack/generated/pi/agents/devrites-retrospector.md +1 -1
  545. package/pack/generated/pi/agents/devrites-security-auditor.md +4 -4
  546. package/pack/generated/pi/agents/devrites-simplifier-reviewer.md +5 -4
  547. package/pack/generated/pi/agents/devrites-slice-wright.md +18 -9
  548. package/pack/generated/pi/agents/devrites-spec-reviewer.md +4 -4
  549. package/pack/generated/pi/agents/devrites-strategy-reviewer.md +5 -6
  550. package/pack/generated/pi/agents/devrites-test-analyst.md +7 -4
  551. package/pack/generated/pi/agents/devrites-upgrade-planner.md +1 -1
  552. package/pack/generated/pi/agents/fast-builder.md +4 -2
  553. package/pack/generated/pi/agents/fast-checker.md +3 -2
  554. package/pack/generated/pi/agents/fast-critic.md +3 -2
  555. package/pack/generated/pi/agents/fast-planner.md +3 -3
  556. package/pack/generated/pi/agents/overhaul-backend-engineer.md +1 -1
  557. package/pack/generated/pi/agents/overhaul-boundary.md +1 -1
  558. package/pack/generated/pi/agents/overhaul-craft.md +1 -1
  559. package/pack/generated/pi/agents/overhaul-frontend-engineer.md +1 -1
  560. package/pack/generated/pi/agents/overhaul-implementer.md +1 -1
  561. package/pack/generated/pi/agents/overhaul-recon.md +6 -5
  562. package/pack/generated/pi/agents/overhaul-specialist.md +1 -1
  563. package/pack/generated/pi/agents/overhaul-verifier.md +1 -1
  564. package/pack/generated/pi/skills/devrites-api-interface/SKILL.md +1 -1
  565. package/pack/generated/pi/skills/devrites-audit/SKILL.md +1 -1
  566. package/pack/generated/pi/skills/devrites-debug-recovery/SKILL.md +1 -1
  567. package/pack/generated/pi/skills/devrites-doubt/SKILL.md +5 -5
  568. package/pack/generated/pi/skills/devrites-frontend-craft/reference/reuse-first.md +3 -3
  569. package/pack/generated/pi/skills/devrites-interview/SKILL.md +1 -1
  570. package/pack/generated/pi/skills/devrites-lib/SKILL.md +11 -6
  571. package/pack/generated/pi/skills/devrites-lib/reference/orchestration-profiles.md +2 -0
  572. package/pack/generated/pi/skills/devrites-lib/reference/parallel-dispatch.md +25 -14
  573. package/pack/generated/pi/skills/devrites-lib/reference/standards/README.md +2 -1
  574. package/pack/generated/pi/skills/devrites-lib/reference/standards/afk-hitl.md +11 -3
  575. package/pack/generated/pi/skills/devrites-lib/reference/standards/agents.md +43 -19
  576. package/pack/generated/pi/skills/devrites-lib/reference/standards/architecture-health.md +1 -1
  577. package/pack/generated/pi/skills/devrites-lib/reference/standards/code-index.md +111 -0
  578. package/pack/generated/pi/skills/devrites-lib/reference/standards/code-navigation.md +13 -63
  579. package/pack/generated/pi/skills/devrites-lib/reference/standards/context-hygiene.md +8 -9
  580. package/pack/generated/pi/skills/devrites-lib/reference/standards/core.md +14 -1
  581. package/pack/generated/pi/skills/devrites-lib/reference/standards/deprecation.md +1 -1
  582. package/pack/generated/pi/skills/devrites-lib/reference/standards/gates.md +10 -1
  583. package/pack/generated/pi/skills/devrites-lib/reference/standards/security.md +4 -0
  584. package/pack/generated/pi/skills/devrites-lib/reference/standards/testing.md +3 -1
  585. package/pack/generated/pi/skills/devrites-lib/reference/standards/tooling.md +9 -8
  586. package/pack/generated/pi/skills/devrites-lib/reference/standards/windows.md +3 -2
  587. package/pack/generated/pi/skills/devrites-lib/reference/standards/workflow-artifacts.md +2 -0
  588. package/pack/generated/pi/skills/devrites-lib/reference/workspace-artifact-schema.md +16 -16
  589. package/pack/generated/pi/skills/devrites-ux-shape/SKILL.md +1 -1
  590. package/pack/generated/pi/skills/overhaul/references/orchestration.md +3 -2
  591. package/pack/generated/pi/skills/rite/SKILL.md +1 -1
  592. package/pack/generated/pi/skills/rite-adopt/SKILL.md +1 -1
  593. package/pack/generated/pi/skills/rite-adopt/reference/adoption.md +1 -1
  594. package/pack/generated/pi/skills/rite-autocomplete/SKILL.md +5 -4
  595. package/pack/generated/pi/skills/rite-build/SKILL.md +4 -3
  596. package/pack/generated/pi/skills/rite-build/reference/afk-discipline.md +2 -0
  597. package/pack/generated/pi/skills/rite-build/reference/checkpoint-protocol.md +4 -1
  598. package/pack/generated/pi/skills/rite-build/reference/checkpoint.md +2 -0
  599. package/pack/generated/pi/skills/rite-build/reference/one-slice-cycle.md +1 -1
  600. package/pack/generated/pi/skills/rite-build/reference/output.md +2 -0
  601. package/pack/generated/pi/skills/rite-build/reference/parallel-batch.md +22 -12
  602. package/pack/generated/pi/skills/rite-build/reference/phase-contract.md +13 -3
  603. package/pack/generated/pi/skills/rite-build/reference/wright-dispatch.md +42 -25
  604. package/pack/generated/pi/skills/rite-clarify/SKILL.md +1 -1
  605. package/pack/generated/pi/skills/rite-converge/SKILL.md +4 -4
  606. package/pack/generated/pi/skills/rite-converge/reference/convergence-assessment.md +3 -3
  607. package/pack/generated/pi/skills/rite-define/SKILL.md +10 -5
  608. package/pack/generated/pi/skills/rite-doctor/SKILL.md +17 -2
  609. package/pack/generated/pi/skills/rite-dogfood/SKILL.md +1 -1
  610. package/pack/generated/pi/skills/rite-explain/SKILL.md +1 -1
  611. package/pack/generated/pi/skills/rite-explain/reference/intake.md +1 -1
  612. package/pack/generated/pi/skills/rite-fast/SKILL.md +1 -1
  613. package/pack/generated/pi/skills/rite-handoff/SKILL.md +3 -3
  614. package/pack/generated/pi/skills/rite-handoff/reference/handoff-template.md +1 -1
  615. package/pack/generated/pi/skills/rite-plan/SKILL.md +4 -4
  616. package/pack/generated/pi/skills/rite-plan/reference/slicing.md +3 -2
  617. package/pack/generated/pi/skills/rite-polish/SKILL.md +6 -3
  618. package/pack/generated/pi/skills/rite-prove/SKILL.md +1 -1
  619. package/pack/generated/pi/skills/rite-quick/SKILL.md +1 -1
  620. package/pack/generated/pi/skills/rite-resolve/SKILL.md +1 -1
  621. package/pack/generated/pi/skills/rite-review/SKILL.md +4 -4
  622. package/pack/generated/pi/skills/rite-seal/SKILL.md +2 -2
  623. package/pack/generated/pi/skills/rite-ship/SKILL.md +1 -1
  624. package/pack/generated/pi/skills/rite-spec/SKILL.md +1 -1
  625. package/pack/generated/pi/skills/rite-spec/reference/investigation.md +5 -5
  626. package/pack/generated/pi/skills/rite-spec/reference/spec-template.md +1 -1
  627. package/pack/generated/pi/skills/rite-spec/reference/state-workspace.md +6 -4
  628. package/pack/generated/pi/skills/rite-status/SKILL.md +1 -1
  629. package/pack/generated/pi/skills/rite-temper/SKILL.md +1 -1
  630. package/pack/generated/pi/skills/rite-temper/reference/review-dimensions.md +2 -2
  631. package/pack/generated/pi/skills/rite-temper/reference/scope-modes.md +2 -2
  632. package/pack/generated/pi/skills/rite-temper/reference/significance.md +2 -2
  633. package/pack/generated/pi/skills/rite-vet/SKILL.md +8 -4
  634. package/pack/generated/pi/skills/rite-vet/reference/artifacts.md +10 -3
  635. package/pack/generated/pi/skills/rite-vet/reference/depth.md +2 -2
  636. package/pack/generated/pi/skills/rite-vet/reference/review-axes.md +2 -2
  637. package/pack/generated/pi/skills/rite-zoom-out/SKILL.md +6 -6
  638. package/package.json +1 -1
  639. package/scripts/build-host-artifacts.sh +5 -4
  640. package/scripts/omp-generate.sh +3 -12
  641. package/scripts/pi-generate.sh +5 -51
@@ -5,7 +5,7 @@ argument-hint: "[idea] [--ship|--yolo] [--max-slices N] [--parallel N] [--full]
5
5
  user-invocable: true
6
6
  ---
7
7
 
8
- <!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-lib/reference/standards/afk-hitl.md","devrites-lib/reference/standards/one-shot-actions.md","devrites-lib/reference/orchestration-profiles.md","devrites-lib/reference/standards/acceptance-preserving-reslice.md","rite-autocomplete/reference/decision-policy.md","rite-autocomplete/reference/loop.md","rite-autocomplete/reference/stop-conditions.md"],"triggers":{"workflow-artifacts":["devrites-lib/reference/standards/workflow-artifacts.md"]},"workspace":["state.md","spec.md","plan.md","tasks.md","questions.md","decisions.md","drift.md","evidence.md","test-plan.md"]} -->
8
+ <!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-lib/reference/standards/afk-hitl.md","devrites-lib/reference/standards/one-shot-actions.md","devrites-lib/reference/orchestration-profiles.md","devrites-lib/reference/standards/acceptance-preserving-reslice.md","rite-autocomplete/reference/decision-policy.md","rite-autocomplete/reference/loop.md","rite-autocomplete/reference/stop-conditions.md"],"triggers":{"workflow-artifacts":["devrites-lib/reference/standards/workflow-artifacts.md"]},"workspace":["state.md","spec.md","plan.md","tasks.md","questions.md","decisions.md","drift.md","evidence.md","test-plan.md"],"rootOnly":["devrites-lib/reference/standards/afk-hitl.md","devrites-lib/reference/orchestration-profiles.md","devrites-lib/reference/standards/workflow-artifacts.md"]} -->
9
9
  > Read-set manifest: `devrites-engine context --skills-root .agents/skills <slug> --phase autocomplete` bundles every file named below into one deduplicated read. Trigger names map to the conditional rules in the sections that follow.
10
10
 
11
11
 
@@ -91,8 +91,9 @@ executable controller/harness/bundle bytes or a missing writer, read
91
91
  <!-- workflow-artifact-adapter: {"module":"devrites-lib/reference/standards/workflow-artifacts.md","entry":"lifecycle cursor encounters admitted set or resumable journal","action":"invoke classifier; execute returned route internally","return":"saved phase/action; zero intermediate reply"} -->
92
92
  Reconstruct a missing return cursor only from
93
93
  the current phase and exact approved action in `test-plan.md`/evidence, never
94
- from chat. After compaction or a resumed session, read `.devrites/ACTIVE`, then
95
- the `state.md` cursor, `questions.md`, `decisions.md`, and `test-plan.md`/`evidence.md`.
94
+ from chat. After compaction or a resumed session, always run `devrites-engine
95
+ handoff <slug> --resume` first (slug from `.devrites/ACTIVE`) and open only the
96
+ `read_next` artifacts it names, per [`context-hygiene.md`](../devrites-lib/reference/standards/context-hygiene.md) § Compaction fallback.
96
97
  Normalize current arguments to idea, `ship_preflight: yes|no`,
97
98
  `max_slices: unlimited`, `parallel: N|default`, `profile: standard|full`,
98
99
  and `cross_model: yes|no`.
@@ -113,7 +114,7 @@ executable controller/harness/bundle bytes or a missing writer, read
113
114
  `$rite-build` batch loop → `$rite-prove` → `$rite-polish` →
114
115
  `$rite-review` → `$rite-seal`. Read and execute each skill; durable files, not
115
116
  chat, carry state. Apply the mutable post-vet budget before first Build.
116
- Build runs the largest eligible path-disjoint batch (cap: this invocation's
117
+ Build runs the path-disjoint batch `parallel select --from-plan` picks (cap: this invocation's
117
118
  `--parallel N`, else sentinel `max_parallel`, else 10) and refills a slot
118
119
  per landing until no pending slice remains; a one-slice round is serial for that round only, then
119
120
  selection runs again (host isolation still forces serial when concurrent writers
@@ -5,7 +5,7 @@ argument-hint: "[--parallel N] [slice number or name]"
5
5
  user-invocable: true
6
6
  ---
7
7
 
8
- <!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-lib/reference/standards/code-navigation.md","devrites-lib/reference/standards/agents.md","rite-build/reference/phase-contract.md","rite-build/reference/one-slice-cycle.md","rite-build/reference/wright-dispatch.md","rite-build/reference/checkpoint.md","rite-build/reference/spec-drift-guard.md","rite-build/reference/output.md","rite-build/reference/anti-patterns.md"],"rootOnly":["rite-build/reference/phase-contract.md","rite-build/reference/wright-dispatch.md","rite-build/reference/checkpoint.md","rite-build/reference/output.md","rite-build/reference/afk-discipline.md","rite-build/reference/checkpoint-protocol.md","rite-build/reference/parallel-batch.md","devrites-lib/reference/standards/afk-hitl.md","devrites-lib/reference/standards/workflow-artifacts.md"],"triggers":{"afk":["rite-build/reference/afk-discipline.md","devrites-lib/reference/standards/afk-hitl.md","rite-build/reference/checkpoint-protocol.md"],"applicability":["devrites-lib/reference/standards/repository-topology.md","devrites-lib/reference/standards/data-integrity.md","devrites-lib/reference/standards/integration-reliability.md"],"coding":["devrites-lib/reference/standards/coding-style.md"],"debug-recovery":["devrites-lib/reference/standards/debug-recovery.md"],"dod":["devrites-lib/reference/standards/definition-of-done.md"],"errors":["devrites-lib/reference/standards/error-handling.md"],"frontend":["rite-build/reference/frontend-trigger.md"],"parallel":["rite-build/reference/parallel-batch.md"],"patterns":["devrites-lib/reference/standards/patterns.md"],"principles":["devrites-lib/reference/standards/principles.md"],"security":["devrites-lib/reference/standards/security.md"],"tdd":["rite-build/reference/tdd.md","devrites-lib/reference/standards/testing.md"],"workflow-artifacts":["devrites-lib/reference/standards/workflow-artifacts.md"]},"workspace":["brief.md","spec.md","state.md","decisions.md","assumptions.md","questions.md","decision-coverage.md","architecture.md","plan.md","tasks.md","traceability.md","eng-review.md","test-plan.md","gates.md","strategy.md"],"workspaceByRole":{"code-reviewer":["spec.md","plan.md","tasks.md","test-plan.md","architecture.md","decisions.md","state.md"],"doubt-reviewer":["spec.md","plan.md","tasks.md","state.md","decisions.md"],"slice-wright":["brief.md","spec.md","architecture.md","plan.md","tasks.md","test-plan.md","state.md","decisions.md","assumptions.md","questions.md"],"test-analyst":["spec.md","tasks.md","test-plan.md","state.md"]}} -->
8
+ <!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-lib/reference/standards/code-navigation.md","devrites-lib/reference/standards/code-index.md","devrites-lib/reference/standards/agents.md","rite-build/reference/phase-contract.md","rite-build/reference/one-slice-cycle.md","rite-build/reference/wright-dispatch.md","rite-build/reference/checkpoint.md","rite-build/reference/spec-drift-guard.md","rite-build/reference/output.md","rite-build/reference/anti-patterns.md"],"rootOnly":["devrites-lib/reference/standards/code-index.md","rite-build/reference/phase-contract.md","rite-build/reference/wright-dispatch.md","rite-build/reference/checkpoint.md","rite-build/reference/output.md","rite-build/reference/afk-discipline.md","rite-build/reference/checkpoint-protocol.md","rite-build/reference/parallel-batch.md","devrites-lib/reference/standards/afk-hitl.md","devrites-lib/reference/standards/workflow-artifacts.md"],"triggers":{"afk":["rite-build/reference/afk-discipline.md","devrites-lib/reference/standards/afk-hitl.md","rite-build/reference/checkpoint-protocol.md"],"applicability":["devrites-lib/reference/standards/repository-topology.md","devrites-lib/reference/standards/data-integrity.md","devrites-lib/reference/standards/integration-reliability.md"],"coding":["devrites-lib/reference/standards/coding-style.md"],"debug-recovery":["devrites-lib/reference/standards/debug-recovery.md"],"dod":["devrites-lib/reference/standards/definition-of-done.md"],"errors":["devrites-lib/reference/standards/error-handling.md"],"frontend":["rite-build/reference/frontend-trigger.md"],"parallel":["rite-build/reference/parallel-batch.md"],"patterns":["devrites-lib/reference/standards/patterns.md"],"principles":["devrites-lib/reference/standards/principles.md"],"security":["devrites-lib/reference/standards/security.md"],"tdd":["rite-build/reference/tdd.md","devrites-lib/reference/standards/testing.md"],"workflow-artifacts":["devrites-lib/reference/standards/workflow-artifacts.md"]},"workspace":["brief.md","spec.md","state.md","decisions.md","assumptions.md","questions.md","decision-coverage.md","architecture.md","plan.md","tasks.md","traceability.md","eng-review.md","test-plan.md","gates.md","strategy.md"],"workspaceByRole":{"code-reviewer":["spec.md","plan.md","tasks.md","test-plan.md","architecture.md","decisions.md","state.md"],"doubt-reviewer":["spec.md","plan.md","tasks.md","state.md","decisions.md"],"slice-wright":["brief.md","spec.md","architecture.md","plan.md","tasks.md","test-plan.md","state.md","decisions.md","assumptions.md","questions.md"],"test-analyst":["spec.md","tasks.md","test-plan.md","state.md"]}} -->
9
9
  > Read-set manifest: `devrites-engine context --skills-root .agents/skills <slug> --phase build` bundles every file named below into one deduplicated read. Trigger names map to the conditional rules in the sections that follow.
10
10
 
11
11
 
@@ -29,7 +29,8 @@ Execute [`reference/phase-contract.md`](reference/phase-contract.md)
29
29
  [`reference/wright-dispatch.md`](reference/wright-dispatch.md).
30
30
  Every wright contract names the writer-safe checks the wright runs (syntax/type/lint,
31
31
  unit and self-check suites, a narrow local smoke) and never forbids them; only
32
- artifact-producing, consumptive, or full canonical gates stay root-owned;
32
+ artifact-producing, consumptive, or full canonical gates stay root-owned, and a
33
+ `RUN: writer` gate adds `gates precheck` to them;
33
34
  `dispatch open --contract` refuses a contract that breaks this. Prior contracts in `evidence.md` are not a template for this. **Failing case:** the
34
35
  contract says "skip tests mid-flight; root runs them after return", and the wright
35
36
  returns three unit failures that a 20 s `go test` would have caught in-round.
@@ -80,7 +81,7 @@ Wright applies anti-slop; root verifies returns and never patches source. Refuse
80
81
  ## `--parallel N` (opt-in)
81
82
 
82
83
  Omitted/`1` ≡ serial; `2`–`10` is a **cap** — the root runs the largest eligible
83
- path-disjoint set it can start now (`N_eff`), takes fewer when the cap cannot be
84
+ path-disjoint set it can start now (`N_eff`, from `parallel select --from-plan`), takes fewer when the cap cannot be
84
85
  filled, and refills a slot per landing (serial slice or one sibling) until
85
86
  no pending slice remains
86
87
  ([`parallel-batch.md` § Dynamic selection](reference/parallel-batch.md#dynamic-selection-and-re-batching)).
@@ -1,5 +1,7 @@
1
1
  # AFK discipline for unattended `$rite-build`
2
2
 
3
+ > Root-only: not inlined in --role bundles.
4
+
3
5
  AFK mode is active when `.devrites/AFK` exists. It lets `$rite-build` chain slices
4
6
  without per-slice user input. The rules below limit that unattended work.
5
7
 
@@ -1,5 +1,7 @@
1
1
  # Checkpoint protocol: what `$rite-build` does when a slice is HITL
2
2
 
3
+ > Root-only: not inlined in --role bundles.
4
+
3
5
  HITL slices pause **pre-action** as a ranked **option set** before any code:
4
6
 
5
7
  - **Interactive:** `AskUserQuestion`; record to `questions.md`/`decisions.md`; clear gate;
@@ -48,8 +50,9 @@ rewrite; do not claim cross-file atomicity):
48
50
  options: | # the ranked set, recommended first (matches the render)
49
51
  1. <recommended> (Recommended) — logic: … · infra: … · business: … · architecture: …
50
52
  2. <alternative> — <rationale>
53
+ 3. Something else — describe it
51
54
  proposed: <the recommended option restated; matches option 1>
52
- raised_at: <iso>
55
+ raised_at: <full RFC 3339 timestamp, e.g. 2026-10-19T08:17:08Z>
53
56
  ```
54
57
 
55
58
  2. **`state.md` updates:** cursor `status` = `awaiting_human`, `active_slice` =
@@ -1,5 +1,7 @@
1
1
  # Checkpoint: land local WIP only after the check loop is green
2
2
 
3
+ > Root-only: not inlined in --role bundles.
4
+
3
5
  The wright does not commit onto the control/primary branch. Independent review
4
6
  and fail-on-red proof run first; a red or gap finding dispatches another wright.
5
7
  Only when that loop is green does the orchestrator land the local unpushed
@@ -14,7 +14,7 @@ The orchestrator (`$rite-build`) gates and records; the **wright** writes. See
14
14
  SELECT → orchestrator: restate slice goal + acceptance + scope boundary; HITL gate (pause pre-code)
15
15
  (SHAPE) → orchestrator: missing UI design-brief.md → shape it, then $rite-vet before dispatch
16
16
  DISPATCH → hand the slice contract to devrites-slice-wright (fresh context). Inside the wright:
17
- ORIENT → load only the files this slice touches; learn the project's idiom; reuse-first
17
+ ORIENT → load only the files this slice touches; learn the project's idiom; reuse-first; affected set via `trace_path` (`../../devrites-lib/reference/standards/code-navigation.md`)
18
18
  (RED) → if behavior change: write the failing test first
19
19
  IMPLEMENT → smallest complete version; match conventions; devrites-frontend-craft for UI
20
20
  VERIFY → writer-safe tests/types/lint; return code + tests (no control-branch commit)
@@ -1,5 +1,7 @@
1
1
  # rite-build output
2
2
 
3
+ > Root-only: not inlined in --role bundles.
4
+
3
5
  **Slices remain:**
4
6
 
5
7
  ```text
@@ -1,5 +1,7 @@
1
1
  # Parallel batch (`--parallel N`)
2
2
 
3
+ > Root-only: not inlined in --role bundles.
4
+
3
5
  Opt-in only. Default `$rite-build` stays [`one-slice-cycle.md`](one-slice-cycle.md).
4
6
 
5
7
  ## Entry
@@ -30,15 +32,18 @@ N_eff = min(
30
32
  )
31
33
  ```
32
34
 
33
- Select **greedily in plan order**: pass every currently dependency-ready pending slice
34
- (plan order, `Files likely touched`) to
35
- `devrites-engine parallel select --cap N [--root <dir>]`. `N_eff ≥ 2` → parallel batch;
35
+ Select **greedily in plan order** with
36
+ `devrites-engine parallel select --slug <slug> --cap N --from-plan`: the engine
37
+ reads the ready set (tasks.md dependencies checked `built` in `state.md`, minus
38
+ running-lease slices) and each slice's Writer allowlist (else `Files likely
39
+ touched`), plus its manifest/lockfile when `External dependencies:` is not none;
40
+ in Build, `next` prints the same `eligible_now:`/`batch:`. `N_eff ≥ 2` → parallel batch;
36
41
  `N_eff = 1` → one serial round; nothing pending → Prove. A cap that cannot be filled
37
42
  is normal: take fewer. Serial is this round's size, not the rest of the run.
38
43
 
39
44
  **Refill per landing; never wait for the batch.** Each sibling lands alone when
40
45
  green ([Lifecycle](#lifecycle) step 6). Then re-read `state.md`, pending slices, and
41
- the tree and run `parallel select --cap N --slug <slug>`: unlanded siblings hold
46
+ the tree and run `parallel select --slug <slug> --cap N --from-plan`: unlanded siblings hold
42
47
  their slots and paths, landed ones count as built, and only new picks print;
43
48
  `parallel add` starts each from the control tip and its wright dispatches at once.
44
49
  No lease → plain `select` + `create`. AFK/autocomplete is one run; HITL stops after
@@ -66,8 +71,13 @@ Before `parallel select`, add each slice's hidden write surfaces (list owner:
66
71
  [repository-topology.md § Ownership rules](../../devrites-lib/reference/standards/repository-topology.md#ownership-rules))
67
72
  — lockfile/manifest, the generated target of an edited source, migration chain,
68
73
  snapshot directory, formatter sweep — and compare paths case-folded
69
- (`src/Api.ts` = `src/api.ts`). Slices colliding on either run serially; the rest
70
- stay eligible. Record `serial: <ids> — <surface>` in `evidence.md`. **Failing
74
+ (`src/Api.ts` = `src/api.ts`); `--from-plan` adds the manifest/lockfile itself.
75
+ Slices colliding on either run serially; the rest
76
+ stay eligible. Record `serial: <ids> — <surface>` in `evidence.md`. Under AFK
77
+ with `max_parallel ≥ 2`, `dispatch open` refuses a first-round build wright wave
78
+ narrower than the from-plan batch (printing batch and command) until the wave
79
+ holds that batch or `serial:` names every skipped pick; repair rounds, lease
80
+ siblings, and HITL runs are never refused. **Failing
71
81
  case:** two slices each add a dependency, run in parallel, and integrate fails or
72
82
  lands a broken lockfile.
73
83
 
@@ -87,12 +97,12 @@ Lease: `batch_id`, `created_at`, `base_sha`, `n`,
87
97
 
88
98
  1. Orient/gate; parse the cap; compute `N_eff` and select the eligible set
89
99
  ([Dynamic selection and re-batching](#dynamic-selection-and-re-batching)) —
90
- candidates from `orient` `task_graph.slices` + built list, each candidate's
91
- `Files likely touched` via `observe slice`, then
92
- `parallel select --cap N` (pairwise disjointness is inside that verb).
100
+ `parallel select --slug <slug> --cap N --from-plan` (ready set, write paths,
101
+ and pairwise disjointness are inside that verb).
93
102
  Preflight each selected slice with `devrites-engine check slice <slug>
94
- <id>`; a malformed contract is dropped from the batch and recorded as a
95
- gap, not dispatched.
103
+ <id>`, plus `check preconditions <slug> --slice <id>` when it has a
104
+ `pre-dispatch <id>` preflight row; a malformed contract or non-zero
105
+ precondition is dropped from the batch and recorded as a gap, not dispatched.
96
106
  2. Write lease; freeze `B=HEAD`; `parallel create` worktrees.
97
107
  3. Dispatch ≤10 wrights in parallel (cwd=worktree; allowlist; prove `HEAD==B`;
98
108
  one `--slice` per sibling on the wave).
@@ -196,7 +206,7 @@ Repair rejected work in place; never discard/rebuild while budget remains.
196
206
  ## Engine verbs
197
207
 
198
208
  ```text
199
- devrites-engine parallel select --cap <1-10> [--root <dir>] [--slug <slug>] [<json-file>|-]
209
+ devrites-engine parallel select --cap <1-10> [--root <dir>] [--slug <slug>] [--from-plan | <json-file>|-]
200
210
  devrites-engine parallel create --root <repo> --slug <slug> --batch <id> --base <B> --json <file>|-
201
211
  devrites-engine parallel add --root <repo> --slug <slug> --json <file>|-
202
212
  devrites-engine parallel record-green --root <repo> --slug <slug> --slice <id> --commit <sha>
@@ -1,5 +1,7 @@
1
1
  # rite-build phase contract
2
2
 
3
+ > Root-only: not inlined in --role bundles.
4
+
3
5
  Apply [`one-slice-cycle.md`](one-slice-cycle.md) and
4
6
  [`candidate-integrity.md`](../../devrites-lib/reference/candidate-integrity.md).
5
7
  Opt-in `--parallel N` replaces steps 2–8 with [`parallel-batch.md`](parallel-batch.md);
@@ -30,7 +32,7 @@ Spec Drift Guard still applies.
30
32
  paths; wright cannot widen scope; missing profile blocks.
31
33
  <!-- workflow-artifact-adapter: {"module":"devrites-lib/reference/standards/workflow-artifacts.md","entry":"Build gate enters or resumes transaction","action":"invoke canonical operation table; reconcile exact result","return":"same slice/checkpoint cursor or Plan/Vet route"} -->
32
34
  4. **Inspect.** Wait; run `devrites-engine check diff-scope <slug> --allow
33
- <contract-paths>` for the mechanical returned-paths ⊆ contract check **before**
35
+ <contract-paths> --baseline` (after a pre-dispatch `--snapshot`) for the mechanical returned-paths ⊆ contract check **before**
34
36
  any reviewer dispatch — a violation returns through the bounded wright without
35
37
  spending review. Then compare returned paths and `git diff --name-only` with the
36
38
  contract for semantics diff-scope cannot judge (stale/partial/malformed work;
@@ -78,7 +80,10 @@ without the section, run every row each round.
78
80
 
79
81
  ## Independent Build review
80
82
 
81
- After inspection, freeze full slice scope and cumulative baseline diff. Initial
83
+ After inspection, freeze full slice scope and cumulative baseline diff with
84
+ `devrites-engine candidate freeze <slug> --wave <w> --slice <SLICE-ID> --base <baseline>`;
85
+ render each reviewer packet with `devrites-engine packet` (never hand-written; a doubt
86
+ reviewer's `--focus` holds its claim, 1-3 rows `- <DEC-ID> decisions.md:<line> <claim>`). Initial
82
87
  inventory: one full-diff `devrites-code-reviewer`, one `devrites-test-analyst`,
83
88
  and one exact `devrites-doubt-reviewer` per stood decision that meets
84
89
  `devrites-doubt` § When to use (boundary, data model, auth, public API, migration,
@@ -86,7 +91,8 @@ user flow, assumption tests cannot prove); other stood decisions are recorded in
86
91
  `decisions.md` without dispatch. Bundles take `--slice <SLICE-ID>`. Dispatch fresh,
87
92
  read-only under [`parallel-dispatch.md`](../../devrites-lib/reference/parallel-dispatch.md).
88
93
  Wait for every required account to become terminal; missing/gap needs a valid result.
89
- Fold supported in-scope Critical/Important findings by cause into one inventory.
94
+ Fold supported in-scope Critical/Important findings by cause into one inventory; a
95
+ row `check anchors` leaves Unverified or Deferred never enters it.
90
96
  Dispatch one repair-all wright instructed to fix every finding, then attack its own
91
97
  correction for fix-introduced defects before returning; durable contract defects use Spec
92
98
  Drift Guard.
@@ -97,6 +103,10 @@ all open findings owned by that role and affected dependency/regression closure
97
103
  in one fresh dispatch. Supply new candidate, inventory, correction diff, tests
98
104
  and unchanged-coverage evidence under candidate integrity; include newly triggered
99
105
  roles. A changed contract or uncertain impact requires the full inventory.
106
+ A bounded recheck bundle adds `--recheck <inventory-file>` (open `Finding:` rows
107
+ plus correction-diff paths) to its `--slice` bundle, and its `packet` adds `--recheck`: inventory and core inline, every
108
+ other triggered standard by anchor index plus each `<file>.md § <heading>` the
109
+ findings cite. First reviews and full-inventory rechecks keep the plain bundle.
100
110
  Collect all required rechecks before another folded correction. Canonical recovery
101
111
  owns fingerprints/budget and the
102
112
  [late-finding rule](../../devrites-lib/reference/standards/afk-hitl.md#retry-cap-no-progress-loops-and-self-resolve):
@@ -1,5 +1,7 @@
1
1
  # Slice-wright dispatch
2
2
 
3
+ > Root-only: not inlined in --role bundles.
4
+
3
5
  `$rite-build` gives one bounded task to exact `devrites-slice-wright`.
4
6
  Root owns scope/artifacts/inspection; never writes source/tests.
5
7
  Wright alone writes; no agents.
@@ -54,15 +56,19 @@ worktrees stay forbidden.
54
56
  1. Run `devrites-engine check slice <slug> <SLICE-ID>` first — it fails a
55
57
  malformed contract (missing goal, empty/invalid Writer allowlist,
56
58
  unresolvable `Satisfies` AC ids, empty proof field) before a wright
57
- context is spent; a failure is a gap, not a dispatch. Then derive the
59
+ context is spent; a failure is a gap, not a dispatch. A slice with a
60
+ `pre-dispatch <SLICE-ID>` preflight row next runs
61
+ `devrites-engine check preconditions <slug> --slice <SLICE-ID>` before
62
+ `dispatch open`; non-zero is the same gap. Then derive the
58
63
  smallest exact project-relative source/test path list; reject
59
64
  directories/globs, traversal, symlink escapes, duplicates, and `.devrites/**`.
60
65
  A target composed only of vetted executable workflow artifacts routes to the
61
66
  controlling root under
62
67
  [`workflow-artifacts.md`](../../devrites-lib/reference/standards/workflow-artifacts.md);
63
68
  its rejection here is not a blocker.
64
- 2. Include goal, verbatim acceptance, exclusions, context,
65
- `test-plan.md` proof commands, applicable standards, and the exact
69
+ 2. Goal, verbatim acceptance, exclusions, context, `test-plan.md` proof
70
+ commands, and applicable standards reach the wright through the slice bundle
71
+ its contract names; only a native-worktree pilot contract adds the exact
66
72
  `WIP(<slug>):` subject (no slice id). Build the wright's read-set with
67
73
  `devrites-engine context --skills-root .agents/skills <slug> --phase build --role slice-wright --slice <SLICE-ID> --trigger <set>`
68
74
  and hand it the bundle path (over-budget artifacts arrive as anchor indexes;
@@ -70,41 +76,46 @@ worktrees stay forbidden.
70
76
  that fire (TDD slice → `tdd`, AFK run → `afk`, UI work → `frontend`, …).
71
77
  The command prints `unselected=[...]`; an omitted applicable trigger is a gap.
72
78
  For each triggered
73
- topology/data/integration standard, include only the feature-specific owner/invariant,
79
+ topology/data/integration standard, add as anchored `--focus` rows only the feature-specific owner/invariant,
74
80
  failure or partial-state case, recovery rule, and required proof from the vetted plan.
75
81
  Do not paste the whole standard or silently omit an applicable risk.
76
- Quote every active `decisions.md` carry-forward constraint whose `Files:`
82
+ Quote, as a `--focus` row, every active `decisions.md` carry-forward constraint whose `Files:`
77
83
  overlap the task paths (or that names no files).
78
84
  A new path requires a new bounded contract; the wright cannot widen the task.
79
- Name the writer-safe commands the wright must run (syntax/type/lint, unit and
85
+ Name (`--checks` gate IDs) the writer-safe commands the wright must run (syntax/type/lint, unit and
80
86
  self-check suites, a narrow local smoke of the changed path) and never forbid
81
87
  them: a wright that cannot execute writes blind and its failures surface a
82
88
  whole review round later. Only artifact-producing, consumptive, or full
83
- canonical feature gates stay root-owned.
84
- 3. Record `git diff --name-only` before dispatch so unrelated work remains
85
- distinguishable. For an isolated pilot, also record committed base SHA and exact
89
+ canonical feature gates stay root-owned; when `gates.md` has a `RUN: writer`
90
+ gate, the checks include `devrites-engine gates precheck <slug> --worktree <path>`
91
+ (those gates plus `check windows`; never evidence, root still runs every gate).
92
+ 3. Run `devrites-engine check diff-scope <slug> --snapshot` before dispatch so
93
+ unrelated work remains distinguishable (it fingerprints every dirty path). For an isolated pilot, also record committed base SHA and exact
86
94
  baseline status before asking the host for isolation. **Failing case:** paths that
87
95
  were dirty at that baseline are listed as slice-owned after dispatch.
88
96
 
89
97
  ## Run
90
98
 
91
- Same-worktree (non-isolated) dispatch claims before writing: `devrites-engine
92
- claim add --session <id> <task-paths>`; retain its returned `<claim-id>`, then run
93
- `devrites-engine claim check --session <id> <task-paths>` — a held claim from a
94
- live foreign session releases the retained claim and stops the dispatch, per
99
+ Same-worktree (non-isolated) dispatch claims before writing: the `dispatch open`
100
+ below adds `--claim-session <id>`, one `--claim <path>` per task path, and
101
+ `--claim-ttl <minutes>` sized to the write; it runs the
102
+ `claim check --session <id> <task-paths>` test, and a live foreign holder fails the
103
+ open with no wave and no claim and stops the dispatch, per
95
104
  [`agents.md`](../../devrites-lib/reference/standards/agents.md). `.devrites/**`
96
105
  is never a task path; see [Workflow Artifact admission](../../devrites-lib/reference/standards/workflow-artifacts.md).
97
- Write the exact contract, with its `Writer-safe checks:` line, to
98
- `packets/<wave>.contract.md` and hand the wright that text verbatim. Reviewers read
99
- that file, so it states each defect to fix with its anchor, never a reviewer's verdict,
106
+ Render the contract with `devrites-engine packet <slug> --wave <wave> --phase build
107
+ --role slice-wright --slice <SLICE-ID> --checks <G-ID,...> [--focus <file>]` (it
108
+ writes the linted same-worktree `packets/<wave>.contract.md`; a native-worktree pilot
109
+ writes its own contract with `Isolation`, `worktree_base`, and subject) and hand the wright that text verbatim. Reviewers read
110
+ that file, so `--focus` rows state each defect to fix with its anchor, never a reviewer's verdict,
100
111
  count, or pass status ("code review is no-findings" voids the next review). Ask the host
101
112
  for the exact writer in fresh context; a repair round on the same slice whose
102
113
  returned wright the host can still continue goes to that wright on its existing
103
114
  handle instead, so it does not re-read the slice from scratch. Wait, and track it
104
115
  through the launch barrier — `devrites-engine dispatch <slug> open --phase build --wave
105
116
  <slice-id> --role slice-wright --slice <SLICE-ID> --contract <file>` (it refuses a
106
- contract that forbids writer-safe checks or names none), then `start` with the host handle, `seal`, and
107
- `return` on completion (auto-records dispatch/return metrics). Every 5 wright
117
+ contract that forbids writer-safe checks or names none), then `start` with the host handle
118
+ (the last start seals the wave) and `return` on completion (auto-records dispatch/return metrics). Every 5 wright
108
119
  rounds on one slice, `open` blocks for a reslice review. First re-admit each
109
120
  finding still driving rounds under the Proportionality rule of
110
121
  [agents.md § Result admission](../../devrites-lib/reference/standards/agents.md#result-admission): one without a broken anchor or a reachable trigger becomes a
@@ -121,17 +132,23 @@ writers in one worktree, run isolated and same-worktree writers concurrently, or
121
132
  substitute a generic agent. Opt-in `$rite-build --parallel N` fans out only under
122
133
  [`parallel-batch.md`](parallel-batch.md).
123
134
 
124
- After `claim add`, every terminal path releases the claim with
125
- `devrites-engine claim release --session <id> --id <claim-id>`: successful
126
- return, rejected result, stop, or a launch the host refused with no handle. A
135
+ The `return` that completes the wave releases its claim; `dispatch abandon --release`
136
+ releases it on any other host-confirmed terminal path (a stop, a launch refused with no
137
+ handle, or a timed-out child later confirmed terminal). A `claim add` claim releases
138
+ with `devrites-engine claim release --session <id> --id <claim-id>` on every terminal path:
139
+ successful return, rejected result, stop, or a launch the host refused with no handle. A
127
140
  timeout or unknown outcome keeps the claim ([`parallel-dispatch.md`](../../devrites-lib/reference/parallel-dispatch.md#cancellation-and-terminal-reconciliation)).
128
141
  TTL is crash recovery, not normal cleanup.
142
+ An `unattributed root edit` exit 3 (root-edit tripwire) routes the path through a wright wave naming it in
143
+ `--claim`, or, given evidence (owner work, gate output, a standalone wright, Polish ADR/`DESIGN.md`),
144
+ `dispatch <slug> attribute --reason <evidence> --path <path>`.
129
145
 
130
146
  ## Inspect and prove
131
147
 
132
148
  1. Compare the returned file list and `git diff --name-only` with task paths.
133
- `devrites-engine check diff-scope <slug> --allow <task-paths>` is the
134
- mechanical subset gate — run it before any reviewer dispatch; a violation
149
+ `devrites-engine check diff-scope <slug> --allow <task-paths> --baseline` is the
150
+ mechanical subset gate (a step-3 path whose bytes are unchanged is not a
151
+ violation; a changed one still is) — run it before any reviewer dispatch; a violation
135
152
  restores through the bounded wright without spending review, but only for a
136
153
  path the wright's `files_changed` or diff trace attributes to it. An
137
154
  unattributed extra path that was clean at the step-3 baseline is preserved
@@ -141,8 +158,8 @@ TTL is crash recovery, not normal cleanup.
141
158
  whether empty or filled — or adds a path. Root never widens scope or edits
142
159
  source.
143
160
  2. Run `devrites-engine check windows <slug>` on the wright's diff (`--worktree`
144
- in the same tree; `--base <B> --cwd <worktree>` for a parallel transfer
145
- commit). Each unwaived hit is repaired through the bounded wright or gets a
161
+ in the same tree, plus `--since-dispatch <wave>` naming a repair round's wave;
162
+ `--base <B> --cwd <worktree>` for a parallel transfer commit). Each unwaived hit is repaired through the bounded wright or gets a
146
163
  reasoned `windows.md` row before review; never waive to reach green. Then
147
164
  inspect the test diff for deletion, skipping, focus markers, or loosened
148
165
  assertions. Dedicated test analysis treats weakening as Critical.
@@ -5,7 +5,7 @@ argument-hint: "[feature-slug]"
5
5
  user-invocable: true
6
6
  ---
7
7
 
8
- <!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-lib/reference/standards/afk-hitl.md","rite-clarify/reference/decision-coverage.md","rite-clarify/reference/anti-patterns.md"],"triggers":{"agents":["devrites-lib/reference/standards/agents.md"]},"workspace":["brief.md","spec.md","state.md","decisions.md","assumptions.md","questions.md","decision-coverage.md"],"workspaceByRole":{"evidence-scout":["brief.md","spec.md","state.md","questions.md"]}} -->
8
+ <!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-lib/reference/standards/code-navigation.md","devrites-lib/reference/standards/code-index.md","devrites-lib/reference/standards/afk-hitl.md","rite-clarify/reference/decision-coverage.md","rite-clarify/reference/anti-patterns.md"],"triggers":{"agents":["devrites-lib/reference/standards/agents.md"]},"workspace":["brief.md","spec.md","state.md","decisions.md","assumptions.md","questions.md","decision-coverage.md"],"workspaceByRole":{"evidence-scout":["brief.md","spec.md","state.md","questions.md"]},"rootOnly":["devrites-lib/reference/standards/code-index.md","devrites-lib/reference/standards/afk-hitl.md"]} -->
9
9
  > Read-set manifest: `devrites-engine context --skills-root .agents/skills <slug> --phase clarify` bundles every file named below into one deduplicated read. Trigger names map to the conditional rules in the sections that follow.
10
10
 
11
11
 
@@ -5,7 +5,7 @@ argument-hint: "[feature-slug]"
5
5
  user-invocable: true
6
6
  ---
7
7
 
8
- <!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-lib/reference/standards/spec-grammar.md","devrites-lib/reference/standards/agents.md","devrites-lib/reference/standards/tooling.md","devrites-lib/reference/standards/testing.md","rite-converge/reference/convergence-assessment.md","rite-converge/reference/anti-patterns.md","rite-build/reference/spec-drift-guard.md"],"triggers":{"applicability":["devrites-lib/reference/standards/repository-topology.md","devrites-lib/reference/standards/data-integrity.md","devrites-lib/reference/standards/integration-reliability.md"],"principles":["devrites-lib/reference/standards/principles.md"],"workflow-artifacts":["devrites-lib/reference/workspace-artifact-schema.md"]},"workspace":["brief.md","spec.md","state.md","decisions.md","assumptions.md","questions.md","decision-coverage.md","architecture.md","plan.md","tasks.md","traceability.md","eng-review.md","test-plan.md","gates.md","evidence.md"],"workspaceByRole":{"evidence-scout":["spec.md","plan.md","tasks.md","state.md","evidence.md"]}} -->
8
+ <!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-lib/reference/standards/code-navigation.md","devrites-lib/reference/standards/code-index.md","devrites-lib/reference/standards/spec-grammar.md","devrites-lib/reference/standards/agents.md","devrites-lib/reference/standards/tooling.md","devrites-lib/reference/standards/testing.md","rite-converge/reference/convergence-assessment.md","rite-converge/reference/anti-patterns.md","rite-build/reference/spec-drift-guard.md"],"triggers":{"applicability":["devrites-lib/reference/standards/repository-topology.md","devrites-lib/reference/standards/data-integrity.md","devrites-lib/reference/standards/integration-reliability.md"],"principles":["devrites-lib/reference/standards/principles.md"],"workflow-artifacts":["devrites-lib/reference/workspace-artifact-schema.md"]},"workspace":["brief.md","spec.md","state.md","decisions.md","assumptions.md","questions.md","decision-coverage.md","architecture.md","plan.md","tasks.md","traceability.md","eng-review.md","test-plan.md","gates.md","evidence.md"],"workspaceByRole":{"evidence-scout":["spec.md","plan.md","tasks.md","state.md","evidence.md"]},"rootOnly":["devrites-lib/reference/standards/code-index.md","devrites-lib/reference/standards/tooling.md"]} -->
9
9
  > Read-set manifest: `devrites-engine context --skills-root .agents/skills <slug> --phase converge` bundles every file named below into one deduplicated read. Trigger names map to the conditional rules in the sections that follow.
10
10
 
11
11
 
@@ -33,8 +33,8 @@ Pull on demand:
33
33
  - [`spec-grammar.md`](../devrites-lib/reference/standards/spec-grammar.md): buildable acceptance criteria vs `## Success metrics` (outcome KPIs the
34
34
  code can't make true and this pass never enqueues); structured `### Requirement:` /
35
35
  `#### Scenario:` blocks, each scenario one behavior to check as built / partial / absent.
36
- - [`tooling.md`](../devrites-lib/reference/standards/tooling.md): use the primary available code index; cross-check only a named unresolved
37
- predicate, then fall back to LSP/file search. Read live code, not artifact claims.
36
+ - [`code-navigation.md`](../devrites-lib/reference/standards/code-navigation.md): find each unit's code with codebase-memory `search_graph`
37
+ and `get_code_snippet`, check cited paths with `check_index_coverage`, then fall back to LSP/file search. Read live code, not artifact claims.
38
38
  - [`testing.md`](../devrites-lib/reference/standards/testing.md): a criterion with code but no covering test is *partial*, not done.
39
39
  - [`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 for
40
40
  triggered applicability rows; missing failure/recovery behavior is partial or absent.
@@ -94,7 +94,7 @@ Pull on demand:
94
94
  proof still agrees with its `test-plan.md` row, and the mapped prose preserves the
95
95
  requirement's meaning. Record orphaned, invented, duplicate, or contradictory
96
96
  mappings as gaps. Then read the live code
97
- (code-intelligence index per [`tooling.md`](../devrites-lib/reference/standards/tooling.md)); artifact mappings never prove implementation.
97
+ (codebase-memory per [`code-navigation.md`](../devrites-lib/reference/standards/code-navigation.md)); artifact mappings never prove implementation.
98
98
  4. **Assess each unit as built / partial / absent** against the live code (the rubric is in
99
99
  [`reference/convergence-assessment.md`](reference/convergence-assessment.md)): every
100
100
  acceptance criterion / scenario, every plan touch-point, and every existing slice's stated
@@ -25,9 +25,9 @@ slice.
25
25
  | **partial** | Some of it exists: happy path only, un-wired, untested, a TODO stub, or an edge case from the scenario's WHEN/THEN missing. | Append a slice for the **remainder**, its `Known-Gotchas` naming what's already there so `$rite-build` extends rather than rebuilds. |
26
26
  | **absent** | No code implements it. | Append a full slice. |
27
27
 
28
- Read the code to decide: do not infer from the plan. Apply [`tooling.md`](../../devrites-lib/reference/standards/tooling.md): use the
29
- primary available code index, cross-check only a named unresolved predicate, then use LSP/file
30
- search so the verdict reflects live code. Read `traceability.md` to see what is mapped; only
28
+ Read the code to decide: do not infer from the plan. Apply [`code-navigation.md`](../../devrites-lib/reference/standards/code-navigation.md): locate
29
+ code with codebase-memory `search_graph`, confirm cited paths with `check_index_coverage`, then use
30
+ LSP/file search so the verdict reflects live code. Read `traceability.md` to see what is mapped; only
31
31
  code and tests tell you what is built.
32
32
 
33
33
  Treat accepted invariants, failure/recovery rows, and triggered applicability obligations as
@@ -5,7 +5,7 @@ argument-hint: "[feature-slug]"
5
5
  user-invocable: true
6
6
  ---
7
7
 
8
- <!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-lib/reference/standards/spec-grammar.md","rite-define/reference/plan-template.md","rite-define/reference/gates.md","rite-define/reference/anti-patterns.md","rite-plan/reference/slicing.md","rite-plan/reference/task-breakdown.md","rite-spec/reference/acceptance-criteria.md","rite-spec/reference/state-workspace.md"],"triggers":{"afk":["devrites-lib/reference/standards/afk-hitl.md"],"agents":["devrites-lib/reference/standards/agents.md"],"applicability":["devrites-lib/reference/standards/repository-topology.md","devrites-lib/reference/standards/data-integrity.md","devrites-lib/reference/standards/integration-reliability.md"],"documentation":["devrites-lib/reference/standards/documentation.md"],"elicitation":["devrites-lib/reference/standards/elicitation.md"],"frontend":["devrites-frontend-craft/reference/fullstack.md"],"principles":["devrites-lib/reference/standards/principles.md"],"visual":["devrites-lib/reference/visual-playbooks/index.md"],"workflow":["devrites-lib/reference/standards/development-workflow.md"],"workflow-artifacts":["devrites-lib/reference/workspace-artifact-schema.md"]},"workspace":["brief.md","spec.md","state.md","decisions.md","assumptions.md","questions.md","decision-coverage.md","architecture.md","plan.md","tasks.md","traceability.md","strategy.md","design-brief.md","references.md"],"workspaceByRole":{"plan-drafter":["brief.md","spec.md","decision-coverage.md","questions.md","decisions.md","assumptions.md","architecture.md","strategy.md","design-brief.md","references.md","state.md"]}} -->
8
+ <!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-lib/reference/standards/code-navigation.md","devrites-lib/reference/standards/code-index.md","devrites-lib/reference/standards/spec-grammar.md","rite-define/reference/plan-template.md","rite-define/reference/gates.md","rite-define/reference/anti-patterns.md","rite-plan/reference/slicing.md","rite-plan/reference/task-breakdown.md","rite-spec/reference/acceptance-criteria.md","rite-spec/reference/state-workspace.md"],"triggers":{"afk":["devrites-lib/reference/standards/afk-hitl.md"],"agents":["devrites-lib/reference/standards/agents.md"],"applicability":["devrites-lib/reference/standards/repository-topology.md","devrites-lib/reference/standards/data-integrity.md","devrites-lib/reference/standards/integration-reliability.md"],"documentation":["devrites-lib/reference/standards/documentation.md"],"elicitation":["devrites-lib/reference/standards/elicitation.md"],"frontend":["devrites-frontend-craft/reference/fullstack.md"],"principles":["devrites-lib/reference/standards/principles.md"],"visual":["devrites-lib/reference/visual-playbooks/index.md"],"workflow":["devrites-lib/reference/standards/development-workflow.md"],"workflow-artifacts":["devrites-lib/reference/workspace-artifact-schema.md"]},"workspace":["brief.md","spec.md","state.md","decisions.md","assumptions.md","questions.md","decision-coverage.md","architecture.md","plan.md","tasks.md","traceability.md","strategy.md","design-brief.md","references.md"],"workspaceByRole":{"plan-drafter":["brief.md","spec.md","decision-coverage.md","questions.md","decisions.md","assumptions.md","architecture.md","strategy.md","design-brief.md","references.md","state.md"]},"rootOnly":["devrites-lib/reference/standards/code-index.md","devrites-lib/reference/standards/afk-hitl.md"]} -->
9
9
  > Read-set manifest: `devrites-engine context --skills-root .agents/skills <slug> --phase define` bundles every file named below into one deduplicated read. Trigger names map to the conditional rules in the sections that follow.
10
10
 
11
11
 
@@ -86,8 +86,8 @@ Pull these via `Read` when shaping the plan:
86
86
  never an assumption the build discovers.
87
87
  2. **Reconcile architecture + approach** against live seams; root writes at step 6.
88
88
  `architecture.md` owns layers/boundaries/integrations/data/dependencies/risks/impact;
89
- `plan.md` owns build strategy. Use the code index for structure/impact
90
- ([`tooling.md`](../devrites-lib/reference/standards/tooling.md)) and source-check external behavior.
89
+ `plan.md` owns build strategy. Use codebase-memory-mcp for structure/impact
90
+ (`get_architecture`, `trace_path`; [`code-navigation.md`](../devrites-lib/reference/standards/code-navigation.md)) and source-check external behavior.
91
91
  Record significant options as `DEC-###` only for non-obvious real trade-offs where
92
92
  independently built lower units could choose incompatibly; leave other details to convention/
93
93
  slice. Compare ≥2 viable approaches for hard-to-reverse boundaries, models, contracts, or
@@ -136,8 +136,13 @@ Pull these via `Read` when shaping the plan:
136
136
  ([artifacts.md](../rite-vet/reference/artifacts.md)). Lift covered/backstop `Edge Coverage` rows and resolved `Prohibitions (must-NOT)`
137
137
  rows into `traceability.md` and `test-plan.md`; unresolved rows get a gate/owner. Each
138
138
  `Existing behavior to preserve` row becomes a regression row whose current evidence is
139
- observed green on the unchanged baseline as a prerequisite of the first slice touching that
140
- seam, and green again at Prove; a red baseline is recorded pre-existing, never relabelled.
139
+ observed green on the unchanged baseline at Vet (preflight `Run at` `vet`), again before the
140
+ first slice touching that seam edits it, and green at Prove; a red baseline is recorded
141
+ pre-existing, never relabelled. A slice whose `Files likely touched` names a manifest or
142
+ lockfile also plans a `dependency-dry-run SLICE-###` preflight row ([artifacts.md](../rite-vet/reference/artifacts.md)).
143
+ Mark a proof row `RUN: writer` only when it is local, needs no network, container or browser,
144
+ and passes in an uncommitted worktree (an empty-`git diff` check stays root); its `gates.md`
145
+ gate carries the attribute, the wright pre-runs it via `gates precheck`, and root still runs it.
141
146
  Evidence that cannot run takes `characterize-before-modify` or blocks. Each
142
147
  cross-slice boundary names producer, consumer, invariant, integration step, and proof.
143
148
  Map each applicable topology/data/integration risk to a slice, failure/recovery path,
@@ -39,6 +39,19 @@ Read-only: never repair files, advance a feature, or diagnose the application.
39
39
  missing required profile is `FAIL`. A project or local Claude
40
40
  `permissions.defaultMode: plan` blocks the root's `.devrites` writes:
41
41
  `FAIL`, remediation: remove it.
42
+ Host-overhead advisories are report-only, never `FAIL`; read files, spawn
43
+ nothing. (a) If user, project, or local Claude `permissions.deny` names `Grep`
44
+ or `Glob` (possibly deliberate), `WARN` and list the installed roles whose
45
+ `tools:` lacks Bash, which leaves the denied tool as their only search route.
46
+ Remediation: remove `Grep`/`Glob` from the `permissions.deny` of the settings
47
+ file that names it, if the deny is not deliberate, or accept whole-file reads.
48
+ (b) `INFO` each DevRites marker block in `AGENTS.md` with its byte size; for a
49
+ block whose host is not the one running doctor, name the `--no-<host>` flag
50
+ to add to the manifest's recorded install flags when re-running
51
+ `devrites-engine install`, if that host is unused. (c) On omp, `INFO` the count and total `SKILL.md` bytes of
52
+ non-DevRites skills in omp's user-global agent skills directory and the
53
+ servers in its user-global agent `mcp.json`, which every subagent inherits; the user may prune
54
+ them. Never edit or hide them.
42
55
  4. **Inspect workspace topology.** Read `.devrites/ACTIVE` if present. An empty
43
56
  cursor is `OK` (no active feature). Otherwise require one safe slug, a
44
57
  contained regular `.devrites/work/<slug>/state.md`, and no symlink in the
@@ -61,7 +74,8 @@ Read-only: never repair files, advance a feature, or diagnose the application.
61
74
  skill is `WARN`; a failing schema validation in behavioral/trigger corpora is
62
75
  `FAIL`.
63
76
  7. **Report, do not repair.** Emit every check as `OK`, `WARN`, or `FAIL` with
64
- the observed path/value and one concrete `Remediation:`. A check that is
77
+ the observed path/value and one concrete `Remediation:`; step 3 advisories
78
+ may emit `INFO`. A check that is
65
79
  absent, errors without a parsed result, or times out emits an
66
80
  `unavailable: <reason>` row, never `OK` or `WARN`. Never install,
67
81
  update, delete, chmod, rewrite config, create a workspace, or trust a command
@@ -77,10 +91,11 @@ DevRites doctor: <OK | WARN | FAIL>
77
91
  OK: <check — observed evidence>
78
92
  WARN: <check — observed evidence>
79
93
  FAIL: <check — observed evidence>
94
+ INFO: <advisory — observed evidence>
80
95
  unavailable: <check — reason>
81
96
  Remediation: <one action for each WARN/FAIL | none>
82
97
  ```
83
98
 
84
99
  Overall status is the worst emitted severity; any `unavailable` row keeps it
85
- from `OK` (`WARN` when nothing is worse). Omit empty severity rows; never
100
+ from `OK` (`WARN` when nothing is worse); `INFO` never raises it. Omit empty severity rows; never
86
101
  label a skipped or unavailable check `OK`.
@@ -5,7 +5,7 @@ argument-hint: "[feature-slug|branch] [--port N]"
5
5
  user-invocable: true
6
6
  disable-model-invocation: true
7
7
  ---
8
- <!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-frontend-craft/reference/quality-standards.md","devrites-lib/reference/reply-contract.md"],"triggers":{"afk":["devrites-lib/reference/standards/afk-hitl.md"],"testing":["devrites-lib/reference/standards/testing.md"],"tooling":["devrites-lib/reference/standards/tooling.md"]},"workspace":["state.md","questions.md","dogfood.md"]} -->
8
+ <!-- loads: {"always":["devrites-lib/reference/standards/core.md","devrites-frontend-craft/reference/quality-standards.md","devrites-lib/reference/reply-contract.md"],"triggers":{"afk":["devrites-lib/reference/standards/afk-hitl.md"],"testing":["devrites-lib/reference/standards/testing.md"],"tooling":["devrites-lib/reference/standards/tooling.md"]},"workspace":["state.md","questions.md","dogfood.md"],"rootOnly":["devrites-lib/reference/standards/afk-hitl.md"]} -->
9
9
  > Read-set manifest: `devrites-engine context --skills-root .agents/skills <slug> --skill rite-dogfood` (no workspace: `--out <path>`) bundles every file named below into one deduplicated read.
10
10
 
11
11
  # $rite-dogfood: diff-scoped browser QA
@@ -5,7 +5,7 @@ argument-hint: "[a concept | a diff ref | an idea | \"what did I do this week?\"
5
5
  user-invocable: true
6
6
  disable-model-invocation: true
7
7
  ---
8
- <!-- loads: {"always":["rite-explain/reference/intake.md"],"triggers":{"repo":["devrites-lib/reference/standards/tooling.md"],"style":["devrites-lib/reference/standards/prose-style.md"],"principles":["devrites-lib/reference/standards/principles.md"]}} -->
8
+ <!-- loads: {"always":["rite-explain/reference/intake.md"],"triggers":{"repo":["devrites-lib/reference/standards/tooling.md","devrites-lib/reference/standards/code-navigation.md","devrites-lib/reference/standards/code-index.md"],"style":["devrites-lib/reference/standards/prose-style.md"],"principles":["devrites-lib/reference/standards/principles.md"]},"rootOnly":["devrites-lib/reference/standards/code-index.md"]} -->
9
9
  > Read-set manifest: `devrites-engine context --skills-root .agents/skills <slug> --skill rite-explain` (no workspace: `--out <path>`) bundles every file named below into one deduplicated read. Trigger names map to the conditional rules in the sections that follow.
10
10
 
11
11
  # $rite-explain: the human half of the learning loop
@@ -8,7 +8,7 @@ source for classification; the SKILL improvises none of it.
8
8
 
9
9
  | Shape | The input is… | Grounds in | Composes as | Check-in |
10
10
  | --- | --- | --- | --- | --- |
11
- | **concept** | a named idea / pattern / technology ("explain optimistic locking", "how does our gate engine work") | this repo's footprint of the concept (codegraph first) + external sources only if they sharpen it | build the mental model from a known part of *this* codebase outward | **checked exercise** |
11
+ | **concept** | a named idea / pattern / technology ("explain optimistic locking", "how does our gate engine work") | this repo's footprint of the concept (codebase-memory `search_graph` first) + external sources only if they sharpen it | build the mental model from a known part of *this* codebase outward | **checked exercise** |
12
12
  | **diff** | a specific change: a ref, a slice, a PR, "this diff" | `git diff` / the hunks + `decisions.md` + `seal.md` for the *why* + `touched-files.md` `Review trail` when present | explainer, or **walkthrough** when the user asks to review/approve/checkpoint the change | **predict-then-reveal** |
13
13
  | **idea** | a hypothesis or "what if" with no code yet | the user's framing + prior art (external, date-weighted) | steelman the idea, name its hinge and its failure mode | **checked exercise** |
14
14
  | **recap** | a time window of the user's own work ("what did I ship this week") | the shipped archive + `git log`/`git diff` over the window + `evidence.md` | narrate what changed and what was learned, ranked by leverage | **predict-then-reveal** |