process: the review audits the change, delegated passes return facts, and the packet is bounded - #20
Merged
Conversation
… and the packet is bounded Canonical rules distilled from six delivery retrospectives on a store-backed workspace, where every session that went wrong went wrong the same way: the review attacked the packet instead of the change, a delegated pass reasoned past a refusal, or a session reached past its sanctioned tool. PROCESS.md - Planning: a single-requirement packet is at most one page; more reconnaissance means the scope is wrong. - Cold review: audits the change, not the document; packet-wording findings are notes; traceability is material only when a builder or gate would act on the wrong citation; independence is the recorded context, not a claim; carried closures are claims; a finding that changes a human decision goes to the human. Convergence bound: two rounds, then cut the packet, never a third. - Entry: the defect lane (USER:2026-09-12) - a diagnosed, bounded defect may have its failing test written on a branch before entry as a RUN: source; the SR's lower RED is still re-established after entry. - Development loop: delegated passes return findings and verdicts and write nothing; a refusal is a decision - the pass stops and returns it verbatim. - Completion: the delivered revision is the integrated one; a STALE member-scoped trace still counts against its Epic. - State records: the project's sanctioned tool - a missing surface is a gap to surface, never a variance; read-only workaround with a filed gap is fine, a hand-written store change is a stop; notes never carry a workaround past the surface landing (USER:2026-09-12, tool-neutral wording). Skills - rdd-cold-review: the independent context and delegated-pass rule, closures as claims, materiality by effect, the round bound, report shape. - rdd-entry-review, rdd-completion-review: trace before gate so the gate names it; answer then apply, members before epic; delivered revision. - rdd-plan: scope from the relation graph; inventory by the invariant and judge breaks per call site; read before claiming; a RED case must fail today; the defect lane. - rdd-start: suspended selections are a preflight fact; read the projection before any readiness claim; timebox tooling diagnosis then surface; never mutate a shared store to test a hypothesis; a direction given twice is a decision. - rdd-build: the commit gate binds GREEN, cleanup and reconciliation; a RED waypoint may fail the suite the gate runs; record RED evidence at the RED commit. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019qTRmYNwxhofJUNhxW45oc
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Why
Six delivery retrospectives on a store-backed workspace (the ModernPath monorepository, plan
process/2026-09-11-agent-tooling-self-sufficiency-plan.mdthere, items E1–E9 and H1) found the same three failure shapes:Two decisions were taken by the process owner on 2026-09-12 and are applied here: the defect lane (a diagnosed, bounded defect may have its failing test written on a branch before entry, cited as a
RUN:source) and the sanctioned-tool principle in canonical, tool-neutral wording (the project'sAGENTS.mdnames the tool; the process owns the rule).What
PROCESS.mdtraceabilityis material only when a builder or a gate would act on the wrong citation; the independent context is the recorded context, not a claim in the text; carried closures are claims; a finding that changes a human decision goes back to the human. Convergence bound: at most two rounds; a second round about the packet cuts the packet; a third round does not start.TODO"; the SR's own lower RED is still re-established after entry.STALEmember-scoped trace from an earlier round still counts against its Epic.AGENTS.md— project instructions name the sanctioned tool and the gap channel; the rule lives inPROCESS.md.Skills —
rdd-cold-review(context, closures, materiality by effect, round bound, report shape),rdd-entry-reviewandrdd-completion-review(trace before gate so the gate names it; answer then apply, members before epic; the delivered revision),rdd-plan(scope from the relation graph; inventory by the invariant, breaks judged per call site; read before claiming; a RED case must fail today; the defect lane),rdd-start(suspended selections are a preflight fact; read the projection before a readiness claim; timebox tooling diagnosis then surface; never mutate a shared store to test a hypothesis; a direction given twice is a decision),rdd-build(the commit gate binds GREEN, cleanup and reconciliation; a RED waypoint may fail the suite the gate runs; record RED evidence at the RED commit).Wording stays tool-neutral throughout: no CLI verb is named.
Relation to open PRs
FIRST/RE_REVIEWmodes and continuation gate can subsume it. The cold-review procedure steps were renumbered here (6–9), so Bound cold-review remediation loops #13 needs a rebase.Validation
git diff --checknode skills/rdd-audit/audit-citations.mjs PROCESS.md file-state README.md— 0/0 citations, no elided pathsfile-state/for competing authority statements on tests-before-TODO, review rounds, and review independence: none outside the edited passagesAfter merge, consuming workspaces pick this up through the CLI's sync-and-repin procedure (
tools/modernpath/scripts/sync-rdd-assets.sh), never by editing installed copies.🤖 Generated with Claude Code
https://claude.ai/code/session_019qTRmYNwxhofJUNhxW45oc