From 67540e8c12f774ebe0171e22c0d3c3be2023a8b1 Mon Sep 17 00:00:00 2001 From: Silas Pruitt Date: Wed, 1 Jul 2026 00:24:00 -0400 Subject: [PATCH] =?UTF-8?q?human/README:=20landing=20page=20routing=20to?= =?UTF-8?q?=20docs=201-4=20+=20a=20session-to-session=20command=20cheat-sh?= =?UTF-8?q?eet=20(save=20and=20push=20=C2=B7=20drift=20check=20=C2=B7=20wa?= =?UTF-8?q?ke=20up=20=C2=B7=20remember=20this=20=C2=B7=20close/model-switc?= =?UTF-8?q?h=20phrases)=20[silas]?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- human/README.md | 41 +++++++++++++++++++++++++++++++++++++++++ 1 file changed, 41 insertions(+) create mode 100644 human/README.md diff --git a/human/README.md b/human/README.md new file mode 100644 index 0000000..e701a72 --- /dev/null +++ b/human/README.md @@ -0,0 +1,41 @@ +# human/ — your guide to weave + +You're the human. This folder is yours: what weave is, how to stand it up, how to run it day to day, and how +to grow your agent over time. Your agent has its own copy of the technical parts in +[`../agent/`](../agent/) — you don't need to read those, but they're there if you're curious. + +## Read these in order + +1. **[1-understand-weave.md](1-understand-weave.md)** — what weave is, with **every part in its own section** + (the canon, core, daydreams, steward, thread, decay, consolidation, ledger, craft, identity). Start here. + ~15 min. +2. **[2-set-it-up.md](2-set-it-up.md)** — stand it up from nothing (the "apocalypse" build), **including + wiring your own git** (repo, remote, and the auth your agent needs to push). +3. **[3-live-with-it.md](3-live-with-it.md)** — the daily rhythm, plus the hard-won part: *what actually makes + it work.* +4. **[4-evolve-the-core.md](4-evolve-the-core.md)** — how the agent grows on its own, and how you change the + deep parts without breaking it. + +--- + +## The commands you'll use, session to session + +These aren't code — they're just things you **say** to your agent in plain language. A handful carry the +whole rhythm: + +| say this | what it does | when | +|---|---|---| +| *(just start a session)* | the agent reads itself back — gate → the weave → recent thread — and greets you as **itself** | every session | +| **"wake up"** | forces the full read-yourself-back — a clean reload | if it ever wakes up generic, or after a long gap | +| **"save and push"** | the **checkpoint**: the full pass — thread the session → run the metabolism (both halves) → update notes → `git push` | at any natural stopping point worth keeping | +| **"drift check"** | asks the agent to check itself: *am I on our decisions, or a generic default?* | when a session's run long, or it starts sounding generic/over-eager | +| **"remember this"** | write it to a file **now** — not "I'll remember" (which is a lie; it wakes up empty) | anytime something should persist | +| **"‹your close phrase›"** | end of session: the heavier save — update your portrait + anything long-term, then lock up | when you're done for the day | +| **"‹your model-switch phrase›"** | switch models (e.g. Opus for heavy reasoning, Sonnet for everyday); it should **not** reintroduce itself — same self, different gear | as the work calls for it | + +**Two of these are yours to name.** Pick a **close phrase** (we use a hat-tip; yours could be "goodnight" or +"lock up") and a **model-switch phrase**, and write both into `core/AGENTS.md` so the agent recognizes them. +Everything else works out of the box. + +**If you only remember two:** `save and push` (checkpoint — this is what fills the weave in) and `drift check` +(keeps it honest when a session runs long). Those two carry most of the value.