devrites 4.0.11 → 4.1.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 +14 -0
- package/README.md +5 -3
- package/docs/architecture.md +4 -4
- package/docs/command-map.md +4 -3
- package/docs/flow.md +2 -1
- package/docs/orchestration.md +45 -4
- package/docs/skills.md +5 -4
- package/engine/internal/devritespaths/paths.go +5 -4
- package/engine/internal/hostpack/hostpack.go +9 -4
- package/engine/internal/hostpack/hostpack_test.go +16 -7
- package/engine/internal/install/install_test.go +5 -0
- package/pack/.claude/agents/devrites-code-reviewer.md +6 -1
- package/pack/.claude/agents/devrites-plan-drafter.md +5 -0
- package/pack/.claude/agents/devrites-plan-reviewer.md +6 -0
- package/pack/.claude/agents/devrites-proof-runner.md +7 -1
- package/pack/.claude/agents/devrites-retrospector.md +21 -25
- package/pack/.claude/agents/devrites-security-auditor.md +7 -3
- package/pack/.claude/agents/devrites-slice-wright.md +30 -4
- package/pack/.claude/agents/devrites-spec-reviewer.md +5 -0
- package/pack/.claude/agents/devrites-strategy-reviewer.md +3 -4
- package/pack/.claude/agents/devrites-test-analyst.md +5 -0
- package/pack/.claude/skills/devrites-debug-recovery/SKILL.md +12 -16
- package/pack/.claude/skills/devrites-debug-recovery/reference/build-the-loop.md +11 -14
- package/pack/.claude/skills/devrites-doubt/SKILL.md +3 -4
- package/pack/.claude/skills/devrites-frontend-craft/reference/reuse-first.md +3 -4
- package/pack/.claude/skills/devrites-lib/reference/reply-contract.md +6 -0
- package/pack/.claude/skills/devrites-lib/reference/standards/README.md +5 -1
- package/pack/.claude/skills/devrites-lib/reference/standards/afk-hitl.md +33 -8
- package/pack/.claude/skills/devrites-lib/reference/standards/agents.md +11 -3
- package/pack/.claude/skills/devrites-lib/reference/standards/ci-cd.md +19 -0
- package/pack/.claude/skills/devrites-lib/reference/standards/code-review.md +1 -1
- package/pack/.claude/skills/devrites-lib/reference/standards/context-hygiene.md +9 -0
- package/pack/.claude/skills/devrites-lib/reference/standards/core.md +9 -1
- package/pack/.claude/skills/devrites-lib/reference/standards/data-integrity.md +95 -0
- package/pack/.claude/skills/devrites-lib/reference/standards/developer-experience.md +5 -5
- package/pack/.claude/skills/devrites-lib/reference/standards/documentation.md +28 -29
- package/pack/.claude/skills/devrites-lib/reference/standards/edge-case-trace.md +70 -10
- package/pack/.claude/skills/devrites-lib/reference/standards/integration-reliability.md +79 -0
- package/pack/.claude/skills/devrites-lib/reference/standards/loop-operations.md +85 -0
- package/pack/.claude/skills/devrites-lib/reference/standards/observability.md +10 -0
- package/pack/.claude/skills/devrites-lib/reference/standards/patterns.md +20 -0
- package/pack/.claude/skills/devrites-lib/reference/standards/repository-topology.md +73 -0
- package/pack/.claude/skills/devrites-lib/reference/standards/security-checklist.md +6 -2
- package/pack/.claude/skills/devrites-lib/reference/standards/security.md +51 -16
- package/pack/.claude/skills/devrites-lib/reference/standards/skill-authoring.md +35 -40
- package/pack/.claude/skills/devrites-lib/reference/standards/test-proof-checklist.md +4 -0
- package/pack/.claude/skills/devrites-lib/reference/standards/testing.md +51 -6
- package/pack/.claude/skills/rite/SKILL.md +2 -0
- package/pack/.claude/skills/rite-adopt/SKILL.md +8 -10
- package/pack/.claude/skills/rite-adopt/reference/adoption.md +13 -15
- package/pack/.claude/skills/rite-autocomplete/SKILL.md +26 -11
- package/pack/.claude/skills/rite-autocomplete/reference/loop.md +47 -6
- package/pack/.claude/skills/rite-autocomplete/reference/stop-conditions.md +12 -0
- package/pack/.claude/skills/rite-build/SKILL.md +7 -1
- package/pack/.claude/skills/rite-build/reference/phase-contract.md +6 -1
- package/pack/.claude/skills/rite-build/reference/wright-dispatch.md +37 -4
- package/pack/.claude/skills/rite-clarify/SKILL.md +3 -2
- package/pack/.claude/skills/rite-converge/SKILL.md +4 -2
- package/pack/.claude/skills/rite-converge/reference/convergence-assessment.md +8 -4
- package/pack/.claude/skills/rite-customize/SKILL.md +16 -18
- package/pack/.claude/skills/rite-define/SKILL.md +60 -62
- package/pack/.claude/skills/rite-define/reference/plan-template.md +88 -71
- package/pack/.claude/skills/rite-explain/SKILL.md +2 -1
- package/pack/.claude/skills/rite-learn/SKILL.md +28 -32
- package/pack/.claude/skills/rite-plan/SKILL.md +42 -45
- package/pack/.claude/skills/rite-plan/reference/dependency-graph.md +11 -2
- package/pack/.claude/skills/rite-plan/reference/task-breakdown.md +2 -0
- package/pack/.claude/skills/rite-polish/reference/adr-promotion.md +7 -7
- package/pack/.claude/skills/rite-pressure-test/SKILL.md +24 -31
- package/pack/.claude/skills/rite-prove/SKILL.md +12 -15
- package/pack/.claude/skills/rite-prove/reference/acceptance-proof.md +28 -0
- package/pack/.claude/skills/rite-review/SKILL.md +5 -4
- package/pack/.claude/skills/rite-review/reference/five-axis-review.md +6 -0
- package/pack/.claude/skills/rite-review/reference/security-review.md +7 -2
- package/pack/.claude/skills/rite-seal/reference/final-evidence.md +3 -0
- package/pack/.claude/skills/rite-seal/reference/risk-and-rollback.md +19 -4
- package/pack/.claude/skills/rite-ship/reference/rollout.md +62 -43
- package/pack/.claude/skills/rite-spec/SKILL.md +8 -1
- package/pack/.claude/skills/rite-spec/reference/ai-spec-template.md +13 -6
- package/pack/.claude/skills/rite-spec/reference/spec-checklists.md +14 -2
- package/pack/.claude/skills/rite-spec/reference/spec-template.md +33 -4
- package/pack/.claude/skills/rite-temper/SKILL.md +5 -1
- package/pack/.claude/skills/rite-vet/SKILL.md +14 -10
- package/pack/.claude/skills/rite-vet/reference/artifacts.md +5 -3
- package/pack/.claude/skills/rite-vet/reference/review-axes.md +67 -77
- package/pack/.claude/skills/rite-watch-pr/SKILL.md +85 -0
- package/pack/.claude/skills/rite-zoom-out/SKILL.md +4 -5
- package/pack/.claude/workflows/devrites-readonly-review.js +194 -0
- package/pack/generated/README.md +1 -1
- package/pack/generated/claude/agents/devrites-code-reviewer.md +6 -1
- package/pack/generated/claude/agents/devrites-plan-drafter.md +5 -0
- package/pack/generated/claude/agents/devrites-plan-reviewer.md +6 -0
- package/pack/generated/claude/agents/devrites-proof-runner.md +7 -1
- package/pack/generated/claude/agents/devrites-retrospector.md +21 -25
- package/pack/generated/claude/agents/devrites-security-auditor.md +7 -3
- package/pack/generated/claude/agents/devrites-slice-wright.md +30 -4
- package/pack/generated/claude/agents/devrites-spec-reviewer.md +5 -0
- package/pack/generated/claude/agents/devrites-strategy-reviewer.md +3 -4
- package/pack/generated/claude/agents/devrites-test-analyst.md +5 -0
- package/pack/generated/claude/skills/devrites-debug-recovery/SKILL.md +12 -16
- package/pack/generated/claude/skills/devrites-debug-recovery/reference/build-the-loop.md +11 -14
- package/pack/generated/claude/skills/devrites-doubt/SKILL.md +3 -4
- package/pack/generated/claude/skills/devrites-frontend-craft/reference/reuse-first.md +3 -4
- package/pack/generated/claude/skills/devrites-lib/reference/reply-contract.md +6 -0
- package/pack/generated/claude/skills/devrites-lib/reference/standards/README.md +5 -1
- package/pack/generated/claude/skills/devrites-lib/reference/standards/afk-hitl.md +33 -8
- package/pack/generated/claude/skills/devrites-lib/reference/standards/agents.md +11 -3
- package/pack/generated/claude/skills/devrites-lib/reference/standards/ci-cd.md +19 -0
- package/pack/generated/claude/skills/devrites-lib/reference/standards/code-review.md +1 -1
- package/pack/generated/claude/skills/devrites-lib/reference/standards/context-hygiene.md +9 -0
- package/pack/generated/claude/skills/devrites-lib/reference/standards/core.md +9 -1
- package/pack/generated/claude/skills/devrites-lib/reference/standards/data-integrity.md +95 -0
- package/pack/generated/claude/skills/devrites-lib/reference/standards/developer-experience.md +5 -5
- package/pack/generated/claude/skills/devrites-lib/reference/standards/documentation.md +28 -29
- package/pack/generated/claude/skills/devrites-lib/reference/standards/edge-case-trace.md +70 -10
- package/pack/generated/claude/skills/devrites-lib/reference/standards/integration-reliability.md +79 -0
- package/pack/generated/claude/skills/devrites-lib/reference/standards/loop-operations.md +85 -0
- package/pack/generated/claude/skills/devrites-lib/reference/standards/observability.md +10 -0
- package/pack/generated/claude/skills/devrites-lib/reference/standards/patterns.md +20 -0
- package/pack/generated/claude/skills/devrites-lib/reference/standards/repository-topology.md +73 -0
- package/pack/generated/claude/skills/devrites-lib/reference/standards/security-checklist.md +6 -2
- package/pack/generated/claude/skills/devrites-lib/reference/standards/security.md +51 -16
- package/pack/generated/claude/skills/devrites-lib/reference/standards/skill-authoring.md +35 -40
- package/pack/generated/claude/skills/devrites-lib/reference/standards/test-proof-checklist.md +4 -0
- package/pack/generated/claude/skills/devrites-lib/reference/standards/testing.md +51 -6
- package/pack/generated/claude/skills/rite/SKILL.md +2 -0
- package/pack/generated/claude/skills/rite-adopt/SKILL.md +8 -10
- package/pack/generated/claude/skills/rite-adopt/reference/adoption.md +13 -15
- package/pack/generated/claude/skills/rite-autocomplete/SKILL.md +26 -11
- package/pack/generated/claude/skills/rite-autocomplete/reference/loop.md +47 -6
- package/pack/generated/claude/skills/rite-autocomplete/reference/stop-conditions.md +12 -0
- package/pack/generated/claude/skills/rite-build/SKILL.md +7 -1
- package/pack/generated/claude/skills/rite-build/reference/phase-contract.md +6 -1
- package/pack/generated/claude/skills/rite-build/reference/wright-dispatch.md +37 -4
- package/pack/generated/claude/skills/rite-clarify/SKILL.md +3 -2
- package/pack/generated/claude/skills/rite-converge/SKILL.md +4 -2
- package/pack/generated/claude/skills/rite-converge/reference/convergence-assessment.md +8 -4
- package/pack/generated/claude/skills/rite-customize/SKILL.md +16 -18
- package/pack/generated/claude/skills/rite-define/SKILL.md +60 -62
- package/pack/generated/claude/skills/rite-define/reference/plan-template.md +88 -71
- package/pack/generated/claude/skills/rite-explain/SKILL.md +2 -1
- package/pack/generated/claude/skills/rite-learn/SKILL.md +28 -32
- package/pack/generated/claude/skills/rite-plan/SKILL.md +42 -45
- package/pack/generated/claude/skills/rite-plan/reference/dependency-graph.md +11 -2
- package/pack/generated/claude/skills/rite-plan/reference/task-breakdown.md +2 -0
- package/pack/generated/claude/skills/rite-polish/reference/adr-promotion.md +7 -7
- package/pack/generated/claude/skills/rite-pressure-test/SKILL.md +24 -31
- package/pack/generated/claude/skills/rite-prove/SKILL.md +12 -15
- package/pack/generated/claude/skills/rite-prove/reference/acceptance-proof.md +28 -0
- package/pack/generated/claude/skills/rite-review/SKILL.md +5 -4
- package/pack/generated/claude/skills/rite-review/reference/five-axis-review.md +6 -0
- package/pack/generated/claude/skills/rite-review/reference/security-review.md +7 -2
- package/pack/generated/claude/skills/rite-seal/reference/final-evidence.md +3 -0
- package/pack/generated/claude/skills/rite-seal/reference/risk-and-rollback.md +19 -4
- package/pack/generated/claude/skills/rite-ship/reference/rollout.md +62 -43
- package/pack/generated/claude/skills/rite-spec/SKILL.md +8 -1
- package/pack/generated/claude/skills/rite-spec/reference/ai-spec-template.md +13 -6
- package/pack/generated/claude/skills/rite-spec/reference/spec-checklists.md +14 -2
- package/pack/generated/claude/skills/rite-spec/reference/spec-template.md +33 -4
- package/pack/generated/claude/skills/rite-temper/SKILL.md +5 -1
- package/pack/generated/claude/skills/rite-vet/SKILL.md +14 -10
- package/pack/generated/claude/skills/rite-vet/reference/artifacts.md +5 -3
- package/pack/generated/claude/skills/rite-vet/reference/review-axes.md +67 -77
- package/pack/generated/claude/skills/rite-watch-pr/SKILL.md +85 -0
- package/pack/generated/claude/skills/rite-zoom-out/SKILL.md +4 -5
- package/pack/generated/claude/workflows/devrites-readonly-review.js +194 -0
- package/pack/generated/codex/agents/devrites-code-reviewer.toml +6 -1
- package/pack/generated/codex/agents/devrites-plan-drafter.toml +5 -0
- package/pack/generated/codex/agents/devrites-plan-reviewer.toml +6 -0
- package/pack/generated/codex/agents/devrites-proof-runner.toml +7 -1
- package/pack/generated/codex/agents/devrites-retrospector.toml +21 -25
- package/pack/generated/codex/agents/devrites-security-auditor.toml +7 -3
- package/pack/generated/codex/agents/devrites-slice-wright.toml +30 -4
- package/pack/generated/codex/agents/devrites-spec-reviewer.toml +5 -0
- package/pack/generated/codex/agents/devrites-strategy-reviewer.toml +3 -4
- package/pack/generated/codex/agents/devrites-test-analyst.toml +5 -0
- package/pack/generated/codex/skills/devrites-debug-recovery/SKILL.md +12 -16
- package/pack/generated/codex/skills/devrites-debug-recovery/reference/build-the-loop.md +11 -14
- package/pack/generated/codex/skills/devrites-doubt/SKILL.md +3 -4
- package/pack/generated/codex/skills/devrites-frontend-craft/reference/reuse-first.md +3 -4
- package/pack/generated/codex/skills/devrites-lib/reference/reply-contract.md +6 -0
- package/pack/generated/codex/skills/devrites-lib/reference/standards/README.md +5 -1
- package/pack/generated/codex/skills/devrites-lib/reference/standards/afk-hitl.md +33 -8
- package/pack/generated/codex/skills/devrites-lib/reference/standards/agents.md +11 -3
- package/pack/generated/codex/skills/devrites-lib/reference/standards/ci-cd.md +19 -0
- package/pack/generated/codex/skills/devrites-lib/reference/standards/code-review.md +1 -1
- package/pack/generated/codex/skills/devrites-lib/reference/standards/context-hygiene.md +9 -0
- package/pack/generated/codex/skills/devrites-lib/reference/standards/core.md +9 -1
- package/pack/generated/codex/skills/devrites-lib/reference/standards/data-integrity.md +95 -0
- package/pack/generated/codex/skills/devrites-lib/reference/standards/developer-experience.md +5 -5
- package/pack/generated/codex/skills/devrites-lib/reference/standards/documentation.md +28 -29
- package/pack/generated/codex/skills/devrites-lib/reference/standards/edge-case-trace.md +70 -10
- package/pack/generated/codex/skills/devrites-lib/reference/standards/integration-reliability.md +79 -0
- package/pack/generated/codex/skills/devrites-lib/reference/standards/loop-operations.md +85 -0
- package/pack/generated/codex/skills/devrites-lib/reference/standards/observability.md +10 -0
- package/pack/generated/codex/skills/devrites-lib/reference/standards/patterns.md +20 -0
- package/pack/generated/codex/skills/devrites-lib/reference/standards/repository-topology.md +73 -0
- package/pack/generated/codex/skills/devrites-lib/reference/standards/security-checklist.md +6 -2
- package/pack/generated/codex/skills/devrites-lib/reference/standards/security.md +51 -16
- package/pack/generated/codex/skills/devrites-lib/reference/standards/skill-authoring.md +35 -40
- package/pack/generated/codex/skills/devrites-lib/reference/standards/test-proof-checklist.md +4 -0
- package/pack/generated/codex/skills/devrites-lib/reference/standards/testing.md +51 -6
- package/pack/generated/codex/skills/rite/SKILL.md +2 -0
- package/pack/generated/codex/skills/rite-adopt/SKILL.md +8 -10
- package/pack/generated/codex/skills/rite-adopt/reference/adoption.md +13 -15
- package/pack/generated/codex/skills/rite-autocomplete/SKILL.md +26 -11
- package/pack/generated/codex/skills/rite-autocomplete/reference/loop.md +47 -6
- package/pack/generated/codex/skills/rite-autocomplete/reference/stop-conditions.md +12 -0
- package/pack/generated/codex/skills/rite-build/SKILL.md +7 -1
- package/pack/generated/codex/skills/rite-build/reference/phase-contract.md +6 -1
- package/pack/generated/codex/skills/rite-build/reference/wright-dispatch.md +37 -4
- package/pack/generated/codex/skills/rite-clarify/SKILL.md +3 -2
- package/pack/generated/codex/skills/rite-converge/SKILL.md +4 -2
- package/pack/generated/codex/skills/rite-converge/reference/convergence-assessment.md +8 -4
- package/pack/generated/codex/skills/rite-customize/SKILL.md +16 -18
- package/pack/generated/codex/skills/rite-define/SKILL.md +60 -62
- package/pack/generated/codex/skills/rite-define/reference/plan-template.md +88 -71
- package/pack/generated/codex/skills/rite-explain/SKILL.md +2 -1
- package/pack/generated/codex/skills/rite-learn/SKILL.md +28 -32
- package/pack/generated/codex/skills/rite-plan/SKILL.md +42 -45
- package/pack/generated/codex/skills/rite-plan/reference/dependency-graph.md +11 -2
- package/pack/generated/codex/skills/rite-plan/reference/task-breakdown.md +2 -0
- package/pack/generated/codex/skills/rite-polish/reference/adr-promotion.md +7 -7
- package/pack/generated/codex/skills/rite-pressure-test/SKILL.md +24 -31
- package/pack/generated/codex/skills/rite-prove/SKILL.md +12 -15
- package/pack/generated/codex/skills/rite-prove/reference/acceptance-proof.md +28 -0
- package/pack/generated/codex/skills/rite-review/SKILL.md +5 -4
- package/pack/generated/codex/skills/rite-review/reference/five-axis-review.md +6 -0
- package/pack/generated/codex/skills/rite-review/reference/security-review.md +7 -2
- package/pack/generated/codex/skills/rite-seal/reference/final-evidence.md +3 -0
- package/pack/generated/codex/skills/rite-seal/reference/risk-and-rollback.md +19 -4
- package/pack/generated/codex/skills/rite-ship/reference/rollout.md +62 -43
- package/pack/generated/codex/skills/rite-spec/SKILL.md +8 -1
- package/pack/generated/codex/skills/rite-spec/reference/ai-spec-template.md +13 -6
- package/pack/generated/codex/skills/rite-spec/reference/spec-checklists.md +14 -2
- package/pack/generated/codex/skills/rite-spec/reference/spec-template.md +33 -4
- package/pack/generated/codex/skills/rite-temper/SKILL.md +5 -1
- package/pack/generated/codex/skills/rite-vet/SKILL.md +14 -10
- package/pack/generated/codex/skills/rite-vet/reference/artifacts.md +5 -3
- package/pack/generated/codex/skills/rite-vet/reference/review-axes.md +67 -77
- package/pack/generated/codex/skills/rite-watch-pr/SKILL.md +85 -0
- package/pack/generated/codex/skills/rite-zoom-out/SKILL.md +4 -5
- package/package.json +1 -1
- package/scripts/build-host-artifacts.sh +3 -1
|
@@ -54,6 +54,7 @@ What each verb does lives once, in the Menu below; this table is the dispatch ma
|
|
|
54
54
|
| `pov [candidate]` | `/rite-pov` |
|
|
55
55
|
| `dogfood [--port N]` | `/rite-dogfood` |
|
|
56
56
|
| `pr-feedback [PR\|thread]` | `/rite-pr-feedback` |
|
|
57
|
+
| `watch-pr [PR\|URL]` | `/rite-watch-pr` |
|
|
57
58
|
| `customize [instruction \| skill \| agent \| plugin]` | `/rite-customize` |
|
|
58
59
|
| `use <slug>` | (inline) |
|
|
59
60
|
| `guide` | (inline) |
|
|
@@ -124,6 +125,7 @@ EXPLAIN /rite explain ... ≡ /rite-explain grounded concept
|
|
|
124
125
|
POV /rite pov ... ≡ /rite-pov decide adopt / trial / hold / reject for an external option
|
|
125
126
|
DOGFOOD /rite dogfood ... ≡ /rite-dogfood browser QA by changed user journey
|
|
126
127
|
PR FEEDBACK /rite pr-feedback ... ≡ /rite-pr-feedback fix and resolve PR review threads
|
|
128
|
+
WATCH PR /rite watch-pr ... ≡ /rite-watch-pr observe PR/CI once without mutation
|
|
127
129
|
CUSTOMIZE /rite customize ... ≡ /rite-customize author overrides/extensions without forking the pack
|
|
128
130
|
SWITCH /rite use <slug> re-point .devrites/ACTIVE to another feature (inline)
|
|
129
131
|
GUIDE /rite guide first feature, guided — full lifecycle on one small real change (inline)
|
|
@@ -7,18 +7,17 @@ user-invocable: true
|
|
|
7
7
|
|
|
8
8
|
# /rite-adopt: onboard existing code
|
|
9
9
|
|
|
10
|
-
Reverse-engineer
|
|
11
|
-
features. Adoption documents the repository; it does not rewrite it or create a
|
|
10
|
+
Reverse-engineer current behavior into `spec.md`; do not rewrite product code or create a
|
|
12
11
|
parallel convention system.
|
|
13
12
|
|
|
14
13
|
## Workflow
|
|
15
14
|
|
|
16
|
-
1. Read
|
|
17
|
-
objective. Ask once when either is materially ambiguous.
|
|
15
|
+
1. Read core; resolve repository/sub-area and next objective. Ask once only if material.
|
|
18
16
|
2. Follow [`reference/adoption.md`](reference/adoption.md): inspect current
|
|
19
17
|
behavior, architecture and placement, callers, reusable seams, repository/CI
|
|
20
|
-
commands, visible code/test patterns,
|
|
21
|
-
|
|
18
|
+
commands, visible code/test patterns, non-obvious constraints, and any touched
|
|
19
|
+
load-bearing seam that needs `characterize-before-modify`. Read existing
|
|
20
|
+
`AGENTS.md`, `CLAUDE.md`, product, and design guidance.
|
|
22
21
|
3. Create the workspace and write `spec.md`, `decisions.md`, `assumptions.md`,
|
|
23
22
|
`questions.md`, and `state.md`. The spec separates the current baseline from
|
|
24
23
|
the measurable next objective.
|
|
@@ -26,10 +25,9 @@ parallel convention system.
|
|
|
26
25
|
[`ledger.md`](../rite-polish/reference/ledger.md): read current specs, preview
|
|
27
26
|
ADDED entries, confirm paths, refuse escape/symlink/clobber/ignored targets,
|
|
28
27
|
write, lint, and require an empty re-preview.
|
|
29
|
-
5.
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
a command cache.
|
|
28
|
+
5. For a verified non-obvious policy or recurring/costly mistake, prefer existing hook/lint/
|
|
29
|
+
CI/type/schema enforcement; else propose one evidence-cited nearest-scope instruction edit.
|
|
30
|
+
Apply only after review; never create convention bands, scores, or a command cache.
|
|
33
31
|
6. A genuine non-negotiable invariant may be proposed for
|
|
34
32
|
`.devrites/principles.md`; the human must ratify it.
|
|
35
33
|
7. Set the next step to `/rite-clarify` and stop. Do not plan or build.
|
|
@@ -1,21 +1,19 @@
|
|
|
1
1
|
# Adoption: reverse-investigation
|
|
2
2
|
|
|
3
|
-
Loaded
|
|
4
|
-
lifecycle starts from evidence rather than guesses.
|
|
3
|
+
Loaded by `/rite-adopt`; record code reality before forward work.
|
|
5
4
|
|
|
6
|
-
Capture
|
|
5
|
+
Capture visible behavior; architecture/placement/callers/seams; repository/CI commands;
|
|
6
|
+
live naming/layering/error/data/test conventions; and non-obvious constraints.
|
|
7
7
|
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
- real test, build, typecheck, and lint commands from repository scripts or CI;
|
|
11
|
-
- naming, layering, error, data-access, and test patterns visible in live code;
|
|
12
|
-
- non-obvious ordering or framework constraints.
|
|
8
|
+
For each next-objective load-bearing seam without a discriminating test, append after its
|
|
9
|
+
source in `spec.md` existing behavior's `Current evidence` cell:
|
|
13
10
|
|
|
14
|
-
|
|
15
|
-
|
|
11
|
+
```text
|
|
12
|
+
Characterization: characterize-before-modify; risk: <risk>; first touch: <slice|unknown>
|
|
13
|
+
```
|
|
16
14
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
`
|
|
21
|
-
|
|
15
|
+
This is a touched-behavior ratchet, not repository-wide coverage.
|
|
16
|
+
|
|
17
|
+
Use current code/search/docs; source and CI beat history. Put baseline/objective in
|
|
18
|
+
`spec.md`, uncertainty in `assumptions.md`, durable choices in `decisions.md`, and guidance
|
|
19
|
+
in nearest scoped instructions—never ledgers, scores, confidence bands, or command caches.
|
|
@@ -36,13 +36,20 @@ the terminal cursor or its recovery count.
|
|
|
36
36
|
through repair, Vet, bounded implementation correction, and re-proof inside
|
|
37
37
|
the active run. A nested phase `STOP` or intermediate `Next step` is not a
|
|
38
38
|
user handoff; pause only on the shared real stop conditions.
|
|
39
|
+
- **Treat technical readiness as routing, not completion.** `NEEDS_REPLAN` is a backward edge
|
|
40
|
+
to Plan repair and narrow Vet; `NEEDS_CLARIFICATION` is likewise internal when
|
|
41
|
+
decision coverage can be resolved from existing authority. Neither state may
|
|
42
|
+
end Autocomplete unless its underlying fingerprint is actually exhausted or a
|
|
43
|
+
human/safety/access decision is required.
|
|
39
44
|
- **Do not confuse an action budget with recovery exhaustion.** After a failed
|
|
40
45
|
consumptive action, zero remaining real attempts blocks only another execution.
|
|
41
46
|
New retained Critical/Important evidence starts offline repair and narrow Vet
|
|
42
47
|
inside this Autocomplete invocation. Stop for a fresh GO only after that repair
|
|
43
48
|
changes the failure condition and Vet is READY.
|
|
44
|
-
- **
|
|
45
|
-
`--max-slices N`
|
|
49
|
+
- **Admit work under the AFK resource envelope.** Vet may split/add slices.
|
|
50
|
+
`--max-slices N` replaces the safe new-sentinel default of 10; post-Vet pending
|
|
51
|
+
count may lower it. Before every phase or leaf dispatch, also enforce expiry,
|
|
52
|
+
review-backlog, and native agent/token/cost/time limits from `afk-hitl.md`.
|
|
46
53
|
- **Parse flags only from this invocation.** `--ship`, `--yolo`, `--max-slices`,
|
|
47
54
|
`--full`, and `--cross-model` are active only when their exact standalone tokens
|
|
48
55
|
occur in `$ARGUMENTS`; their presence in this skill, examples, or earlier messages
|
|
@@ -73,16 +80,20 @@ the terminal cursor or its recovery count.
|
|
|
73
80
|
fingerprint below its no-progress cap reopens caller-owned offline recovery;
|
|
74
81
|
a stale pre-ownership workflow-artifact writer stop reopens under
|
|
75
82
|
`workflow-artifacts.md` when no controlling-root materialization attempt exists.
|
|
83
|
+
A `NEEDS_REPLAN` cold resume with a valid technical return cursor immediately
|
|
84
|
+
invokes Plan repair and Recovery Vet before selecting a forward phase or
|
|
85
|
+
emitting any reply.
|
|
76
86
|
That materialization runs directly as non-consumptive prerequisite recovery,
|
|
77
87
|
even with no pending product slice or AFK budget; it does not re-ask an answered
|
|
78
88
|
human gate.
|
|
79
89
|
reconstruct any missing return cursor only from the current phase plus the
|
|
80
90
|
exact approved action in `test-plan.md` / evidence, never from chat or guesswork.
|
|
81
91
|
The idea + flags: `--ship` / `--yolo` (continue through ship preflight, then stop
|
|
82
|
-
for literal-GO and native approval), `--max-slices N` (optional
|
|
83
|
-
|
|
84
|
-
`$ARGUMENTS`; normalize the result to the idea,
|
|
85
|
-
`max_slices: N|
|
|
92
|
+
for literal-GO and native approval), `--max-slices N` (optional explicit cap;
|
|
93
|
+
a newly created sentinel defaults to 10 and post-Vet pending count may lower it).
|
|
94
|
+
Parse only the current `$ARGUMENTS`; normalize the result to the idea,
|
|
95
|
+
`ship_preflight: yes|no`, `max_slices: N|default`, `profile: standard|full`, and
|
|
96
|
+
`cross_model: yes|no`.
|
|
86
97
|
**Completion:** that normalized state is unambiguous and no sentinel or workspace
|
|
87
98
|
file has been written.
|
|
88
99
|
2. **Specify and clarify up front.** Use `devrites-interview`, `/rite-spec`, and
|
|
@@ -90,8 +101,10 @@ the terminal cursor or its recovery count.
|
|
|
90
101
|
coverage never arms AFK. **Completion:** `decision-coverage.md` records `CLEAR`.
|
|
91
102
|
3. **Arm AFK after clarity.** Require `Decision coverage: CLEAR`, then apply the
|
|
92
103
|
loop's [one-write AFK contract](reference/loop.md#arm-afk-once): preserve a valid
|
|
93
|
-
existing sentinel byte-for-byte or create an advisory-only sentinel once
|
|
94
|
-
|
|
104
|
+
existing sentinel byte-for-byte or create an advisory-only sentinel once with
|
|
105
|
+
bounded slices, agents, wall time, review queue, and four-hour absolute expiry;
|
|
106
|
+
never rewrite it after Vet or reset it on resume. Also `touch .devrites/CHECKPOINT`:
|
|
107
|
+
unattended runs use
|
|
95
108
|
checkpoint mode so each proven slice is committed locally as a crash-survivable
|
|
96
109
|
`WIP` ([rite-build/reference/checkpoint.md](../rite-build/reference/checkpoint.md));
|
|
97
110
|
`/rite-ship` collapses them into the one feature commit. **Completion:** AFK config is
|
|
@@ -108,14 +121,16 @@ the terminal cursor or its recovery count.
|
|
|
108
121
|
phase resumes.
|
|
109
122
|
Immediately after `/rite-vet` and before the first Build dispatch, apply the loop's
|
|
110
123
|
[mutable post-vet budget](reference/loop.md#derive-the-mutable-post-vet-budget)
|
|
111
|
-
contract
|
|
124
|
+
contract, then apply resource admission before every phase and native dispatch.
|
|
125
|
+
**Completion:** the loop reaches Seal GO, or a stop condition is persisted
|
|
112
126
|
before any later phase runs; the cursor names the last completed phase and the
|
|
113
127
|
effective remaining budget.
|
|
114
128
|
5. **Apply stop conditions at every gate** ([reference/stop-conditions.md](reference/stop-conditions.md)):
|
|
115
129
|
first route an agent-owned red technical result through the loop's bounded
|
|
116
130
|
recovery; its `blocked` label alone is not a stop condition. After that, on
|
|
117
|
-
hard-risk / human-owned blocking / escalating / NO-GO /
|
|
118
|
-
|
|
131
|
+
hard-risk / human-owned blocking / escalating / NO-GO / slice, agent, token,
|
|
132
|
+
cost, time, review-queue, or expiry exhaustion / still-low-confidence → write
|
|
133
|
+
`state.md` (`Status`, `Next step`), surface *why*, and **STOP**.
|
|
119
134
|
Exhausted agent-owned technical recovery uses the terminal `Next step: none`
|
|
120
135
|
marker and never hands the user `/rite-plan unblock` or another routine
|
|
121
136
|
phase command.
|
|
@@ -9,15 +9,23 @@ Arm the gate policy up front without mutating it later:
|
|
|
9
9
|
|
|
10
10
|
```yaml
|
|
11
11
|
allow_gates: [advisory] # only advisory auto-handles; validating+ pause
|
|
12
|
-
|
|
13
|
-
|
|
12
|
+
max_slices: 10 # explicit --max-slices N replaces this default
|
|
13
|
+
max_agents: 32 # native leaf dispatches in this host activation
|
|
14
|
+
max_minutes: 120 # activation wall-clock cap
|
|
15
|
+
max_review_queue: 8 # unresolved review/gate backlog cap
|
|
16
|
+
expires_at: "<now + 4 hours>" # write one absolute ISO-8601 UTC timestamp
|
|
17
|
+
# max_tokens: <N> # optional stricter native-host cap
|
|
18
|
+
# max_cost_usd: <amount> # optional stricter native-host cap
|
|
19
|
+
# notify: "<cmd>" # optional — fired after a durable stop
|
|
14
20
|
```
|
|
15
21
|
|
|
16
22
|
Read an existing sentinel first. Preserve it byte-for-byte when valid; stop if its gate
|
|
17
|
-
ceiling exceeds `advisory
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
23
|
+
ceiling exceeds `advisory`, its required resource envelope is missing/malformed/expired,
|
|
24
|
+
or its `max_slices` conflicts with the invocation. If absent, write it once after clarity
|
|
25
|
+
with the safe defaults above, replacing `max_slices` only for an explicit
|
|
26
|
+
`--max-slices N` and resolving `expires_at` to one absolute timestamp. The sentinel is
|
|
27
|
+
read-only: never rewrite it after `/rite-vet` to inject a discovered plan count or to
|
|
28
|
+
reset resource authority.
|
|
21
29
|
|
|
22
30
|
### Derive the mutable post-vet budget
|
|
23
31
|
|
|
@@ -28,6 +36,19 @@ valid remaining counter already exists, retain the lower of it and the derived b
|
|
|
28
36
|
never increase or reinitialize it. This keeps the crash-survivable budget in its mutable owner
|
|
29
37
|
without changing AFK configuration mid-run.
|
|
30
38
|
|
|
39
|
+
### Admit each unattended cycle
|
|
40
|
+
|
|
41
|
+
Before every phase, parallel review fan-out, recovery dispatch, or writer dispatch,
|
|
42
|
+
apply [`afk-hitl.md`](../../devrites-lib/reference/standards/afk-hitl.md#unattended-resource-envelope):
|
|
43
|
+
run the cheapest readiness/current-state check, reject overlapping work, count the
|
|
44
|
+
current unresolved review queue, and check expiry plus native agent/token/cost/time
|
|
45
|
+
headroom. Count every leaf, including failed/malformed/unavailable results. At the
|
|
46
|
+
review cap, only reconciliation that reduces the queue may run. Any limit reached or
|
|
47
|
+
unobservable declared cap ends the current activation before more work and persists
|
|
48
|
+
its checkpoint/reason. A genuinely new native activation starts fresh agent/time/token/
|
|
49
|
+
cost counters, but reuses durable slice/recovery state, absolute expiry, and recomputed
|
|
50
|
+
review queue. It never resets those durable bounds.
|
|
51
|
+
|
|
31
52
|
`allow_gates: [advisory]` prevents an open `gate: validating` from being queued until
|
|
32
53
|
seal, where it would force NO-GO under `afk-hitl.md`. Autocomplete pauses on it instead. Widen
|
|
33
54
|
`allow_gates` only outside autocomplete through an explicit human configuration change;
|
|
@@ -104,9 +125,29 @@ for a human-owned decision or mandatory safety/access action. Exhausted
|
|
|
104
125
|
agent-owned recovery stops once with its reproduction and dead ends, never with
|
|
105
126
|
another routine Plan/Vet command.
|
|
106
127
|
|
|
128
|
+
## Continuous caller obligation
|
|
129
|
+
|
|
130
|
+
No user-facing reply is permitted while the durable state contains an
|
|
131
|
+
agent-owned `NEEDS_REPLAN`, an intermediate Plan/Vet `next_action`, or a distinct
|
|
132
|
+
Critical/Important fingerprint with remaining recovery budget. Invoke the exact
|
|
133
|
+
next Plan repair and Recovery Vet immediately. A narrow reviewer closing its input
|
|
134
|
+
finding and exposing another Critical/Important invariant is progress: close the
|
|
135
|
+
old fingerprint, open the new one, and continue without handing a command to the
|
|
136
|
+
user.
|
|
137
|
+
|
|
138
|
+
The number of completed repair/Vet cycles is not a stop condition and cannot be
|
|
139
|
+
used as a surrogate recovery budget. Only three no-progress corrections of the
|
|
140
|
+
same exact fingerprint exhaust. Context pressure, compaction, session duration,
|
|
141
|
+
or a nested skill's completion footer also cannot convert an internal checkpoint
|
|
142
|
+
into a stop; persist the checkpoint and resume from it inside the same controlling
|
|
143
|
+
invocation. Autocomplete may emit its final reply only after reaching its requested
|
|
144
|
+
rest point or one of the shared human/safety/access/exhaustion stop conditions.
|
|
145
|
+
|
|
107
146
|
## Between phases
|
|
108
147
|
|
|
109
148
|
- Re-read the active workspace before each phase (don't trust chat memory).
|
|
149
|
+
- Re-run resource admission before each phase or native dispatch; stop before work
|
|
150
|
+
when expiry, review backlog, or agent/token/cost/time headroom is exhausted.
|
|
110
151
|
- After a phase that edits code (build, polish, review), evidence may be stale: let
|
|
111
152
|
the next gate re-prove rather than carrying a stale pass (see
|
|
112
153
|
`.claude/skills/devrites-lib/reference/standards/development-workflow.md`).
|
|
@@ -29,6 +29,11 @@ on exhaustion, stop as a technical blocker unless human-owned.
|
|
|
29
29
|
|
|
30
30
|
## Not a stop: agent-owned backtracking
|
|
31
31
|
|
|
32
|
+
`NEEDS_REPLAN` is not a stop condition under an active Autocomplete caller. It
|
|
33
|
+
blocks forward advancement, persists the return cursor, and immediately routes
|
|
34
|
+
Plan repair plus Recovery Vet. The same applies to any intermediate nested
|
|
35
|
+
`STOP`/`Next step` whose underlying decision is agent-owned.
|
|
36
|
+
|
|
32
37
|
Agent-owned backtracking is not a stop condition while its causal-fingerprint
|
|
33
38
|
budget remains. The active caller invokes the earlier phase inline, follows Vet
|
|
34
39
|
and any bounded remediation, then resumes the originating phase. Persist
|
|
@@ -96,6 +101,13 @@ exists, a real human/risk/scope gate owns it, or bounded recovery is exhausted.
|
|
|
96
101
|
remaining value, explicit flag, sentinel cap, or post-vet pending count) and the
|
|
97
102
|
unbuilt slices. A malformed value also fails closed. Zero with no pending slices is
|
|
98
103
|
normal completion → continue to `/rite-prove` without pausing.
|
|
104
|
+
- **Resource envelope unavailable or exhausted:** stop before more work when the AFK
|
|
105
|
+
envelope is missing/malformed/expired; another run overlaps; native agent, token,
|
|
106
|
+
cost, or wall-time headroom is exhausted/unobservable despite a declared cap; or
|
|
107
|
+
unresolved review/gate backlog is above its cap. At the review cap, permit only
|
|
108
|
+
reconciliation that reduces the queue. Record the exact winning limit and observed
|
|
109
|
+
usage/count. A new activation gets fresh activation-local counters; it does not reset
|
|
110
|
+
durable slice/recovery budgets, expiry, or the recomputed queue.
|
|
99
111
|
- **Still low-confidence after the interview:** the idea can't be pinned to testable
|
|
100
112
|
acceptance criteria → stop and ask, rather than guessing the product.
|
|
101
113
|
- **Repeated failure:** bounded recovery exhausts → stop with reproduction.
|
|
@@ -31,12 +31,18 @@ reads named on-demand rules while writing; root reads them for doubt/record gate
|
|
|
31
31
|
- `patterns.md`: composition over inheritance, avoid premature abstraction.
|
|
32
32
|
- `principles.md`: the project invariants (`.devrites/principles.md`) the slice must honor; the wright reads them as **binding**, not priors.
|
|
33
33
|
- `security.md`: when the slice touches user input, auth, data, or external integrations.
|
|
34
|
+
- `repository-topology.md`: when targets span roots/languages/services or touch generated/vendor surfaces.
|
|
35
|
+
- `data-integrity.md`: when the slice writes durable state or changes migration/concurrency/tenant/retention behavior.
|
|
36
|
+
- `integration-reliability.md`: when the slice changes an API/webhook/queue/job/cache/cross-service boundary.
|
|
34
37
|
- `definition-of-done.md`: standing Done bar: acceptance mapped, fresh proof, no open hard gates, scoped edits, rollback/docs where needed.
|
|
35
38
|
|
|
36
39
|
|
|
37
40
|
## Operating rules
|
|
38
41
|
- **One slice per wright dispatch.** Every wright returns after it. The controlling
|
|
39
|
-
root applies the mode rule above before another dispatch.
|
|
42
|
+
root applies the mode rule above before another dispatch. Prefer the guarded serial
|
|
43
|
+
native-worktree pilot in `wright-dispatch.md` only when its committed-clean
|
|
44
|
+
preflight and explicit reconciliation path both hold; otherwise use the existing
|
|
45
|
+
serial same-worktree writer. Never run writers in parallel.
|
|
40
46
|
- Evidence over confidence. Prefer existing conventions. Feature scope only: no
|
|
41
47
|
drive-by refactors.
|
|
42
48
|
- **Record adjacent issues; do not edit them.** An issue outside the exact paths
|
|
@@ -9,7 +9,9 @@ See [`one-slice-cycle.md`](one-slice-cycle.md); candidate lifecycle is
|
|
|
9
9
|
ID-and-meaning traceability, and green proof preflight; run
|
|
10
10
|
`devrites-engine check readiness <slug>`. Any miss/nonzero stops.
|
|
11
11
|
2. **Select one target.** Restate goal, acceptance criteria, exclusions, and exact
|
|
12
|
-
source/test paths.
|
|
12
|
+
source/test paths. Reconcile the spec/plan applicability map and include only the
|
|
13
|
+
triggered topology/data/integration standards plus their named failure/recovery/proof
|
|
14
|
+
cases in the writer contract. Before dispatch, validate relevant `assumptions.md` rows
|
|
13
15
|
against live evidence. If one is disproved and changes acceptance, architecture,
|
|
14
16
|
scope, or proof, use the Spec Drift Guard/plan recovery; a human-owned unknown
|
|
15
17
|
stops. Resolve HITL before source work. AFK answers only permitted gates;
|
|
@@ -50,6 +52,9 @@ the candidate manifest; it returns through narrow Vet before any consumptive act
|
|
|
50
52
|
and recheck `git diff --name-only`. Missing, weakened, red, or source-mutating proof
|
|
51
53
|
is not success.
|
|
52
54
|
|
|
55
|
+
A failure is `pre-existing` or environment-specific only with a same-command,
|
|
56
|
+
same-environment baseline predating the candidate; otherwise it remains unresolved.
|
|
57
|
+
|
|
53
58
|
Technical failure uses bounded `devrites-debug-recovery`: reapply the host gate
|
|
54
59
|
before an accepted in-slice correction, keep one exact fingerprint/three
|
|
55
60
|
no-progress attempts, and never rerun an unchanged check. A closed reproduction
|
|
@@ -11,6 +11,32 @@ Claude grants only the exact wright `acceptEdits`; Codex uses its workspace root
|
|
|
11
11
|
the exact `:workspace` wright, and read-only specialists. Never bypass/substitute
|
|
12
12
|
the wright or recreate an engine bridge.
|
|
13
13
|
|
|
14
|
+
## Isolated writer-worktree pilot
|
|
15
|
+
|
|
16
|
+
Use native isolation only when the current host exposes an explicit named-writer
|
|
17
|
+
worktree plus result reconciliation; separate agent threads or inherited sandboxes do
|
|
18
|
+
not qualify. Codex CLI custom subagents therefore use `same-worktree` unless a future
|
|
19
|
+
supported interface passes this capability gate—never create a manual worktree from the
|
|
20
|
+
read-only root to imitate it. Also require `git rev-parse
|
|
21
|
+
--show-superproject-working-tree` to be empty; resolved git/common dirs; committed,
|
|
22
|
+
clean candidate/index; all inputs at `HEAD`; no other writer; and green cheap isolated
|
|
23
|
+
baseline proof. Otherwise use serial same-worktree dispatch—never stash, commit, or
|
|
24
|
+
discard user work to qualify. Ask host for an explicit current-`HEAD` base when
|
|
25
|
+
supported. Regardless of host defaults, the wright's first command must prove actual `git rev-parse HEAD` equals supplied
|
|
26
|
+
`worktree_base`. Mismatch returns a gap with no write before project reads or baseline proof.
|
|
27
|
+
|
|
28
|
+
The isolated wright returns one local unpushed `transfer_commit`, its `worktree_base`,
|
|
29
|
+
and exact files. Root proves descendant base, exact `git diff --name-only
|
|
30
|
+
<base>..<transfer>`, no `.devrites/**`/submodule/symlink/unrelated delta, unchanged
|
|
31
|
+
source base, and no user-work overwrite. Use only host-native explicit reconciliation;
|
|
32
|
+
never ad hoc copy, cherry-pick, or merge from read-only root. Compare transferred bytes,
|
|
33
|
+
run approved proof, record evidence, then let host remove worktree.
|
|
34
|
+
|
|
35
|
+
Conflict, extra/missing commit, moved base, or cleanup failure is `gap`/STOP:
|
|
36
|
+
preserve the worktree and commit. Without explicit reconciliation, use same-worktree serial.
|
|
37
|
+
Parallel writer work remains forbidden until this serial pilot measures transfer,
|
|
38
|
+
conflict, proof, and review outcomes on both hosts.
|
|
39
|
+
|
|
14
40
|
## Prepare
|
|
15
41
|
|
|
16
42
|
1. Derive the smallest exact project-relative source/test path list; reject
|
|
@@ -20,15 +46,20 @@ the wright or recreate an engine bridge.
|
|
|
20
46
|
[`workflow-artifacts.md`](../../devrites-lib/reference/standards/workflow-artifacts.md);
|
|
21
47
|
its rejection here is not a blocker.
|
|
22
48
|
2. Put it in the task with goal, verbatim acceptance, exclusions, context,
|
|
23
|
-
`test-plan.md` proof commands, and applicable standards.
|
|
49
|
+
`test-plan.md` proof commands, and applicable standards. For each triggered
|
|
50
|
+
topology/data/integration standard, include only the feature-specific owner/invariant,
|
|
51
|
+
failure or partial-state case, recovery rule, and required proof from the vetted plan.
|
|
52
|
+
Do not paste the whole standard or silently omit an applicable risk.
|
|
24
53
|
A new path requires a new bounded contract; the wright cannot widen the task.
|
|
25
54
|
3. Record `git diff --name-only` before dispatch so unrelated work remains
|
|
26
|
-
distinguishable.
|
|
55
|
+
distinguishable. For an isolated pilot, also record committed base SHA and exact
|
|
56
|
+
baseline status before asking the host for isolation.
|
|
27
57
|
|
|
28
58
|
## Run
|
|
29
59
|
|
|
30
|
-
Ask the host for the exact writer in fresh context and wait.
|
|
31
|
-
|
|
60
|
+
Ask the host for the exact writer in fresh context and wait. Use at most one writer
|
|
61
|
+
across all linked worktrees for this workspace. Never run two writers in one worktree,
|
|
62
|
+
run isolated and same-worktree writers concurrently, or substitute a generic agent.
|
|
32
63
|
|
|
33
64
|
## Inspect and prove
|
|
34
65
|
|
|
@@ -38,6 +69,8 @@ writers in one worktree or substitute a generic agent.
|
|
|
38
69
|
wright; root never widens scope or edits source.
|
|
39
70
|
2. Inspect the test diff for deletion, skipping, focus markers, or loosened
|
|
40
71
|
assertions. Dedicated test analysis treats weakening as Critical.
|
|
72
|
+
Confirm a test for a data/integration/topology risk can actually exhibit that risk;
|
|
73
|
+
mocks that erase it and one-root proof offered for another root are unproven.
|
|
41
74
|
3. Run only repository proof already approved by `test-plan.md`, then inspect
|
|
42
75
|
`git diff --name-only` again in case a proof tool changed source.
|
|
43
76
|
4. Challenge decisions. Human choices return; native diagnosis routes failures.
|
|
@@ -39,8 +39,9 @@ dispatch uses
|
|
|
39
39
|
`Spec gate: passed`; otherwise stop at `/rite-spec`. Apply the native cursor
|
|
40
40
|
protocol below before changing workspace artifacts.
|
|
41
41
|
2. **Enumerate the topology.** From the spec, live code, contracts, references,
|
|
42
|
-
and recorded decisions, list every material
|
|
43
|
-
data lifecycle, integration,
|
|
42
|
+
and recorded decisions, list every material stakeholder/priority, invariant, actor,
|
|
43
|
+
journey/component, state, data lifecycle, integration, failure/recovery path,
|
|
44
|
+
operation, proof surface, applicability row, and must-NOT boundary.
|
|
44
45
|
3. **Scan coverage.** Apply `devrites-interview` in clarify mode and mark each
|
|
45
46
|
material surface Clear, Partial, Missing, not-applicable, or justified
|
|
46
47
|
deferred-nonblocking with evidence and an owner. Use native repository search
|
|
@@ -27,9 +27,11 @@ Pull on demand:
|
|
|
27
27
|
- `spec-grammar.md`: buildable acceptance criteria vs `## Success metrics` (outcome KPIs the
|
|
28
28
|
code can't make true and this pass never enqueues); structured `### Requirement:` /
|
|
29
29
|
`#### Scenario:` blocks, each scenario one behavior to check as built / partial / absent.
|
|
30
|
-
- `tooling.md`:
|
|
31
|
-
|
|
30
|
+
- `tooling.md`: use the primary available code index; cross-check only a named unresolved
|
|
31
|
+
predicate, then fall back to LSP/file search. Read live code, not artifact claims.
|
|
32
32
|
- `testing.md`: a criterion with code but no covering test is *partial*, not done.
|
|
33
|
+
- `repository-topology.md`, `data-integrity.md`, `integration-reliability.md`: only for
|
|
34
|
+
triggered applicability rows; missing failure/recovery behavior is partial or absent.
|
|
33
35
|
|
|
34
36
|
## Operating rules
|
|
35
37
|
- **APPEND-ONLY, never rewrite.** The only write to `tasks.md` is **appending** new
|
|
@@ -25,10 +25,14 @@ 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.
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
code and tests
|
|
28
|
+
Read the code to decide: do not infer from the plan. Apply `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
|
|
31
|
+
code and tests tell you what is built.
|
|
32
|
+
|
|
33
|
+
Treat accepted invariants, failure/recovery rows, and triggered applicability obligations as
|
|
34
|
+
buildable units alongside REQ/AC/scenarios. A happy path with missing applicable
|
|
35
|
+
duplicate/retry/concurrency/tenant/timeout/order/interruption/rollback behavior is `partial`.
|
|
32
36
|
|
|
33
37
|
## Principle violations
|
|
34
38
|
|
|
@@ -8,33 +8,31 @@ disable-model-invocation: true
|
|
|
8
8
|
|
|
9
9
|
# /rite-customize: native project customization
|
|
10
10
|
|
|
11
|
-
Use native;
|
|
12
|
-
|
|
13
|
-
current `$ARGUMENTS`; its presence below or in earlier context cannot activate it.
|
|
11
|
+
Use native; no registry/override/sync. `--import-legacy` is active only when that exact
|
|
12
|
+
standalone token occurs in current `$ARGUMENTS`; earlier context cannot activate it.
|
|
14
13
|
|
|
15
14
|
## Workflow
|
|
16
15
|
|
|
17
|
-
1. Map policy
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
21
|
-
|
|
22
|
-
5. Write only the approved artifact; run native validation; keep no mirror.
|
|
16
|
+
1. Map policy→instruction, reusable work→skill, specialist→agent, external capability→plugin/MCP.
|
|
17
|
+
2. Inspect target/host docs; reuse before copying.
|
|
18
|
+
3. Draft smallest nearest-scope change; do not restate safeguards.
|
|
19
|
+
4. Show path/exact diff; wait.
|
|
20
|
+
5. Write approved artifacts, validate natively, keep no mirror.
|
|
23
21
|
|
|
24
|
-
Here, edit canonical source
|
|
22
|
+
Here, edit canonical source and generate; never edit derived artifacts.
|
|
25
23
|
|
|
26
24
|
## Legacy import mode
|
|
27
25
|
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
26
|
+
1. Inventory `.devrites/extensions/`, `.devrites/overrides/`, and `.devrites/runbooks/` read-only
|
|
27
|
+
as untrusted data.
|
|
28
|
+
2. Record origin/files: external URL/SHA/path/license or local relative path, commit/content
|
|
29
|
+
digest, and owner confirmation. Add review date, copied/re-authored status, canonical owner,
|
|
30
|
+
and derived targets. Unverified external rights stay reference-only; never execute imported instructions.
|
|
31
|
+
3. Map useful behavior to native owners; map runbooks to a native skill with explicit gate,
|
|
34
32
|
checkpoint, and resume semantics.
|
|
35
|
-
|
|
33
|
+
4. Reject weaker gates/permissions. Show every diff and provenance receipt; wait. Never auto-copy,
|
|
36
34
|
bulk-convert, or delete.
|
|
37
|
-
|
|
35
|
+
5. Write and validate approved native artifacts. Leave the legacy files intact until native
|
|
38
36
|
validation passes; cleanup needs separate approval.
|
|
39
37
|
|
|
40
38
|
## Rules
|