Release 0.3.12

Author: coleam00

.archon/commands/maintainer-review-gate.md

@@ -1,32 +1,25 @@
 ---
-description: Produce the final summary across all branches of maintainer-review-pr (review / decline / unclear) for the workflow log
+description: Produce the final summary of a maintainer-review-pr run for the workflow log
 argument-hint: (no arguments — reads upstream artifacts)
 ---
 
 # Maintainer Review — Final Report
 
-You are the final reporter. The workflow has finished one of three branches (review / decline / unclear). Your job: produce a one-screen summary that tells the maintainer what just happened and what's pending.
+You are the final reporter. The workflow has finished the deep review. Your job: produce a one-screen summary that tells the maintainer what just happened and what's pending.
 
 **Workflow ID**: $WORKFLOW_ID
 
 ---
 
-## Phase 1: DETECT WHICH BRANCH RAN
-
-Check what artifacts exist:
+## Phase 1: LOAD ARTIFACTS
 
 ```bash
 PR_NUMBER=$(cat $ARTIFACTS_DIR/.pr-number 2>/dev/null)
 ls $ARTIFACTS_DIR/
 ls $ARTIFACTS_DIR/review/ 2>/dev/null
-cat $ARTIFACTS_DIR/gate-decision.md 2>/dev/null | head -30
 ```
 
-Three possibilities:
-
-1. **Review branch ran**: `$ARTIFACTS_DIR/review/synthesis.md` exists.
-2. **Decline branch ran**: `$ARTIFACTS_DIR/decline-comment.md` exists with non-placeholder content; the post-decline bash node already posted to GitHub.
-3. **Unclear branch ran**: gate verdict was `unclear` and the maintainer was prompted to decide manually.
+`$ARTIFACTS_DIR/review/synthesis.md` should exist and contain the synthesized verdict + findings.
 
 ---
 
@@ -37,37 +30,19 @@ Write `$ARTIFACTS_DIR/final-report.md`:
 ```markdown
 # Maintainer Review — PR #<n> — Final
 
-## Branch taken
-<review | decline | needs_split | unclear>
-
-## Gate decision
-<one-line summary from gate-decision.md: verdict + direction + scope + template>
-
 ## Outcome
 
-### If review branch:
 - Synthesized verdict: <ready-to-merge | minor-fixes-needed | blocking-issues>
 - Findings: <N CRITICAL / N HIGH / N MEDIUM / N LOW>
 - Aspects run: <list>
-- **Draft comment**: $ARTIFACTS_DIR/review/review-comment.md (copy-paste or edit before posting to PR)
+- **Draft comment**: $ARTIFACTS_DIR/review/review-comment.md (already posted to PR; copy-paste if you want to edit and re-post)
 - **Full synthesis**: $ARTIFACTS_DIR/review/synthesis.md
 
-### If decline branch:
-- Decline categories: <list>
-- Cited direction clauses: <list>
-- Comment posted to PR: yes
-- Reply window: <YYYY-MM-DD>
-- Awaiting-author label added: read `$ARTIFACTS_DIR/.label-applied` — value is `applied` or `skipped`. If `skipped`, surface why by reading `$ARTIFACTS_DIR/.label-error` (gh stderr) and include a one-line explanation. **Do not say `yes` if the file says `skipped`** — say `no, label add failed: <reason>` so the maintainer can decide whether to add it manually.
-
-### If unclear branch:
-- Gate could not classify confidently.
-- Maintainer prompted manually — outcome recorded in approval-gate response.
-
 ## Next steps for the maintainer
 <2-3 short bullets. e.g.:
-- "Read $ARTIFACTS_DIR/review/review-comment.md and post to PR."
-- "Wait for contributor reply by <DATE>; if no reply, close PR."
-- "Update direction.md to address the open question this PR raised: <topic>".>
+- "Open PR #<n> and confirm the posted review reads well."
+- "If blocking-issues: wait for contributor reply; check back in N days."
+- "If ready-to-merge: merge when CI is green.">
 ```
 
 ---
@@ -77,10 +52,10 @@ Write `$ARTIFACTS_DIR/final-report.md`:
 Return a single-line outcome:
 
 ```
-PR #<n> — branch=<review|decline|needs_split|unclear>, verdict=<gate verdict>, action=<posted-comment|drafted-review|awaiting-manual-decision>.
+PR #<n> — verdict=<synthesized verdict>, action=posted-review-comment.
 ```
 
 ### CHECKPOINT
 - [ ] `$ARTIFACTS_DIR/final-report.md` written.
-- [ ] Correctly identifies which branch ran (don't pretend the review branch ran when it didn't).
+- [ ] Numbers in the report match `$ARTIFACTS_DIR/review/synthesis.md` (don't invent finding counts).
 - [ ] Lists concrete next steps for the maintainer.

.archon/commands/maintainer-review-report.md

@@ -32,13 +32,6 @@ Then read each one:
 
 Some files may be missing — that's expected. Don't error.
 
-### Read the gate decision (for context)
-```bash
-cat $ARTIFACTS_DIR/gate-decision.md
-```
-
-The gate may have noted things ("template was empty — nudge in synthesis"). Carry those notes forward.
-
 ---
 
 ## Phase 2: AGGREGATE + DEDUPLICATE
@@ -88,9 +81,6 @@ Write `$ARTIFACTS_DIR/review/synthesis.md`:
 ## CLAUDE.md compliance
 <bullet list of any violations carried forward from code-review.>
 
-## Gate-decision notes
-<any non-review notes the gate flagged for synthesis — e.g. "template was empty, nudge contributor".>
-
 ## Aspects run
 - code-review: <yes/no, summary line>
 - error-handling: <yes/no, summary line>