sam-4screen-desktop 2026-11-5:23:6:30

010 inbox/TUIOS Coding Harness.md

@@ -0,0 +1,35 @@
+---
+proposed_folder: 300 areas/350 AI Pi Coding Agent
+proposed_toc: "100 Table of Contents/Areas.md → AI & Coding Agent"
+proposed_tags:
+  - project
+  - go
+  - agents
+  - system
+  - coding
+  - tuios
+confidence: 0.59
+approved: false
+proposed_for: d95b860095a7
+---
+
+# TUIOS Coding Harness
+
+**What it is.** A terminal "office" that runs inside TUIOS: a board of tasks, three worker agents in their own panes, and a person who is only interrupted when a decision is needed.
+
+**Why it exists.** To stop being the person in the middle. Instead of reading agent output and telling each agent what to do next, the work is a list of cards. Workers take cards. A green test run merges. The person handles exceptions.
+
+**How it is put together.**
+- **TUIOS** (0.12.1) supplies panes, six named workspaces, task cards with an atomic claim, worktrees, checkpoints and shipping. Most of the system was already there.
+- **The board** is a Go program written with Bubble Tea and Lip Gloss — the same toolkit TUIOS uses. It reads the task cards and takes every key.
+- **The agents** are Pi, one per worker pane, each in its own git worktree.
+- **Gitea** holds the code.
+
+**The one design rule.** One thing owns each piece of state: the task queue belongs to the TUIOS daemon, code belongs to git, decisions belong to the person.
+
+**What went wrong on the way, and is worth knowing.**
+TUIOS can draw rich panels from markup (TML). They render beautifully in a browser and take no keyboard input there, which made every button built on them dead. A plain terminal program has none of that problem. That single discovery turned a month of dead ends into one program.
+
+**What it shows.** Agent orchestration, terminal UI work in Go, task governance, and the discipline of removing components: an early plan had a custom board, a lock, a messenger and a scheduler. TUIOS already had all four.
+
+**Status.** The board, the six screens and the repair path work on three machines. The gate, the review screen and the first real project are next.