Factories

Factories

Agent skills that run software work as gated pipelines. A factory is a fixed line of stations. Each station records its evidence and stops at a gate until you approve the next step.

  • Agent Skills format
  • MIT License
  • v0.1.0
bugfix-factory v0.1.05 stations · 5 gates · 1 run record

Bugfix Factory

v0.1.0

Fixes one reported bug, from the report to a pull request that is ready for review.

  1. Station 01

    Intake

    The bug as expected and actual behavior, the files in scope, and acceptance evidence that includes neighboring cases.

    Gate 1One bug, with clear acceptance evidence.

  2. Station 02

    Reproduce

    A new automated test that fails for the reported reason.

    Gate 2The test fails for the right reason, and no production code has changed.

  3. Station 03

    Fix

    The root cause in writing, and the smallest change that fixes it.

    Gate 3The new and neighboring tests pass, and the diff contains only the fix.

  4. Station 04

    Verify

    Results from the repository's own tests, linter, type checker, and build.

    Gate 4Every check passes on the final code, with no edits after the last run.

  5. Station 05

    Pull request

    A commit message and pull request description backed by the evidence.

    Gate 5You approve the commit, the push, and the pull request.

  6. Ready for review. A pull request with its evidence, waiting for a human reviewer.

Evidence, not claims

Every station writes to a run record in your repository, so a reviewer can see what was checked and why. This example uses the shipping bug from Issue #52.

.factories/bugfix/free-delivery-threshold.mdrun record
# Bugfix run: free delivery at exactly £50 ## 1. Intake- Expected: a £50.00 cart gets free delivery- Actual: it is charged £4.99- Acceptance evidence: [ ] 5000p and 5001p cost 0p [ ] 0p and 4999p cost 499p [ ] -1p raises ValueError- Gate: approved ## 2. Reproduce- Failing test: 5000p returned 499p, expected 0p- Gate: approved ## 3. Fix- Root cause: the threshold check used > instead of >=- Gate: waiting for approval

Rules every factory follows

The same rules apply at every station, in every factory.

  1. You approve every gate before the next station starts.
  2. The repository's own instructions and commands come first: AGENTS.md, CONTRIBUTING.md, and CI.
  3. A check counts only for the code it ran against. After any edit, the checks run again.
  4. The smallest change that fixes the root cause. No unrelated refactoring.
  5. Tests are never weakened, skipped, or deleted to make them pass.

Install

Claude Code

Add the marketplace and install the plugin in a session.

/plugin marketplace add ElliotOne/factories
/plugin install factories@elliotone

Other agents

Install with the skills CLI.

npx skills add ElliotOne/factories

Then ask your agent to fix a bug, or run /factories:bugfix-factory in Claude Code. Manual setup and update steps are in the README.

New stations and factories ship alongside The Modern Engineer. If your team wants hands-on help beyond the skills, XOREN, the company I founded, reviews and builds production AI systems.