human/README: landing page routing to docs 1-4 + a session-to-session command cheat-sheet (save and push · drift check · wake up · remember this · close/model-switch phrases) [silas]

2026-07-01 00:24:00 -04:00
parent f58a026405
commit 67540e8c12
1 changed files with 41 additions and 0 deletions
@@ -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.