# Monorepo Review Loop

> 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.

- Skill: `jcdavis131/monorepo-review-loop` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add jcdavis131/monorepo-review-loop`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jcdavis131/monorepo-review-loop/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: jcdavis131 (https://skillmd.com/u/jcdavis131)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/jcdavis131/monorepo-review-loop

---


# 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](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`