{
  "id": "page:library-gastown",
  "_kind": "Page",
  "_file": "wiki/library/gastown.md",
  "_cluster": "wiki",
  "attributes": {
    "nodeKind": "Page",
    "title": "Gas Town Methodology (Library)",
    "displayName": "Gas Town Methodology (Library)",
    "slug": "library/gastown",
    "articlePath": "wiki/library/gastown.md",
    "article": "\n# Gas Town Methodology\n\n**Source**: [steveyegge/gastown](https://github.com/steveyegge/gastown) by Steve Yegge\n**Category**: Multi-Agent Orchestration / AI-Driven Software Development\n**License**: See upstream repository\n\n## Overview\n\nGas Town is a multi-agent orchestration framework for AI-driven software development. It provides infrastructure roles (Mayor, Deacon, Witness, Refinery), worker roles (Crew, Polecats, Dogs), and a git-backed work unit system (Beads, Convoys, Molecules) for coordinating parallel agent execution with persistent attribution.\n\n## Core Principles\n\n- **GUPP** (Gas Town Universal Propulsion Principle): \"If there is work on your Hook, YOU MUST RUN IT\"\n- **MEOW** (Molecular Expression of Work): Breaking goals into trackable atomic units\n- **NDI** (Nondeterministic Idempotence): Ensuring useful outcomes through orchestration of unreliable processes\n\n## Process Files\n\n| Process | File | Description | Task Count |\n|---------|------|-------------|------------|\n| Mayor Orchestrator | `gastown-orchestrator.js` | Global coordinator: convoys, agents, monitoring | 8 |\n| Patrol Monitoring | `gastown-patrol.js` | Deacon/Witness health checks and recovery | 4 |\n| Convoy Lifecycle | `gastown-convoy.js` | Create, assign, track, and land convoys | 6 |\n| Molecule Workflow | `gastown-molecule.js` | Formula -> Protomolecule -> Molecule execution | 6 |\n| Merge Queue | `gastown-merge-queue.js` | Refinery conflict resolution and integration | 5 |\n\n## Skills Catalog\n\n| Skill | Directory | Description |\n|-------|-----------|-------------|\n| convoy-management | `skills/convoy-management/` | Convoy lifecycle: create, track, land |\n| work-decomposition | `skills/work-decomposition/` | MEOW decomposition into beads and wisps |\n| agent-coordination | `skills/agent-coordination/` | Crew/Polecat assignment and hook management |\n| merge-queue | `skills/merge-queue/` | Refinery conflict resolution and merge |\n| patrol-monitoring | `skills/patrol-monitoring/` | Deacon/Witness health and recovery |\n| formula-authoring | `skills/formula-authoring/` | TOML Formula -> Protomolecule -> Molecule |\n| issue-tracking | `skills/issue-tracking/` | Bead lifecycle and attribution tracking |\n| session-management | `skills/session-management/` | Agent session init, handoff, seance |\n\n## Agents Catalog\n\n| Agent | Directory | Role |\n|-------|-----------|------|\n| mayor | `agents/mayor/` | Global Coordinator |\n| deacon | `agents/deacon/` | System Supervisor |\n| witness | `agents/witness/` | Rig Lifecycle Manager |\n| refinery | `agents/refinery/` | Merge Queue Processor |\n| polecat | `agents/polecat/` | Task Worker (transient) |\n| crew-lead | `agents/crew-lead/` | Persistent Collaborator |\n\n## Workflow Lifecycle\n\n```\nMayor analyzes goal -> MEOW decomposition -> Convoy creation -> Agent assignment -> Execution (GUPP) -> Patrol monitoring -> Refinery merge -> Landing\n```\n\nCross-cutting concerns applied throughout:\n- `patrol-monitoring` - Continuous health checks via Deacon\n- `merge-queue` - Refinery processes all agent work\n- `issue-tracking` - All beads carry persistent attribution\n- `session-management` - Agent lifecycle across sessions\n\n## Work Unit Hierarchy\n\n```\nGoal -> MEOWs -> Convoy (work order) -> Beads (git-backed tasks) + Wisps (ephemeral)\n                                    |\n                                    +-> Formula -> Protomolecule -> Molecule (durable workflow)\n```\n\n## Philosophy\n\n- **GUPP enforcement** - Work on hooks must be executed, no exceptions\n- **Persistent attribution** - All work tracked for agent evaluation and A/B testing\n- **Durable workflows** - Molecules survive restarts via checkpointing\n- **NDI resilience** - Useful outcomes despite unreliable individual processes\n- **Three-tier hooks** - Base -> Role -> Rig+Role hierarchy for configuration\n",
    "documents": [
      "specialization:gastown"
    ]
  },
  "outgoingEdges": [
    {
      "from": "page:library-gastown",
      "to": "specialization:gastown",
      "kind": "documents"
    }
  ],
  "incomingEdges": [
    {
      "from": "page:index",
      "to": "page:library-gastown",
      "kind": "contains_page"
    }
  ]
}