devrites 5.4.0 → 5.6.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.
- package/CHANGELOG.md +12 -0
- package/README.md +8 -6
- package/docs/command-map.md +2 -2
- package/docs/engine/state-schema.md +12 -0
- package/docs/flow.md +4 -0
- package/docs/orchestration.md +5 -2
- package/engine/commands.go +2 -2
- package/engine/internal/devritespaths/paths.go +18 -0
- package/engine/internal/gate/gate.go +78 -0
- package/engine/internal/gate/gate_test.go +118 -0
- package/engine/internal/hostpack/hostpack.go +45 -6
- package/engine/internal/hostpack/hostpack_test.go +29 -13
- package/engine/internal/install/apply.go +14 -5
- package/engine/internal/install/install.go +8 -2
- package/engine/internal/install/install_test.go +12 -5
- package/engine/internal/install/merge.go +5 -0
- package/engine/internal/install/preflight.go +20 -2
- package/engine/internal/install/uninstall.go +5 -0
- package/engine/internal/install/update.go +1 -1
- package/engine/internal/lib/candidate.go +7 -3
- package/engine/internal/lib/manifest_union.go +326 -0
- package/engine/internal/lib/manifest_union_test.go +214 -0
- package/engine/internal/lib/observe_budgets.go +73 -0
- package/engine/internal/lib/observe_budgets_test.go +142 -0
- package/engine/internal/lib/observe_summary.go +74 -13
- package/engine/internal/lib/workspace_read.go +11 -6
- package/engine/internal/state/budgets.go +163 -0
- package/engine/internal/state/budgets_test.go +42 -0
- package/engine/internal/state/cursor.go +16 -10
- package/engine/internal/state/observation.go +50 -4
- package/engine/internal/state/status.go +38 -26
- package/engine/internal/state/taskgraph.go +23 -0
- package/engine/main.go +32 -13
- package/engine/root_routing_test.go +3 -1
- package/install.sh +4 -1
- package/pack/.claude/agents/devrites-code-reviewer.md +9 -6
- package/pack/.claude/agents/devrites-doubt-reviewer.md +6 -0
- package/pack/.claude/agents/devrites-plan-reviewer.md +7 -1
- package/pack/.claude/agents/devrites-slice-wright.md +42 -46
- package/pack/.claude/agents/devrites-test-analyst.md +9 -4
- package/pack/.claude/agents/devrites-upgrade-planner.md +9 -1
- package/pack/.claude/settings.json +17 -0
- package/pack/.claude/skills/devrites-api-interface/SKILL.md +2 -2
- package/pack/.claude/skills/devrites-doubt/SKILL.md +9 -17
- package/pack/.claude/skills/devrites-lib/reference/candidate-integrity.md +34 -35
- package/pack/.claude/skills/devrites-lib/reference/parallel-dispatch.md +11 -12
- package/pack/.claude/skills/devrites-lib/reference/standards/afk-hitl.md +104 -51
- package/pack/.claude/skills/devrites-lib/reference/standards/agents.md +1 -0
- package/pack/.claude/skills/devrites-lib/reference/standards/context-hygiene.md +45 -25
- package/pack/.claude/skills/devrites-lib/reference/standards/core.md +1 -1
- package/pack/.claude/skills/devrites-lib/reference/workspace-artifact-schema.md +80 -41
- package/pack/.claude/skills/rite-autocomplete/SKILL.md +19 -8
- package/pack/.claude/skills/rite-autocomplete/reference/loop.md +33 -1
- package/pack/.claude/skills/rite-build/SKILL.md +26 -19
- package/pack/.claude/skills/rite-build/reference/afk-discipline.md +1 -1
- package/pack/.claude/skills/rite-build/reference/parallel-batch.md +90 -40
- package/pack/.claude/skills/rite-build/reference/phase-contract.md +79 -59
- package/pack/.claude/skills/rite-build/reference/spec-drift-guard.md +14 -15
- package/pack/.claude/skills/rite-build/reference/wright-dispatch.md +8 -8
- package/pack/.claude/skills/rite-define/SKILL.md +4 -1
- package/pack/.claude/skills/rite-plan/SKILL.md +4 -1
- package/pack/.claude/skills/rite-plan/reference/replan-and-repair.md +21 -0
- package/pack/.claude/skills/rite-plan/reference/slicing.md +117 -15
- package/pack/.claude/skills/rite-prove/SKILL.md +20 -22
- package/pack/.claude/skills/rite-review/SKILL.md +23 -16
- package/pack/.claude/skills/rite-seal/SKILL.md +8 -8
- package/pack/.claude/skills/rite-seal/reference/final-evidence.md +6 -5
- package/pack/.claude/skills/rite-seal/reference/phase-contract.md +13 -13
- package/pack/.claude/skills/rite-ship/SKILL.md +3 -0
- package/pack/.claude/skills/rite-ship/reference/close-out.md +16 -2
- package/pack/.claude/skills/rite-ship/reference/git-ship.md +14 -5
- package/pack/.claude/skills/rite-spec/SKILL.md +6 -0
- package/pack/.claude/skills/rite-spec/reference/state-workspace.md +6 -0
- package/pack/.claude/skills/rite-status/SKILL.md +4 -1
- package/pack/.claude/skills/rite-temper/SKILL.md +14 -11
- package/pack/.claude/skills/rite-temper/reference/anti-patterns.md +14 -13
- package/pack/.claude/skills/rite-temper/reference/review-dimensions.md +3 -4
- package/pack/.claude/skills/rite-upgrade/SKILL.md +11 -2
- package/pack/.claude/skills/rite-vet/SKILL.md +22 -15
- package/pack/.claude/skills/rite-vet/reference/anti-patterns.md +11 -9
- package/pack/.claude/skills/rite-vet/reference/depth.md +6 -7
- package/pack/.claude/skills/rite-vet/reference/review-axes.md +39 -14
- package/pack/generated/README.md +5 -1
- package/pack/generated/claude/agents/devrites-code-reviewer.md +9 -6
- package/pack/generated/claude/agents/devrites-doubt-reviewer.md +6 -0
- package/pack/generated/claude/agents/devrites-plan-reviewer.md +7 -1
- package/pack/generated/claude/agents/devrites-slice-wright.md +42 -46
- package/pack/generated/claude/agents/devrites-test-analyst.md +9 -4
- package/pack/generated/claude/agents/devrites-upgrade-planner.md +9 -1
- package/pack/generated/claude/settings.json +17 -0
- package/pack/generated/claude/skills/devrites-api-interface/SKILL.md +2 -2
- package/pack/generated/claude/skills/devrites-doubt/SKILL.md +9 -17
- package/pack/generated/claude/skills/devrites-lib/reference/candidate-integrity.md +34 -35
- package/pack/generated/claude/skills/devrites-lib/reference/parallel-dispatch.md +11 -12
- package/pack/generated/claude/skills/devrites-lib/reference/standards/afk-hitl.md +104 -51
- package/pack/generated/claude/skills/devrites-lib/reference/standards/agents.md +1 -0
- package/pack/generated/claude/skills/devrites-lib/reference/standards/context-hygiene.md +45 -25
- package/pack/generated/claude/skills/devrites-lib/reference/standards/core.md +1 -1
- package/pack/generated/claude/skills/devrites-lib/reference/workspace-artifact-schema.md +80 -41
- package/pack/generated/claude/skills/rite-autocomplete/SKILL.md +19 -8
- package/pack/generated/claude/skills/rite-autocomplete/reference/loop.md +33 -1
- package/pack/generated/claude/skills/rite-build/SKILL.md +26 -19
- package/pack/generated/claude/skills/rite-build/reference/afk-discipline.md +1 -1
- package/pack/generated/claude/skills/rite-build/reference/parallel-batch.md +90 -40
- package/pack/generated/claude/skills/rite-build/reference/phase-contract.md +79 -59
- package/pack/generated/claude/skills/rite-build/reference/spec-drift-guard.md +14 -15
- package/pack/generated/claude/skills/rite-build/reference/wright-dispatch.md +8 -8
- package/pack/generated/claude/skills/rite-define/SKILL.md +4 -1
- package/pack/generated/claude/skills/rite-plan/SKILL.md +4 -1
- package/pack/generated/claude/skills/rite-plan/reference/replan-and-repair.md +21 -0
- package/pack/generated/claude/skills/rite-plan/reference/slicing.md +117 -15
- package/pack/generated/claude/skills/rite-prove/SKILL.md +20 -22
- package/pack/generated/claude/skills/rite-review/SKILL.md +23 -16
- package/pack/generated/claude/skills/rite-seal/SKILL.md +8 -8
- package/pack/generated/claude/skills/rite-seal/reference/final-evidence.md +6 -5
- package/pack/generated/claude/skills/rite-seal/reference/phase-contract.md +13 -13
- package/pack/generated/claude/skills/rite-ship/SKILL.md +3 -0
- package/pack/generated/claude/skills/rite-ship/reference/close-out.md +16 -2
- package/pack/generated/claude/skills/rite-ship/reference/git-ship.md +14 -5
- package/pack/generated/claude/skills/rite-spec/SKILL.md +6 -0
- package/pack/generated/claude/skills/rite-spec/reference/state-workspace.md +6 -0
- package/pack/generated/claude/skills/rite-status/SKILL.md +4 -1
- package/pack/generated/claude/skills/rite-temper/SKILL.md +14 -11
- package/pack/generated/claude/skills/rite-temper/reference/anti-patterns.md +14 -13
- package/pack/generated/claude/skills/rite-temper/reference/review-dimensions.md +3 -4
- package/pack/generated/claude/skills/rite-upgrade/SKILL.md +11 -2
- package/pack/generated/claude/skills/rite-vet/SKILL.md +22 -15
- package/pack/generated/claude/skills/rite-vet/reference/anti-patterns.md +11 -9
- package/pack/generated/claude/skills/rite-vet/reference/depth.md +6 -7
- package/pack/generated/claude/skills/rite-vet/reference/review-axes.md +39 -14
- package/pack/generated/codex/agents/devrites-code-reviewer.toml +9 -6
- package/pack/generated/codex/agents/devrites-doubt-reviewer.toml +6 -0
- package/pack/generated/codex/agents/devrites-plan-reviewer.toml +7 -1
- package/pack/generated/codex/agents/devrites-slice-wright.toml +42 -46
- package/pack/generated/codex/agents/devrites-test-analyst.toml +9 -4
- package/pack/generated/codex/agents/devrites-upgrade-planner.toml +9 -1
- package/pack/generated/codex/skills/devrites-api-interface/SKILL.md +2 -2
- package/pack/generated/codex/skills/devrites-doubt/SKILL.md +9 -17
- package/pack/generated/codex/skills/devrites-lib/reference/candidate-integrity.md +34 -35
- package/pack/generated/codex/skills/devrites-lib/reference/parallel-dispatch.md +11 -12
- package/pack/generated/codex/skills/devrites-lib/reference/standards/afk-hitl.md +104 -51
- package/pack/generated/codex/skills/devrites-lib/reference/standards/agents.md +1 -0
- package/pack/generated/codex/skills/devrites-lib/reference/standards/context-hygiene.md +45 -25
- package/pack/generated/codex/skills/devrites-lib/reference/standards/core.md +1 -1
- package/pack/generated/codex/skills/devrites-lib/reference/workspace-artifact-schema.md +80 -41
- package/pack/generated/codex/skills/rite-autocomplete/SKILL.md +19 -8
- package/pack/generated/codex/skills/rite-autocomplete/reference/loop.md +33 -1
- package/pack/generated/codex/skills/rite-build/SKILL.md +26 -19
- package/pack/generated/codex/skills/rite-build/reference/afk-discipline.md +1 -1
- package/pack/generated/codex/skills/rite-build/reference/parallel-batch.md +90 -40
- package/pack/generated/codex/skills/rite-build/reference/phase-contract.md +79 -59
- package/pack/generated/codex/skills/rite-build/reference/spec-drift-guard.md +14 -15
- package/pack/generated/codex/skills/rite-build/reference/wright-dispatch.md +8 -8
- package/pack/generated/codex/skills/rite-define/SKILL.md +4 -1
- package/pack/generated/codex/skills/rite-plan/SKILL.md +4 -1
- package/pack/generated/codex/skills/rite-plan/reference/replan-and-repair.md +21 -0
- package/pack/generated/codex/skills/rite-plan/reference/slicing.md +117 -15
- package/pack/generated/codex/skills/rite-prove/SKILL.md +20 -22
- package/pack/generated/codex/skills/rite-review/SKILL.md +23 -16
- package/pack/generated/codex/skills/rite-seal/SKILL.md +8 -8
- package/pack/generated/codex/skills/rite-seal/reference/final-evidence.md +6 -5
- package/pack/generated/codex/skills/rite-seal/reference/phase-contract.md +13 -13
- package/pack/generated/codex/skills/rite-ship/SKILL.md +3 -0
- package/pack/generated/codex/skills/rite-ship/reference/close-out.md +16 -2
- package/pack/generated/codex/skills/rite-ship/reference/git-ship.md +14 -5
- package/pack/generated/codex/skills/rite-spec/SKILL.md +6 -0
- package/pack/generated/codex/skills/rite-spec/reference/state-workspace.md +6 -0
- package/pack/generated/codex/skills/rite-status/SKILL.md +4 -1
- package/pack/generated/codex/skills/rite-temper/SKILL.md +14 -11
- package/pack/generated/codex/skills/rite-temper/reference/anti-patterns.md +14 -13
- package/pack/generated/codex/skills/rite-temper/reference/review-dimensions.md +3 -4
- package/pack/generated/codex/skills/rite-upgrade/SKILL.md +11 -2
- package/pack/generated/codex/skills/rite-vet/SKILL.md +22 -15
- package/pack/generated/codex/skills/rite-vet/reference/anti-patterns.md +11 -9
- package/pack/generated/codex/skills/rite-vet/reference/depth.md +6 -7
- package/pack/generated/codex/skills/rite-vet/reference/review-axes.md +39 -14
- package/pack/generated/omp/agents/devrites-code-reviewer.md +9 -6
- package/pack/generated/omp/agents/devrites-doubt-reviewer.md +6 -0
- package/pack/generated/omp/agents/devrites-plan-reviewer.md +7 -1
- package/pack/generated/omp/agents/devrites-slice-wright.md +42 -46
- package/pack/generated/omp/agents/devrites-test-analyst.md +9 -4
- package/pack/generated/omp/agents/devrites-upgrade-planner.md +9 -1
- package/pack/generated/omp/skills/devrites-api-interface/SKILL.md +2 -2
- package/pack/generated/omp/skills/devrites-doubt/SKILL.md +9 -17
- package/pack/generated/omp/skills/devrites-lib/reference/candidate-integrity.md +34 -35
- package/pack/generated/omp/skills/devrites-lib/reference/parallel-dispatch.md +11 -12
- package/pack/generated/omp/skills/devrites-lib/reference/standards/afk-hitl.md +104 -51
- package/pack/generated/omp/skills/devrites-lib/reference/standards/agents.md +1 -0
- package/pack/generated/omp/skills/devrites-lib/reference/standards/context-hygiene.md +45 -25
- package/pack/generated/omp/skills/devrites-lib/reference/standards/core.md +1 -1
- package/pack/generated/omp/skills/devrites-lib/reference/workspace-artifact-schema.md +80 -41
- package/pack/generated/omp/skills/rite-autocomplete/SKILL.md +19 -8
- package/pack/generated/omp/skills/rite-autocomplete/reference/loop.md +33 -1
- package/pack/generated/omp/skills/rite-build/SKILL.md +26 -19
- package/pack/generated/omp/skills/rite-build/reference/afk-discipline.md +1 -1
- package/pack/generated/omp/skills/rite-build/reference/parallel-batch.md +90 -40
- package/pack/generated/omp/skills/rite-build/reference/phase-contract.md +79 -59
- package/pack/generated/omp/skills/rite-build/reference/spec-drift-guard.md +14 -15
- package/pack/generated/omp/skills/rite-build/reference/wright-dispatch.md +8 -8
- package/pack/generated/omp/skills/rite-define/SKILL.md +4 -1
- package/pack/generated/omp/skills/rite-plan/SKILL.md +4 -1
- package/pack/generated/omp/skills/rite-plan/reference/replan-and-repair.md +21 -0
- package/pack/generated/omp/skills/rite-plan/reference/slicing.md +117 -15
- package/pack/generated/omp/skills/rite-prove/SKILL.md +20 -22
- package/pack/generated/omp/skills/rite-review/SKILL.md +23 -16
- package/pack/generated/omp/skills/rite-seal/SKILL.md +8 -8
- package/pack/generated/omp/skills/rite-seal/reference/final-evidence.md +6 -5
- package/pack/generated/omp/skills/rite-seal/reference/phase-contract.md +13 -13
- package/pack/generated/omp/skills/rite-ship/SKILL.md +3 -0
- package/pack/generated/omp/skills/rite-ship/reference/close-out.md +16 -2
- package/pack/generated/omp/skills/rite-ship/reference/git-ship.md +14 -5
- package/pack/generated/omp/skills/rite-spec/SKILL.md +6 -0
- package/pack/generated/omp/skills/rite-spec/reference/state-workspace.md +6 -0
- package/pack/generated/omp/skills/rite-status/SKILL.md +4 -1
- package/pack/generated/omp/skills/rite-temper/SKILL.md +14 -11
- package/pack/generated/omp/skills/rite-temper/reference/anti-patterns.md +14 -13
- package/pack/generated/omp/skills/rite-temper/reference/review-dimensions.md +3 -4
- package/pack/generated/omp/skills/rite-upgrade/SKILL.md +11 -2
- package/pack/generated/omp/skills/rite-vet/SKILL.md +22 -15
- package/pack/generated/omp/skills/rite-vet/reference/anti-patterns.md +11 -9
- package/pack/generated/omp/skills/rite-vet/reference/depth.md +6 -7
- package/pack/generated/omp/skills/rite-vet/reference/review-axes.md +39 -14
- package/pack/generated/pi/AGENTS.md +22 -0
- package/pack/generated/pi/agents/devrites-code-reviewer.md +142 -0
- package/pack/generated/pi/agents/devrites-devex-reviewer.md +124 -0
- package/pack/generated/pi/agents/devrites-doubt-reviewer.md +88 -0
- package/pack/generated/pi/agents/devrites-evidence-scout.md +72 -0
- package/pack/generated/pi/agents/devrites-frontend-reviewer.md +116 -0
- package/pack/generated/pi/agents/devrites-performance-reviewer.md +115 -0
- package/pack/generated/pi/agents/devrites-plan-drafter.md +99 -0
- package/pack/generated/pi/agents/devrites-plan-reviewer.md +142 -0
- package/pack/generated/pi/agents/devrites-proof-runner.md +74 -0
- package/pack/generated/pi/agents/devrites-retrospector.md +61 -0
- package/pack/generated/pi/agents/devrites-security-auditor.md +109 -0
- package/pack/generated/pi/agents/devrites-simplifier-reviewer.md +94 -0
- package/pack/generated/pi/agents/devrites-slice-wright.md +204 -0
- package/pack/generated/pi/agents/devrites-spec-reviewer.md +96 -0
- package/pack/generated/pi/agents/devrites-strategy-reviewer.md +100 -0
- package/pack/generated/pi/agents/devrites-test-analyst.md +94 -0
- package/pack/generated/pi/agents/devrites-upgrade-planner.md +89 -0
- package/pack/generated/pi/prompts/rite-adopt.md +5 -0
- package/pack/generated/pi/prompts/rite-autocomplete.md +5 -0
- package/pack/generated/pi/prompts/rite-build.md +5 -0
- package/pack/generated/pi/prompts/rite-clarify.md +5 -0
- package/pack/generated/pi/prompts/rite-converge.md +5 -0
- package/pack/generated/pi/prompts/rite-customize.md +5 -0
- package/pack/generated/pi/prompts/rite-define.md +5 -0
- package/pack/generated/pi/prompts/rite-doctor.md +5 -0
- package/pack/generated/pi/prompts/rite-dogfood.md +5 -0
- package/pack/generated/pi/prompts/rite-explain.md +5 -0
- package/pack/generated/pi/prompts/rite-frame.md +5 -0
- package/pack/generated/pi/prompts/rite-handoff.md +5 -0
- package/pack/generated/pi/prompts/rite-learn.md +5 -0
- package/pack/generated/pi/prompts/rite-plan.md +5 -0
- package/pack/generated/pi/prompts/rite-polish.md +5 -0
- package/pack/generated/pi/prompts/rite-pov.md +5 -0
- package/pack/generated/pi/prompts/rite-pr-feedback.md +5 -0
- package/pack/generated/pi/prompts/rite-pressure-test.md +5 -0
- package/pack/generated/pi/prompts/rite-prototype.md +5 -0
- package/pack/generated/pi/prompts/rite-prove.md +5 -0
- package/pack/generated/pi/prompts/rite-quick.md +5 -0
- package/pack/generated/pi/prompts/rite-resolve.md +5 -0
- package/pack/generated/pi/prompts/rite-review.md +5 -0
- package/pack/generated/pi/prompts/rite-seal.md +5 -0
- package/pack/generated/pi/prompts/rite-ship.md +5 -0
- package/pack/generated/pi/prompts/rite-spec.md +5 -0
- package/pack/generated/pi/prompts/rite-status.md +5 -0
- package/pack/generated/pi/prompts/rite-temper.md +5 -0
- package/pack/generated/pi/prompts/rite-upgrade.md +5 -0
- package/pack/generated/pi/prompts/rite-vet.md +5 -0
- package/pack/generated/pi/prompts/rite-watch-pr.md +5 -0
- package/pack/generated/pi/prompts/rite-zoom-out.md +5 -0
- package/pack/generated/pi/prompts/rite.md +5 -0
- package/pack/generated/pi/skills/devrites-api-interface/SKILL.md +63 -0
- package/pack/generated/pi/skills/devrites-audit/SKILL.md +50 -0
- package/pack/generated/pi/skills/devrites-browser-proof/SKILL.md +76 -0
- package/pack/generated/pi/skills/devrites-browser-proof/reference/browser-performance.md +15 -0
- package/pack/generated/pi/skills/devrites-browser-proof/reference/visual-verdict.md +34 -0
- package/pack/generated/pi/skills/devrites-debug-recovery/SKILL.md +96 -0
- package/pack/generated/pi/skills/devrites-debug-recovery/reference/build-the-loop.md +58 -0
- package/pack/generated/pi/skills/devrites-debug-recovery/reference/cleanup-and-classify.md +34 -0
- package/pack/generated/pi/skills/devrites-debug-recovery/reference/hypotheses.md +17 -0
- package/pack/generated/pi/skills/devrites-debug-recovery/reference/instrumentation.md +21 -0
- package/pack/generated/pi/skills/devrites-debug-recovery/reference/regression-test.md +30 -0
- package/pack/generated/pi/skills/devrites-debug-recovery/reference/trace.md +25 -0
- package/pack/generated/pi/skills/devrites-doubt/SKILL.md +79 -0
- package/pack/generated/pi/skills/devrites-frontend-craft/SKILL.md +86 -0
- package/pack/generated/pi/skills/devrites-frontend-craft/reference/craft.md +63 -0
- package/pack/generated/pi/skills/devrites-frontend-craft/reference/design-references.md +116 -0
- package/pack/generated/pi/skills/devrites-frontend-craft/reference/fullstack.md +46 -0
- package/pack/generated/pi/skills/devrites-frontend-craft/reference/quality-standards.md +294 -0
- package/pack/generated/pi/skills/devrites-frontend-craft/reference/reuse-first.md +53 -0
- package/pack/generated/pi/skills/devrites-frontend-craft/reference/shape.md +56 -0
- package/pack/generated/pi/skills/devrites-interview/SKILL.md +102 -0
- package/pack/generated/pi/skills/devrites-lib/SKILL.md +58 -0
- package/pack/generated/pi/skills/devrites-lib/reference/candidate-integrity.md +42 -0
- package/pack/generated/pi/skills/devrites-lib/reference/intent-map.md +64 -0
- package/pack/generated/pi/skills/devrites-lib/reference/orchestration-profiles.md +27 -0
- package/pack/generated/pi/skills/devrites-lib/reference/parallel-dispatch.md +73 -0
- package/pack/generated/pi/skills/devrites-lib/reference/reply-contract.md +88 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/README.md +60 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/acceptance-preserving-reslice.md +30 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/afk-hitl.md +398 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/agents.md +99 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/anti-patterns.md +48 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/browser-proof-checklist.md +24 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/ci-cd.md +50 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/code-navigation.md +43 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/code-review.md +108 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/coding-style.md +48 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/context-hygiene.md +109 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/core.md +167 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/data-integrity.md +118 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/debug-recovery.md +28 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/definition-of-done.md +19 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/deprecation.md +31 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/developer-experience.md +119 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/development-workflow.md +29 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/documentation.md +43 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/edge-case-trace.md +92 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/elicitation.md +85 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/error-handling.md +47 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/git-workflow.md +49 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/hooks.md +25 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/integration-reliability.md +102 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/loop-operations.md +85 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/observability.md +88 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/one-shot-actions.md +97 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/patterns.md +68 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/performance.md +51 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/principles.md +42 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/prose-style.md +123 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/release/ship-checklist.md +8 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/repository-topology.md +80 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/review-checklist.md +12 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/security-checklist.md +25 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/security.md +202 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/skill-authoring.md +209 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/spec-grammar.md +197 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/test-proof-checklist.md +13 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/testing.md +212 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/tooling.md +92 -0
- package/pack/generated/pi/skills/devrites-lib/reference/standards/workflow-artifacts.md +427 -0
- package/pack/generated/pi/skills/devrites-lib/reference/visual-playbooks/code.md +44 -0
- package/pack/generated/pi/skills/devrites-lib/reference/visual-playbooks/comparison.md +42 -0
- package/pack/generated/pi/skills/devrites-lib/reference/visual-playbooks/diagram.md +51 -0
- package/pack/generated/pi/skills/devrites-lib/reference/visual-playbooks/index.md +66 -0
- package/pack/generated/pi/skills/devrites-lib/reference/visual-playbooks/input.md +46 -0
- package/pack/generated/pi/skills/devrites-lib/reference/visual-playbooks/outline-template.md +106 -0
- package/pack/generated/pi/skills/devrites-lib/reference/visual-playbooks/plan.md +48 -0
- package/pack/generated/pi/skills/devrites-lib/reference/visual-playbooks/slides.md +40 -0
- package/pack/generated/pi/skills/devrites-lib/reference/visual-playbooks/table.md +42 -0
- package/pack/generated/pi/skills/devrites-lib/reference/workspace-artifact-schema.md +267 -0
- package/pack/generated/pi/skills/devrites-prose-craft/SKILL.md +73 -0
- package/pack/generated/pi/skills/devrites-prose-craft/reference/banned-phrases.md +132 -0
- package/pack/generated/pi/skills/devrites-prose-craft/reference/examples.md +131 -0
- package/pack/generated/pi/skills/devrites-prose-craft/reference/structures.md +196 -0
- package/pack/generated/pi/skills/devrites-source-driven/SKILL.md +52 -0
- package/pack/generated/pi/skills/devrites-ux-shape/SKILL.md +134 -0
- package/pack/generated/pi/skills/devrites-ux-shape/reference/brief-template.md +108 -0
- package/pack/generated/pi/skills/devrites-ux-shape/reference/visual-direction-probe.md +48 -0
- package/pack/generated/pi/skills/rite/SKILL.md +148 -0
- package/pack/generated/pi/skills/rite/reference/menu.md +48 -0
- package/pack/generated/pi/skills/rite-adopt/SKILL.md +52 -0
- package/pack/generated/pi/skills/rite-adopt/reference/adoption.md +19 -0
- package/pack/generated/pi/skills/rite-adopt/reference/anti-patterns.md +19 -0
- package/pack/generated/pi/skills/rite-autocomplete/SKILL.md +132 -0
- package/pack/generated/pi/skills/rite-autocomplete/reference/decision-policy.md +41 -0
- package/pack/generated/pi/skills/rite-autocomplete/reference/loop.md +148 -0
- package/pack/generated/pi/skills/rite-autocomplete/reference/stop-conditions.md +92 -0
- package/pack/generated/pi/skills/rite-build/SKILL.md +96 -0
- package/pack/generated/pi/skills/rite-build/reference/afk-discipline.md +145 -0
- package/pack/generated/pi/skills/rite-build/reference/anti-patterns.md +23 -0
- package/pack/generated/pi/skills/rite-build/reference/checkpoint-protocol.md +120 -0
- package/pack/generated/pi/skills/rite-build/reference/checkpoint.md +44 -0
- package/pack/generated/pi/skills/rite-build/reference/frontend-trigger.md +39 -0
- package/pack/generated/pi/skills/rite-build/reference/one-slice-cycle.md +50 -0
- package/pack/generated/pi/skills/rite-build/reference/output.md +33 -0
- package/pack/generated/pi/skills/rite-build/reference/parallel-batch.md +205 -0
- package/pack/generated/pi/skills/rite-build/reference/phase-contract.md +87 -0
- package/pack/generated/pi/skills/rite-build/reference/spec-drift-guard.md +84 -0
- package/pack/generated/pi/skills/rite-build/reference/tdd.md +27 -0
- package/pack/generated/pi/skills/rite-build/reference/wright-dispatch.md +89 -0
- package/pack/generated/pi/skills/rite-clarify/SKILL.md +99 -0
- package/pack/generated/pi/skills/rite-clarify/reference/anti-patterns.md +24 -0
- package/pack/generated/pi/skills/rite-clarify/reference/decision-coverage.md +55 -0
- package/pack/generated/pi/skills/rite-converge/SKILL.md +145 -0
- package/pack/generated/pi/skills/rite-converge/reference/anti-patterns.md +35 -0
- package/pack/generated/pi/skills/rite-converge/reference/convergence-assessment.md +65 -0
- package/pack/generated/pi/skills/rite-customize/SKILL.md +60 -0
- package/pack/generated/pi/skills/rite-define/SKILL.md +169 -0
- package/pack/generated/pi/skills/rite-define/reference/anti-patterns.md +26 -0
- package/pack/generated/pi/skills/rite-define/reference/gates.md +154 -0
- package/pack/generated/pi/skills/rite-define/reference/plan-template.md +149 -0
- package/pack/generated/pi/skills/rite-doctor/SKILL.md +69 -0
- package/pack/generated/pi/skills/rite-dogfood/SKILL.md +55 -0
- package/pack/generated/pi/skills/rite-explain/SKILL.md +152 -0
- package/pack/generated/pi/skills/rite-explain/reference/intake.md +89 -0
- package/pack/generated/pi/skills/rite-frame/SKILL.md +115 -0
- package/pack/generated/pi/skills/rite-frame/reference/failure-modes.md +66 -0
- package/pack/generated/pi/skills/rite-handoff/SKILL.md +97 -0
- package/pack/generated/pi/skills/rite-handoff/reference/handoff-template.md +44 -0
- package/pack/generated/pi/skills/rite-learn/SKILL.md +72 -0
- package/pack/generated/pi/skills/rite-plan/SKILL.md +186 -0
- package/pack/generated/pi/skills/rite-plan/reference/anti-patterns.md +34 -0
- package/pack/generated/pi/skills/rite-plan/reference/dependency-graph.md +48 -0
- package/pack/generated/pi/skills/rite-plan/reference/replan-and-repair.md +105 -0
- package/pack/generated/pi/skills/rite-plan/reference/slicing.md +167 -0
- package/pack/generated/pi/skills/rite-plan/reference/task-breakdown.md +42 -0
- package/pack/generated/pi/skills/rite-polish/SKILL.md +104 -0
- package/pack/generated/pi/skills/rite-polish/reference/adr-promotion.md +11 -0
- package/pack/generated/pi/skills/rite-polish/reference/anti-ai-slop.md +187 -0
- package/pack/generated/pi/skills/rite-polish/reference/anti-patterns.md +30 -0
- package/pack/generated/pi/skills/rite-polish/reference/backend-polish.md +80 -0
- package/pack/generated/pi/skills/rite-polish/reference/browser-polish-evidence.md +33 -0
- package/pack/generated/pi/skills/rite-polish/reference/code.md +82 -0
- package/pack/generated/pi/skills/rite-polish/reference/design-memory.md +117 -0
- package/pack/generated/pi/skills/rite-polish/reference/design-system-discovery.md +8 -0
- package/pack/generated/pi/skills/rite-polish/reference/harden-checklist.md +109 -0
- package/pack/generated/pi/skills/rite-polish/reference/ledger.md +65 -0
- package/pack/generated/pi/skills/rite-polish/reference/ui.md +137 -0
- package/pack/generated/pi/skills/rite-pov/SKILL.md +58 -0
- package/pack/generated/pi/skills/rite-pr-feedback/SKILL.md +54 -0
- package/pack/generated/pi/skills/rite-pressure-test/SKILL.md +67 -0
- package/pack/generated/pi/skills/rite-prototype/SKILL.md +104 -0
- package/pack/generated/pi/skills/rite-prove/SKILL.md +120 -0
- package/pack/generated/pi/skills/rite-prove/reference/acceptance-proof.md +88 -0
- package/pack/generated/pi/skills/rite-prove/reference/anti-patterns.md +25 -0
- package/pack/generated/pi/skills/rite-prove/reference/browser-proof.md +51 -0
- package/pack/generated/pi/skills/rite-prove/reference/failure-triage.md +43 -0
- package/pack/generated/pi/skills/rite-prove/reference/proof-ladder.md +28 -0
- package/pack/generated/pi/skills/rite-prove/reference/test-command-discovery.md +30 -0
- package/pack/generated/pi/skills/rite-quick/SKILL.md +82 -0
- package/pack/generated/pi/skills/rite-resolve/SKILL.md +95 -0
- package/pack/generated/pi/skills/rite-resolve/reference/answer-protocol.md +118 -0
- package/pack/generated/pi/skills/rite-review/SKILL.md +170 -0
- package/pack/generated/pi/skills/rite-review/reference/anti-patterns.md +32 -0
- package/pack/generated/pi/skills/rite-review/reference/cognitive-load.md +90 -0
- package/pack/generated/pi/skills/rite-review/reference/feature-scoped-review.md +26 -0
- package/pack/generated/pi/skills/rite-review/reference/five-axis-review.md +66 -0
- package/pack/generated/pi/skills/rite-review/reference/nielsen-heuristics.md +126 -0
- package/pack/generated/pi/skills/rite-review/reference/performance-checklist.md +80 -0
- package/pack/generated/pi/skills/rite-review/reference/performance-review.md +14 -0
- package/pack/generated/pi/skills/rite-review/reference/security-review.md +42 -0
- package/pack/generated/pi/skills/rite-seal/SKILL.md +75 -0
- package/pack/generated/pi/skills/rite-seal/reference/anti-patterns.md +29 -0
- package/pack/generated/pi/skills/rite-seal/reference/final-evidence.md +41 -0
- package/pack/generated/pi/skills/rite-seal/reference/go-no-go.md +29 -0
- package/pack/generated/pi/skills/rite-seal/reference/output.md +5 -0
- package/pack/generated/pi/skills/rite-seal/reference/phase-contract.md +47 -0
- package/pack/generated/pi/skills/rite-seal/reference/risk-and-rollback.md +56 -0
- package/pack/generated/pi/skills/rite-seal/reference/seal-template.md +27 -0
- package/pack/generated/pi/skills/rite-ship/SKILL.md +88 -0
- package/pack/generated/pi/skills/rite-ship/reference/anti-patterns.md +28 -0
- package/pack/generated/pi/skills/rite-ship/reference/close-out.md +68 -0
- package/pack/generated/pi/skills/rite-ship/reference/git-ship.md +120 -0
- package/pack/generated/pi/skills/rite-ship/reference/rollout.md +62 -0
- package/pack/generated/pi/skills/rite-ship/reference/ship-template.md +39 -0
- package/pack/generated/pi/skills/rite-spec/SKILL.md +150 -0
- package/pack/generated/pi/skills/rite-spec/reference/acceptance-criteria.md +31 -0
- package/pack/generated/pi/skills/rite-spec/reference/ai-spec-template.md +40 -0
- package/pack/generated/pi/skills/rite-spec/reference/anti-patterns.md +27 -0
- package/pack/generated/pi/skills/rite-spec/reference/interview-patterns.md +56 -0
- package/pack/generated/pi/skills/rite-spec/reference/investigation.md +83 -0
- package/pack/generated/pi/skills/rite-spec/reference/question-protocol.md +36 -0
- package/pack/generated/pi/skills/rite-spec/reference/references-intake.md +62 -0
- package/pack/generated/pi/skills/rite-spec/reference/spec-checklists.md +89 -0
- package/pack/generated/pi/skills/rite-spec/reference/spec-template.md +154 -0
- package/pack/generated/pi/skills/rite-spec/reference/state-workspace.md +227 -0
- package/pack/generated/pi/skills/rite-status/SKILL.md +57 -0
- package/pack/generated/pi/skills/rite-temper/SKILL.md +130 -0
- package/pack/generated/pi/skills/rite-temper/reference/anti-patterns.md +30 -0
- package/pack/generated/pi/skills/rite-temper/reference/review-dimensions.md +66 -0
- package/pack/generated/pi/skills/rite-temper/reference/scope-modes.md +53 -0
- package/pack/generated/pi/skills/rite-temper/reference/significance.md +46 -0
- package/pack/generated/pi/skills/rite-temper/reference/strategy-template.md +90 -0
- package/pack/generated/pi/skills/rite-upgrade/SKILL.md +121 -0
- package/pack/generated/pi/skills/rite-vet/SKILL.md +193 -0
- package/pack/generated/pi/skills/rite-vet/reference/anti-patterns.md +43 -0
- package/pack/generated/pi/skills/rite-vet/reference/artifacts.md +202 -0
- package/pack/generated/pi/skills/rite-vet/reference/cross-model.md +19 -0
- package/pack/generated/pi/skills/rite-vet/reference/depth.md +59 -0
- package/pack/generated/pi/skills/rite-vet/reference/eng-lenses.md +48 -0
- package/pack/generated/pi/skills/rite-vet/reference/review-axes.md +201 -0
- package/pack/generated/pi/skills/rite-watch-pr/SKILL.md +85 -0
- package/pack/generated/pi/skills/rite-zoom-out/SKILL.md +69 -0
- package/package.json +3 -2
- package/scripts/build-host-artifacts.sh +54 -4
- package/scripts/codex-generate.sh +6 -0
- package/scripts/pi-generate.sh +198 -0
|
@@ -31,6 +31,11 @@ A drift event stopped the build. Steps:
|
|
|
31
31
|
2. If the user answered a drift question, encode that decision in `decisions.md`.
|
|
32
32
|
3. Update `spec.md` (only the affected sections) and `plan.md`/`tasks.md` to match
|
|
33
33
|
reality. Adjust acceptance criteria if they were wrong.
|
|
34
|
+
**Write the pointer, not the history.** Name the findings a fold closes by ID, one line
|
|
35
|
+
of meaning each; never restate prior folds, prior DEC lists, or closed-round narrative in
|
|
36
|
+
`architecture.md`/`plan.md`/`tasks.md`/`traceability.md`. That text belongs in
|
|
37
|
+
`decisions.md`, or in `history/` via [Budget relocation](#revise) once closed, so each
|
|
38
|
+
fold appends a bounded line. A banner that grows with the round count is the defect.
|
|
34
39
|
4. Mark each `drift.md` entry **resolved** with the resolution + date.
|
|
35
40
|
5. **Self-check and self-attack the repaired candidate on the delta before
|
|
36
41
|
handoff** — re-verify every invariant the correction touched (acyclic
|
|
@@ -68,6 +73,14 @@ Mid-build user pivot. Apply the marked action, choose rollback or forward-fix, a
|
|
|
68
73
|
update permitted artifacts atomically (`MVP cut` is the named retreat). Invalidate
|
|
69
74
|
Vet/readiness when contract or topology changes.
|
|
70
75
|
|
|
76
|
+
**Feature-ceiling cut.** When unbuilt slices exceed the
|
|
77
|
+
[feature ceiling](slicing.md#feature-ceiling-split-an-epic-never-override-the-budget),
|
|
78
|
+
`MVP cut` keeps the built slices plus the thinnest shippable unbuilt subset here; the
|
|
79
|
+
remaining slices, their REQ/AC IDs and proof rows move verbatim into a named
|
|
80
|
+
continuation list (spec `Non-goals` → future `$rite-spec <slug>-2`, `-3`, …) through
|
|
81
|
+
the Spec Drift Guard. IDs never renumber; each ID is owned by exactly one workspace.
|
|
82
|
+
Record the sequence once in `decisions.md`.
|
|
83
|
+
|
|
71
84
|
## revise
|
|
72
85
|
|
|
73
86
|
Artifact-only reconciliation of `spec.md`, `architecture.md`, `plan.md`, `tasks.md`,
|
|
@@ -78,6 +91,14 @@ Unchanged acceptance/behavior with non-equivalent `proposed_coverage` is a
|
|
|
78
91
|
contradictory input: the canonical classifier blocks it — there is no fourth
|
|
79
92
|
route (see `acceptance-preserving-reslice.md`).
|
|
80
93
|
|
|
94
|
+
**Budget relocation** (admitted by `$rite-upgrade`, or by the phase owner when
|
|
95
|
+
`orient` reports `over: true`): move checkpoint narrative, historical fold text and
|
|
96
|
+
closed-round accounts verbatim from `state.md`/`tasks.md`/`plan.md`/`architecture.md`/
|
|
97
|
+
`eng-review.md` into `history/<file>-<YYYYMMDD>.md`, packets/accounts from the root
|
|
98
|
+
into `packets/`, leaving a one-line pointer. Cursor, live slices, open findings, IDs,
|
|
99
|
+
answers, decisions and bindings stay unchanged; nothing is deleted or reworded.
|
|
100
|
+
Re-emit the readiness binding when a readiness input moved.
|
|
101
|
+
|
|
81
102
|
## Always
|
|
82
103
|
|
|
83
104
|
Update `state.md` (phase, next step) and append a dated line to `decisions.md`
|
|
@@ -4,9 +4,7 @@ DevRites builds in **thin vertical slices**: each slice cuts through every layer
|
|
|
4
4
|
needs (data → logic → API → UI) and leaves the system in a working, testable state.
|
|
5
5
|
|
|
6
6
|
## Vertical, not horizontal
|
|
7
|
-
Horizontal
|
|
8
|
-
software and hides integration risk until the end. Vertical delivers a usable path each
|
|
9
|
-
slice:
|
|
7
|
+
Horizontal layering delays integration feedback. Vertical slicing delivers a usable path:
|
|
10
8
|
```
|
|
11
9
|
SLICE-001: Create a task (DB + API + minimal UI) -> user can create + test passes
|
|
12
10
|
SLICE-002: List tasks (query + API + UI) -> user can see them
|
|
@@ -17,20 +15,21 @@ SLICE-004: Delete a task (delete + API + UI + confirm) -> full CRUD
|
|
|
17
15
|
## Sizing a slice
|
|
18
16
|
A slice is the right size when it:
|
|
19
17
|
- delivers one observable capability end-to-end;
|
|
20
|
-
- can
|
|
18
|
+
- can finish its writer, independent review, and slice proof within `$rite-build`;
|
|
21
19
|
- has acceptance criteria you can verify with evidence;
|
|
22
20
|
- can be rolled back on its own;
|
|
23
21
|
- is worth its own review gate: a reviewer could meaningfully reject *this* slice while
|
|
24
22
|
approving its neighbor. If two slices can only pass or fail together, they're one slice.
|
|
25
23
|
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
24
|
+
Size by independent invariants, failure modes, and proof seams, not file count or
|
|
25
|
+
the word "and". Split independently acceptable/provable responsibilities; several
|
|
26
|
+
files may serve one inseparable capability. Full feature `$rite-prove` follows all
|
|
27
|
+
slices; slice proof never replaces final integration or acceptance proof.
|
|
29
28
|
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
29
|
+
For `Complexity` and irreducible boundaries, use the canonical
|
|
30
|
+
[`tasks.md` slice grammar](../../devrites-lib/reference/workspace-artifact-schema.md#canonical-slice-grammar).
|
|
31
|
+
Keep the smallest cut that stands alone end-to-end; do not add slices or gates for
|
|
32
|
+
fragments that can only pass together. No slice size guarantees first-pass correctness.
|
|
34
33
|
|
|
35
34
|
## How many slices?: derive, don't dictate
|
|
36
35
|
The slice **count is an output, not an input.** It falls out of the work: one slice per
|
|
@@ -46,10 +45,113 @@ a 12-criterion feature is however many thin end-to-end cuts those 12 need.
|
|
|
46
45
|
- **Re-size by the rule, not the tally** (`$rite-plan reslice`): split a slice because it
|
|
47
46
|
failed the sizing test, not to hit a count.
|
|
48
47
|
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
48
|
+
`.devrites/AFK` `max_slices` limits unattended execution, never plan decomposition.
|
|
49
|
+
|
|
50
|
+
## Feature ceiling: split an epic, never override the budget
|
|
51
|
+
|
|
52
|
+
The derived count is also a size signal. A decomposition that cannot fit the
|
|
53
|
+
`tasks.md` / `plan.md` / `traceability.md` budgets in
|
|
54
|
+
[`workspace-artifact-schema.md`](../../devrites-lib/reference/workspace-artifact-schema.md)
|
|
55
|
+
(about ten canonical slices) is an epic: every Vet/Doubt/Build review re-reads the
|
|
56
|
+
whole surface, each round finds new material, and the loop never converges.
|
|
57
|
+
`Budget override` never covers slice or acceptance-criteria count.
|
|
58
|
+
|
|
59
|
+
- Keep the thinnest independently shippable subset here; the rest becomes spec
|
|
60
|
+
`Non-goals` (via the Spec Drift Guard), each continuation a named future `$rite-spec`
|
|
61
|
+
workspace. Record the sequence once in `decisions.md`.
|
|
62
|
+
- Acceptance-preserving: every REQ/AC keeps its ID, owned by exactly one workspace.
|
|
63
|
+
- Earliest owner wins: Temper's one-sentence test → Define/Plan decomposition → Vet §0
|
|
64
|
+
scope finding → `$rite-plan course-correct` (`MVP cut`). Mid-build, unbuilt slices
|
|
65
|
+
beyond the ceiling move; built slices stay.
|
|
66
|
+
- The ceiling bounds one **workspace**, never the product: the sequence delivers every
|
|
67
|
+
slice, in order, each with its own Vet/Build/Review loop. A human may still accept a
|
|
68
|
+
single larger workspace by recording the decision in `decisions.md` and a structural
|
|
69
|
+
`Budget override:` in the affected artifacts; the extra review rounds on the whole
|
|
70
|
+
surface are then the accepted, named cost. The deterministic gate
|
|
71
|
+
(`check readiness`/`check seal`) blocks only a material overshoot without such an
|
|
72
|
+
override, so the choice stays explicit rather than accidental.
|
|
73
|
+
|
|
74
|
+
### Continuation workspaces
|
|
75
|
+
|
|
76
|
+
Granularity is a real cost choice, not a formality: a workspace costs ~8–12 fixed
|
|
77
|
+
dispatches (drafter, plan reviewer, proof runner, spec/code reviewers, seal roster;
|
|
78
|
+
Temper is skippable when the parent's `strategy.md` already covers the scope) plus
|
|
79
|
+
~3–5 per slice. The split does not remove per-slice cost; it bounds each round's
|
|
80
|
+
context, stops the non-convergent whole-surface loop, isolates a plan defect's blast
|
|
81
|
+
radius to its own workspace, and lets independent continuations run in parallel.
|
|
82
|
+
|
|
83
|
+
Make each continuation cheap and drift-free:
|
|
84
|
+
|
|
85
|
+
- `brief.md` names the parent slug and the sequence position; `decisions.md` holds the
|
|
86
|
+
sequence once (in the parent).
|
|
87
|
+
- The child's `state.md` seeds the durable cursor at creation — `sequence_parent` =
|
|
88
|
+
parent slug, `sequence_position` = parent position + 1,
|
|
89
|
+
`sequence_workspaces_remaining` = parent remaining − 1, and `sequence_role:
|
|
90
|
+
release` only when the recorded entry is the sequence's release milestone.
|
|
91
|
+
Values derive from the parent's `state.md` and its `decisions.md` record,
|
|
92
|
+
exactly once; resume re-derives the same values rather than charging again.
|
|
93
|
+
A workspace that is not a recorded continuation leaves all four rows absent.
|
|
94
|
+
This is what `state merge-manifest` walks and what the release-union gate reads,
|
|
95
|
+
so a manually opened continuation needs the same seeding as an armed run.
|
|
96
|
+
- Read the parent's `architecture.md`, `plan.md`, `decisions.md` (or its archived copy)
|
|
97
|
+
as **design input** — never re-derive settled architecture, dependency choices, or
|
|
98
|
+
interfaces. Proof is always fresh for the new candidate; parent evidence is cited as
|
|
99
|
+
input, never as proof for this workspace.
|
|
100
|
+
- Shared interfaces, data shapes, and contracts are pinned **once**, in the workspace
|
|
101
|
+
that introduces them, and referenced afterwards. A continuation that must change a
|
|
102
|
+
pinned contract does so through its own `plan.md` shared-contract proof and an ADR
|
|
103
|
+
that names the superseded owner — never by silently re-deciding it.
|
|
104
|
+
- A request that names a recorded continuation is a new workspace, not
|
|
105
|
+
`$rite-plan revise` on the parent.
|
|
106
|
+
- Phases chain automatically only **inside** one workspace (`$rite-autocomplete`
|
|
107
|
+
drives spec → clarify → temper → define → vet → build × slices → prove → polish →
|
|
108
|
+
review → seal; plain HITL chains plan↔vet inline and stops at each other boundary).
|
|
109
|
+
Crossing into the next continuation is a new invocation by design, so the human sees
|
|
110
|
+
each delivered increment before the next one starts.
|
|
111
|
+
|
|
112
|
+
### Release milestone (full-picture gate)
|
|
113
|
+
|
|
114
|
+
Milestone gates are feature-scoped: `prove` proves *that* workspace's acceptance,
|
|
115
|
+
`review`/`seal` judge *that* candidate. A product release therefore needs one more
|
|
116
|
+
workspace — the **release milestone** — planned last, whose subject is the assembled
|
|
117
|
+
product:
|
|
118
|
+
|
|
119
|
+
- Its ACs are product-level: cross-milestone integration, end-to-end journeys,
|
|
120
|
+
performance/release budgets, docs/rollout. Milestone ACs stay owned by their
|
|
121
|
+
milestones and are **referenced** here, never re-owned.
|
|
122
|
+
- Its candidate manifest lists the union of shipped surfaces, so one `prove` → `review`
|
|
123
|
+
→ `seal` binds the whole product, and one `ship` commits/pushes/tags the release.
|
|
124
|
+
Its `state.md` cursor carries `sequence_role: release` (seeded when the recorded
|
|
125
|
+
continuation is the sequence's release entry); `check candidate`/`check seal`
|
|
126
|
+
then require the manifest to cover the whole recorded chain. Build that union
|
|
127
|
+
deterministically: `devrites-engine state merge-manifest <release-slug>` walks
|
|
128
|
+
the recorded `sequence_parent` chain (live `work/` first, then `archive/`) and
|
|
129
|
+
folds every predecessor's manifest into the release `## Candidate manifest`;
|
|
130
|
+
on a path collision the later sequence position's row wins. An explicit
|
|
131
|
+
ordered `<pred>...` argument exists for chains recorded before the sequence
|
|
132
|
+
cursor fields.
|
|
133
|
+
- Earlier milestones keep their own slice-level proof and their own prove/review/seal;
|
|
134
|
+
that is what stops a late defect from invalidating 170 slices of work. Skipping a
|
|
135
|
+
milestone's proof is allowed only by recording the decision — the release milestone
|
|
136
|
+
then carries the full acceptance burden, and that cost is the named trade-off.
|
|
137
|
+
- The capability ledger (`.devrites/specs/<capability>/spec.md`) accumulates the
|
|
138
|
+
product picture across milestones; Polish folds each milestone's deltas.
|
|
139
|
+
- **Deferred-ship sequence** (`.devrites/AFK` `continue_sequence: true`, `max_workspaces: N`):
|
|
140
|
+
milestones are sealed but not shipped, and the armed run opens the next recorded
|
|
141
|
+
continuation automatically; per-slice `WIP(<slug>)` checkpoints still land locally,
|
|
142
|
+
so the tree stays clean. One release ship at the end collapses the sequence's
|
|
143
|
+
checkpoints into the single release commit, pushes/tags it, and may archive the
|
|
144
|
+
sealed predecessors. Because no milestone boundary was shipped, later work can touch
|
|
145
|
+
an earlier milestone's surfaces without an affected-re-proof trigger — so the release
|
|
146
|
+
milestone re-proves the union acceptance map, and that full re-proof is this mode's
|
|
147
|
+
named cost. Trade-off against per-milestone ship: no shared-history rollback point
|
|
148
|
+
per increment, one Git approval at the end.
|
|
149
|
+
- What is full-surface here is the **review**: reviewers see the whole product diff.
|
|
150
|
+
Re-proof stays targeted — this milestone's product ACs, everything a later milestone
|
|
151
|
+
touched, and any uncertain closure. Milestone evidence is cited only under
|
|
152
|
+
[evidence validity](../../devrites-lib/reference/candidate-integrity.md#evidence-validity)
|
|
153
|
+
with explicit unchanged-input/dependency justification and a link to the original
|
|
154
|
+
account; a blind re-proof of every milestone AC is a recorded decision, not a default.
|
|
53
155
|
|
|
54
156
|
## First slice
|
|
55
157
|
Make slice 1 the **thinnest useful end-to-end path**. It flushes out integration and
|
|
@@ -7,10 +7,12 @@ user-invocable: true
|
|
|
7
7
|
|
|
8
8
|
# $rite-prove: prove the completed feature
|
|
9
9
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
Never
|
|
13
|
-
criteria and bind
|
|
10
|
+
Prove the assembled feature once. No workspace: use `/verify` or `/run`;
|
|
11
|
+
pending tasks: stop for `$rite-build`.
|
|
12
|
+
Never assert unobserved passes. After Polish/Review edits, repeat affected
|
|
13
|
+
criteria/dependencies and bind under
|
|
14
|
+
[evidence validity](../devrites-lib/reference/candidate-integrity.md#evidence-validity).
|
|
15
|
+
Initial full feature proof and required mutable observations still run.
|
|
14
16
|
|
|
15
17
|
## Rules
|
|
16
18
|
|
|
@@ -21,21 +23,19 @@ Read the applicable standards: `testing.md`, `test-proof-checklist.md`,
|
|
|
21
23
|
`workflow-artifacts.md`. Developer surfaces require an observed flow, measured
|
|
22
24
|
TTHW, and exact signal-bearing errors; never assert DX.
|
|
23
25
|
|
|
24
|
-
-
|
|
25
|
-
|
|
26
|
-
signal is unproven.
|
|
26
|
+
- Each claim needs an executed positive, discriminating assertion and decisive
|
|
27
|
+
signal; green commands alone are unproven.
|
|
27
28
|
- Follow [`candidate-integrity.md`](../devrites-lib/reference/candidate-integrity.md). Prove owns proof binding, not candidate
|
|
28
29
|
grammar/hashing. Spec Drift Guard owns revealed contract drift.
|
|
29
|
-
- Root
|
|
30
|
-
|
|
31
|
-
source/tests; root never does.
|
|
30
|
+
- Root runs vetted gates/browser and records immutable evidence; proof runner
|
|
31
|
+
validates it. Only the bounded wright fixes product source/tests.
|
|
32
32
|
- **Prove remains the controlling caller** during technical backtracking. Save
|
|
33
33
|
its cursor; run Plan repair, Recovery Vet, remediation, and re-proof inline;
|
|
34
34
|
consume nested boundaries; resume the failed rung. Recovery exhausts after
|
|
35
35
|
three no-progress attempts on the exact same fingerprint. Closing one or exposing a distinct
|
|
36
36
|
Critical/Important invariant is progress, not a reason to hand work off.
|
|
37
37
|
<!-- workflow-artifact-adapter: {"module":"devrites-lib/reference/standards/workflow-artifacts.md","entry":"Prove consumes installed Workflow Artifact or CLEANED rerun","action":"VERIFY_EXISTING or admitted proof path ending PROVE_AND_RETURN","return":"saved Prove cursor; stop before real action"} -->
|
|
38
|
-
## Released-workspace refresh
|
|
38
|
+
## Released-workspace refresh
|
|
39
39
|
|
|
40
40
|
Only an admitted `$rite-upgrade` assessment proving a released-format candidate
|
|
41
41
|
defect enters. Require legacy touched-file scope, live diff, tasks, and traceability agree unambiguously
|
|
@@ -85,19 +85,17 @@ test changes.
|
|
|
85
85
|
[browser proof](reference/browser-proof.md): routes, viewports, opened and
|
|
86
86
|
described screenshots, console/network, interaction, target comparisons, and
|
|
87
87
|
every required state. Material mismatch fails.
|
|
88
|
-
7. **Independent validation.**
|
|
89
|
-
`devrites-
|
|
90
|
-
commands
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
scenario, interaction, and planned key link gets positive discriminating
|
|
95
|
-
evidence or a blocker, including applicable critical-path, observability,
|
|
96
|
-
developer, and wiring branches.
|
|
88
|
+
7. **Independent validation.** Fresh read-only `devrites-proof-runner` and
|
|
89
|
+
`devrites-spec-reviewer` judge the same candidate/commands/evidence/acceptance map.
|
|
90
|
+
Neither runs commands; reject missing/stale, invented-ID, label-only or self-attested reports.
|
|
91
|
+
8. **Map proof.** Reconcile verdicts under [acceptance-proof.md](reference/acceptance-proof.md).
|
|
92
|
+
Every criterion/scenario/interaction/key link needs discriminating evidence or a
|
|
93
|
+
blocker, including critical-path, observability, developer and wiring branches.
|
|
97
94
|
9. **Recover red.** Use [failure triage](reference/failure-triage.md) and Debug
|
|
98
95
|
Recovery. Reconcile reproduction; send accepted in-scope source/test correction
|
|
99
96
|
to the sole wright; update actual manifest; rerun affected proof, both candidate
|
|
100
|
-
checks, and fresh proof runner.
|
|
97
|
+
checks, and fresh proof runner. Recheck affected acceptance with the exact spec
|
|
98
|
+
reviewer; reconcile both validators under evidence validity. Scope growth blocks.
|
|
101
99
|
|
|
102
100
|
Agent-owned durable-plan errors run Spec Drift Guard, Plan, and Vet inline,
|
|
103
101
|
preserving Prove as origin. Consumptive failures use retained fixtures, repair,
|
|
@@ -112,7 +110,7 @@ test changes.
|
|
|
112
110
|
> Do not claim an unobserved pass, skip browser proof, or proceed with pending
|
|
113
111
|
> slices. Load `reference/anti-patterns.md` when tempted to do so.
|
|
114
112
|
|
|
115
|
-
## Phase exit
|
|
113
|
+
## Phase exit
|
|
116
114
|
|
|
117
115
|
**Complete when:** every criterion in `acceptance-proof.md` has discriminating
|
|
118
116
|
evidence bound to the current candidate digest, both independent validators admit
|
|
@@ -57,7 +57,7 @@ Pull these via `Read` when the diff demands them:
|
|
|
57
57
|
|
|
58
58
|
0. Read `.agents/skills/devrites-lib/reference/standards/core.md` first (the always-on operating rules); pull the
|
|
59
59
|
on-demand rules above as the diff demands them.
|
|
60
|
-
1. Read `spec.md`, `tasks.md`, `state.md`, `decisions.md`,
|
|
60
|
+
1. Read `spec.md`, `tasks.md`, `state.md`, `decisions.md`,
|
|
61
61
|
`touched-files.md`, `.devrites/principles.md` (if present: the binding invariants to score
|
|
62
62
|
the diff against), and the `git diff`. For "what would this change break"
|
|
63
63
|
questions, apply `.agents/skills/devrites-lib/reference/standards/tooling.md`: use
|
|
@@ -66,7 +66,14 @@ Pull these via `Read` when the diff demands them:
|
|
|
66
66
|
current API, context7 if available can confirm the signature. Run
|
|
67
67
|
`devrites-engine check candidate <slug>` and require its digest to match the
|
|
68
68
|
single `evidence.md` binding and the `browser-evidence.md` binding when that
|
|
69
|
-
file exists.
|
|
69
|
+
file exists. Read those ledgers via the bounded advisory read
|
|
70
|
+
(`workspace-artifact-schema.md` § Read next by phase): binding line, `EVID-###`
|
|
71
|
+
index, then bodies for this candidate's AC/slice IDs only. A missing,
|
|
72
|
+
malformed, or open candidate returns to Polish/Prove.
|
|
73
|
+
Read `touched-files.md` `## Review trail` and `eng-review.md` `## Deferred findings`:
|
|
74
|
+
every deferred row is an input finding for the step-3 cohort (quoted in the owning
|
|
75
|
+
reviewer's brief without severity) and ends in `review.md` with its own label and
|
|
76
|
+
action tag — never silently dropped.
|
|
70
77
|
2. **Review tests first:** do they prove the acceptance criteria? Missing,
|
|
71
78
|
weak, or wrong tests are the first findings.
|
|
72
79
|
**Completion:** every acceptance criterion maps to a proven test or a labeled finding.
|
|
@@ -74,7 +81,8 @@ Pull these via `Read` when the diff demands them:
|
|
|
74
81
|
one axis and fail the other: code that follows every project standard but
|
|
75
82
|
implements the wrong thing (Code-review pass, Spec fail), or code that does exactly
|
|
76
83
|
what the spec asked but breaks project conventions (Spec pass, Code-review fail).
|
|
77
|
-
Separate contexts prevent one axis from masking the other
|
|
84
|
+
Separate contexts prevent one axis from masking the other. This is the initial
|
|
85
|
+
full pass; a correction uses step 7's bounded recheck:
|
|
78
86
|
- Freeze that closed digest and give the same digest to **two** read-only reviewers in
|
|
79
87
|
parallel, each with its own narrow brief and no
|
|
80
88
|
cross-pollination — and evaluate the frontend (step 4), security (step 5),
|
|
@@ -88,17 +96,10 @@ Pull these via `Read` when the diff demands them:
|
|
|
88
96
|
missing spec` and do not infer requirements from the diff."
|
|
89
97
|
- **Code-review axis** → `devrites-code-reviewer`: "Apply your full documented
|
|
90
98
|
discipline (tests-first, correctness, readability, architecture, maintainability,
|
|
91
|
-
standards) on the
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
where 20 would do) and the silent-failure bugs (a missing value coerced to 0/''/[],
|
|
96
|
-
a dropped Result/err return, off-by-one / boundary, logic that contradicts the
|
|
97
|
-
comment/docstring/name). Per hunk, check whether working code was deleted that the
|
|
98
|
-
task did not ask to remove. Score the diff against `.devrites/principles.md`: a change
|
|
99
|
-
that breaks a declared invariant with no recorded, human-approved exception is a Critical.
|
|
100
|
-
Distinguish hard documented-standard violations from baseline smells; smells are judgment
|
|
101
|
-
calls unless a DevRites or project standard makes them binding."
|
|
99
|
+
standards) on the feature workspace + diff. Cite file:line; skip tooling-enforced
|
|
100
|
+
checks. Apply canonical anti-slop and silent-failure lenses; inspect each hunk
|
|
101
|
+
for unrequested deletion. Unexcepted `.devrites/principles.md` violations are
|
|
102
|
+
Critical. Distinguish binding standards from judgment-only baseline smells."
|
|
102
103
|
- **Do NOT merge or re-rank** their findings. Present them under separate
|
|
103
104
|
`## Spec` and `## Code review` sub-sections in `review.md`. Surface contradictions
|
|
104
105
|
between the axes explicitly (e.g. "Spec axis says complete, Code-review axis says
|
|
@@ -131,9 +132,15 @@ Pull these via `Read` when the diff demands them:
|
|
|
131
132
|
7. Reconcile and accept only in-scope fixes. Consolidate them into one bounded
|
|
132
133
|
wright correction; never edit source in the reviewing context. Any correction
|
|
133
134
|
updates the candidate manifest, returns through affected Prove, and then starts
|
|
134
|
-
a fresh Review on the new digest.
|
|
135
|
+
a fresh Review binding on the new digest. Dispatch affected exact reviewers on
|
|
136
|
+
all their open findings and the dependency/regression closure under
|
|
137
|
+
[evidence validity](../devrites-lib/reference/candidate-integrity.md#evidence-validity).
|
|
138
|
+
Cite unchanged sub-scope coverage only with its original identity and explicit
|
|
139
|
+
justification; never relabel old accounts. Changed contracts or uncertain impact
|
|
140
|
+
require the full applicable pass.
|
|
135
141
|
8. The root updates `review.md` and `state.md`, writing exactly one candidate
|
|
136
|
-
binding in `review.md` for the digest
|
|
142
|
+
binding in `review.md` for the current digest, distinguishing fresh accounts from
|
|
143
|
+
cited unchanged sub-scope evidence and reconciling complete coverage.
|
|
137
144
|
**Completion:** the records name the reviewed candidate identity and every accepted
|
|
138
145
|
correction has affected proof plus a fresh Review.
|
|
139
146
|
|
|
@@ -7,8 +7,8 @@ user-invocable: true
|
|
|
7
7
|
|
|
8
8
|
# $rite-seal: GO / NO-GO
|
|
9
9
|
|
|
10
|
-
Verify
|
|
11
|
-
|
|
10
|
+
Verify final candidate in `seal.md`; `$rite-ship` owns authorized irreversible
|
|
11
|
+
actions and close-out.
|
|
12
12
|
|
|
13
13
|
## Authority
|
|
14
14
|
|
|
@@ -36,6 +36,7 @@ The host runs/reconciles named read-only reviewers; engine checks invariants.
|
|
|
36
36
|
| Any acceptance criterion, resolved prohibition, or declared key link lacks proof | **NO-GO** |
|
|
37
37
|
| Evidence is stale, or native diff review plus the exact test analyst finds weakened tests | **NO-GO: Critical** |
|
|
38
38
|
| Any exact required reviewer account is missing or silent | **NO-GO** |
|
|
39
|
+
| Any deferred finding (`touched-files.md` `## Review trail`, `eng-review.md` `## Deferred findings`) lacks a `review.md` verdict | **NO-GO** |
|
|
39
40
|
| Any `gate: validating` question remains open | **NO-GO** |
|
|
40
41
|
| Material UI acceptance lacks or fails required browser proof | **NO-GO** |
|
|
41
42
|
| Unresolved drift, unsafe migration/removal, or unapproved principle violation remains | **NO-GO** |
|
|
@@ -52,18 +53,17 @@ Follow [`reference/phase-contract.md`](reference/phase-contract.md)
|
|
|
52
53
|
|
|
53
54
|
1. read workspace and final diff;
|
|
54
55
|
2. recheck the canonical candidate/bindings and approved repository/CI proof;
|
|
55
|
-
3.
|
|
56
|
-
|
|
57
|
-
read-only verdicts on one frozen candidate;
|
|
56
|
+
3. admit valid Spec/Code accounts; dispatch remaining required exact roles under
|
|
57
|
+
`../devrites-lib/reference/parallel-dispatch.md` on the same frozen candidate;
|
|
58
58
|
4. reconcile their read-only verdicts against source and immutable evidence;
|
|
59
59
|
5. draft GO/NO-GO `seal.md` with acceptance, tests, decisions, and seven accounts;
|
|
60
60
|
6. write exactly one candidate binding, then run
|
|
61
61
|
`devrites-engine check seal <slug>` for structure and identity, never semantics.
|
|
62
62
|
|
|
63
|
-
|
|
64
|
-
|
|
63
|
+
Corrections return through affected Prove/Review before restarting Seal under
|
|
64
|
+
[evidence validity](../devrites-lib/reference/candidate-integrity.md#evidence-validity).
|
|
65
65
|
|
|
66
|
-
Only repository scripts/CI authorize commands; never guess
|
|
66
|
+
Only repository scripts/CI authorize commands; never guess.
|
|
67
67
|
|
|
68
68
|
## On GO
|
|
69
69
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Final evidence check
|
|
2
2
|
|
|
3
|
-
Map
|
|
3
|
+
Map spec promises to valid observed proof.
|
|
4
4
|
|
|
5
5
|
## Acceptance
|
|
6
6
|
|
|
@@ -11,7 +11,7 @@ inspection alone, and generic "tests pass" do not count.
|
|
|
11
11
|
|
|
12
12
|
Apply [`testing.md`'s positive, discriminating proof](../../devrites-lib/reference/standards/testing.md#positive-discriminating-proof),
|
|
13
13
|
including invalid-result exclusions and static/textual criterion boundaries.
|
|
14
|
-
|
|
14
|
+
Unproven behavior: NO-GO.
|
|
15
15
|
|
|
16
16
|
## Cross-check
|
|
17
17
|
|
|
@@ -25,11 +25,12 @@ recovery evidence or an evidence-backed dismissal; a generic green suite cannot
|
|
|
25
25
|
|
|
26
26
|
Run `devrites-engine check candidate <slug>` and require its digest to match the
|
|
27
27
|
single evidence/review bindings and browser binding when present. Diff tests,
|
|
28
|
-
dispatch exact `devrites-test-analyst
|
|
29
|
-
|
|
28
|
+
dispatch exact `devrites-test-analyst`; apply
|
|
29
|
+
[evidence validity](../../devrites-lib/reference/candidate-integrity.md#evidence-validity)
|
|
30
|
+
to approved proof, then require unchanged digest/sources. Deleted/skipped/focused/
|
|
30
31
|
weakened/tautological tests are Critical.
|
|
31
32
|
|
|
32
|
-
After
|
|
33
|
+
After recording verdicts in `seal.md`, run:
|
|
33
34
|
|
|
34
35
|
```bash
|
|
35
36
|
devrites-engine check seal "<slug>"
|
|
@@ -1,27 +1,29 @@
|
|
|
1
1
|
# rite-seal phase contract
|
|
2
2
|
|
|
3
|
-
Seal's candidate action follows
|
|
4
|
-
[`candidate-integrity.md`](../../devrites-lib/reference/candidate-integrity.md).
|
|
5
|
-
|
|
6
3
|
1. **Read.** Resolve the explicit slug or `.devrites/ACTIVE`, require its
|
|
7
4
|
`state.md`, then read required workspace artifacts, conditional
|
|
8
5
|
browser/design/devex evidence, and final diff.
|
|
9
6
|
2. **Recheck identity and real proof.** Run
|
|
10
7
|
`devrites-engine check candidate <slug>` and require its exact digest to match
|
|
11
8
|
the single evidence/review bindings and the browser binding when present.
|
|
12
|
-
Apply `spec-grammar.md`'s Native grammar re-read checklist
|
|
13
|
-
|
|
9
|
+
Apply `spec-grammar.md`'s Native grammar re-read checklist and
|
|
10
|
+
[evidence validity](../../devrites-lib/reference/candidate-integrity.md#evidence-validity).
|
|
11
|
+
Run required `test-plan.md` commands unless valid observed proof already satisfies
|
|
12
|
+
them under that contract. Rerun the
|
|
14
13
|
candidate check afterward and require the identical digest and no source
|
|
15
14
|
mutation. Capture command, cwd, exit, decisive output, and identity.
|
|
16
15
|
Missing/red/mismatched blocks; unavailable is `cannot_verify`, never pass.
|
|
17
16
|
3. **Judge acceptance.** Dispatch exact `devrites-proof-runner` on immutable
|
|
18
|
-
proof
|
|
17
|
+
proof; admit valid same-candidate `devrites-spec-reviewer` evidence from Review
|
|
18
|
+
or dispatch that exact reviewer. Reconcile every
|
|
19
19
|
AC/REQ/scenario/key link by ID and meaning; missing/stale/self-attested/mismatched is NO-GO.
|
|
20
20
|
4. **Judge tests.** Diff baseline/candidate tests for deletion, skip/focus,
|
|
21
21
|
tautology, or weakening; dispatch exact `devrites-test-analyst`. Missing or
|
|
22
22
|
adverse account, or green tests not asserting mapped behavior, is Critical.
|
|
23
23
|
5. **Resolve gates.** Open blocking/escalating/validating questions and drift
|
|
24
24
|
block. Each stood decision needs a reconciled exact `devrites-doubt-reviewer` verdict.
|
|
25
|
+
Every deferred finding (`touched-files.md` `## Review trail`, `eng-review.md`
|
|
26
|
+
`## Deferred findings`) needs its `review.md` verdict; a row without one blocks.
|
|
25
27
|
6. **Risk and native review.** Apply [`risk-and-rollback.md`](risk-and-rollback.md)
|
|
26
28
|
and the [`review roster`](../../devrites-lib/reference/parallel-dispatch.md) on
|
|
27
29
|
the candidate. Admit each result through
|
|
@@ -31,17 +33,15 @@ Seal's candidate action follows
|
|
|
31
33
|
7. **Route corrections.** Reconcile cited findings/disagreements, but do not
|
|
32
34
|
edit the candidate or manifest in Seal. Route an accepted correction through
|
|
33
35
|
one bounded wright, update the manifest, run affected Prove, complete a fresh
|
|
34
|
-
Review, then restart Seal on the new digest.
|
|
35
|
-
8. **Draft
|
|
36
|
+
Review under evidence validity, then restart Seal on the new digest.
|
|
37
|
+
8. **Draft/check.** Write `seal.md` from
|
|
36
38
|
[`seal-template.md`](seal-template.md) with the GO/NO-GO rationale, acceptance map,
|
|
37
39
|
test-analysis account, stood-decision verdicts, all seven reviewer accounts,
|
|
38
40
|
and exactly one `Candidate SHA-256: <64 lowercase hex>` line. Then run:
|
|
39
41
|
```bash
|
|
40
42
|
devrites-engine check seal "<slug>"
|
|
41
43
|
```
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
smallest fix. Never commit, push, tag, publish, deploy, or close here.
|
|
44
|
+
Structure/bindings only: blocks exit `3`, invalid state `2`. GO sets
|
|
45
|
+
`Next step: $rite-ship`; NO-GO names the fix. No commit/push/tag/publish/deploy/close.
|
|
45
46
|
|
|
46
|
-
|
|
47
|
-
> load [`anti-patterns.md`](anti-patterns.md).
|
|
47
|
+
Apply [`anti-patterns.md`](anti-patterns.md); never average away disagreement.
|
|
@@ -80,6 +80,9 @@ if absent, route to `$rite-spec <feature>`. Ship only with current **GO** in `se
|
|
|
80
80
|
to move `.devrites/work/<slug>` → `.devrites/archive/<slug>` and clear `ACTIVE`
|
|
81
81
|
only if it names this slug; preserve another active feature's cursor.
|
|
82
82
|
Preserve every `.md`; stable hierarchical instructions need no active-workspace sync.
|
|
83
|
+
Report the recorded `Next step` verbatim — the exact `$rite-spec <parent>-<n> "<objective>"`
|
|
84
|
+
when a continuation sequence remains — so the next increment starts from one line,
|
|
85
|
+
never from chat memory.
|
|
83
86
|
|
|
84
87
|
> **Mid-flight discipline.** No seal GO, skipped type-GO, out-of-manifest stage, or
|
|
85
88
|
> deleted workspace. Stop and use [`anti-patterns`](reference/anti-patterns.md).
|
|
@@ -5,8 +5,13 @@ deleted. DevRites keeps the audit trail; it just moves out of the live path.
|
|
|
5
5
|
|
|
6
6
|
## What close-out does
|
|
7
7
|
|
|
8
|
-
1. **Mark done.** Set `state.md` → `Phase: done`, `Status: done`, and a `Next step
|
|
9
|
-
|
|
8
|
+
1. **Mark done.** Set `state.md` → `Phase: done`, `Status: done`, and a `Next step`.
|
|
9
|
+
When this workspace's `decisions.md` records an unfinished
|
|
10
|
+
[continuation sequence](../../rite-plan/reference/slicing.md#continuation-workspaces),
|
|
11
|
+
that step is the **exact** next command — `$rite-spec <parent>-<n> "<objective>"` —
|
|
12
|
+
and the ship reply prints the same line. Otherwise it stays
|
|
13
|
+
`$rite-spec <next feature>`. Nothing spawns the continuation automatically:
|
|
14
|
+
the recorded command is the handoff, so the human starts each increment knowingly.
|
|
10
15
|
2. **Archive.** Run the deterministic script:
|
|
11
16
|
```bash
|
|
12
17
|
devrites-engine state close <slug>
|
|
@@ -25,6 +30,15 @@ can also fail. Inspect the actual live path, archive and cursor before reporting
|
|
|
25
30
|
retrying. Record the command/error and observed locations; never claim restored state
|
|
26
31
|
from an attempted rollback or repeat a move against an unverified destination.
|
|
27
32
|
|
|
33
|
+
## Sequence predecessors
|
|
34
|
+
|
|
35
|
+
A deferred-ship sequence leaves earlier milestones sealed and unarchived in
|
|
36
|
+
`.devrites/work/`. The release ship's disclosed plan may close them
|
|
37
|
+
(`devrites-engine state close '<slug>'` per predecessor) after the release commit
|
|
38
|
+
lands; each close is safe because `ACTIVE` names the release workspace. Closing is
|
|
39
|
+
bookkeeping only: the release commit already carries their bytes, and their audit
|
|
40
|
+
records move intact.
|
|
41
|
+
|
|
28
42
|
## Why archive, not delete
|
|
29
43
|
|
|
30
44
|
- The `.md` files (`spec`, `decisions`, `assumptions`, `evidence`, `seal`, `ship`, …)
|
|
@@ -12,11 +12,13 @@ Acceptance criteria proven: <n / total>
|
|
|
12
12
|
Branch: <target branch>
|
|
13
13
|
Candidate paths: <exact project-relative paths>
|
|
14
14
|
Checkpoint collapse: <exact `git reset --soft '<merge-base>'` command | skip>
|
|
15
|
+
Collapse slugs: <active slug plus every recorded sequence slug in the range | n/a>
|
|
15
16
|
Stage plan: <exact argv-safe `git add -- '<path>'` command for every manifest row>
|
|
16
17
|
Commit: <exact git commit command>
|
|
17
18
|
Push: <exact git push command | skip>
|
|
18
19
|
Tag: <exact git tag command | skip>
|
|
19
20
|
PR: <exact PR command, target, title, and body source | skip>
|
|
21
|
+
Close: <exact `devrites-engine state close '<slug>'` for each sealed sequence predecessor | skip>
|
|
20
22
|
|
|
21
23
|
Type "GO" exactly to approve this attempt once. Anything else cancels.
|
|
22
24
|
```
|
|
@@ -45,9 +47,12 @@ Pre-GO is read-only. Do not run the disclosed collapse or staging commands.
|
|
|
45
47
|
1. **Analyze checkpoint history without mutating it.** Read the upstream, merge
|
|
46
48
|
base, commit OIDs, and full subjects. If no checkpoint commit exists, disclose
|
|
47
49
|
`skip`. A collapse is eligible only when every commit in its range has the exact
|
|
48
|
-
`WIP(<
|
|
49
|
-
|
|
50
|
-
|
|
50
|
+
`WIP(<slug>):` prefix for the validated active slug — or, for a release ship of a
|
|
51
|
+
deferred-ship sequence, for a slug recorded in the parent's `decisions.md`
|
|
52
|
+
sequence whose workspace is sealed in this run
|
|
53
|
+
([afk-hitl.md § Sequence continuation](../../devrites-lib/reference/standards/afk-hitl.md#sequence-continuation-continue_sequence-max_workspaces));
|
|
54
|
+
disclose the exact slug set. A different slug, missing colon, broad `WIP(` match,
|
|
55
|
+
ordinary commit, or mixed history blocks; never reinterpret the range.
|
|
51
56
|
2. **Verify the candidate.** Rerun `devrites-engine check candidate <slug>` and
|
|
52
57
|
`devrites-engine check seal <slug>`, compare every binding, require the
|
|
53
58
|
candidate worktree paths to be unchanged, and inspect the existing staged
|
|
@@ -62,8 +67,8 @@ Pre-GO is read-only. Do not run the disclosed collapse or staging commands.
|
|
|
62
67
|
|
|
63
68
|
1. **Optional checkpoint collapse.** If and only if the prompt disclosed it,
|
|
64
69
|
recheck that `HEAD`, merge base, and every subject are unchanged and that each
|
|
65
|
-
subject starts exactly `WIP(<slug>):` for the
|
|
66
|
-
disclosed `git reset --soft "$mb"`. Otherwise skip. Any different or mixed
|
|
70
|
+
subject starts exactly `WIP(<slug>):` for the disclosed slug set, then run the
|
|
71
|
+
exact disclosed `git reset --soft "$mb"`. Otherwise skip. Any different or mixed
|
|
67
72
|
subject blocks without mutation.
|
|
68
73
|
2. **Exact staging.** Run `git add -- "$path"` once for each disclosed manifest
|
|
69
74
|
row, passing each validated project-relative path as its own quoted argv
|
|
@@ -95,6 +100,10 @@ Pre-GO is read-only. Do not run the disclosed collapse or staging commands.
|
|
|
95
100
|
Any mismatch stops; do not reinterpret it.
|
|
96
101
|
8. **Push** to the project-conventional target branch.
|
|
97
102
|
9. **Tag / PR** only when project convention requires it; otherwise skip.
|
|
103
|
+
10. **Close sealed predecessors** only when the prompt disclosed them: run the
|
|
104
|
+
exact `devrites-engine state close '<slug>'` once per predecessor. Each is safe
|
|
105
|
+
because `ACTIVE` names the release workspace; a nonzero exit stops the rest and
|
|
106
|
+
is reported, never retried against an unverified destination.
|
|
98
107
|
|
|
99
108
|
Record SHA(s), branch, and tag/PR URL in `ship.md`.
|
|
100
109
|
|
|
@@ -50,6 +50,12 @@ load a routed standard to discover required behavior, not to prescribe implement
|
|
|
50
50
|
problem in one sentence. **Completion:** it includes both.
|
|
51
51
|
1a. **Dedupe.** Search local issues/PRDs, work, and archive. On a close match ask
|
|
52
52
|
extend/adopt/new, then record the choice; otherwise continue silently.
|
|
53
|
+
A recorded [feature-sequence continuation](../rite-plan/reference/slicing.md#continuation-workspaces)
|
|
54
|
+
is a **new** workspace (`<parent>-2`): carry the parent slug and position into
|
|
55
|
+
`brief.md`, read the parent artifacts as design input, and do not route to
|
|
56
|
+
`$rite-plan revise` on the parent. When the ask is open and archived work records
|
|
57
|
+
an unfinished sequence, propose that next continuation (slug + objective) as the
|
|
58
|
+
recommended option instead of a fresh slug.
|
|
53
59
|
2. **Investigate:** follow [investigation](reference/investigation.md) through its
|
|
54
60
|
complete findings and done-when gate. Discover the project's **test /
|
|
55
61
|
build/typecheck/lint** commands, frontend/backend systems, and declared project guidance
|
|
@@ -172,6 +172,12 @@ Ordinary workspace creation preserves the field without initializing,
|
|
|
172
172
|
increasing, renaming, or deleting it. Released bullet workspaces spell it `AFK
|
|
173
173
|
slices remaining`; preserve that presentation rather than migrating it.
|
|
174
174
|
|
|
175
|
+
When the brief records a [sequence continuation](../../rite-plan/reference/slicing.md#continuation-workspaces),
|
|
176
|
+
seed the `sequence_parent`, `sequence_position`, `sequence_workspaces_remaining`,
|
|
177
|
+
and — for the release entry — `sequence_role` rows at creation per that contract.
|
|
178
|
+
Without them `state merge-manifest` cannot walk the chain and the release-union
|
|
179
|
+
gate never engages.
|
|
180
|
+
|
|
175
181
|
## questions.md entry format
|
|
176
182
|
|
|
177
183
|
```markdown
|