Documentation

This repo uses a modified Diátaxis documentation structure:

• Getting Started (tutorials) — install, run, and see value fast
• How-to / Developer Guides — accomplish specific tasks (testing, configuration, extending)
• Reference — precise, factual surfaces (CLI flags, env vars, schemas)
• Explanation / Architecture — why the system is structured the way it is

Design history and engineering process docs (specs, ADRs, debt, bugs) are kept, but are not the primary onboarding path.

Getting Started

• Quickstart
• Common Usage

Developer Guides

• Configuration (env vars, paths, caches)
• Testing
• E2E Testing
• CLI Reference (generated)
• PDF Conversion (optional [pdf] extra)

Architecture

• Overview
• CLI Design
• Data Pipeline
• RAG System

Project & Process Docs

Category	Index	Next ID
Specs	Design specs + roadmap (mostly archived)	SPEC-036
ADRs	Architecture decision records	ADR-004
Bugs	Bug reports & adversarial reviews	BUG-039
Debt	Technical debt tracking	DEBT-108
Vendor Docs	External API notes	—
Ralph Wiggum Protocol	Autonomous sprint loop	—
Archive	Completed specs, bugs, debt, and process docs	—

Master Documents

• Master Vision — long-range architecture and roadmap
• Master Qualifications — scope and requirements

Future / Brainstorming

• Future Ideations
• Research State Management (v3)

Numbering Convention (Process Docs)

• Specs: Sequential, permanent (SPEC-001, SPEC-002, …)
• Bugs: Sequential (BUG-001, BUG-002, …)
• Debt: Sequential (DEBT-001, DEBT-002, …)

Numbers are never reused. Each category README is the SSOT for that category.