← ClaudeAtlas

onboardlisted

Fast comprehension of an unfamiliar codebase — surface scan, run-it-first, one traced end-to-end flow, git-history archaeology (churn hotspots, bus factor, the oldest untouched code), seams & boundaries, load-bearing weirdness list — into a written orientation map. TRIGGER when: joining/inheriting an unfamiliar repo, "разберись в этом проекте", "how does this codebase work", "map this project", before the first real task in a codebase nobody has profiled yet. DO NOT TRIGGER when: researching one feature/capability in a known repo (use /discover), hunting architectural rot in a familiar one (use /arch-health), or the user wants PROJECT.md written (that's /bootstrap — this skill *feeds* it).
mik2win/foureyes · ★ 2 · AI & Automation · score 79
Install: claude install-skill mik2win/foureyes
# Codebase Onboarding: $ARGUMENTS ## Principle Understanding is built from **behavior first, then structure, then history** — run it before reading it, trace one real flow before mapping all of them, and let `git log` tell you what the files can't: where the work happens, who knows it, and what everyone is afraid to touch. The output is a written map, because comprehension that stays in one session's head is re-paid by every next session. Read-only on app code. The only file you create is the orientation report. ## Phase 0 — Context (works pre-bootstrap by design), and which mode you are in Read `README`/`CONTRIBUTING`/docs index if present — as *claims to verify*, not facts: docs drift, code doesn't. Then pick the mode from whether the repo carries an active profile: **Cold mode — no `.claude/PROJECT.md`.** The default, and what this skill was built for: run the full suite of phases below and build the map from zero. Don't stop for the missing profile. **Verification mode — an active `PROJECT.md` (plus `CONTEXT.md`, project rules, docs index).** The repo is already profiled, so **start from what exists, verify it against code, and report drift** rather than rediscovering from scratch: read the profile's architecture/module map and commands first, then run the phases as *checks* on those claims — does the entry point still live where the map says, does the stated test command still pass, does the traced flow still go through the layers the profile names. Every phase st