citation-evidence/docs/mvp-workplans-index.md
tegwick 36d8d3a73f
All checks were successful
CI Smoke / host-smoke (push) Successful in 0s
CI Smoke / container-smoke (push) Successful in 1s
Implement CE-WP-0012 attribute types; freeze accepted catalog defaults.
Demo schema exercises amount and one-of; capture-state validates options;
proposal marked accepted; workplan finished.
2026-07-30 21:05:44 +02:00

73 lines
3.3 KiB
Markdown

# 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:
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