Source of truth — for the cross-subproject contract. This document is the canonical artefact for the person entity as a whole: how the trio composes (front-end → service REST API → embedded matcher), the DTO contract between service and matcher, shared invariants, and entity-wide goals. Each subproject's own
spec/remains the single source of truth for that subproject's internals. When this spec and a crate spec disagree about crate internals, the crate spec wins; when they disagree about the integration contract, this spec wins. Open a task in §13 to bring the loser in line — do not silently rewrite either spec.Three-part PRs. A behavioural change is one PR: spec edit + code edit + test edit. See
AGENTS/spec-driven-development.md.
Subproject specs:
- person-service-with-loco/spec — registry service (§1–§18)
- person-matcher-rust-crate/spec — matching library (§1–§25)
- person-front-end-with-svelte/spec — operator UI (§1–§18)
For shared infrastructure (technology stack, observability,
compliance), see the project-root AGENTS.md and
agents/share/*. For entity-level agent
reference (subproject map, models, matching, REST, testing), see
AGENTS/.