generated from coulomb/repo-seed
tegwick
d06a456c2a
- INTENT.md: declare umbrella as the home for shared contracts; document umbrella-first MVP decision (code lives here until subsystems stabilize) - wiki/SharedContracts.md: vocabulary, state enums, relation types, selector taxonomy, event vocabulary, viewer adapter contract, canonical text normalization, rect-registry contract - wiki/DependencyMap.md: allowed dependency edges; folder layout + lint-rule strategy during umbrella-first phase - history/2026-05-24-initial-assessment.md: alignment review, technical risks, and the umbrella-first pivot rationale - workplans/CE-WP-0001..0004: four ralph-compatible workplans covering foundations, PDF review slice, form binding + visual guide, and citation card export — implementing PRD §20 end-to-end Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
1.6 KiB
1.6 KiB
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:
- Create a collection
- Upload a PDF
- Select a passage, add commentary, create an evidence item
- Open a side-by-side form
- Link the evidence item to a form field
- Focus the field → field, evidence card, and PDF passage all highlighted
- SVG guide visible between field → card → highlight
- Export evidence as a Markdown citation card