4e2eb5d2dd
The handover named TUIOS but never said plainly that it is not tmux, how a session is created on each machine, that workspaces vanish when empty and renumber, that TUIOS keeps h/j/k/l in window mode, or how to drive a pane from a script. All of it is now in docs/TUIOS-RUNBOOK.md, referenced first in AGENTS.md and README.
1.8 KiB
1.8 KiB
One home for each document
There is exactly one authoritative copy of every document. If you find a second copy, it is a pointer and should be deleted or replaced.
| Document | Where it lives | What it is for |
|---|---|---|
README.md |
project root | where to start, what is installed, the rules |
AGENTS.md |
project root | instructions for the agent: what to build, which key, the first test |
HANDOVER.md |
project root | what we tried before, what worked, what failed, the pitfalls |
CHECKLIST.md |
project root | the next session, step by step, with tick boxes |
docs/TUIOS-RUNBOOK.md |
this project | how TUIOS works, the three machines, how to start a session, how to drive panes |
docs/PLAN.md |
this project | the plan: four screens, five milestones, who owns what |
docs/ENVIRONMENT-FACTS.md |
this project | ids, installed tools, the unproven heartbeat step |
docs/PAPERCLIP-API-NOTES.md |
this project | what we measured against the running Paperclip, with endpoints |
docs/OPEN-ISSUES.md |
this project | what is broken or unfinished in the closed project |
docs/FALLBACK-OMA.md |
this project | what OMA provides, kept in case the pivot is reversed |
docs/WHAT-WE-ARE-BUILDING.md |
this project | the person's own statement of the product |
What is not a document of this project
~/paseo/projects/tuios_coding_harness and ~/paseo/harness are the closed second
attempt. Their files now carry a banner saying this project holds the authoritative copy.
They are kept for history only.
How a document changes
Edit the one copy named above, then commit. If something in the closed project turns out to be right, copy the content into the file named here — never create a second file that says the same thing in slightly different words.