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
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
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
and proven (proposal, rule, file), still open and why, the walk's result,
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`
(project convention first, else short: root cause in the subject, at most
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
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:
```
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).
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
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:
```
+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
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
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
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.
+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
`mcp__model-router__route(phase="plan")` first (route: end-of-run review).
Before proposing the finish, the main loop makes its
end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer
goes with the proposal as an `Advisor:` line.
Before proposing the finish, the main loop prints the run's diff stat,
then makes its end-of-run advisor call (`lib/effort-shift.md` § Advisor);
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
— **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).
Before the ask, the main loop makes its
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:
```
+4 -3
View File
@@ -320,9 +320,10 @@ on the branch FINISH integrates.
## STEP 9 — FINISH
`mcp__model-router__route(phase="plan")` first (route: end-of-run review).
Before proposing the finish, the main loop makes its
end-of-run advisor call (`lib/effort-shift.md` § Advisor); its answer
goes with the proposal as an `Advisor:` line.
Before proposing the finish, the main loop prints the run's diff stat,
then makes its end-of-run advisor call (`lib/effort-shift.md` § Advisor);
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
user's explicit go** (the `gitflow` finish gate):