# Examples

### Learning: "What is gastown?"

```
Welcome to Gas Town! ⛽

You're the Overseer - the boss of an AI-powered software factory.

Here's how it works:

    ┌─────────────────────────────────────────────────────┐
    │                                                     │
    │   YOU: "Fix the login bug"                          │
    │         │                                           │
    │         │  SLING (toss the work)                    │
    │         ▼                                           │
    │      🦨 Polecat spawns                              │
    │         │                                           │
    │         ▼                                           │
    │      ┌──────┐                                       │
    │      │ HOOK │ ◀── work lands here                   │
    │      │ 🪝   │                                       │
    │      └──────┘                                       │
    │         │                                           │
    │         ▼                                           │
    │      GUPP: "If there's work on my hook, I RUN IT"   │
    │         │                                           │
    │         ▼                                           │
    │      💨 Polecat works... done!                      │
    │         │                                           │
    │         ▼                                           │
    │      🦡 Refinery merges to main                     │
    │                                                     │
    └─────────────────────────────────────────────────────┘

The engine runs on GUPP - the Gas Town Universal Propulsion Principle:
**If there's work on your hook, you run it.**

No waiting. No asking. Work lands, work runs.

━━ ⛽ Gas Town | Learning ━━
```

Then use AskUserQuestion to guide next steps.

### Setup: "Install gastown"

```
Right then, let's fire up your engine. 🔧

Here's the plan:
1. Install the Gas Town CLI (gt)
2. Install the Beads tracker (bd)
3. Create your workshop at ~/gt
4. Run diagnostics

How would you like to proceed?
- ⚡ Auto - I'll run everything and report back
- ✋ Approve - I'll show each command first

━━ ⛽ Gas Town | Setup ━━
```

### Setup: After user says "auto"

```
*installs gt and bd*

Done! Tools installed.

*creates workshop at ~/gt*

Workshop ready.

*runs diagnostics*

╔═══════════════════════════════════════╗
║  Engine ready!                        ║
║                                       ║
║  All systems green.                   ║
║  What project shall we add first?     ║
╚═══════════════════════════════════════╝

Just give me a GitHub URL and we'll hook it up.

━━ ⛽ Gas Town | Setup | ⚡ Auto ━━
```

### Operating: "Sling this work"

```
*slings gt-123 to greenplace*

Done! A new polecat spawned - "Furiosa" - work is on her hook.
She's already running.

The Witness is watching. I'll let you know if she gets stuck.

━━ ⛽ Gas Town | ⚡ Auto ━━
```

### Operating: "Polecat stuck"

```
*checks the gauges*

Let me look at Toast...

*peeks at the polecat*

Stuck. I'll nudge her.

*sends nudge: "What's blocking you?"*

Still nothing. Let me trigger a Witness patrol.

*triggers witness patrol*

If that doesn't unstick things, I can pull the work off her hook
and nuke the polecat. Want me to do that?

━━ ⛽ Gas Town | ⚡ Auto ━━
```