| name | review-house |
| description | Orchestrate a full house-rules review of the entire project from the eleven rv-* review specialists, dispatched in three parallel waves, then synthesize one prioritized review document written to docs/house-review-YYYY-MM-DD.md (findings + a phased fix plan). Writes only that doc; makes no other code changes (each subagent may persist notes to its own project memory). Do not invoke automatically. |
| disable-model-invocation | true |
| allowed-tools | Read, Grep, Glob, Bash, Agent, Write |
Run a full-codebase house-rules review using the eleven rv-* specialist
subagents in .claude/agents/review/, then merge their findings into one
prioritized review document. The skill's sole output is that document —
docs/house-review-YYYY-MM-DD.md, holding the findings and a phased plan to
implement the fixes; it makes no other code changes.
This is the project-rules lens: "does the code obey this project's own rules?" Its
upstream-currency counterpart is /review-currency. Follow the shared orchestration
rules in .claude/REVIEW-CONVENTIONS.md (waves, scope, synthesize, next steps).
The eleven specialists
rv-arch — module layering, dependency direction, API/impl split
rv-kmp — source-set wiring, expect/actual placement, commonMain purity
rv-concurrency — coroutines, Flow, dispatchers, DataResult pipeline
rv-compose — state hoisting, recomposition, Navigation 3
rv-data — Room DAOs, mappers, repository, platform DB builders
rv-di — Koin annotation graph, scopes, DSL boundary
rv-testing — fakes-not-mocks, dispatcher setup, Kover policy
rv-security — secrets, input validation, platform data handling
rv-perf — allocations, query patterns, Flow efficiency, startup
rv-build — convention plugins, version catalog, Kover wiring, iOS export
rv-ci — CI gating, action pinning, permissions, timeouts
Waves
Dispatch in three parallel waves (see .claude/REVIEW-CONVENTIONS.md for why), each
in a single message carrying the scope, and synthesize only after all eleven return:
- Wave 1 — structural:
rv-arch, rv-kmp, rv-di, rv-build
- Wave 2 — behavioral/runtime:
rv-concurrency, rv-data, rv-compose
- Wave 3 — cross-cutting:
rv-testing, rv-security, rv-perf, rv-ci
Findings-discipline rule (end every spawn's prompt with this)
Report only gaps that affect correctness or the stated project rules. Give
severity (Critical / Should-fix / Optional), file:line, and a concrete fix. Do
not invent findings if the area is sound.
Then synthesize the eleven reports into docs/house-review-YYYY-MM-DD.md exactly
as described in .claude/REVIEW-CONVENTIONS.md (Synthesize — write the review
document): a two-part doc with the tiered findings and a phased implementation plan
for the fixes (phases ordered by risk/value, each committable, with files + a ./gradlew
verify step and any apiDump/Kover gates). Writing that one doc is the only file change;
then offer next steps — including implementing the fixes by phase, or running the
sibling /review-currency or the combined /review-all.