tegwick
a65acc5bf8
Capture locked shell UX requirements from manual document review: Annotate label, Attributes terminology, list filters, Capture four-column layout, and evidence-to-citation connector lines.
69 lines
2.9 KiB
Markdown
69 lines
2.9 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 | proposed |
|
|
|
|
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. See `workplans/CE-WP-0010-annotate-attributes-ux.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
|