AGENTS.md@docs/operational/troubleshooting git:20260317.1cc241dA

Immutable. This exact content is served forever at /api/v1/blob/4bb478fe59815a06.

## docs/operational/troubleshooting/ — Troubleshooting

### Scope

Diagnosis and recovery guides for common failures:

- Environment setup issues (pandoc/LaTeX/Python)
- Test failures and coverage thresholds
- Pipeline stage failures and recovery
- LLM/Ollama troubleshooting (optional stages)

### Files

| File | Purpose |
| --- | --- |
| `README.md` | Troubleshooting entry point and flow |
| `common-errors.md` | Known error patterns and fixes |
| `build-tools.md` | Tooling failures (pandoc/LaTeX) |
| `test-failures.md` | Debugging failing tests |
| `environment-setup.md` | Setup and dependency issues |
| `recovery-procedures.md` | Recovery steps after partial runs |
| `llm-review.md` | LLM review troubleshooting |
| `llm-diagnostics.md` | LLM diagnostics and symptoms |

### See also

- [`docs/RUN_GUIDE.md`](../../RUN_GUIDE.md)
- [`docs/operational/config/checkpoint-resume.md`](../config/checkpoint-resume.md)