Startup — orient, fast and read-only

Get oriented at the top of a session. Read-only and lean — read the active docs and git state, surface where things stand, and point at the right next skill. This is not onboarding (that's /rad-repo-manager:repo-init) and not an audit (that's /rad-repo-manager:repo-align).

What this skill does NOT do

• No scaffolding or onboarding — a fresh repo gets pointed at repo-init.
• No deep audit, contradiction/redundancy check, or doc filing — that's repo-align.

(The two mechanical scans in step 1 are read-only and near-instant — they're evidence for the briefing, not an audit.)

• No reading of docs/archive/.
• No cleanup, no writes of any kind, no commits.
• No product or implementation changes.
• No offering to run wrapup or any end-of-session action — startup only orients.

Procedure

1. Gather evidence (read-only), in one batch — the git state plus the two cheap

mechanical scans. Determine the plugin root directory path (e.g., local ./plugins/rad-repo-manager if developing in the monorepo, the global path $HOME/.gemini/config/plugins/rad-repo-manager for Antigravity, or ${CLAUDE_PLUGIN_ROOT} for Claude Code).

Run in PowerShell (pwsh) under Antigravity on Windows:

   git status --short
   git branch --show-current
   $PluginRoot = if (Test-Path "$PWD/plugins/rad-repo-manager") { "$PWD/plugins/rad-repo-manager" } else { "$HOME/.gemini/config/plugins/rad-repo-manager" }
   python "$PluginRoot/scripts/repo-scan.py" . --json --no-record    # loose/floating docs, active-set growth, AGENTS.md bloat
   python "$PluginRoot/scripts/doc-freshness.py" . --json            # stale handoff; prd/plan unchanged while code churned

Or run in Bash/sh under Claude Code (macOS/Linux/Windows):

   git status --short
   git branch --show-current
   PLUGIN_ROOT=$( [ -d "./plugins/rad-repo-manager" ] && echo "./plugins/rad-repo-manager" || echo "${CLAUDE_PLUGIN_ROOT:-$HOME/.gemini/config/plugins/rad-repo-manager}" )
   python3 "$PLUGIN_ROOT/scripts/repo-scan.py" . --json --no-record
   python3 "$PLUGIN_ROOT/scripts/doc-freshness.py" . --json

(If Python is unavailable, skip the scans and say so in the briefing — don't guess at hygiene from globs alone.)

1. Glob for AGENTS.md and the docs/ core to see what exists. Decide the path:

• Fresh repo — no AGENTS.md and no real docs/prd.md/docs/plan.md. Stop

and recommend /rad-repo-manager:repo-init. Do not scaffold here.

• Established repo — AGENTS.md exists. Orient (below).

1. Read the active core that exists, in one parallel batch: AGENTS.md,

docs/prd.md, docs/plan.md, docs/handoff.md. Read nothing else by default — not reference docs, not docs/design.md, not docs/archive/.

1. Note alignment from the scan results (no deep scan beyond them): the repo-scan

JSON tells you about loose docs, active-set growth, and AGENTS.md bloat; the doc-freshness JSON tells you whether the handoff is stale and whether prd/plan sat unchanged while code churned. Report what the scans found — grounded counts and file names, not impressions. If the handoff is stale, say so explicitly and treat its "Resume point" with suspicion in the briefing. If the scans show drift, recommend /rad-repo-manager:repo-align — don't fix anything here.

1. Surface the briefing (format below), then stop — the briefing is the whole

deliverable. Ground every line in what you actually read; if a doc is missing or stale, say so plainly rather than inventing. The only forward action you may suggest is repo-init (fresh repo) or repo-align (drift) — never offer to run wrapup, commit, or anything else.

Output format

Startup:
Branch:           <current branch>
Working tree:     <clean / dirty summary from git status>
Active docs:      <which of the 4 exist; name any missing>
Current focus:    <current milestone / active task from docs/plan.md, one line>
Resume point:     <next action from docs/handoff.md; append "(handoff is stale — verify against git)" if doc-freshness flagged it>
Stop conditions:  <from docs/plan.md, if declared>
Doc freshness:    <from doc-freshness.py: "fresh" | the findings, one line each>
Repo hygiene:     <from repo-scan.py: "tidy" | "N loose ends: <names>" → recommend repo-align | fresh repo → recommend repo-init>
Notes:            <anything material, or "None">

References

• <plugin-root>/references/doc-model.md — the active core, the conditional tiers, and what "aligned" means (where <plugin-root> is either ${CLAUDE_PLUGIN_ROOT}, global config plugins/rad-repo-manager, or local workspace plugins/rad-repo-manager).