rad-repo-manager

A repo manager for vibe coders — a closed doc system where every kind of information has exactly one home, every home has exactly one update trigger, and nothing depends on anyone remembering anything. It is the 'manager'; your coding agent is the 'employee.' The model (references/shelf-spec.md, the single source): a five-layer context stack — L0 `AGENTS.md` (≤40 lines: identity, stack, ≤7 hard rules, the doc-model block) + L1 `docs/handoff.md` (≤60 lines: state + a 'Deferred — do not re-raise' ledger), both injected into every session by hook; L2 `docs/decisions.md` (append-only settled decisions); L3 prd/plan (the planner's); L4 `docs/archive/`. Reference docs live on a closed shelf (decisions, ideas, lessons, design, architecture, api), each created only when its trigger fires — never scaffolded. One vocabulary (Goal → Release → Milestone → Task; phase/slice/sprint/epic/stage banned), one writer per file, and an interaction contract: hard-gate only the irreversible, challenge once then commit, ideas append to docs/ideas.md and block nothing. Six skills: - `/startup` — read-only orientation with a trust report: one line per managed doc, measured in commits-behind (handoff 0–3 green / 4–10 yellow / >10 red), ending with the next task from the handoff. - `/wrapup` — quick by default (<1 min): overwrite docs/handoff.md from git evidence, carry the Deferred ledger forward, ask two questions (decisions settled? → append decisions.md; lessons? → append lessons.md). `--full` adds the session-scoped reconcile pass. No auto-commit. - `/ship` — the close-out chain: mechanical scans → quick wrapup → conventional commit → push origin/main → deploy-verify (only when AGENTS.md declares a `deploy:` target; polls the Coolify MCP when available, degrades to 'verify manually' when not) → stray branch/worktree sweep → one-line report. Invoking /ship IS the commit+push authorization. First ship runs the fit-out: detect repo traits (deploy target, API routes, UI-heavy, TypeScript, CMS, >1 moving part), propose the matching equipment as a menu, install what's approved. - `/repo-init` — greenfield container only: AGENTS.md skeleton with the stamped doc-model block, CLAUDE.md `@AGENTS.md` shim, docs/ + docs/archive/, handoff stub. No shelf docs (their triggers haven't fired); ends by recommending /rad-planner:plan. - `/adopt` — brownfield archaeology, never code changes: git history + docs + code read; L0–L2 drafted from evidence (build/test commands verified by running them); every existing doc triaged onto the shelf (keep/merge/archive via git mv, each move proposed); 5–10 questions only for what evidence can't answer; dormant repos stamped; hands plan reconstruction to /rad-planner:rescue. - `/repo-align` — the deep pass (every ~25 commits or on red trust): doc router (reads off-shelf files and proposes where their content belongs), vocabulary lint, api.md route-diff, on-request rules audit of AGENTS.md (promote to hook / keep in the 7 slots / demote), L0/L1 size budgets, plus the classic contradiction/redundancy/authority checks. Proposes everything; git mv preserves history. Hooks v2 (Claude Code-only, silent in repos without the doc model, never blocking): SessionStart injects an identity banner (repo purpose from the parent folder's CLAUDE.md glossary when one exists — the wrong-repo guard), the handoff content, and a trust summary; Stop nudges once per session when the handoff drifts >3 commits behind or real work sits uncommitted (suppressed by the Deferred ledger); PreCompact asks for a quick handoff refresh — or verbatim preservation of its raw material — before context loss. Six pure-stdlib validators (repo-scan, doc-freshness with the trust block, vocab-lint, doc-contradiction, doc-redundancy, audit-user-content). Pairs with rad-planner v7 (which reads the repo's doc-model block, writes prd/plan in the shelf's headings and vocabulary, and seeds decisions/ideas at /plan) and rad-brainstormer v4 (transient dated specs, rejected ideas routed to ideas.md); works standalone.