gas-town-workflow
Skill5 starsChanged 23 days agoMITView on GitHub
Coordinate agents with Gas Town role mapping and convoy-based task decomposition. Use only when the user explicitly requests Gas Town, convoy workflow, theatrical roles, or this repo's agent-role system; not for generic parallel work.
In this repository47 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- agents-md-fixerSkill
- arch-docsSkill
- book-to-markdownSkill
- docset-updaterSkill
- humanizerSkill
- news-release-docsSkill
- pdf-guideSkill
- readme-docsSkill
- screenshot-docsSkill
- see-also-docsSkill
- setup-install-usage-docsSkill
- bptools-writer-expertSkill
- color-accessibility-expertSkill
- css-creative-expertSkill
- game-design-expertSkill
- geometry-expertSkill
- glass-expertSkill
- hic-human-interact-expertSkill
- openscad-3d-printing-expertSkill
- podman-expertSkill
- postgresql-expertSkill
- pyside6-engineerSkill
- rust-code-expertSkill
- solid-js-expertSkill
- svg-creator-expertSkill
- typescript-engineerSkill
- ui-ux-engineerSkill
- vision-expertSkill
- wasm-rust-expertSkill
- webwork-writer-expertSkill
- delegate-manager-to-subagentsSkill
- hang-checkSkill
- html-game-parallel-builderSkill
- parallel-planSkill
- stay-busySkill
- repo-rules-readerSkill
- blueprint-plan-drafterSkill
- ideonomy-plainSkill
- ideonomy-richSkill
- make-goalSkill
- modest-plan-drafterSkill
- audit-code-reviewerSkill
- old-python-code-reviewSkill
- prune-testsSkill
- unit-test-starterSkill
The file
We split this skill into the rules it gives an agent
6 rules. About 0 are common, 3 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 8
Use this only for an explicit Gas Town request.
- Distinctive: line 23
Read references/glossary.md when Gas Town terms or their tool equivalents matter.
- Distinctive: line 43
Use the repository role catalog for fuller authority and escalation detail.
- Very specific: line 49
Create one parent task for the initiative and atomic child tasks with role tags such as [CODER] or [TESTER].
- Very specific: line 51
Put Role, Convoy, and measurable Done when criteria in every task.
- Distinctive: line 61
Use direct messages for a specific escalation, coordination need, or completion signal.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Gas Town workflow
Use this only for an explicit Gas Town request. For ordinary approved-plan
execution, use delegate-manager-to-subagents; do not silently replace its
plain manager/coder/reviewer vocabulary with theatrical terms.
Operating contract
- GUPP: an assigned, unblocked task starts immediately.
- MEOW: decompose a goal into atomic, independently completable tasks with objective done-when criteria.
- NDI: preserve task state, detect failed or stalled work, retry or escalate it, and never silently drop it.
- A convoy is the grouped, dependency-ordered set of those tasks. Every task has one owner, an explicit role, a convoy name, a status, and a completion signal.
Read references/glossary.md when Gas Town terms or their tool equivalents matter. Read references/convoy-templates.md before creating a convoy.
Route work by role
| Gas Town role | Agent | Boundary |
| Crew | coder | Production code and small documentation updates |
| Refinery | integrator | Merge and conflict resolution |
| Witness | monitor | Observe progress and report stalls |
| Deacon | scheduler | Trigger retries; do not diagnose |
| Dogs | maintainer | Cleanup, lint, and index regeneration |
| -- | reviewer | Read-only code or plan review |
| -- | tester | Tests and validation |
| -- | architect | Cross-cutting design decisions |
| -- | planner | Plans and documentation only |
| -- | orchestrator | Parallel coordination |
Use the repository role catalog for fuller authority and escalation detail. Route design conflicts to architect, plan ambiguity to planner, implementation failures revealed by tests to coder, and detected stalls to orchestrator.
Create and run a convoy
- Create one parent task for the initiative and atomic child tasks with role
tags such as
[CODER]or[TESTER]. - Put
Role,Convoy, and measurableDone whencriteria in every task. - Set the dependency graph before assignment; give each task to its matching role and keep ownership exclusive.
- Each agent claims its highest-priority unblocked role-matching task, marks it in progress, performs the work, records evidence, and explicitly completes or escalates it.
- A monitor checks for genuine stalls; a scheduler retries work that has been diagnosed as retryable. At convoy close, verify every done-when criterion and shut down no-longer-needed teammates.
Use direct messages for a specific escalation, coordination need, or completion signal. Do not broadcast routine status. Dispatch a fresh subagent for each atomic task; status messages do not convert a finished task into a new editing assignment.
Escalation and completion
An agent outside its authority creates or updates the blocker, notifies the appropriate role, and continues with independent unblocked work. A completed task includes relevant test or review evidence, an updated task state, and a completion message to the lead. If no suitable task remains, report that fact to the lead rather than claiming another role's work.
For full templates, role vocabulary, and tool mapping, use the routed references above; they are intentionally outside this entrypoint's control plane.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

