From b6f0cb572beab0d8dc2957e6df45aad862c95d92 Mon Sep 17 00:00:00 2001
From: sam <sam@local>
Date: Tue, 10 Nov 2026 10:01:06 +1100
Subject: [PATCH] Finish the documents: one authoritative copy of each, listed
 in DOCMAP

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.
---
 .../00-system/pi-agent/memory-manifest.md     | 20 +++++++++++++
 .pi/settings.json                             | 17 +++++++++++
 README.md                                     |  3 +-
 docs/DOCMAP.md                                | 29 +++++++++++++++++++
 4 files changed, 68 insertions(+), 1 deletion(-)
 create mode 100644 .pi/memory-vault/packs/paperclip-harness/00-system/pi-agent/memory-manifest.md
 create mode 100644 .pi/settings.json
 create mode 100644 docs/DOCMAP.md

diff --git a/.pi/memory-vault/packs/paperclip-harness/00-system/pi-agent/memory-manifest.md b/.pi/memory-vault/packs/paperclip-harness/00-system/pi-agent/memory-manifest.md
new file mode 100644
index 0000000..fd0f5ce
--- /dev/null
+++ b/.pi/memory-vault/packs/paperclip-harness/00-system/pi-agent/memory-manifest.md
@@ -0,0 +1,20 @@
+---
+type: system
+id: system.paperclip-harness.memory-manifest
+title: Paperclip Harness Memory Manifest
+status: active
+source_of_truth: true
+freshness: current
+last_reviewed: 2026-11-09
+tags:
+  - agent-memory/system
+  - pack/paperclip-harness
+---
+
+# Paperclip Harness Memory Manifest
+
+This pack stores safe durable context generated from `/home/sam/paseo/projects/paperclip-harness`.
+
+## Retrieval Protocol
+
+See [[packs/paperclip-harness/00-system/pi-agent/retrieval-protocol|Retrieval Protocol]] and [[packs/paperclip-harness/00-system/pi-agent/resource-map|Resource Map]].
diff --git a/.pi/settings.json b/.pi/settings.json
new file mode 100644
index 0000000..a83bff0
--- /dev/null
+++ b/.pi/settings.json
@@ -0,0 +1,17 @@
+{
+  "packages": [
+    {
+      "source": "/home/sam/.agents",
+      "extensions": [
+        "extensions/pi-config/index.ts",
+        "extensions/filechanges/index.ts",
+        "extensions/ask-user-question/index.ts"
+      ],
+      "skills": [
+        "skills/obsidian-cli",
+        "skills/npm-security",
+        "skills/system-architect"
+      ]
+    }
+  ]
+}
diff --git a/README.md b/README.md
index 8efc4c0..aa29c3e 100644
--- a/README.md
+++ b/README.md
@@ -11,7 +11,8 @@ If you are the person: read these in order:
 2. `docs/PLAN.md` — the plan: the four screens, the milestones, what is Paperclip's job and what is ours.
 3. `docs/PAPERCLIP-API-NOTES.md` — what we measured against your running Paperclip, with the endpoint and the response.
 4. `CHECKLIST.md` — the exact steps for the next session, in order, with boxes to tick.
-5. `docs/ENVIRONMENT-FACTS.md` — the ids, the installed tools, and the one step that is
+5. `docs/DOCMAP.md` — which document is authoritative for what. One home per document.
+6. `docs/ENVIRONMENT-FACTS.md` — the ids, the installed tools, and the one step that is
    still unproven.
 
 ## The one-line version
diff --git a/docs/DOCMAP.md b/docs/DOCMAP.md
new file mode 100644
index 0000000..275b5d3
--- /dev/null
+++ b/docs/DOCMAP.md
@@ -0,0 +1,29 @@
+# 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/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.