coulomb/evidence-binder
2
0
Fork 0
generated from coulomb/repo-seed
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Add MVP Coordination section: code lives in citation-evidence umbrella during MVP

Browse Source 
Documents the umbrella-first MVP decision (2026-05-24). This repo remains
INTENT-only until the binding model and rect-registry contract stabilize
through real product use. Reconciles relation vocabulary against umbrella
SharedContracts §2.5: derived-from dropped as domain-specific; needs-check
moved onto EvidenceLink.status. Reaffirms: binder depends on engine + anchor,
not on source or work.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
Bernd Worsch
2026-05-24 16:51:11 +02:00
parent 56e29ae1bf
commit 7445626c76
1 changed files with 34 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
INTENT.md
View File

@@ -454,6 +454,40 @@ 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/binder/`.
This INTENT.md documents the *intended* responsibilities and boundaries.
When the binding model and visual-guide rect-registry contract have stabilized
through actual MVP use, the corresponding code extracts into this repository.
**Shared contracts** (EvidenceLink.status enum, EvidenceLink.relation enum,
EvidenceSet shape, rect registry contract, 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. The
target-evidence-state vocabulary in the original INTENT
(`no-evidence|candidate|confirmed|conflicting|insufficient|verified`) is now
canonical in `SharedContracts.md` §2.4. The relation vocabulary
(`supports|contradicts|explains|qualifies|source-for|context-for`) is now
canonical in `SharedContracts.md` §2.5; `derived-from` and `needs-check`
were dropped — `derived-from` is a domain-specific extension, `needs-check`
belongs on link status.
Under the dependency map, **`evidence-binder` may depend on `citation-engine`
and `evidence-anchor`** — but NOT on `evidence-source` or `citation-work`.
When the binder needs source context, it asks `evidence-anchor` to resolve
the annotation.
---
## Guiding Statement
**evidence-binder exists to connect cited evidence to the structured things it supports.**