Skip to main content

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.