Troubleshooting index

Match the symptom, open one page. These are the same lessons as .pipeline/wiki/ with human titles.

Symptom	Page
Tracker key ran the text ladder, or a bug went through PM/BA	Tracker intake
Next Task prompt is huge; prior HANDOFF pasted	Slim handoffs
Missing HANDOFF; parent thinks the agent stopped	Interrupted Task
Port in use; second process; secret in HANDOFF	Deploy listeners
Grep misses visible UI copy	UI copy split
Hooks never fire; double deny with a portal	IDE hooks
Pipeline declared complete after health; retro invents chat	Retro
Tester wrote markdown only; devops before e2e	Test layers
Empty ledger; no Langfuse trace	Observability

Change-class and planning mistakes are covered in Workflows and Planning gates.