42 lines
2.8 KiB
Markdown
42 lines
2.8 KiB
Markdown
# 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.
|