Monorepo Review Loop
Goal: Review and refine the monorepo so docs, registry, tests, gates, and deploy stay aligned — "done" is unambiguous.
Commands and gates per phase: reference.md
Cadence: daily or on demand after a batch of changes.
The arc (10 phases)
| Phase |
Skills |
Exit gate |
| 0 Orient |
session-orient, correct-assumptions, disk-pressure-proactive |
Healthy env or docker-free task chosen |
| 1 Lane & Plan |
lane-discipline, follow-procedure, progress-board, auto-mode |
Board with tracker-tied deliverables in lane |
| 2 Review fan-out |
sme-fanout, verify-subagent-output |
SME reviews conformant; top-3 synthesized |
| 3 Code review |
match-conventions, use-design-system, dependency-hygiene, abstract-the-provider, conservative-rename, policy-as-config, idempotent-seed-script |
Conventions + shared primitives |
| 4 Gate pass |
smoke-import, affected-tests, validate-gate, a11y-gate |
Gates green; corpus size stated |
| 5 Guard pass |
respect-the-guard, shell-confirm-hygiene, pre-commit-hygiene, agent-guardrails, deterministic-core-llm-judgment |
Guards structural; secrets clean |
| 6 Metadata |
metadata-align |
Registry/docs match structure |
| 7 Deploy & smoke |
use-available-integrations, post-deploy-smoke, event-driven-wait |
One e2e path proven live |
| 8 Triage |
background-failure-triage, silent-op-recovery, diagnose-before-retry, fill-the-wait, cost-transparency |
Failures diagnosed; no blind retries |
| 9 Close-out |
readiness-report, document-non-action, close-the-loop, logical-commit-split, persist-learnings, recap-on-long-session |
Handoff + SHA + learnings persisted |
Loop discipline (all phases)
cost-transparency · fill-the-wait · event-driven-wait · progress-board · lane-discipline
Anti-patterns
Deploy before gates; skip metadata-align "because nothing changed"; close without commit SHA; persist learnings only at end; treat thin-corpus green as proof.
Pair with
Runner: scripts/monorepo_review_loop.py · Artifacts: knowledge/reviews/monorepo-review-<date>.md, HANDOFF.md
1---2name: monorepo-review-loop3description: A recurring review workflow that walks a monorepo through a fixed arc — orient, plan, fan out reviewers, review code, run gates, check guards, align metadata, deploy+smoke, close out — using the 39 codified skills as the steps. Use to continuously update and refine a detailed monorepo so "done" is unambiguous, every claim is auditable, and docs/registry/tests/deploy stay aligned with the code. Run on a cadence (e.g. daily) or on demand after a batch of changes.4---56# Monorepo Review Loop78**Goal:** Review and refine the monorepo so docs, registry, tests, gates, and deploy stay aligned — "done" is unambiguous.910**Commands and gates per phase:** [reference.md](reference.md)1112**Cadence:** daily or on demand after a batch of changes.1314## The arc (10 phases)1516| Phase | Skills | Exit gate |17|---|---|---|18| 0 Orient | `session-orient`, `correct-assumptions`, `disk-pressure-proactive` | Healthy env or docker-free task chosen |19| 1 Lane & Plan | `lane-discipline`, `follow-procedure`, `progress-board`, `auto-mode` | Board with tracker-tied deliverables in lane |20| 2 Review fan-out | `sme-fanout`, `verify-subagent-output` | SME reviews conformant; top-3 synthesized |21| 3 Code review | `match-conventions`, `use-design-system`, `dependency-hygiene`, `abstract-the-provider`, `conservative-rename`, `policy-as-config`, `idempotent-seed-script` | Conventions + shared primitives |22| 4 Gate pass | `smoke-import`, `affected-tests`, `validate-gate`, `a11y-gate` | Gates green; corpus size stated |23| 5 Guard pass | `respect-the-guard`, `shell-confirm-hygiene`, `pre-commit-hygiene`, `agent-guardrails`, `deterministic-core-llm-judgment` | Guards structural; secrets clean |24| 6 Metadata | `metadata-align` | Registry/docs match structure |25| 7 Deploy & smoke | `use-available-integrations`, `post-deploy-smoke`, `event-driven-wait` | One e2e path proven live |26| 8 Triage | `background-failure-triage`, `silent-op-recovery`, `diagnose-before-retry`, `fill-the-wait`, `cost-transparency` | Failures diagnosed; no blind retries |27| 9 Close-out | `readiness-report`, `document-non-action`, `close-the-loop`, `logical-commit-split`, `persist-learnings`, `recap-on-long-session` | Handoff + SHA + learnings persisted |2829## Loop discipline (all phases)3031`cost-transparency` · `fill-the-wait` · `event-driven-wait` · `progress-board` · `lane-discipline`3233## Anti-patterns3435Deploy before gates; skip metadata-align "because nothing changed"; close without commit SHA; persist learnings only at end; treat thin-corpus green as proof.3637## Pair with3839Runner: `scripts/monorepo_review_loop.py` · Artifacts: `knowledge/reviews/monorepo-review-<date>.md`, `HANDOFF.md`
jcdavis131