Skip to content

Work / Chitragupt / Wiki / Decisions

2026-10-23-source-of-truth-lives-in-the-wiki

Decisioncanonicalverified 2026-10-23

DECISION.2026-10-23.SOURCE-OF-TRUTH-LIVES-IN-THE-WIKI

Source of truth is the wiki, not six root files

Decision

The six root files (SPEC, CATALOG, SCREENS, FLOWS, ROADMAP, DECISIONS) no longer exist. Their content lives in .context/wiki/ (entities, surfaces, flows, decisions) and .context/features/index.md. CLAUDE.md and .claude/rules/source-of-truth.md still require reading the wiki before a non-trivial change.

Why

One folder with a schema and lint is easier to keep true than six loose files. The original goal, stopping decisions from leaking into chat, is kept by logging every decision as an ADR.

Impact

Status

Active. Replaces 2026-05-30-pdlc-scaffold-adopted.

Sources

  • Repo root listing (no SPEC/CATALOG/SCREENS/FLOWS/ROADMAP/DECISIONS files)
  • .claude/rules/source-of-truth.md