Skip to content

Repository files navigation

Software Factory Intensive

Hosted by Actual AI

Table of Contents

Overview

This is a multi-step software factory intensive to give participants tools and principles to configure complete software factories for their use case. Participants will learn how to think about the dimensions of configurations for software factories and how to elevate their software development infrastructure above individual coding agents.

The curriculum runs over two days. Day 1 stands up a working factory and takes it apart to see how it is made: packs, agents, formulas, orders, and the five ways agents coordinate. Day 2 points that machinery at a project of your own and extends it, from a menu of options you choose between rather than a fixed sequence.

You start from a base factory that already works, built on the out-of-the-box examples that ship with Gas City and two reference agents from Gas Town, mol-polecat-work and mol-refinery-patrol. What you layer on top is your choice: GitHub pull requests and quality gates are already in the base, and the options add specialized reviewer agents, an architecture-best-practices loop, a multi-model review, a gate at the front of the queue, and a loop that lets the factory propose changes to itself.

About Gas City

Gas City is an open-source framework for running multi-agent systems. It abstracts the primitives of multi-agent coordination — agents, packs, rigs, beads, sessions, orders, routes — so that any multi-agent architecture can be expressed within the same framework rather than re-invented each time. Once you've learned the primitives, you can swap out the specific agent roles and build pipelines for code review, research, data processing, ops automation, etc.

For the authoritative definitions of every Gas City term (agent, pack, rig, bead, sling, order, route, formula, overlay, etc.), see the Gas City glossary. Brief term map:

Gas City Term Analogous Term
bead Issue / ticket / task
convoy Epic / batch
dog Daemon / cron worker
formula Workflow / pipeline / recipe
mail Message / inbox item
order Cron job / scheduled task
pack Plugin / module / package
rig Workspace / repository
sling Job dispatch / enqueue

Community & Support

Stuck on a step, want to share what you've built, or looking to collaborate with other participants? Join the Actual AI User Community Slack to ask questions and get help from other participants.

Prerequisites

CLI Coding Agent Subscription (or API key)

You’ll need at least one coding agent subscription (or API key) to run the workshop. Having more than one gives you broader capabilities and redundancy.

  • Recommended: Claude Code Max (20x) or Codex Pro (20x)
  • Minimum: Claude Code Max or Codex Pro (standard tier)
  • Alternatives: Gemini CLI, OpenCode (compatibility not guaranteed)

Actual Factory Demo

To prepare for the workshop, please install the Actual Factory Demo and follow the instructions to get it running. This proves your machine is ready to go and gives you a hands-on understanding of the basics of Gas City.

Curriculum Structure

Two days. Workshops (W) are instructor-led, while labs (L) are participant-led.

Day 1: run and explore a standard software factory

Session Type Duration Title Page
W1 Workshop 30 min Vocabulary and Concepts W1
W2 Workshop 45 min Cloud Box and Preflight W2
W3 Workshop 60 min Run Your Factory W3
W4 Workshop 60 min Tour the Factory W4
W5 Workshop 30 min Observability and Traceability W5
L1 Lab 45 min Point the Factory at Your Own Project L1
L2 Lab 30 min Capability Map (starts) L2

Day 2: build your own software factory

Session Type Duration Title Page
L2 Lab 30 min Capability Map (finishes) L2
L3 Lab 45 min First enhancement — one of the six options L3-L5
W6 Workshop 60 min Advanced Concepts W6
L4 Lab 60 min Second enhancement L3-L5
W7 Workshop 45 min Sharing Your Factory W7
L5 Lab 45 min Third enhancement L3-L5

Six Enhancement Ideas

The three feature labs draw on the same menu of options. In L3 you pick one of these six, then in L4 and L5 you can either choose one you have not used yet, or a feature of your own from your capability map.

Option Solves
Bead creation formula extensions Beads arrive with no design, test or docs thinking attached
Specialized domain reviewers One reviewer judging everything reviews nothing well
Architecture best-practices loop Reviews are opinions rather than scores against named principles
Strengthen the review system One model is one point of view, and it is confidently wrong sometimes
Self-improvement loop The factory produces evidence about itself and nobody reads it
Bead gate checks Work reaches an implementer under-specified and it has to guess

The Base Factory

W3 installs one pack, base-factory, and gets a working multi-agent factory with an example of every Gas City primitive already running in it: formulas, an agent persona, orders, a rig, and mail. Day 2 extends it.

The four appendix pages assemble that same factory by hand, step by step. They are off the taught path and worth reading when you want to know why a layer exists rather than what it does.


Ready? Start at W1 Vocabulary and Concepts.

About

Software factory tutorial

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages