The Claw: Minions of Toil
Agent architecture taught through game design patterns, with the course skeleton wired up before the lessons are fully written.
The dungeon is still being built in public. This structured content stub gives The Claw a real route, manifest, and companion surface before the lesson text is fully written.
Expect the first lessons to emerge from the game-design research, the taxonomy work, and the exploratory builds happening in the course repo.
Lesson outline
- Enter The Hollows — Install the skill. Your coding agent becomes a Zot. A dungeon generates. You're playing.
- Give the Zot Hands — Add tools via defineCommand. The Zot can scry, inscribe, invoke — act on the filesystem.
- The Zot Speaks — Wire the Zot to an LLM with AI SDK. streamText + tools. The Zot thinks, acts, narrates.
- The Tick — Build the game loop. Services boot on the filesystem, produce output, depend on each other.
- Services — Build services that run on the tick — database, webserver, monitor. Dependencies and cascading failure.
- The Task Queue — A service that generates work. Tasks arrive in the inbox. The Zot processes them.
- Chaos — The chaos agent breaks things. Delete pid files, corrupt configs, flood logs. The Zot must detect and repair.
- The Grue — Unobserved destructive autonomy. Things you can't see will kill you. Build observability or die.
- Resource Pressure — Every action costs tokens. Track real usage. The numbers are real. Learn when to act and when to conserve.
- You Watch — The Zot runs autonomously. You set policy. The operator paradigm — manage, don't micromanage.
- The Scorecard — The run IS an eval. Build the trace — commands, tokens, service health, encounter response time.
- Your Zots Are Ready — Point them at something real. Or don't. They're Zots.
Lesson sequence
Build it step by step
Lesson 1
Enter The Hollows
Lesson 2
Give the Zot Hands
Lesson 3
The Zot Speaks
Lesson 4
The Tick
Lesson 5
Services
Lesson 6
The Task Queue
Lesson 7
Chaos
Lesson 8
The Grue
Lesson 9
Resource Pressure
Lesson 10
You Watch
Lesson 11
The Scorecard
Lesson 12
Your Zots Are Ready
Companions
Bring the skill along
the-claw-minions-of-toil
Companion skill for The Claw: Minions of Toil course. This skill is in early development — it will grow as lessons are built. Say "teach me" to start, or ask any question about agent architecture through game design patterns.
companion/skills/the-claw-minions-of-toil/SKILL.md