discover-repository-statelisted
Install: claude install-skill gtrabanco/agentic-workflow
# Discover Repository State
Create a reviewable evidence snapshot before planning or implementation.
## Turn contract
```
✓ Repository evidence was read or commands were run for every fact
✓ Facts, documentation, planned work, decisions, and inference are separated
✓ Snapshot status is frozen unless a contradiction was recorded
✓ No accepted decision or existing frozen fact was silently changed
✓ The closing → Next: block is printed last
```
## Step 0 — Discover the project (always first)
Read the agent guide, documentation map, and any existing repository-state
ledger before collecting evidence.
## Process
1. Read the project guide, documentation map, and any existing
`docs/workflow/REPOSITORY_STATE.md`.
2. Inspect repository files, tests, git state, and declared tooling. Record only
directly observed statements in **Repository Facts**, each with file:line or
command evidence.
3. Record design records under **Accepted Decisions**, roadmap entries under
**Planned work**, and document-only claims under **Documentation**. Do not
copy them into facts without separate implementation evidence.
4. Place reasoning under **Inference** and unresolved ambiguity under **Open
Questions**.
5. If the existing snapshot is already `contradicted`, preserve that status and
do not alter its unresolved contradiction; hand off to
`resolve-repository-state`. Otherwise, if new evidence conflicts with a
frozen fact, append a **Contradiction**, set snapshot status to