Paper Legal Token Map
Paper Legal — component taxonomy rationale
Why this component exists
Every prior legal-document component in this vault (legal-agency-suite,
legal-prospectus, legal-subscription-agreement) is a concrete register:
real CSS backing a specific document type, built from a specific source draft.
None of them separately captures the drafting convention — heading form,
numbering scheme, cross-reference grammar — as a reusable rule set that
downstream authors (human or AI) can apply to a new document type without
re-deriving it from scratch or copying an existing register that may not
actually fit.
paper-legal is the first component built specifically to hold that
convention layer. It was requested by project-documents after a blind
two-reviewer (Opus + Fable) research pass grounded in filed-exhibit evidence
(EDGAR full-text search) and standard drafting-style authorities (Adams/MSCD,
Weagree, Canada Justice Legistics, US House Manual on Drafting Style),
cross-checked against a real pilot document (the Master Engagement Agreement,
JW8/JW9).
Key findings from this session's build
- The 5-category split is evidence-backed, not house style. The
commercial-vs-constitutional heading split (flat
Sectionvs.ARTICLE) maps cleanly onto a real, observable pattern in filed agency/underwriting agreements vs. filed shareholder/LP agreements — see the citations list in the recipe and usage.md. This is a genuine reason to keep them as separate variants rather than collapsing to one generic "legal document" heading rule. - Real naming collision found, not silently resolved. project-documents'
own request refers to their local
templates/legal-agreement.cssas the Constitutional/Shareholder-Agreement base. This vault already haspaper.semantic.legal-agreement.*tokens — but they back the unrelatedlegal-subscription-agreementcomponent (accredited-investor fill-in booklets). Same name, two different document families, two different archives' independent naming choices colliding by coincidence. This component'sconstitutional-agreementvariant deliberately does not bind to the pre-existinglegal-agreement.*tokens for this reason — seeoq-1on the recipe. - Two real overlaps with
legal-agency-suite, flagged not merged. That component'sschedule-covervariant and itsproposal-letter/mou-engagement-lettervariants cover essentially the same ground as this component'sschedule-exhibitandlettervariants. Both components are now live with overlapping scope — this needs a reconciliation decision (which register is authoritative, or do they merge) that neither this session nor project-documents' original request resolved. Recorded asoq-2/oq-3. - Most token values are provisional by design, not by omission.
project-documents' own request explicitly defers CSS delivery ("Commercial
first, from JW9... [others] to follow as we work each type"). This
component's
paper.semantic.paper-legal.*DTCG tokens therefore only bind the one thing stated with confidence (Tinos font family) plus generic rule weights already proven safe to reuse across the Paper pillar; every variant's heading-form/numbering/cross-ref rule lives instead in the separatepaper-legal-conventionsblock, which is deliberately non-DTCG-typed string data (mirroring the existingnumber-formatblock's own precedent for the same kind of non-measurement convention data). preliminary-instrumentis genuinely new ground. Unlike the other four variants, no existing component in this vault covers MOU/LOI/term-sheet documents at all — no reconciliation question needed there.
What a downstream consumer should do
- Classify the document into one of the 5 categories using the recipe's
variantsarray descriptions. - Pull that category's heading-form / article-word / cross-ref-capitalization
rule from
paper.semantic.paper-legal-conventions.<variant>. - Apply the 9 family-wide drafting rules
(
paper.semantic.paper-legal-conventions.drafting-rules-family-wide) regardless of category. - For CSS: check whether project-documents has delivered the category's
templates/<name>.cssyet (only commercial-agreement is in progress as of this writing); if not, the convention rules above still apply even before CSS exists — draft to the rule, not to a stylesheet that doesn't exist yet. - If the category is
schedule-exhibitorletter, also checklegal-agency-suite'sschedule-cover/proposal-letter/mou-engagement-lettervariants before building anything net-new — the overlap is unresolved, and building against both independently would create a third, worse inconsistency.
Important Information
Design System disclosure
This site provides open-source design tokens, documentation, and self-hostable software published by Woodfine Capital Projects Inc. Information here is for general reference only and does not constitute an offer, warranty, or a guarantee of fitness for any particular purpose. Statements regarding planned, intended, or targeted future features are forward-looking and subject to change without notice; they are not undertaken to be updated except as required by law.