project-onboarding

When starting work on a new codebase, the agent has zero context. This leads to hallucinated conventions, ignored project patterns, and wasted turns re-explaining the stack. This skill crawls a target directory, infers everything it can automatically, and generates a structured PROJECT.md that the agent loads for all future work on that project.

When to invoke

Invoke this skill when:

• Starting work on a codebase for the first time
• The agent begins making assumption errors about the project structure
• A new team member (agent) is added to an existing project

Onboarding protocol

Step 1 — Crawl the directory Scan the project root for:

• package.json, pyproject.toml, Cargo.toml, go.mod, pom.xml, etc. → infer tech stack
• Makefile, justfile, scripts/ → infer build/test commands
• .github/workflows/ → CI commands and quality gates
• Test file patterns (__tests__/, spec/, *_test.go) → testing conventions