discoverlisted
Install: claude install-skill rterakedis/leanwheel-skills
# Discover Skill
**Goal:** Produce `docs/prd.md`, `docs/architecture.md`, `CLAUDE.md` from existing codebase.
**Brownfield:** PRD documents current state (FRs = existing behavior). Plan new work via `/epics` or `/quick-dev`.
## Activation
Scan project root. Read key files silently: README, package.json (or equiv), config, Makefile/docker-compose, existing docs/, CLAUDE.md.
Greet: "I see {language/framework}. Found {key files}. Need questions then generate docs."
## Phase 1 — Product Interview
Five questions, one at a time:
1. What does this product do? (problem, users, main capabilities)
2. Current state? (production/dev, completeness)
3. Explicitly out of scope? (Non-Goals)
4. Non-obvious architectural decisions? (why certain choices, unusual patterns)
5. Common mistakes or footguns? (past bugs, patterns that look right but break)
## Phase 2 — Codebase Analysis
**Tech stack:** language, runtime, framework, libs, database, auth, testing, build/deploy.
**Folder structure:** top-level layout, features/modules, tests.
**Patterns:** naming, feature structure, error handling, test approach, standard imports/utilities.
**Current capabilities:** routes/endpoints, data model, integrations.
## Phase 3 — Write `docs/architecture.md`
Use `skills/spec/architecture-template.md`. Fill from Phase 2 + interview. Priority: Tech Stack (exact versions), Folder Structure (annotated), Key Patterns (especially from Q4), Testing Strategy.
Write to `docs/architecture.md`.
## Phase 4 —