What do you want to do?
4 use cases
-
Install the Factory into an existing GitHub project
Add the committed Claude and Codex Factory files to a repo and check the setup with doctor.
- Factory
- Claude Code
- Codex
- Software and DevOps
- Intermediate
View prompt
Using the addyosmani/factory repository, install the factory into <target-repo-path> by running install.sh against it. Then run .factory/scripts/doctor.sh inside the target and report every finding. Expected output: a list of remaining setup gaps, or confirmation that none remain. Verify that docs/factory/CHARTER.md exists in the target.
-
Turn small labeled issues into reviewed draft pull requests
Let scheduled agents implement charter-allowed issues on claimed branches and open draft PRs for review.
- Factory
- Claude Code
- Software and DevOps
- Advanced
View prompt
In the addyosmani/factory setup of <target-repo>, pick one issue labeled factory:ready-to-implement and run the implementation stage on it. Expected output: a draft pull request with its gate results and verifier verdict. Verify that no merge was performed and that the PR is still open as a draft.
-
Sort an issue backlog into implement, spec, or wait
Have a triage run classify each untriaged issue and write a handoff comment with its gate level.
- Factory
- Claude Code
- Codex
- Software and DevOps
- Intermediate
View prompt
Using the addyosmani/factory skills in <target-repo>, run the triage stage on the open untriaged GitHub issues. Expected output: a list of issues with the factory:* label applied to each and a one-line reason. Verify that no code was changed and that every issue has exactly one queue label.
-
Get a weekly health sweep that files issues for findings
Run a monitor that checks the default branch and Factory health, then files findings as GitHub issues.
- Factory
- Claude Code
- Software and DevOps
- Advanced
View prompt
For the factory installed in <target-repo>, run the monitor stage once and report the issues it would file. Expected output: a list of proposed issue titles and the default-branch or setup finding behind each. Verify that the stage lists findings before filing any issue.
How to use Factory
- Check you have what it needs: A GitHub project you control, with permission to create labels and manage its pull requests; Claude Code installed, or Codex if you use the Codex adapter; A clone of the addyosmani/factory repository.
- Open addyosmani/factory on GitHub and read the README and license.
- Clone the addyosmani/factory repository to your machine.
- Run
install.shagainst the target repository you want to automate. - Open the target repository in your coding agent and fill in
docs/factory/CHARTER.md. - Run
.factory/scripts/doctor.shand fix every placeholder, missing label, or missing remote it reports.
These steps come from our top use case, Install the Factory into an existing GitHub project, which also has a copy-paste agent prompt.
Get 5 new use cases every morning. Free, one short email, unsubscribe anytime.
Get them freeFactory alternatives · Best AI repos for Software and DevOps
About this repo
- Who it is forEngineering teams or solo developers who already use GitHub Issues and want agents to triage work and open draft pull requests under human review.
- Why it is hot
- LanguageShell
- Sourcegithub.com/addyosmani/factory · Back to Hot repos
Requirements
- A GitHub project you control, with permission to create labels and manage its pull requests
- Claude Code installed, or Codex if you use the Codex adapter
- A clone of the addyosmani/factory repository
- Your project's real test, lint, and build commands, since the gates run them
- A human-owned docs/factory/CHARTER.md that defines scope, risk, and the review-queue limit
Maintain Factory? Add the Featured on Deduped badge
Paste this into your README:
[](https://dedupedai.com/use-cases/addyosmani-factory/?ref=badge)
Questions about Factory
What is Factory?
Factory is a shell-based reference that installs a repeatable, GitHub-backed software delivery loop into an existing project for Claude Code, with a thin Codex adapter. It is an open-source project on GitHub: https://github.com/addyosmani/factory.
Who is Factory for?
Engineering teams or solo developers who already use GitHub Issues and want agents to triage work and open draft pull requests under human review.
What can I do with Factory?
4 use cases so far, for example: Install the Factory into an existing GitHub project; Turn small labeled issues into reviewed draft pull requests; Sort an issue backlog into implement, spec, or wait. Each has steps and a copy-paste agent prompt.
What do I need to run Factory?
A GitHub project you control, with permission to create labels and manage its pull requests; Claude Code installed, or Codex if you use the Codex adapter; A clone of the addyosmani/factory repository; Your project's real test, lint, and build commands, since the gates run them.
What are alternatives to Factory?
Other hot AI repos in Software and DevOps: Harness2, iFixAi, Orca, Diagram Design, AI Memory.
Is Factory safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.