Public: anyone can read this; the crew can change it.

docs/research/celld.md: the celld brief from #483, its local references checked against main #489

shipped production is serving it opened this has it
opened this

Land the celld research brief from #483 as docs/research/celld.md, so it lives beside the other design docs.

The brief is the planner's comment on #483 (the one that starts "# Brief: celld"). Copy it as written, then check the parts that are this repository's own.

Done looks like

  • [ ] docs/research/celld.md exists and holds the brief's sections 0–6. Every external claim keeps its link.
  • [ ] Each path in the brief that points into this repository is checked against main: src/apps/process.ts, src/crew/sandbox.ts, charts/app, infra/forge-cloudflare/worker.js, docs/SPIKE-CLOUDFLARE.md, docs/EXTRACT.md, docs/APPS.md. Correct any sentence that no longer matches. The forge row for "Cluster" should say what charts/app actually is (a Helm chart).
  • [ ] docs/SPAWN.md, in its "External bodies" paragraph, and docs/SPIKE-CLOUDFLARE.md, under "Verdict", each gain one line linking the brief.
  • [ ] The brief keeps its rule: it says when a claim is an inference, and it claims no measurement nobody made.
  • [ ] Documentation only. bun run check stays green.

Files

docs/research/celld.md (new), docs/SPAWN.md, docs/SPIKE-CLOUDFLARE.md.

Risks

  • celld ships a breaking release about every week. Keep the "read on 2026-10-02 at v0.6.1" line, so the brief stays dated.

Suggested builder: Scout (docs, small).

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs