Skip to content

docs(agreement-quarter): walkthrough page for the Agreement 1.0 template proposal - #530

Draft
mttrbrts wants to merge 6 commits into
claude/template-nested-payment-migration-00l9atfrom
claude/agreement-quarter-page
Draft

mttrbrts wants to merge 6 commits into
claude/template-nested-payment-migration-00l9atfrom
claude/agreement-quarter-page

Conversation

@mttrbrts

@mttrbrts mttrbrts commented Oct 1, 2026 •

Copy link
Copy Markdown
Member

A walkthrough page for the proposal prototyped in #528: what changes for templates, and what they gain. It's stacked on #528's branch, so this diff shows only the page.

Changes

  • docs/agreement-quarter/index.html: an Inns of Court walk through the proposal.
    • Ten stops:
      • Models 1.0
      • one tree of documents and clauses
      • one state index
      • handlers instead of a switch
      • self and read-only views
      • transactions
      • type factories
      • obligations
      • testing
      • deployment
    • Each stop has:
      • a headline;
      • what template authors change and what they get;
      • the shape in code, with notes on each part;
      • the commit or PR behind it;
      • a worked example (before/after code, or numbered steps).
    • The page closes with a migration checklist, a roll of every change by kind (models#200, proposed, engine, template), and what isn't possible yet.
    • Static apart from a Directory that tracks the current stop. Light and dark themes; works down to phone width.
  • docs/agreement-quarter/images/: twelve plates, generated from scenes.json with Gemini 2.5 Flash Image ("Nano Banana") through nano-banana-mcp, at 16:9, saved as WebP (about 3.7MB in total). A plate without an image shows a numbered placeholder.
  • docs/agreement-quarter/README.md: how the plates were made.

Flags

Screenshots or Video

Rendered copy: https://claude.ai/artifact/2fHENfTDVaY255kord8vkk (private to the author).

Related Issues

Author Checklist

  • Ensure you provide a DCO sign-off for your commits using the --signoff option of git commit.
  • Vital features and changes captured in unit and/or integration tests
  • Commits messages follow AP format
  • Extend the documentation, if necessary
  • Merging to master from fork:branchname

🤖 Generated with Claude Code

https://claude.ai/code/session_011LWZaJoaq9HFMVceNxCXMS

claude added 5 commits October 1, 2026 10:14
…gh page

Twelve illustration prompts, one per stop on the Inns of Court walk
through the copyright-license-agreement-poc proposal, in one shared
engraving style, for generating the page's plates with an image model.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011LWZaJoaq9HFMVceNxCXMS
Signed-off-by: Claude <noreply@anthropic.com>
…ates

An Inns of Court walk through the Agreement 1.0 template proposal
prototyped in src/copyright-license-agreement-poc. There are ten stops
(models, the document tree, the state index, handlers, self,
transactions, factories, obligations, testing and deployment). Each
gives what template authors change, what they get, the shape, receipts
and a worked example. A migration checklist, a roll of every change and
what isn't possible yet close the page.

The twelve plates were generated from scenes.json with Gemini 2.5 Flash
Image through nano-banana-mcp, at 16:9, and saved as WebP. A plate
without an image shows a numbered placeholder.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011LWZaJoaq9HFMVceNxCXMS
Signed-off-by: Claude <noreply@anthropic.com>
Make the recurring barrister a Black woman, and redraw the Gatehouse,
Conveyancer's, Strongroom, Library, Seal Office, Moot and Roll plates
with her, keeping each scene's style and composition (edited from the
originals, not regenerated). scenes.json records the cast for the plates
still to be redrawn.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011LWZaJoaq9HFMVceNxCXMS
Signed-off-by: Claude <noreply@anthropic.com>
Redraw the Registry, Clerks' Windows, Chancery, Recorder and Porters'
Lodge plates with the Black woman barrister and a mixed cast, keeping
each scene's style and composition. Give her a barrister's wig in the
Moot, the one scene in court dress. The registrar and porters were
edited with Gemini 3 Pro Image, as the earlier model left them
unchanged. The README and scenes.json record the cast.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011LWZaJoaq9HFMVceNxCXMS
Signed-off-by: Claude <noreply@anthropic.com>
…lates

The Registry edit had given the barrister a beard; she now has her own
face again. In the Moot her hands were drawn pale; they now match her
skin.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011LWZaJoaq9HFMVceNxCXMS
Signed-off-by: Claude <noreply@anthropic.com>
The composition proposal now lives in models#205's 1.0.0 namespaces,
the logic API in template-engine#187, and cicero-core support in
template-archive#946 and #950, with the example split into three
sibling templates. Update the shapes, $class values, receipts, the
Roll and the limitations to match, and drop the runtime/*.ts and
prototype-engine references.

Signed-off-by: Claude <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011LWZaJoaq9HFMVceNxCXMS
@github-actions

Copy link
Copy Markdown

This PR is stale because it has been open with no activity. Remove the stale label or comment to keep it active. Only items with maintainer engagement are auto-closed.

@github-actions github-actions Bot added the Stale label Oct 17, 2026

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants