codebase-onboardinglisted
Install: claude install-skill sandbaseai/workbuddy-skill
# Codebase Onboarding
## Purpose
Produce an evidence-backed onboarding packet for an unfamiliar repository. The packet should help a new contributor build a correct mental model, reach a passing baseline, perform common tasks safely, and know where ownership and integration boundaries lie. It is a living operational asset, not a prose tour or a substitute for repository instructions.
## Scope and authority
Default to read-only discovery. Define target revision, audience, output path, time budget, and exclusions before inspection. Do not modify application code, install arbitrary dependencies, run production commands, expose secrets, or infer undocumented permissions. Documentation edits require an authorized path and a reviewable diff.
## Step 1: gather facts
Inspect repository instructions, branch/status, top-level structure, manifests, build/test/lint configuration, CI workflows, deployment descriptors, ownership files, and recent history. Record exact revision and tool versions. Inventory:
- languages, frameworks, runtimes, package managers, and generated artifacts;
- entry points, service/module boundaries, public interfaces, storage, queues, and external integrations;
- configuration and environment variables by sensitivity (names only for secrets);
- setup, build, test, lint, debug, release, and rollback commands;
- key directories/files a contributor should read first;
- architectural decisions, compatibility constraints, and known hotspots;
- owners, contributi