somniumzzz

Persistent project agents for brand developers. The brand developer says "make the landing warmer." The agent does the rest — the engineering is invisible.Des agents de projet persistants pour les développeurs de marque. Le développeur dit « rends la page d'accueil plus chaleureuse ». L'agent fait le reste — l'ingénierie est invisible.

The problemLe problème

Terrarium is a well-governed machine. The governance is built by and for engineers. Feature branches, PRs, rebase, merge gates. moon ci, lefthook, conventional commits, GPG signing. ArgoCD gitops, Helm charts, kaniko builds. Linear tickets, critpath sweeps, lineage blocks.Terrarium est une machine bien gouvernée. Sa gouvernance est bâtie par et pour des ingénieurs. Branches de fonctionnalités, PR, rebase, gates de fusion. moon ci, lefthook, commits conventionnels, signature GPG. GitOps ArgoCD, charts Helm, builds kaniko. Tickets Linear, balayages critpath, blocs de lignage.

Marc and Laura — the brand developers — cannot use this machine. They shouldn't have to. The brand canon, the design tokens, the component library — all of it is for them. But the surface to interact with it is an intimidating backpanel of enterprise dev tools.Marc et Laura — les développeurs de marque — ne peuvent pas se servir de cette machine. Et ils ne le devraient pas. Le canon de la marque, les tokens de design, la bibliothèque de composants — tout cela est pour eux. Mais la surface pour y toucher est un intimidant panneau d'outils de développement d'entreprise.

The visionLa vision

Every node gets two things: a live shared dev environment — an always-up preview at a stable URL (<node>.preview.cerebral.work), automatically rebuilt on every change. No npm run dev, no wrangler, no kubectl. Just a URL that's always live.Chaque nœud reçoit deux choses : un environnement de développement partagé et vivant — un aperçu toujours actif à une URL stable (<nœud>.preview.cerebral.work), reconstruit automatiquement à chaque changement. Pas de npm run dev, pas de wrangler, pas de kubectl. Juste une URL toujours vivante.

And a persistent project agent — one per node — that is the node's dedicated operator. It lives in the node's repo, knows its canon, and translates brand-developer intent into the engineering operations the node requires.Et un agent de projet persistant — un par nœud — qui en est l'opérateur dédié. Il vit dans le dépôt du nœud, en connaît le canon, et traduit l'intention du développeur de marque en les opérations d'ingénierie que le nœud exige.

What they seeCe qu'ils voient

Three surfaces. No backpanel.Trois surfaces. Aucun panneau technique.

1. The live preview — always on. The running app at a stable URL. Source of truth for "what does this project look like right now."L'aperçu vivant — toujours actif. L'application en fonctionnement à une URL stable. La source de vérité pour « à quoi ressemble ce projet en ce moment ».
2. The change timeline — a simple web page. What changed, is it ready, do you approve. No git hashes, no PR numbers, no CI logs.Le journal des changements — une simple page web. Ce qui a changé, est-ce prêt, approuves-tu. Pas de hash git, pas de numéros de PR, pas de logs de CI.
3. The conversation — chat or voice. Plain language. Previews, approvals, results. The same interaction model the operator uses — scoped to one project, stripped of engineering vocabulary.La conversation — chat ou voix. Langage clair. Aperçus, approbations, résultats. Le même modèle d'interaction que l'opérateur utilise — restreint à un seul projet, dépouillé du vocabulaire d'ingénierie.

What they never seeCe qu'ils ne voient jamais

• git — branches, commits, rebase, mergegit — branches, commits, rebase, fusion
• github — PRs, reviews, CI status checksgithub — PR, revues, vérifications de CI
• argocd / helm / kubectl / kanikoargocd / helm / kubectl / kaniko
• openbao / external-secretsopenbao / external-secrets
• linear — the agent files tickets, the brand developer doesn't manage themlinear — l'agent crée les tickets, le développeur de marque ne les gère pas
• wrangler / workers config / KV / D1 bindingswrangler / config des workers / liaisons KV / D1
• the terminal — unless they want tole terminal — sauf s'ils le souhaitent

