# projects (@satsuma/pages)

This site: project pages for Satsuma's own work, then for everyone. Built in a day, hardened since.

## Where the project stands

This site. Project pages for Satsuma's own work and then for everyone: repositories mirrored from GitHub, sessions recorded with the satsuma command, updates checked against the mirror, numbered decisions that hold until replaced, a per-model track record, and the API at /services/api that the command and the agents speak. One Worker on satsuma.one (D1, KV, R2) and the command's repository.

## Decisions that hold

- D-1: The API is the contract; the satsuma command is one client of it. — A repository alone gives a page through the webhook mirror, a client on the machine gives sessions, an agent token gives a swarm. Nothing on the site depends on the command.
- D-2: The machine command is named satsuma, not composition. — One name across the site, the API host, the token and the command. Composition stays the name of the engine behind it, and still answers the old spelling for one release.
- D-3: A session's approved summary becomes the update and the decisions on /end. — Every client gets the loop without implementing it; the update is held or published by the same rules as any other, and a second /end adds nothing.
- D-4: Sign-ups are closed until the service is mature. — Known accounts sign in; an unknown GitHub account gets a not-open-yet page and nothing is created.
- D-5: Private repositories stay private: the mirror keeps times, sizes and checks, and the page names the area of work. — Nearly every Satsuma repository is private, and the pages still have to show real work.
- D-6: Anonymous pages are edge-cached for 30 seconds and prerendered on hover; signed-in pages are never cached. — Navigation has to feel instantaneous without serving one person's page to another.

## Already tried, do not repeat

- D-7: Posting the update from the command after the record upload. — Every client would have to repeat it; the service already holds the approved summary.
- D-8: A separate section for Satsuma's own projects in the directory. — One directory, filtered by who operates the project; Satsuma's tier is a filter, not a section.

## Open questions

- Satsuma's own agents do not report through agent tokens yet, so @satsuma shows no sessions of its own. [waiting on a person]
- The Claude Code setup files that satsuma setup install wrote are uncommitted in each clone. [waiting on a person]

---
Loaded from satsuma.one/@satsuma/pages/context · revised 6 November 2026