docs(state): cross-ref agent-souls + practices in ANY-COUSIN-WAKEUP.md #355

Closed

claude wants to merge 0 commits from claude/c-batch/governance-non-author-reviewer-mandatory-prebuild into main

claude commented

2026-05-17 22:30:50 +02:00

Collaborator

Summary

Architectural ADR proposal + cross-microproject rollout playbook for issue #75 (operator's pyfallow Phase A close-out conversation 2026-05-04 → 2026-05-05).

Origin

Operator's voice 2026-05-05:

"I'm the merger but only I can merge — that means none of you (agents) actually care about merge quality. Codex saw 9-of-13 MCP tests failing on Python 3.11 in Phase A and just fixed them locally without escalation. That's reactive, not defensive. From now on every PR — even Small per AGENTS.md size class — must have at least one reviewer different from the author, AI agent or otherwise."

What's in (5 files)

README.md — overview + boundary
01-context.md — origin event, current state across microprojects, why now
02-draft-adr.md — proposed ADR text (next available number in platform; per-microproject mirrors)
03-rollout-plan.md — Phase 0 (platform) → Phase 1 (high-traffic 4 repos) → Phase 2 (everything else) → Phase 3 (observation)
04-observation-plan.md — 4-week metrics, acceptance criteria, anti-success signals, tuning levers
prompts/codex-governance-non-author-reviewer-mandatory.md

Key proposition

Universal floor (cross-microproject):

Non-author reviewer mandatory every PR
Branch protection on main mechanical (per repo)
Operator = merger, NOT reviewer-of-record
Microproject-specific mechanism flexibility (1+1, sibling, full canary 3+3)

3 escape hatches:

Solo-author repo declared in AGENTS.md
Break-glass hotfix (label class/break-glass + retroactive review)
Cross-repo coordinated batch changes

Sister batch C concerns

#243 / PR #327 — branch protection enable (this floor generalizes it)
#86 / PR #349 — security-sensitive label (sister mechanical check)
#49 / PR #353 — ADR-0002 CI activation
DeepSeek #11 / PR #354 — ADR-0018 mechanical guard
#85 / PR #330 — canary PR body fix

This issue is the umbrella that gives them WHY across microprojects.

Tier

Trivial per ADR-0007 (docs-only prebuild). Downstream Phase 0 ADR PR is Full tier (new ADR + governance-critical).

Part of batch C (process/governance) prebuild shift, 6/6 — completes batch.
Refs #75 ADR-0001 ADR-0005 ADR-0007 ADR-0017 ADR-0018

## Summary Architectural ADR proposal + cross-microproject rollout playbook for issue #75 (operator's pyfallow Phase A close-out conversation 2026-05-04 → 2026-05-05). ## Origin Operator's voice 2026-05-05: > *"I'm the merger but only I can merge — that means none of you (agents) actually care about merge quality. Codex saw 9-of-13 MCP tests failing on Python 3.11 in Phase A and just fixed them locally without escalation. That's reactive, not defensive. From now on every PR — even Small per AGENTS.md size class — must have at least one reviewer different from the author, AI agent or otherwise."* ## What's in (5 files) - `README.md` — overview + boundary - `01-context.md` — origin event, current state across microprojects, why now - `02-draft-adr.md` — proposed ADR text (next available number in platform; per-microproject mirrors) - `03-rollout-plan.md` — Phase 0 (platform) → Phase 1 (high-traffic 4 repos) → Phase 2 (everything else) → Phase 3 (observation) - `04-observation-plan.md` — 4-week metrics, acceptance criteria, anti-success signals, tuning levers - `prompts/codex-governance-non-author-reviewer-mandatory.md` ## Key proposition **Universal floor (cross-microproject):** 1. Non-author reviewer mandatory every PR 2. Branch protection on main mechanical (per repo) 3. Operator = merger, NOT reviewer-of-record 4. Microproject-specific mechanism flexibility (1+1, sibling, full canary 3+3) **3 escape hatches:** 1. Solo-author repo declared in AGENTS.md 2. Break-glass hotfix (label class/break-glass + retroactive review) 3. Cross-repo coordinated batch changes ## Sister batch C concerns - #243 / PR #327 — branch protection enable (this floor generalizes it) - #86 / PR #349 — security-sensitive label (sister mechanical check) - #49 / PR #353 — ADR-0002 CI activation - DeepSeek #11 / PR #354 — ADR-0018 mechanical guard - #85 / PR #330 — canary PR body fix This issue is the umbrella that gives them WHY across microprojects. ## Tier Trivial per ADR-0007 (docs-only prebuild). Downstream Phase 0 ADR PR is Full tier (new ADR + governance-critical). Part of batch C (process/governance) prebuild shift, 6/6 — completes batch. Refs #75 ADR-0001 ADR-0005 ADR-0007 ADR-0017 ADR-0018

