generated from coulomb/repo-seed
tegwick
2f25f99cae
T01 Toolchain — vite + pnpm 9.15 + React 18 + strict TS (ADR-0001).
T02 Folder layout — src/{shared,engine,anchor,source,binder,work,app}/
mirroring the future subsystem split, with path aliases.
T03 Boundary lint — eslint-plugin-boundaries enforcing the dependency
edges from wiki/DependencyMap.md §4; verified by a violating fixture.
T04 Canonical normalization v1 — src/shared/text/normalize.ts with
NORMALIZE_VERSION=1; 10/10 vitest covering ligatures, CRLF, soft
hyphens (including line-break reassembly), mixed whitespace.
T05 PDF fixture corpus — 7 user-supplied German PDFs in fixtures/pdfs/
(gitignored binaries) plus a manifest with verbatim known-good
quotes and page counts, ready for CE-WP-0002 selector tests.
T06 README upgrade — umbrella README points at wiki/docs/workplans
and documents the dev workflow.
T07 ADR-0002..0006 stubs in docs/decisions/.
Toolchain end-to-end: pnpm install + lint + typecheck + test all green.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
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