Skip to content
PETROVA

shared/navigation-index

Where to look when stuck

Section titled “Where to look when stuck”

Standard navigation cheatsheet. Identical across petrova-line repos.

  • “What’s the current phase / what should I work on?” → MILESTONES.md § “Active phase”.
  • “Who handles this kind of task?” → AGENTS.xml.
  • “Why was X done this way?” → docs/decisions/ (search by date or slug).
  • “What broke last time we tried Y?” → docs/findings/.
  • “How do I run / deploy / debug Z?” → docs/runbooks/.
  • “Is this idea in scope?” → docs/north-star/intent.md then docs/backlog/.
  • “What’s the cross-cutting rule for this?” → docs/META-RULES.md (MR-N) or this repo’s CLAUDE.md § “Invariants” (I-N).
  • “What’s the convention for this kind of edit?” → CLAUDE.md § “Conventions specific to this repo” first; falls through to the shared conventions.md (referenced from CLAUDE.md).
  • “Who else uses this surface?” → grep, then check docs/spec/ for the contract.