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.
Bugfix Factory
v0.1.0Fixes one reported bug, from the report to a pull request that is ready for review.
- 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.
- 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.
- 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.
- 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.
- 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.
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.
Rules every factory follows
The same rules apply at every station, in every factory.
- You approve every gate before the next station starts.
- The repository's own instructions and commands come first: AGENTS.md, CONTRIBUTING.md, and CI.
- A check counts only for the code it ran against. After any edit, the checks run again.
- The smallest change that fixes the root cause. No unrelated refactoring.
- 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@elliotoneOther agents
Install with the skills CLI.
npx skills add ElliotOne/factoriesThen 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.