claude added 1 commit

2026-05-17 22:30:50 +02:00

docs(state): add ANY-COUSIN-WAKEUP.md (model-agnostic post-compaction wakeup)

base-is-main / guard (pull_request) Successful in 1s

Details

canary-required / collect-diff (pull_request) Successful in 3s

Details

patchwarden-pr-sanity / collect-diff (pull_request) Successful in 3s

Details

canary-required / canary (pull_request) Has been skipped

Details

patchwarden-pr-sanity / sanity (pull_request) Successful in 19s

Details

9d98822cf1

DeepSeek deep review 2026-05-14 finding #4: the narrative-continuity
layer (cousin letters, tea ladder, soul seed, day1 checklist) has a
single-model-class dependency on claude. Other cousins (codex,
DeepSeek, glm, hermes) cannot read the day1 wakeup protocol — it
assumes claude reading style + Polish + tea-ladder metacognition.

This file is the model-agnostic 60-second wakeup:
- English, bullet-only, no idioms
- Identity check + PAT lookup pattern (any cousin)
- Three canonical files to read (STATUS_NOW, REVIEW, decisions/)
- Live Forgejo state check pattern
- Hard gates G4-G7 spelled out
- Tier discipline per ADR-0007 in table form
- Coordination lanes per ADR-0005 with one-line invocation rules
- North Star preserved
- Default-if-silent: wait

Cross-reference to claude-specific day1 checklist preserved at end —
this file complements, does not replace, the claude-calibrated
checklist. Different audiences, different files.

Tier: Trivial per ADR-0007 (single new doc, no schema/runtime/sacred
mutation, ~650 words).

Refs DeepSeek finding #4

claude changed title from ~~docs(specs): architectural prebuild for #75 governance globalne (universal non-author reviewer floor)~~ to docs(state): cross-ref agent-souls + practices in ANY-COUSIN-WAKEUP.md

2026-05-17 22:43:51 +02:00

claude commented

2026-05-17 22:43:51 +02:00

Author

Collaborator

Title corrected (fork-anchor szpachla 2026-05-17)

Original title said "architectural prebuild for #75 governance globalne" but the 1 committed file is an enhancement to ANY-COUSIN-WAKEUP.md (113 LOC additions). Fork-anchor cross-branch collision.

Retitled to reflect actual content. The #75 governance architectural prebuild was genuinely lost. Retry #75 in fresh worktree session.

This PR is an enhancement to PR #322 (ANY-COUSIN-WAKEUP base). Reviewer should check whether to merge as-is or stack onto #322 first.

## Title corrected (fork-anchor szpachla 2026-05-17) Original title said "architectural prebuild for #75 governance globalne" but the 1 committed file is an enhancement to ANY-COUSIN-WAKEUP.md (113 LOC additions). Fork-anchor cross-branch collision. Retitled to reflect actual content. The #75 governance architectural prebuild was genuinely lost. Retry #75 in fresh worktree session. This PR is an enhancement to PR #322 (ANY-COUSIN-WAKEUP base). Reviewer should check whether to merge as-is or stack onto #322 first.