# AWAKE — product plan (swarm IDE)

Status: **BUILDING** (public page live; client shell not downloadable).  
Public: https://izzy.la/os/  
Sibling (do not merge branding): **AWAKE trading terminal** at https://izzy.la/awake/  
Brand family: **IZZY AWAKE** · site: izzy.la  

This doc is the durable product plan. The public page at `/os/` mirrors the honest subset.

Related continuous-ops (do **not** thrash peer workers on these surfaces — link only):

| Doc | Role |
|---|---|
| `mass-build-handoff/CONTINUOUS-IMPROVE.md` | Forever improve + research→apply lanes (never “nothing to do”) |
| `mass-build-handoff/CONTINUOUS-POLICY.md` | Never stop for drained; tick + stop file law |
| `CONTINUOUS-REVENUE` | **Not present in handoff yet** — when peers add it, treat as revenue-lane law and keep surface locks respected |

---

## Thesis

Cursor is optimized for **one human + a few agent turns**.  
Izzy runs **huge AFK multi-agent swarms** that must also **grow the business**, not only ship code: residual craft, research-to-improve, new portfolio projects with a revenue path, marketing/ads automation — all recursive, all gated.

**AWAKE** is a Cursor-class IDE **reoriented around continuous fleet growth**:

1. **Never idle** — every loop either improves something real or researches toward a concrete improve. “Drained” is not a stop condition.  
2. **Fleet orchestration first** — one writer per surface, claim locks, mandate board, parent/worker multitask.  
3. **Full automated recursion** — measure → queue → claim → craft → ship → prove → arm.  
4. **Revenue & growth first-class** — marketing, ads, SEO, funnel work sit beside code, not in a side app.  
5. **No slop** — craft via SaturnDesign / known directions; logo test; no generic AI chrome.  
6. **Human Gates** — credentials, spend, **public publish** stay human-only.

### Named mechanism (SaturnDesign uniqueness gate)

**Fleet shell** — Mandate board + ship rail (+ growth lane) are primary; the code editor is secondary. Agents render as **named, status-pilled mandate cards**. Status color is the only semantic channel. Ship defaults preselected. Money and public-post stay Gate tray.

