Discover project
Run this before substantial work if you have not already grounded in the repo.
For first-time runnable setup (install deps, .env, DB), use
onboard after this pass.
Inspect (in order)
- Root manifests —
package.json,pyproject.toml,Cargo.toml,go.mod, etc. - Monorepo —
pnpm-workspace.yaml,turbo.json,nx.json,lerna.json,go.work - README / AGENTS.md / CLAUDE.md / CONTRIBUTING — conventions and gotchas
- Cursor / agent config —
.cursor/rules/,.cursor/mcp.json, projectAGENTS.md; user skills in~/.cursor/skills/(or%USERPROFILE%\.cursor\skills\on Windows) - CI —
.github/workflows/, or equivalent - Source layout — where apps, libs, tests, and configs live
- Env —
.env.example, required secrets (never commit values)
Report briefly
- Stack — language, framework, package manager
- Run — dev server, build, lint, typecheck, test commands (from scripts or docs)
- Test — unit / integration / e2e locations and how to run them
- Data — DB, APIs, external services (client vs server boundaries)
- Rules — project-specific agent rules, skills, or command folders
- Blockers — anything that prevents
devortestlocally (missing env, Docker, native tools)
Do not
- Assume framework version from training data — read the repo
- Invent scripts that are not in
package.jsonor docs - Skip reading agent instruction files if they exist
Related skills
- onboard — make the project runnable locally
- plan — design after discovery
- plan-driven-implementation — execute approved
docs/plans/*.mdwith living progress/issues logs - audit — deep feature completeness vs spec