docs(doctrine): end-of-run lines name the diff stat and the gate path; release hold is a recommendation

This commit is contained in:
bchanot committed 2026-11-17 18:44:18 +01:00
1 parent 25660542d3
commit 6022b9dfb9
7 files changed
+23 -15

No files matched your search

+3 -2
View File
@@ -197,9 +197,10 @@ open and say so plainly. Never report a fix the re-pass did not prove.
``` ```
Then `git add <files touched>` (never `-A`, never the baseline file) and Then `git add <files touched>` (never `-A`, never the baseline file) and
commit, project convention else 50 words at most. commit, project convention else 50 words at most.
Before the reply, the main loop makes its Before the reply, the main loop prints the run's diff stat, then makes its
end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer
goes into the reply as an `Advisor:` line. goes into the reply as an `Advisor:` line, and a fix it drives goes
back through the gates.
2. `mcp__model-router__route(phase="apply")` for the tail. Reply with: fixed 2. `mcp__model-router__route(phase="apply")` for the tail. Reply with: fixed
and proven (proposal, rule, file), still open and why, the walk's result, and proven (proposal, rule, file), still open and why, the walk's result,
the branch name. Merge waits for the user's explicit signal. the branch name. Merge waits for the user's explicit signal.
+4 -2
View File
@@ -231,9 +231,11 @@ Parse the `BUGFIX-EXEC REPORT`:
3. Commit after approval, message per `$HOME/.claude/lib/commit-message.md` 3. Commit after approval, message per `$HOME/.claude/lib/commit-message.md`
(project convention first, else short: root cause in the subject, at most (project convention first, else short: root cause in the subject, at most
two sentences of body). two sentences of body).
Before the summary, the main loop makes its `mcp__model-router__route(phase="reflect")` first (route: end-of-run review).
Before the summary, the main loop prints the run's diff stat, then makes its
end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer
goes into the summary as an `Advisor:` line. goes into the summary as an `Advisor:` line, and a fix it drives goes
back through the gates.
4. Print summary: 4. Print summary:
``` ```
BUGFIX COMPLETE BUGFIX COMPLETE
+3 -2
View File
@@ -206,9 +206,10 @@ commit-changer (propose opus / apply sonnet, BDR-077); never inline-load the bar
propose/apply executor). propose/apply executor).
Then `mcp__model-router__route(phase="reflect")` (route: nested commit-change loaded at apply; reload feat's level). Then `mcp__model-router__route(phase="reflect")` (route: nested commit-change loaded at apply; reload feat's level).
Before the summary, the main loop makes its Before the summary, the main loop prints the run's diff stat, then makes its
end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer
goes into the summary as an `Advisor:` line. goes into the summary as an `Advisor:` line, and a fix it drives goes
back through the gates.
Print summary: Print summary:
``` ```
+3 -2
View File
@@ -274,9 +274,10 @@ open and say so plainly. Never report a fix the re-pass did not prove.
``` ```
Then `git add <files touched>` (never `-A`, never the baseline file) and Then `git add <files touched>` (never `-A`, never the baseline file) and
commit, project convention else 50 words at most. commit, project convention else 50 words at most.
Before the reply, the main loop makes its Before the reply, the main loop prints the run's diff stat, then makes its
end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer
goes into the reply as an `Advisor:` line. goes into the reply as an `Advisor:` line, and a fix it drives goes
back through the gates.
2. `mcp__model-router__route(phase="apply")` for the tail. Reply with: fixed 2. `mcp__model-router__route(phase="apply")` for the tail. Reply with: fixed
and proven (proposal, rule, file), still open and why, MANUAL steps left and proven (proposal, rule, file), still open and why, MANUAL steps left
for the user, the branch name. Merge waits for the user's explicit signal. for the user, the branch name. Merge waits for the user's explicit signal.
+4 -3
View File
@@ -356,9 +356,10 @@ patched. Report per its rc table — rc 4 = a LOUD upstream BDR-022 anomaly, not
## STEP 11 — FINISH ## STEP 11 — FINISH
`mcp__model-router__route(phase="plan")` first (route: end-of-run review). `mcp__model-router__route(phase="plan")` first (route: end-of-run review).
Before proposing the finish, the main loop makes its Before proposing the finish, the main loop prints the run's diff stat,
end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer then makes its end-of-run advisor call (`lib/effort-shift.md` § Advisor);
goes with the proposal as an `Advisor:` line. its answer goes with the proposal as an `Advisor:` line, and a fix it
drives goes back through the gates.
Tests pass, build clean, no placeholders. Integrate the MVP feature into develop Tests pass, build clean, no placeholders. Integrate the MVP feature into develop
— **only on the user's explicit go** (the `gitflow` finish gate): — **only on the user's explicit go** (the `gitflow` finish gate):
+2 -1
View File
@@ -79,7 +79,8 @@ Parse the `RELEASE-EXEC REPORT`:
`mcp__model-router__route(phase="reflect")` first (route: end-of-run review). `mcp__model-router__route(phase="reflect")` first (route: end-of-run review).
Before the ask, the main loop makes its Before the ask, the main loop makes its
end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer
goes with the ask as an `Advisor:` line; a fix it calls for means hold. goes with the ask as an `Advisor:` line, and a fix it calls for makes
hold the recommended answer.
STOP. Show the prep report's `TESTS` result, then: STOP. Show the prep report's `TESTS` result, then:
``` ```
+4 -3
View File
@@ -320,9 +320,10 @@ on the branch FINISH integrates.
## STEP 9 — FINISH ## STEP 9 — FINISH
`mcp__model-router__route(phase="plan")` first (route: end-of-run review). `mcp__model-router__route(phase="plan")` first (route: end-of-run review).
Before proposing the finish, the main loop makes its Before proposing the finish, the main loop prints the run's diff stat,
end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer then makes its end-of-run advisor call (`lib/effort-shift.md` § Advisor);
goes with the proposal as an `Advisor:` line. its answer goes with the proposal as an `Advisor:` line, and a fix it
drives goes back through the gates.
Tests pass, build clean. Integrate the feature into develop — **only on the Tests pass, build clean. Integrate the feature into develop — **only on the
user's explicit go** (the `gitflow` finish gate): user's explicit go** (the `gitflow` finish gate):