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.
This commit is contained in:
@@ -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]].
|
||||||
17
.pi/settings.json
Normal file
17
.pi/settings.json
Normal file
@@ -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"
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -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.
|
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.
|
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.
|
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.
|
still unproven.
|
||||||
|
|
||||||
## The one-line version
|
## The one-line version
|
||||||
|
|||||||
29
docs/DOCMAP.md
Normal file
29
docs/DOCMAP.md
Normal file
@@ -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.
|
||||||
Reference in New Issue
Block a user