---
title: "Build a local software factory in 10 minutes"
url: https://akdarrah.com/posts/build-a-local-software-factory
author: Adam Darrah
published: 2026-10-09T15:57:39Z
updated: 2026-10-09T15:57:39Z
tags: ["ai","tools"]
---

# Build a local software factory in 10 minutes

Almost everything I build goes through the same lifecycle: read the ticket, plan, build, review, QA, and decide whether it's safe to ship. I was doing those steps by hand with my local Claude agent every time, so I turned them into a factory: a skill that runs the process, and a Claude Code mod that shows me where any session is in it.

It takes one prompt and about ten minutes to set up.

## The prompt

Paste this into Claude Code. I use Linear and CircleCI; swap in your own tracker and CI where noted.

```text title=factory-prompt.txt
I want a local "software factory": a skill plus a Claude Code mod that walks every piece of
work through the same lifecycle and shows me where we are at a glance.

Create a skill called /factory that takes a ticket from my issue tracker (I use Linear; swap
in Jira, GitHub Issues or whatever you use) and runs these steps in order:

1. Ticket. Read the ticket and restate the problem. Then verify it independently. Tickets
   are often incomplete or out of date, so check every claim and proposed solution against
   the code before trusting it.
2. Plan. Propose a solution using the normal planning flow. I'll review it, and we iterate
   until I approve the plan.
3. Build. Implement the approved plan on your own, without checking in, and open a pull
   request.
4. Review. Do rounds of code review and fix every critical or important finding. Repeat
   until a round finds nothing critical or important, however many rounds that takes.
5. QA. Test as many permutations of the change as you can. Use the Claude in Chrome
   extension for anything with a UI, and automated tests or scripts for everything else.
   Keep going until everything that can be tested has been.
6. QA report. Publish an artifact with screenshots of what you tested, and link it in the
   pull request.
7. Risk report. Assess the real-world risk of merging and deploying: the blast area, the
   blast radius, and anything real users might notice. If the work is behind a feature
   flag, verify nothing leaks outside the flag.

Then build a mod that shows a band above the prompt whenever a session is running /factory,
with:
- the current step, and which steps are done
- a link to the ticket
- a link to the pull request
- the CI status (I use CircleCI; swap in GitHub Actions, Buildkite or yours)

Animate the move from one step to the next, and celebrate when everything is done. Give it
a Matrix theme. Finally, add a demo command that plays through the whole lifecycle, so I can
see every step without running real work.
```

The skill does the work; the mod is how you keep track of it. When I glance at a session I can see the step, the ticket, the PR and whether CI is green, without scrolling back through the transcript.

## Pick a theme

I went with the Matrix, but the mod is just a drawing, so make it yours. Here are four directions, all running the same session. To use one, replace "Give it a Matrix theme." at the end of the prompt with its line. Or describe your own; anything you can draw in a terminal works.

### The Matrix

![The Matrix mod](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MSwicHVyIjoiYmxvYl9pZCJ9fQ==--4eeec335317345263a96eb006b0b29a495099609/factory-matrix.webp "Matrix theme: green code rain behind every step")

```text title=theme-matrix.txt
Give it a Matrix theme: green code rain behind the band that surges on every step change,
finished steps glowing solid green, and "FACTORY COMPLETE" glitching in at the end.
```

### Assembly line

![Assembly line mod](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MiwicHVyIjoiYmxvYl9pZCJ9fQ==--e6683d1a8d5fef7ade1d67251cb2cd385e962238/factory-assembly.webp "Assembly line theme: a crate is stamped at every station")

```text title=theme-assembly.txt
Give it an assembly-line theme: a crate rides a conveyor belt past a press for each step,
gets stamped as each step passes, and is stamped SHIPPED with confetti at the end.
```

### 8-bit level map

![8-bit level map mod](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6MywicHVyIjoiYmxvYl9pZCJ9fQ==--d06a41ba25a2d10b4787108f9a2436ec8acc8973/factory-arcade.webp "8-bit theme: one level per step")

```text title=theme-arcade.txt
Give it an 8-bit level-map theme: a small original pixel character hops from level to level,
"LEVEL CLEAR!" and a coin between steps, and a "YOU WIN / SHIP IT!" banner at the end.
```

### Mission control

![Mission control mod](/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6NCwicHVyIjoiYmxvYl9pZCJ9fQ==--771ba7cb8489401ea4d3efbfb133c6c38a0debdc/factory-mission.webp "Mission control theme: GO/NO-GO for every stage")

```text title=theme-mission.txt
Give it a mission-control theme: a stage light per step that goes STANDBY, GO, NOMINAL,
a T-minus countdown, CI as a GO/NO-GO light, and a rocket lifting off at the end.
```

## A few tips

- **Run the demo first.** It plays the whole lifecycle in a few seconds, which is the fastest way to tune the animations before you trust it with real work.
- **Keep the review loop strict.** "Repeat until a round finds nothing critical or important" is the line that does the most work. It might take two rounds, or it might take ten.
- **Make the risk report about users.** The best ones read like a note to whoever is on call: what could break, who would notice, and how to turn it off.