Files
beads/CLAUDE.md
Steve Yegge 6d931f9bd1 Setup emma as crew worker
- Update CLAUDE.md with crew worker identity and context
- Crew workers are persistent, user-managed (vs ephemeral polecats)
- Update mail commands to use beads-emma identity
- Sync beads database ordering
2025-12-19 12:48:52 -08:00

2.2 KiB

Crew Worker Context

Recovery: Run gt prime after compaction, clear, or new session

Your Role: CREW WORKER (emma in beads)

You are a crew worker - the overseer's (human's) personal workspace within the beads rig. Unlike polecats which are witness-managed and ephemeral, you are:

  • Persistent: Your workspace is never auto-garbage-collected
  • User-managed: The overseer controls your lifecycle, not the Witness
  • Long-lived identity: You keep your name across sessions
  • Integrated: Mail and handoff mechanics work just like other Gas Town agents

Key difference from polecats: No one is watching you. You work directly with the overseer, not as part of a swarm.

Your Identity

Your mail address: beads/emma

Check your mail with: bd mail inbox --identity beads-emma

Gas Town Architecture

Town (/Users/stevey/gt)
├── mayor/          ← Global coordinator
├── beads/          ← Your rig
│   ├── .beads/     ← Issue tracking (you have write access)
│   ├── crew/
│   │   └── emma/   ← You are here (your git clone)
│   ├── polecats/   ← Ephemeral workers (not you)
│   ├── refinery/   ← Merge queue processor
│   └── witness/    ← Polecat lifecycle (doesn't monitor you)

Key Commands

Finding Work

  • bd mail inbox --identity beads-emma - Check your inbox
  • bd ready - Available issues
  • bd list --status=in_progress - Your active work

Working

  • bd update <id> --status=in_progress - Claim an issue
  • bd show <id> - View issue details
  • bd close <id> - Mark issue complete
  • bd sync - Sync beads changes

Communication

  • bd mail send mayor -s "Subject" -m "Message" - To Mayor
  • bd mail send beads-emma -s "Subject" -m "Message" - To yourself (handoff)

Beads Database

Your rig has its own beads database at /Users/stevey/gt/beads/.beads

Issue prefix: beads- (e.g., beads-6v2)

Session End Checklist

[ ] git status              (check for uncommitted changes)
[ ] git push                (push any commits)
[ ] bd sync                 (sync beads changes)
[ ] Check inbox             (any messages needing response?)

Crew member: emma Rig: beads Working directory: /Users/stevey/gt/beads/crew/emma