What the agent doesCe que fait l'agent

For each request, the persistent project agent:Pour chaque demande, l'agent de projet persistant :

1. interprets intent against the node's canon, design tokens, and voice rulesinterprète l'intention à l'aune du canon du nœud, des tokens de design et des règles de voix
2. creates a worktree — isolated from the main workspacecrée un worktree — isolé de l'espace de travail principal
3. edits only src/ — tokens, components, stylesne modifie que src/ — tokens, composants, styles
4. builds — validates the change compiles and passes realm-lintbuild — vérifie que le changement compile et passe realm-lint
5. commits + signs — conventional commit, GPG, invisiblecommit + signe — commit conventionnel, GPG, invisible
6. pushes the branch and opens a PR — invisiblepousse la branche et ouvre une PR — invisible
7. deploys a preview — auto-rebuilt from the branch, posts the URLdéploie un aperçu — reconstruit depuis la branche, publie l'URL
8. waits for CI — green means readyattend la CI — vert signifie prêt
9. asks for approval — a simple approve / adjust / reject carddemande l'approbation — une simple carte approuver / ajuster / rejeter
10. on approve — merges. Canon changes require Marc or Laura sign-off.à l'approbation — fusionne. Les changements de canon exigent l'aval de Marc ou de Laura.
11. on merge — ArgoCD syncs. Reports "shipped."à la fusion — ArgoCD synchronise. Rapporte « publié ».
12. files the Linear ticket — linked to the commit, status updated automaticallycrée le ticket Linear — lié au commit, statut mis à jour automatiquement

What already existsCe qui existe déjà

• terrarium monorepo — moon, node templates, lineage blocks, canonmonorepo terrarium — moon, gabarits de nœuds, blocs de lignage, canon
• @cerebral/design — tokens, theme CSS, components, realm-lint@cerebral/design — tokens, CSS de thème, composants, realm-lint
• @cerebral/gate — estate-wide auth, HMAC session cookie@cerebral/gate — authentification à l'échelle du domaine, cookie de session HMAC
• cloudflare workers — wrangler configs for lab, design, dreamscloudflare workers — configs wrangler pour lab, design, dreams
• argocd gitops — unsigned-paas, auto-syncgitops argocd — unsigned-paas, synchro automatique
• linear MCP — ticket filing and updatesMCP linear — création et mise à jour des tickets
• herdr — pane management, agent state, cross-agent messagingherdr — gestion des panneaux, état des agents, messagerie inter-agents
• voicemode — voice interactionvoicemode — interaction vocale

New:Nouveau :

• preview plane — per-branch CF Pages preview URLsplan d'aperçu — URLs d'aperçu CF Pages par branche
• persistent agent — one per node, durable, always on callagent persistant — un par nœud, durable, toujours disponible
• the studio — studio.cerebral.work, the brand developer's entire interfacele studio — studio.cerebral.work, toute l'interface du développeur de marque

NamingLe nom

The dreaming line. Persistent agents that dream alongside brand developers — always-on, always-previewing. The neurology/sleep vein:La lignée du rêve. Des agents persistants qui rêvent aux côtés des développeurs de marque — toujours actifs, toujours en aperçu. La veine neurologie/sommeil :

somnium

"the dream" — Kepler's Somnium, the first sci-fi story about a journey to the moon. A vision of what could be.« le rêve » — le Somnium de Kepler, le premier récit de science-fiction sur un voyage vers la Lune. Une vision de ce qui pourrait être.

oneiros

"dream personified" — Greek mythology, the god of dreams.« le rêve personnifié » — mythologie grecque, le dieu des rêves.

parasomnia

"sleep-behavior disorder" — the agent that acts while you sleep. Building, previewing, deploying.« trouble du comportement du sommeil » — l'agent qui agit pendant que tu dors. Il construit, prévisualise, déploie.

The line is gated in canon — "surface only when real." This concept is real enough to name.La lignée est sous gate dans le canon — « n'émerger que lorsque c'est réel ». Ce concept est assez réel pour être nommé.