Files
citation-evidence/workplans
tegwick 707620adfb Wire workplans to state-hub: topic, 4 workstreams, 29 tasks (UUIDs in frontmatter + task blocks)
Created topic citation_evidence_mvp (96fa8e80-…) and one workstream per
workplan under the citation-evidence repo. Created one state-hub task per
task block. All UUIDs now recorded in workplan frontmatter
(state_hub_workstream_id) and per task block (state_hub_task_id) so ralph
can call update_task_status against them on first run.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-24 17:07:58 +02:00
..

MVP Workplans

These four workplans implement the first reference scenario from wiki/ProductRequirementsDocument.md §20 — end-to-end PDF evidence capture → form binding → citation card export — entirely inside the citation-evidence repository.

Workplan Title Status
CE-WP-0001 Foundations — scaffold, folders, lint rules, normalize, fixtures todo
CE-WP-0002 PDF review slice — engine types, anchor, source, viewer, sidebar todo
CE-WP-0003 Form binding + visual guide — EvidenceLink, rect registry, overlay todo
CE-WP-0004 Citation card export — Markdown + HTML renderers, sidebar export todo

Order

Strictly sequential. CE-WP-0002 depends on the folder/lint scaffolding from CE-WP-0001. CE-WP-0003 and CE-WP-0004 depend on the engine types, viewer adapter, and sidebar from CE-WP-0002.

How to run a workplan

/ralph-workplan workplans/CE-WP-0001-foundations.md

Ralph drives the loop and retires automatically when all tasks in the workplan are marked done. See ~/.claude/plugins/ralph-workplan/ralph-workplan.md.

Acceptance for MVP

The first reference scenario from PRD §20 runs end-to-end:

  1. Create a collection
  2. Upload a PDF
  3. Select a passage, add commentary, create an evidence item
  4. Open a side-by-side form
  5. Link the evidence item to a form field
  6. Focus the field → field, evidence card, and PDF passage all highlighted
  7. SVG guide visible between field → card → highlight
  8. Export evidence as a Markdown citation card