tegwick
36d8d3a73f
Demo schema exercises amount and one-of; capture-state validates options; proposal marked accepted; workplan finished.
3.3 KiB
MVP Workplans
MVP workplans for the citation-evidence umbrella repo. CE-WP-0001..0006 delivered the PRD §20 reference scenario and Forms/Review UX polish. CE-WP-0007 delivered Capture-view polish including field add/edit UX. CE-WP-0008 fixes capture field value persistence and viewport scroll reliability.
| Workplan | Title | Status |
|---|---|---|
CE-WP-0001 |
Foundations — scaffold, folders, lint rules, normalize, fixtures | done |
CE-WP-0002 |
PDF review slice — engine types, anchor, source, viewer, sidebar | done |
CE-WP-0003 |
Form binding + visual guide — EvidenceLink, rect registry, overlay | done |
CE-WP-0004 |
Citation card export — Markdown + HTML renderers, sidebar export | done |
CE-WP-0005 |
Demo sessions — uploads, named sessions, ZIP export/import | done |
CE-WP-0006 |
Forms & review UX refinements — blob fix, scroll centre, linking | done |
CE-WP-0007 |
Capture view polish — scroll, linking, layout, rename, field UX | done |
CE-WP-0008 |
Capture content editing & viewport scroll reliability | done |
Post-MVP — extraction and distribution
| Workplan | Repo | Title | Status |
|---|---|---|---|
CENG-WP-0001 |
citation-engine | Extract engine from umbrella | done |
CE-WP-0009 |
citation-evidence | Wire umbrella to @citation-evidence/engine |
done |
CENG-WP-0002 |
citation-engine | Package distribution (ADR-0002, publish prep) | done |
CE-WP-0009 depends on CENG-WP-0001. CENG-WP-0002 can run in parallel;
publish tasks wait on ADR-0002 resolution.
Post-MVP — shell UX
| Workplan | Title | Status |
|---|---|---|
CE-WP-0010 |
Annotate & Attributes UX — labels, filters, layout, evidence connectors | finished |
CE-WP-0011 |
Attributes guide n:m lines, title migration, Add attribute placement | finished |
CE-WP-0012 |
Attribute value types — time, datetime, amount, one-of, some-of | finished |
User-facing polish after manual document review: rename Review→Annotate, keep
Evidence column in Capture with Attributes on the right, list filters, and
card→citation connector lines. CE-WP-0011 adds n:m attribute↔evidence guides.
CE-WP-0012 extends attribute types; canon ownership tracked as ITC-WP-0013
(see wiki/AttributeValueTypes-proposal.md).
Order
CE-WP-0001..0004 are strictly sequential. CE-WP-0005 depends on 0004. CE-WP-0006 depends on 0005. CE-WP-0007 depends on 0006. CE-WP-0008 depends on 0007:
/ralph-workplan workplans/CE-WP-0008-capture-content-editing.md
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