# factory

> A Claude Code plugin that runs a software factory loop for coding agents.

## Docs

- [Introduction](https://drew-simmons.github.io/factory): factory is a Claude Code plugin that runs a software factory loop for coding agents. The human agrees a spec and a plan; the agent builds, verifies, and ships one slice at a time.
- [Quickstart](https://drew-simmons.github.io/factory/quickstart): Install the plugin, set up one repository, and run the loop once.
- [When to reach for factory](https://drew-simmons.github.io/factory/when-to-use): Not every change needs a spec, a plan, and a stack of pull requests. Size is about agreement and blocking edges, not line count. This page sizes a change as small, medium, or large and says which skills each size needs.
- [The loop](https://drew-simmons.github.io/factory/workflow): One feature, every stage, and the artifact each stage leaves behind.
- [factory.toml](https://drew-simmons.github.io/factory/factory-toml): One file per repository, written by /factory:setup. Every key has a default, so a short file is a correct file.
- [The verify loop](https://drew-simmons.github.io/factory/verify-loop): One command, one exit code. The script owns the stage order; the skill owns the fixes.
- [Upstream skills](https://drew-simmons.github.io/factory/upstream): The method inside each skill comes from vendored upstream skills, pinned by content hash and never edited by hand.
- [Development](https://drew-simmons.github.io/factory/development): Tests, validation, evals, and how to run this documentation site.

## Skills

- [Skills](https://drew-simmons.github.io/factory/skills): One page per skill. Each skill is a portable SKILL.md wrapper over vendored upstream method files, with factory's own rules on top.
- [setup](https://drew-simmons.github.io/factory/skills/setup): Write factory.toml once per repository so the other skills do not ask the same questions on every run.
- [spec](https://drew-simmons.github.io/factory/skills/spec): Align the user and the agent on one spec.md before any code.
- [plan](https://drew-simmons.github.io/factory/skills/plan): Break an agreed spec into vertical slices with blocking edges, stacked branch names, and parallel waves.
- [implement](https://drew-simmons.github.io/factory/skills/implement): Build one planned slice with test-driven development, or walk the whole plan frontier with implementer agents in git worktrees.
- [simplify](https://drew-simmons.github.io/factory/skills/simplify): Make the change smaller and plainer while every test keeps passing.
- [verify](https://drew-simmons.github.io/factory/skills/verify): Run the verification loop on the current change, then fix only what it names until it exits 0.
- [pr](https://drew-simmons.github.io/factory/skills/pr): Publish one green slice as one PR in a base-branch stack and hand it to the reviewer, human or bot.
- [review](https://drew-simmons.github.io/factory/skills/review): Find the defects the author would fix, on two axes that never mask each other, and hand them back without touching the code.
- [run](https://drew-simmons.github.io/factory/skills/run): Drive the whole loop for one change at a chosen size, stop only at the human gates, and resume from disk.
- [steward](https://drew-simmons.github.io/factory/skills/steward): Drive an open stack of PRs to merge-ready, lowest unmerged PR first, through conflicts, review threads, and CI. Never merges.
- [explain-diff](https://drew-simmons.github.io/factory/skills/explain-diff): A rich, interactive HTML explanation of a change, diff, branch, or PR. Outside the loop.

## Agent skills

- [factory](https://drew-simmons.github.io/factory/.well-known/agent-skills/factory/SKILL.md): Read the factory docs instead of answering from memory. A Claude Code plugin that runs a software factory loop for coding agents. Use when a task involves factory: how it works, how to set it up or configure it, or its API.

## Agent resources

- [llms-full.txt](https://drew-simmons.github.io/factory/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](https://drew-simmons.github.io/factory/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](https://drew-simmons.github.io/factory/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at https://drew-simmons.github.io/factory/openapi.json.
- [Agent skills](https://drew-simmons.github.io/factory/.well-known/agent-skills/index.json): Agent Skills discovery index of the skills this site publishes.
- [API catalog](https://drew-simmons.github.io/factory/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [AI catalog](https://drew-simmons.github.io/factory/.well-known/ai-catalog.json): ARD manifest of the agent-facing resources on this site (MCP server, skills, APIs).
- [agent-readability.json](https://drew-simmons.github.io/factory/agent-readability.json): Manifest of every agent-facing artifact on this site.
- [Sitemap](https://drew-simmons.github.io/factory/sitemap.xml): Every indexable page URL with its last-modified date.