diff --git a/INTENT.md b/INTENT.md index 25d852f..f928710 100644 --- a/INTENT.md +++ b/INTENT.md @@ -318,6 +318,32 @@ This repository should be: --- +## MVP Coordination — Code Lives Upstream + +During the umbrella-first MVP phase (decided 2026-05-24), **the source code +for this subsystem does not live in this repository yet**. It lives in the +umbrella repo at `citation-evidence/src/engine/` and `citation-evidence/src/shared/`. + +This INTENT.md documents the *intended* responsibilities and boundaries. +When the engine's interfaces have stabilized through actual MVP use, the +corresponding code extracts into this repository. + +**Shared contracts** (vocabulary, state enums, relation types, selector +taxonomy, event types, viewer adapter, canonical text normalization, allowed +dependency edges) are maintained in the umbrella repo: + +* `citation-evidence/wiki/SharedContracts.md` +* `citation-evidence/wiki/DependencyMap.md` +* `citation-evidence/docs/decisions/` (ADRs) + +This subsystem's eventual code must not contradict those documents. Changes +to shared contracts happen in the umbrella, not here. + +Under the dependency map, **`citation-engine` is the leaf node** — it depends +on none of the other subsystems. Every other subsystem depends on it. + +--- + ## Guiding Statement **citation-engine exists to make evidence-backed citations a stable, reusable, and portable domain model.**