project-discovery

## Project Context - Default branch: !`git symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null || echo unknown` - AGENTS.md: !`find . -maxdepth 1 -name "AGENTS.md" -type f` - CLAUDE.md: !`find . -maxdepth 1 -name "CLAUDE.md" -type f` - README: !`find . -maxdepth 1 -name "README*" -type f` # Project Discovery This skill discovers the project's core attributes and writes them as a concise `## Project Discovery` section **directly into the project's AGENTS.md or CLAUDE.md** — not a separate file. The output is small by design: a few notes on where things live, the languages and frameworks, and the commands to run, so an AI agent working in the repo can find its way around. It is not an exhaustive inventory. ## Step 1: Choose and read the target file Pick the single file this discovery is written into, by priority: 1. If **AGENTS.md** exists (the label above is non-empty), the target is AGENTS.md. 2. Otherwise, if **CLAUDE.md** exists, the target is CLAUDE.md. 3. If neither exists, the target is a new **CLAUDE.md** at the repository root, which you will create in Step 4. If the target file already exists, read it in full and build the **deduplication baseline**: a list of everything the file already documents that this skill would otherwise write — directory and folder locations, languages, frameworks, package manager, build/test/lint/dev commands, and the docs, ADR, and coding-standards directories. Note whether the file already has a `## Project Discovery` section....