content-explorer/workplans/WP-01.md
2026-10-12 18:28:16 +02:00

1.3 KiB

WP-01 — Canonical contracts & 2-domain fixtures

Purpose: Establish source-independent knowledge projection and the zero-UI-code-change experiment.

Dependencies: see INDEX.md. Status: planned. Owner: to assign. Estimate: to refine after WP-00.

Work packages

  • Freeze v0.1 snapshot schema and manifest schema; document migrations.
  • Model entity IDs, kinds, directed relations, evidence and claims in TS/Zod.
  • Normalize systems-thinking and software-architecture fixtures with independently authored prose.
  • Write duplicate, dangling, cyclic non-taxonomy and missing-source tests.
  • Define policy for unknown and conflicting facts.

Acceptance gates

  • Both fixtures validate and supply ≥3 kinds and ≥8 entities each.
  • A shared renderer can switch manifests with no domain vocabulary in UI source.
  • Snapshot format documented and versioned.

Key risk / mitigation focus

R3: abstractions erase domain semantics. Log evidence and deviations in the workplan review before marking complete.

Evidence artifacts

Pull requests, test logs, pinned artifacts, screenshots or comparison report where applicable. Add explicit ImplementationNotes.md and Review.md on completion; do not mark a gate passed without a verifiable link.