> Mechanism × movement × money rule (2026-08-08 compose #2 growth fold):  
> *Fleet shell on photocopier paper × generative continuous operator UI × public publish + spend stay human Gate — no fake download; BUILDING is honest.*

SaturnDesign (`user-izzydesign`):
- **Pass 1 (shell):** `recipe-unmistakable-site` · `replit` · `flighty` · `copy-technical-honest` · `generative-ui` (anti: `homogenized-premium`)
- **Pass 2 (growth fold):** same shell + `landing-page-anatomy` claim/proof/one-action · `brand-craft-provenance` (checkable process) · growth steal from loops only where claims are real · anti-slop / anti-SaaS card wall
- Steal: status-pilled cards; single Deploy-grade ship; never-idle tick truth; SaturnDesign before invented UI
- Avoid: editor-first hero; purple Inter; fake download; “Learn more” as only CTA without a real next step

---

## Continuous growth law (product)

| Law | Meaning in product |
|---|---|
| **Never idle** | Loop arm always has either IMPROVE or RESEARCH→IMPROVE mandates. Idle fleet is a defect. |
| **Improve OR research-to-improve** | Research without an apply path is incomplete; pure busywork is failed. |
| **Portfolio expansion** | New projects enter when they make sense **and** have a revenue path (sell / DFY / productize). |
| **No slop** | Every craft surface runs SaturnDesign compose (or explicit inherited monorepo direction). |
| **Revenue / growth first-class** | Marketing, ads automation, SEO, offer/copy rails are first-class mandate types — not afterthoughts. |
| **Automated + recursive** | Full chain automated under claim law; re-arm after prove. |
| **Public publish Gate** | Agent may draft; **human must approve** before live social/public post. Credentials + money same tray. |

Do not compete with peer AFK **revenue** workers: if they hold claims on growth surfaces, AWAKE plan **coordinates** (surface map) — it does not overwrite their exclusive paths.

---

## Brand

| Layer | Rule |
|---|---|
| Product name | **AWAKE** (swarm IDE / continuous OS) |
| Family | IZZY AWAKE |
| Not this product | `/awake/` paper **trading** terminal · AWAKE Fashion · AWAKE Accounts |
| Visual | izzy.la print roll: aged paper `#ece7db`, ink `#141312`, Anton / Archivo, mint as **status** |
| Voice | Founder-first, technical honest — datasheet over adjectives |

---

## JTBD vs Cursor

| Job | Cursor (typical) | AWAKE |
|---|---|---|
| Run one deep coding task | Excellent | Supported (editor secondary) |
| Run 20–100 parallel specialists | Bolted / pain | **First-class Fleet pane** |
| Never-idle AFK growth loop | Manual re-prompt | **Loop arm**: improve \| research→improve |
| Revenue / marketing as work | Separate tools | **Growth mandates** (ads, SEO, offer) first-class |
| New product projects | Side chat | **Portfolio gate**: sense + revenue path |
| Craft quality under swarm load | Variable slop | **SaturnDesign-required** craft |
| One-writer file ownership | Ad-hoc | **Surface map + claim locks** |
| Ship + prove live | Deploy afterthought | **Ship rail + live prove** |
| Public post / spend | Easy to accident | **Gate tray — human only** |

---

## UI IA (fleet-first + growth)

1. **Fleet pane** — agents: role, surface, status (IDLE is red defect / WORK / WAIT / GATE / SHIP / RESEARCH / GROW).  
2. **Mandate board** — cards for build, residual, research→apply, growth (ads/SEO/offer), portfolio probe.  
3. **Surface map** — sole-writer locks (code + copy + revenue assets); respect peer claims.  
4. **Ship rail** — MEASURE → QUEUE (implicit) → CLAIM → CRAFT → SHIP → PROVE → ARM.  
5. **Gate tray** — credentials · money · **public publish** — human only.  
6. **Loop arm** — never-idle continuous: arm/disarm, interval, stop file (`STOP-AFK-LOOP` class).  
7. **Growth rail** (with ship or adjacent) — marketing/ads automation jobs as first-class actions.  
8. **Editor** — secondary.  
9. **Swarm palette** — `claim`, `release`, `queue residual`, `research`, `growth`, `ship`, `prove`, `arm`, `halt`.

```
┌ Fleet │ Mandate board (craft · research · growth) │ Gate tray ┐
│       │                                            │ PUBLISH  │
├───────┴────────────────────────────────────────────┴──────────┤
│ Rail: MEASURE → CLAIM → CRAFT → SHIP → PROVE → ARM   LOOP    │
├──────────────────────────────────────────────────────────────┤
│ Surface map ················· editor (secondary)             │
└──────────────────────────────────────────────────────────────┘
```

---

## The recursive loop (product law)

```
measure → queue → claim → craft → ship → prove → arm
                 ↘ research → queue improve
                 ↘ growth   → queue / Gate (money, publish)
```

1. **Measure** — live truth (manifest, health, revenue probes when present).  
2. **Queue** — residuals, research apply, growth, portfolio probes become mandates.  
3. **Claim** — one writer per surface; peers take free land.  
4. **Craft** — code/copy/ads/automation with SaturnDesign when inventing UI.  
5. **Ship** — sole-ship only; no force-push.  
6. **Prove** — live bytes / health / checkable claim.  
7. **Arm** — re-arm loop; never idle until stop condition.

**Gate cuts** (cannot automate past): credentials, money spend, public publish.

---

## Roadmap (honest)

### MVP (now)
- Product page + this plan on izzy.la  
- Continuous growth law documented; dogfood loops on existing AFK continuous docs  
- No fake client binary  

### V1
- Thin shell: Fleet, mandates (incl. research/growth types), claims, full rail, Gate tray (publish), SaturnDesign hook before invent  

### V2
- Multi-worktree map; residual + grow scoring; ads automation workers first-class; portfolio “sense + revenue path” wizard; optional hosted orchestrator  

Out of scope this pass: full Electron IDE; inventing CONTINUOUS-REVENUE for peers.

---

## Tech sketch (light)

| Layer | Likely |
|---|---|
| Shell | Electron or VS Code / Cursor fork (eval later) |
| Orchestration | SWARM / saturn-kernel lineage + continuous loop arm |
| Claims | `.swarm-claims/` (respect peers) |
| Ship | `node scripts/ship.mjs` sole-ship |
| Prove | live-manifest style + health probes |
| Gates | Human tray — never auto public post / spend / DNS |
| Craft | SaturnDesign compose before invented UI |
| Growth | Mandate types + optional automation adapters (ads APIs later) |

---

## Risks

1. **Name collision** — trading vs IDE vs fashion → distinct URLs + organ lines.  
2. **Scope creep** — ship fleet/growth shell before editor parity.  
3. **Trust** — Gate tray hard-stop on publish/money.  
4. **Claim thrash** — never steal peer revenue AFK exclusive surfaces.  
5. **Slop under scale** — SaturnDesign + content rule or fail.  
6. **Fake growth metrics** — no invented revenue numbers on public surfaces.  
7. **Download expectation** — BUILDING until real client exists.

---

## Public surfaces (monorepo)

| Surface | Role |
|---|---|
| `/os/` | Product page |
| `docs/AWAKE-PRODUCT.md` | This plan |
| Home `#things` | Project card → `/os/` |
| `llms.txt` · `sitemap.xml` · `README.md` | Registries |
| `/awake/` | Trading only |

---

## Changelog

- 2026-08-08 — Initial plan + `/os/` Fleet shell (SaturnDesign pass 1); sole-ship `cw9xkqg1u`.  
- 2026-08-08 — Continuous growth fold: never-idle, research→improve, revenue/growth first-class, full measure→…→arm loop, public publish Gate; cross-link CONTINUOUS-IMPROVE / CONTINUOUS-POLICY (CONTINUOUS-REVENUE absent).