Actual Factory Demo — Git skill for Claude Code

Actual Factory Demo

Build a working software factory on Claude Code in 15 minutes with Gas City, then watch five agents carry a task from a queue to an open pull request fully autonomously.

Table of contents

• Software Factory Overview
• Walkthrough
  • 1. Install the prerequisites
  • 2. Fork this repo
  • 3. Create the factory
  • 4. Install the pack
  • 5. Seed the task queue
  • 6. Run a task
• Join our Software Factory Intensive for more!

Software Factory Overview

This tutorial uses the [Gas City](https://github.com/gastownhall/gascity) framework to build a complete software factory layer on top of Claude Code. This repo acts as the workspace, or **rig**, that the factory works on. You hand the factory a task, and five agents pass it between themselves until the result lands as a pull request you may review.

flowchart LR
    Q["Task queue
(beads)"] --> P["planner
writes acceptance"]
    P --> B["builder
writes the file"]
    B --> A["architect
gate 1: ADRs"]
    A --> R["reviewer
gate 2: acceptance"]
    R --> M["manager
reports + closes"]
    M --> PR["Pull request
on your fork"]
    PR -.->|you merge| Main["main"]
    A -.->|violations| B
    R -.->|needs changes| B

The work itself is simply to produce ASCII art for a letter, with a rhyming couplet underneath each. The focus, though, is on understanding how work gets dispatched, who reviews it, and where the quality gates sit.

Walkthrough

1. Install the prerequisites

Install

Homebrew runs on both macOS and Linux, and `gascity` declares `bd`, `dolt`, `jq`, `tmux`, and `flock` as dependencies, so one line covers the whole stack:

brew install gascity gh git
gh auth login

`pgrep` and `lsof` a