Documentation

The project, read from its own margins.

Marginalia is an open-source clone of Gemini Notebook (formerly NotebookLM): upload sources, chat with an AI that answers only from them, and follow every claim back to the cited passage. It is built in public, one reviewed session at a time — and this site is where the project documents itself.

Nothing here is written twice. Every page is rendered directly from the markdown files in the repository’s product/ and handovers/ directories, which stay the single source of truth.

Where to start

New to the project? Read the scope for the what, the feasibility study for the how, the roadmap for the when — and the session log for how it actually went.

Quick answers

product/faq.md

In a hurry? The FAQ answers the questions reviewers ask first — why Scaleway and not AWS, whether citations can be faked, what it costs — in a few sentences each, every answer linking into the document that carries the full story.

Product scope
product/scope.md
Every feature of the real Gemini Notebook, catalogued and sorted into build phases. Phase 1 — the grounded-chat core loop — is the current target.
UI research
product/ui-research.md
A top-down decomposition of the real product's interface, screen by screen, with implications for the clone.
Feasibility study
product/feasibility.md
The architecture decision record: whether the chosen stack can deliver Phase 1, and the numbered decisions (D-1…) that shape the build.
Architecture
product/architecture/
The 4+1 views of the system as built: domain model, runtime dynamics, code organization, deployment topology — plus scenarios traced through real verification runs.
Roadmap
product/roadmap.md
The 7-day prototype plan — four parallel lanes of agent-executed sessions, each ending in a PR and a handover.
Project history
product/history/
One page per package: what was built, the decisions and why, and the problems — real ones included — with every claim traced to a PR or handover.
Session log
handovers/
One handover note per working session: what was done, what was decided, what the next session needs to know.