Skip to content

[DO NOT MERGE] Architecture + memory-benchmark deck (Marp) - #25

Draft
FBumann wants to merge 2 commits into
mainfrom
docs/architecture-deck
Draft

[DO NOT MERGE] Architecture + memory-benchmark deck (Marp)#25
FBumann wants to merge 2 commits into
mainfrom
docs/architecture-deck

Conversation

@FBumann

@FBumann FBumann commented Jul 24, 2026

Copy link
Copy Markdown
Owner

⚠️ DO NOT MERGE — draft / preview only. Opened to share and review the
presentation, not to land it. Do not merge without an explicit go-ahead.

A compact three-slide Marp deck (plain markdown in docs/, editable and
git-tracked; renders to slides/PDF/HTML with marp docs/relational.md):

  1. What is the problem? — imperative, solver-coupled, dense build → O(dense dim product) memory.
  2. What we built (MVP) — YAML → typed AST → two differential-tested backends, with the flat-memory benchmark (13.6× lower peak RSS, flat in model size, 107M vars @ 0.57 GB).
  3. The architecture — the typed AST as the narrow waist (issue Architecture: the typed AST is the narrow waist (producers / consumers / transformers) #21): one portable, solver-agnostic model with N backends + M renderers/analyzers/transformers. Built already spans 3 of the 4 consumer families (backends, transformers incl. macros + piecewise expansion, the router).

Notes for reviewers

🤖 Generated with Claude Code

FBumann and others added 2 commits July 24, 2026 18:21
Three-slide scrollytelling deck (problem / MVP / narrow-waist architecture)
built from SPEC §12 and issue #21, with the peak-RSS benchmark as an editable
SVG. Rendered .html/.pdf are gitignored; sources (.md + .svg) are tracked.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
macros/named expressions, piecewise-to-aux-var expansion, and the router have
all landed and read the same AST as the two backends — so built now spans 3 of
the 4 consumer families, not just backends. Add the macros transformer (was
missing) and reorder columns so the built families lead.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Jul 24, 2026

Copy link
Copy Markdown

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 8c80deee-45f3-48e7-821a-6657b66a99ad

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/architecture-deck

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@FBumann FBumann added the area:docs SPEC, ARCHITECTURE, ROADMAP, GLOSSARY, README label Jul 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:docs SPEC, ARCHITECTURE, ROADMAP, GLOSSARY, README

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant