# GENOMA — `ui-iterations/` 30-Prototype Swarm Execution Plan

> **Goal:** Generate **30 completely independent, multi-file interactive UI prototypes**—**10 for Patient** (`patient-01/`..`patient-10/`), **10 for Physician** (`doctor-01/`..`doctor-10/`), and **10 for Administrator** (`admin-01/`..`admin-10/`)—plus a comparison **Launcher (`index.html`)** inside `/home/d/BexoniaProjects/genoma/ui-iterations/`, while leaving `/home/d/BexoniaProjects/genoma/ui-concepts/` untouched.

---

## 1. Directory & Multi-File Explosion Architecture (Zero Tool-Call Timeout)

To guarantee **zero `300s` stream-buffer timeouts** while keeping every prototype clean, maintainable, and offline-ready (`file://` and HTTP):

```text
/home/d/BexoniaProjects/genoma/ui-iterations/
├── README.md                 # Single Source of Truth (Sections 1, 2, 3, 4)
├── PLAN.md                   # This execution plan
├── index.html                # Comparison & QA launcher (plus launcher.{css,js}, catalog.js)
├── patient-01/ .. patient-10/
│   ├── index.html            # <= 150 LOC (semantic shell; classic <script defer> tags — zero CORS on file://)
│   ├── styles.css            # <= 180 LOC (design tokens, responsive rules, motion)
│   ├── data.js               # <= 180 LOC (realistic Venezuelan/LatAm clinical & genomic datasets)
│   ├── state.js              # <= 160 LOC (pure domain state, calculators, filters)
│   └── app.js                # <= 180 LOC (DOM rendering & working event handlers)
├── doctor-01/ .. doctor-10/  # Same 5-file exploded structure (<= 180 LOC per write_file)
└── admin-01/ .. admin-10/    # Same 5-file exploded structure (<= 180 LOC per write_file)
```

### Hard Authoring Caps
- **Max `180 LOC` (`~8 KB`) per `write_file` / `edit_file` call** — every file writes in `~25–35s`, well below the `300s` server tool-call buffering threshold.
- **Classic `<script defer>` Globals (`window.GENOMA_*`)** — avoids `file://` ES-module CORS blocks in Chrome and iframes while preserving clean multi-file separation (`~750–850 LOC` total per concept).
- **Zero External Broken Assets:** Self-contained SVG graphics/charts and system or graceful fallback font stacks so offline/headless Chrome logs **0 console errors, 0 failed network requests, and 0 dead controls**.

---

## 2. Single Source of Truth & Strict Isolation Rules

1. **Sole Domain Input:** `/home/d/BexoniaProjects/genoma/ui-iterations/README.md`
   - **Patient workers (`patient-01`..`patient-10`):** Read ONLY **Sections 1 & 2**.
   - **Physician workers (`doctor-01`..`doctor-10`):** Read ONLY **Sections 1 & 3**.
   - **Administrator workers (`admin-01`..`admin-10`):** Read ONLY **Sections 1 & 4**.
2. **Strict Isolation (Zero Peeking):** Workers are strictly forbidden from reading or listing `ui-concepts/`, `apps/`, `services/`, `contracts/`, `user-behavior/`, `roadmaps/`, `BUSINESS_PLAN.md`, root `README.md`, non-assigned skills in `.agents/skills/`, or sibling folders in `ui-iterations/`.
3. **Zero Layout or UX Prescriptions:** Workers receive **zero** instructions on layout, navigation mechanics, section order, or visual hierarchy—every concept autonomously decides how best to serve its user.
4. **Zero Code Over the Board:** Workers write physical files in their own assigned folder and post only a 1-line completion signal to their role's verifier.

---

## 3. Distinct Design Philosophy Matrix (10 Unique Slots × 3 Roles = 30 Concepts)

Every prototype is paired with `/home/d/BexoniaProjects/genoma/.agents/skills/full-output-enforcement/SKILL.md` (strictly requiring 0 placeholders/TODOs and 0 dead controls, while adhering to the `<= 180 LOC` multi-file split) plus a distinct design philosophy across slots `01`–`10` for each role:

| Slot | Assigned Design Skill / Philosophy | Patient Folder | Physician Folder | Administrator Folder |
| :--- | :--- | :--- | :--- | :--- |
| **`01`** | `minimalist-ui` | `patient-01/` | `doctor-01/` | `admin-01/` |
| **`02`** | `high-end-visual-design` | `patient-02/` | `doctor-02/` | `admin-02/` |
| **`03`** | `design-taste-frontend` (v2 + Chrome look/fix) | `patient-03/` | `doctor-03/` | `admin-03/` |
| **`04`** | `design-taste-frontend-v1` | `patient-04/` | `doctor-04/` | `admin-04/` |
| **`05`** | `design-taste-frontend-v2-experimental` | `patient-05/` | `doctor-05/` | `admin-05/` |
| **`06`** | `gpt-taste` | `patient-06/` | `doctor-06/` | `admin-06/` |
| **`07`** | `frontend-design` | `patient-07/` | `doctor-07/` | `admin-07/` |
| **`08`** | `industrial-brutalist-ui` | `patient-08/` | `doctor-08/` | `admin-08/` |
| **`09`** | `stitch-design-taste` | `patient-09/` | `doctor-09/` | `admin-09/` |
| **`10`** | **Pure First-Principles Freeform** (no style skill) | `patient-10/` | `doctor-10/` | `admin-10/` |

*(Note: For `admin-03` / `doctor-03` / `patient-03` using `design-taste-frontend` v2, workers adapt its researched art-direction library and real-browser Chrome inspection to their application domain while strictly keeping all controls interactive.)*

---

## 4. Phased Swarm Execution & Verification Strategy

To protect model quota and avoid simultaneous RPC congestion (validated at `10` parallel authors in `ui-concepts`):

1. **Clean Swarm Setup:** Retire the completed `ui-concepts` waiting workers before launching the `ui-iterations` swarm (`GENOMA 30 UI Iterations`).
2. **Wave 1 — 10 Patient Prototypes + `verifier-patient`:**
   - Spawn `patient-01`..`patient-10` in parallel (`workspace: "inherit"`, each locked to `ui-iterations/patient-XX/`).
   - `verifier-patient` runs headless Chrome (`/home/d/.nix-profile/bin/google-chrome --headless`) + CDP click/input tests on all 10 Patient apps and pings authors directly for any defects.
3. **Wave 2 — 10 Physician Prototypes + `verifier-doctor`:**
   - Spawn `doctor-01`..`doctor-10` in parallel (`ui-iterations/doctor-XX/`), verified by `verifier-doctor`.
4. **Wave 3 — 10 Administrator Prototypes + `verifier-admin`:**
   - Spawn `admin-01`..`admin-10` in parallel (`ui-iterations/admin-XX/`), verified by `verifier-admin`.
5. **Wave 4 — Comparison Launcher (`launcher`):**
   - Author `ui-iterations/index.html` (`+ launcher.css`, `catalog.js`, `launcher.js`, each `<= 180 LOC`) providing role filtering (`Patient` / `Physician` / `Administrator`), design-philosophy tags, single preview, side-by-side / quad comparison, viewport toggle (desktop/mobile), and scorecard export.
   - Verify `ui-iterations/index.html` + all 30 prototypes in headless Chrome (`0` JS/console/network errors, `0` dead controls).

---

## 5. Verification Checklist (Definition of Done)

- [ ] `/home/d/BexoniaProjects/genoma/ui-concepts/` remains 100% untouched.
- [ ] All 30 subfolders (`patient-01..10`, `doctor-01..10`, `admin-01..10`) contain complete, non-stubbed multi-file apps (`index.html`, `styles.css`, `data.js`, `state.js`, `app.js`).
- [ ] `ui-iterations/index.html` launches and compares all 30 prototypes cleanly via `file://` or HTTP.
- [ ] Headless Chrome + CDP automated test passes `31 / 31` (`30` prototypes + `index.html`) with `0` console errors, `0` uncaught exceptions, `0` broken resources, and `100%` working interactive controls.