| name | repo-init |
| description | This skill should be used when the user says "set up this repo", "bootstrap this project", "new project setup", "scaffold the docs", "initialize the repo model", "get me started right", or when startup recommended it on a fresh repo. Builds the container for the doc model in a new or nearly empty repo: an AGENTS.md skeleton with the stamped doc-model block, the CLAUDE.md @AGENTS.md shim, docs/ + docs/archive/, and a handoff stub. Creates no shelf or initiative docs (their triggers haven't fired), runs no fit-out, never invents product content, and ends by recommending /rad-planner:plan. For an existing repo with history and docs, use /rad-repo-manager:adopt instead.
|
| argument-hint | [--agents claude|codex|gemini|<comma-separated>] |
| user-invocable | true |
| allowed-tools | Read Glob Grep Bash Write AskUserQuestion |
Repo Init — build the container
Lay the foundation for a fresh, nearly empty repo. Build the container only —
the shelf docs (decisions.md, ideas.md, prd.md, plan.md, …) are created later,
each when its trigger fires (see <plugin-root>/references/shelf-spec.md). Do not
write product, plan, or design content — that's the owner's and
/rad-planner:plan's job. Templates live in <plugin-root>/templates/ (where
<plugin-root> is either ${CLAUDE_PLUGIN_ROOT}, global config
plugins/rad-repo-manager, or local workspace plugins/rad-repo-manager).
Use this only for greenfield setup. An established repo with history and docs goes to
/rad-repo-manager:adopt (archaeology first); an on-model repo with drift goes to
/rad-repo-manager:repo-align.
1. Look before scaffolding
git status --short
git remote get-url origin
Glob the repo. Detect the app type and package manager if obvious (package.json,
lockfiles, pyproject.toml, Cargo.toml, framework config) — this only informs the
AGENTS.md identity line, not product content.
Confirm this is greenfield: no AGENTS.md, no real docs, little or no git history.
If the repo is established, stop and recommend adopt.
2. Agent scope
If --agents was passed, use it. Otherwise ask (via AskUserQuestion or ask_question
on Antigravity): which coding agents will use this repo — Claude, Codex, Gemini, or a
mix? This decides which shims to create. Codex reads AGENTS.md natively (no shim).
If unclear, ask before creating non-Codex shims.
3. Scaffold — container only, only what's missing
Create only files that don't already exist. Never overwrite a user-authored file
without explicit confirmation.
AGENTS.md ← templates/AGENTS.md — the L0 skeleton: identity line, deploy:
line, stack/commands placeholders, the doc-model block (stamp it verbatim from
templates/doc-model-block.md — it's what makes every other tool conform), the
"How we work" contract, and the hard-rule slots. Keep it within its 40-line budget.CLAUDE.md ← templates/CLAUDE.md — the one-line @AGENTS.md shim.GEMINI.md ← templates/GEMINI.md — only if Gemini is in scope.docs/ and docs/archive/ folders; docs/archive/README.md ← templates/archive-README.md.
docs/initiatives/ is created only when an approved migration uses
templates/initiative.md; do not scaffold an empty initiative.docs/handoff.md ← templates/handoff.md — the stub, placeholder values, including
the ## Deferred — do not re-raise section.
Do not create any shelf doc — no prd.md, plan.md, decisions.md, ideas.md,
lessons.md, design.md, architecture.md, or api.md. Their triggers haven't
fired; /rad-planner:plan births prd/plan, and the rest appear on first real content.
Do not run fit-out here (no code yet means no traits to detect — that happens at
the first /rad-repo-manager:ship or during adopt). Do not create docs/status.md,
docs/roadmap.md, docs/inbox/, loose root-level status docs, or speculative scoped
instructions. A scoped AGENTS.md plus one-line CLAUDE.md shim is allowed later
only when code provides evidence of materially different subtree rules.
4. Fill only what's mechanical
Set the remote line from git remote get-url origin if available. Leave deploy:
as none unless the user names a target. Stamp the handoff stub's **Updated:**
with today's date. Note in one line that the plugin's hooks (SessionStart banner,
Stop drift nudge, PreCompact checkpoint) are universal — they activate on their own
now that AGENTS.md + docs/handoff.md exist; nothing to install per-repo. Leave
every other <PLACEHOLDER> for the owner. Do not invent goals, stack, rules, or
validation promises.
5. Hand off
Tell the user, plainly: the container is in place; the docs themselves get created
when they're first needed. The next step is /rad-planner:plan — its interview
births docs/prd.md and docs/plan.md and seeds the first decisions and ideas.
Output format
Repo init:
Detected repo type:
Agent scope:
Files created:
Files skipped (already exist):
Next step for the user: /rad-planner:plan
Notes:
References
<plugin-root>/templates/ — AGENTS.md skeleton, doc-model block, shims, handoff stub, initiative, archive README, repository config<plugin-root>/references/shelf-spec.md — the shelf, triggers, budgets, one-writer table
