b6f0cb572b
Docs consolidated: README, AGENTS, HANDOVER, CHECKLIST at the root; PLAN, DOCMAP, ENVIRONMENT-FACTS, PAPERCLIP-API-NOTES, OPEN-ISSUES, FALLBACK-OMA, WHAT-WE-ARE-BUILDING under docs/. DOCMAP names the one home for each. The closed project's copies now carry a 'Superseded' banner pointing here, so there are not two versions of anything.
1.9 KiB
1.9 KiB
Paperclip harness — start here
This is a new project. Nothing here runs yet. It exists so the third attempt starts from a clean place, with the history of the first two attempts attached.
If you are an agent: read AGENTS.md first, then HANDOVER.md, then docs/PLAN.md.
If you are the person: read these in order:
HANDOVER.md— what we tried before, what worked, what failed, and why this is different.docs/PLAN.md— the plan: the four screens, the milestones, what is Paperclip's job and what is ours.docs/PAPERCLIP-API-NOTES.md— what we measured against your running Paperclip, with the endpoint and the response.CHECKLIST.md— the exact steps for the next session, in order, with boxes to tick.docs/DOCMAP.md— which document is authoritative for what. One home per document.docs/ENVIRONMENT-FACTS.md— the ids, the installed tools, and the one step that is still unproven.
The one-line version
Paperclip already owns tasks, blockers, comments, approvals, runs, cost and git worktrees. We are building one small Go terminal program with four screens on top of it. Nothing else.
What you need installed (all present on .13 today)
- Paperclip server running locally on
http://127.0.0.1:3100(it is; 685 endpoints). PAPERCLIP_BOARD_KEYin the environment — the user key. The terminal program uses this one. An agent key cannot write outside a heartbeat run.- Go toolchain — not installed yet; add
goto/etc/nixos/configuration.nixbefore Milestone 2. Seedocs/ENVIRONMENT-FACTS.md. - Pi, which is already the worker adapter on your Paperclip agent.
Rules for this project
- No interface work before a real task has run end to end.
- Paperclip owns the facts. We never keep a second copy of a task, a blocker or a cost.
- Every claim in a document names the command that showed it.
- Nothing is copied from the old project except documents.