ADR-002: Documentation First

Status: Accepted
Date: 2026-06-28
Deciders: Platform Architect
Last updated: 2026-07-05

Context

AI-assisted engineering fails when IDE rules duplicate or contradict canonical documentation.

Decision

Documentation First is a permanent platform invariant:

Platform specs in PL-001 docs/ are canonical authority for engineering truth
Adapter workspace files are mirrors — they implement, never redefine
Conflict resolution: documentation → adapter → chat history
Products extend via registry only — not by editing vendored platform docs

This knowledge base (docs/INDEX.md) is the enterprise navigation root.

Consequences

Positive: Multi-year stability, CI-detectable drift, clear onboarding.
Negative: Documentation phases required for behavioral changes.

Breadcrumbs: Home → ADR → ADR-002