15
A plan an agent can build from

BrainAI

Type one sentence and watch it grow a planning tree with live research and self-taken forks — then compile 45 agent-ready files into a folder on your machine.

TypeScript agentsplanningnextjslocal-first
click to turn
A wave

Seed, ghosts, nodes, an auto-decided fork, coverage closing. Replayed from the documented run loop.

A decision node — the recommended option, and the one chosen
running A decision node — the recommended option, and the one chosen
The wave, and the gate
sentencethe seed wave.tssectionsbreadth-first expandTavily researchauto-accept forksgap-fill until closedstops, and says why graph.jsonZod-parsednot trustedthe source of truth coverage gate34 keysevidence per keylive citation rulesblocks compile compile→ compile-tmp/secret scan in memorycopy into place45 files a gap → grow it STREAMED PREVIEWS a child is drawn as a dashed ghost the moment its JSON closes OR, IN THE BROWSER the same engine on IndexedDB the pack leaves as a .zip

A POST returns 202 and the work runs on the server; SSE only subscribes. A route handler that awaits minutes of model calls dies on the first navigation.

Seven ways the gateway fails
failure kinds
  waf · auth · model_denied · pool_exhausted
  rate_limit · network · parse

per-model failure   → advance the fallback chain
waf / auth          → stop dead
transient           → retry the same model first
truncated           → double the token budget;
                      never switch voice mid-pack

Measured against the live gateway, not guessed — written up as ADR-003.

Compile is a gate, not a button

A pack with a hole in it is worse than no pack. The pack map declares 34 coverage keys — some accept variants, some demand a minimum file count, two carry rules: the market file needs a live citation, the legal files need named facts. Every key must point at a node with real evidence before a single file is written.

Then compile is transactional: files go to a temp directory, are secret-scanned in memory, and only then copied into place. A failed scan leaves the previous pack exactly as it was.

Compile blocked — every key without evidence, named
running Compile blocked — every key without evidence, named

One engine, two filesystems

Locally, projects are real folders and graph.json is a real file. The hosted build runs the same engine against IndexedDB through a small Vfs interface, so keys and projects never leave your browser. One conformance suite runs against both, so the two cannot drift.

One gateway rejects any browser User-Agent — a header a page is not allowed to set. relay/ is a ~120-line worker that rewrites that one header and forwards nothing else.

Status, honestly

34 of 38 requirements done, 12 of 14 tasks. One task asks for a UI rating of 8/10; two independent critic rounds scored it 6, and by its own bar it stays open.

Offline mode is a deterministic planner with nothing researched or reasoned. It is labelled in the top bar, in Settings, and stamped into every file it writes — a harness for the machine, never a shipping path.

The pack
45files compiled
34coverage keys
13ADRs
56tests

Specified before it was built. A PRD of 38 numbered requirements is still the source of truth.

Outcome

BrainAI

livesayandeep1013.github.io/BrainAI/repogithub.com/Sayandeep1013/BrainAIprdgithub.com/Sayandeep1013/BrainAI/blob/main/PRODUCT/prd.md
Chapter 16
DroidDoodle

An offline Android app where a small on-device language model rearranges a structured canvas through tool calls.

continue
15 — BrainAI
scroll · drag · ← →