ADR-008: Build-Time/CI-Time AI over Runtime AI
- Status: Accepted
- Date: 2026-08-12
Context & Problem Statement
Integrating live conversational AI chat widgets on documentation websites creates non-deterministic reader experiences, high API token costs, latency spikes, and real-time prompt injection vulnerabilities.
Decision
Confine all AI generation to Build-Time / CI-Time:
- AI processes canonical evidence and produces static Markdown/MDX or structured JSON during offline CLI runs or CI pipelines.
- The published site renders pre-computed, human-reviewed static artifacts.
- Readers experience zero-latency static page loads with 100% deterministic content.