johno/gastown
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Update wisp-architecture.md: shared storage for rig patrols (gt-nq6j)

Browse Source 
- All rig patrols (Deacon, Witness, Refinery) now share mayor/rig/.beads-wisp/
- Removed separate wisp directories for witness/ and refinery/
- Polecats do not use wisps (each assignment has audit value)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Steve Yegge
2025-12-22 02:58:36 -08:00
parent 98c48f0f29
commit 5f29a3d07f
1 changed files with 9 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
docs/wisp-architecture.md
View File

@@ -30,27 +30,25 @@ with Beads as the tracks. Wisps are steam vapors that dissipate after the work i
│ │ ├── config.yaml
│ │ └── .gitignore # Excludes .beads-wisp
│ │
│ └── .beads-wisp/ # GITIGNORED - local wisps
│ └── issues.jsonl # In-progress wisp molecules
│ └── .beads-wisp/ # GITIGNORED - shared wisp storage
│ └── issues.jsonl # In-progress wisps (Deacon, Witness, Refinery)
│
├── refinery/rig/ # Refinery's clone
│ ├── .beads/ # Inherits from mayor/rig
│ └── .beads-wisp/ # Refinery's local wisps
│ └── .beads/ # Inherits from mayor/rig (no local wisps)
│
├── witness/ # Witness (no clone needed)
│ └── .beads-wisp/ # Witness's local wisps
├── witness/ # Witness (no clone needed, no local wisps)
│
└── polecats/<name>/ # Polecat worktrees
├── .beads/ # Inherits from mayor/rig
└── .beads-wisp/ # Polecat's local wisps (if using wisps)
└── .beads/ # Inherits from mayor/rig (polecats don't use wisps)
```
### Key Points
1. **`.beads-wisp/` is gitignored** - Never synced, never versioned
2. **Each execution context has its own wisp store** - Process isolation
2. **All rig patrols share `mayor/rig/.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
### Gitignore Entry
@@ -96,8 +94,8 @@ 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 | witness/.beads-wisp/ | Per cycle |
| **Refinery** | mol-refinery-cycle | refinery/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 |
### Roles That Use Regular Molecules