From 003a4f22361ad34620139c3834575df6f70a4e53 Mon Sep 17 00:00:00 2001 From: Steve Yegge Date: Mon, 22 Dec 2025 03:11:33 -0800 Subject: [PATCH] Fix wisp storage path: rig root not mayor/rig (gt-nq6j) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Wisps are at /.beads-wisp/, outside any git clone. This matches the actual code implementation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- docs/wisp-architecture.md | 31 +++++++++++++++---------------- 1 file changed, 15 insertions(+), 16 deletions(-) diff --git a/docs/wisp-architecture.md b/docs/wisp-architecture.md index fa52ee6a..16709774 100644 --- a/docs/wisp-architecture.md +++ b/docs/wisp-architecture.md @@ -23,29 +23,28 @@ with Beads as the tracks. Wisps are steam vapors that dissipate after the work i ### Directory Structure ``` -~/gt/gastown/ +~/gt/gastown/ # Rig root (not a git repo) +├── .beads-wisp/ # Shared wisp storage (rig-level, gitignored) +│ └── issues.jsonl # In-progress wisps (Deacon, Witness, Refinery) +│ ├── mayor/rig/ # Mayor's canonical clone -│ ├── .beads/ # CANONICAL rig beads (versioned) -│ │ ├── issues.jsonl # Permanent issues + digests -│ │ ├── config.yaml -│ │ └── .gitignore # Excludes .beads-wisp -│ │ -│ └── .beads-wisp/ # GITIGNORED - shared wisp storage -│ └── issues.jsonl # In-progress wisps (Deacon, Witness, Refinery) +│ └── .beads/ # CANONICAL rig beads (versioned) +│ ├── issues.jsonl # Permanent issues + digests +│ └── config.yaml │ ├── refinery/rig/ # Refinery's clone -│ └── .beads/ # Inherits from mayor/rig (no local wisps) +│ └── .beads/ # Inherits from mayor/rig │ -├── witness/ # Witness (no clone needed, no local wisps) +├── witness/ # Witness (no clone needed) │ └── polecats// # Polecat worktrees - └── .beads/ # Inherits from mayor/rig (polecats don't use wisps) + └── .beads/ # Inherits from mayor/rig ``` ### Key Points -1. **`.beads-wisp/` is gitignored** - Never synced, never versioned -2. **All rig patrols share `mayor/rig/.beads-wisp/`** - Deacon, Witness, Refinery +1. **`.beads-wisp/` is at rig root** - Outside any git clone, naturally isolated +2. **All rig agents share `/.beads-wisp/`** - Deacon, Witness, Refinery 3. **Digests go to canonical `.beads/`** - Permanent record after squash 4. **Wisps are deleted after squash/burn** - No accumulation 5. **Polecats don't use wisps** - Each assignment is a deliverable with audit value @@ -93,9 +92,9 @@ These roles have repetitive/cyclic work that would accumulate without wisps: | Role | Molecule | Storage Location | Squash Frequency | |------|----------|------------------|------------------| -| **Deacon** | mol-deacon-patrol | mayor/rig/.beads-wisp/ | Per cycle | -| **Witness** | mol-witness-patrol | mayor/rig/.beads-wisp/ | Per cycle | -| **Refinery** | mol-refinery-cycle | mayor/rig/.beads-wisp/ | Per cycle | +| **Deacon** | mol-deacon-patrol | `/.beads-wisp/` | Per cycle | +| **Witness** | mol-witness-patrol | `/.beads-wisp/` | Per cycle | +| **Refinery** | mol-refinery-cycle | `/.beads-wisp/` | Per cycle | ### Roles That Use Regular Molecules