factory

Turn tickets and requests into isolated changes with testable acceptance criteria and executable delivery gates.

1|Updated Sep 22, 2026

Search Tags:#testing #code review #claude code #codex #acceptance criteria #worktree #gates #delivery

Ready to run

npx skills add https://github.com/oleg-koval/factory --skill factory-oleg-koval

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: factory
Source: https://github.com/oleg-koval/factory
Command: npx skills add https://github.com/oleg-koval/factory --skill factory-oleg-koval

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? AI coding agents often claim work is delivered without proof. Factory enforces a phased workflow where an agent must produce testable acceptance criteria, isolate changes in a worktree, prove tests fail before and pass after the fix, and pass an executable gate before claiming a terminal state. ## Core Features & Use Cases - Phased delivery workflow: Intake, Isolate, Diagnose, Plan, Build, Prove, and Stop phases with executable gates between each phase. - Executable terminal gate: `scripts/gate.py` validates state.json, open questions, acceptance criteria matrix, isolation, and receipts before allowing a terminal state. - Change scanning: `scripts/change-scan.sh` expands review beyond diff hunks to full file text, callers, concurrency markers, and migrations. - Use Case: A Linear ticket is converted into an isolated worktree with a failing end-to-end test, milestone reviews, and a final gate that issues one of four terminal states: delivered, delivered-with-gaps, blocked, or intentionally-unchanged. ## Quick Start Ask the agent to run Factory on a ticket or request, then resume the run with the slug to continue through the phases.

Frequently Asked Questions about factory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I install Factory for Claude Code and Codex?▼

Install Factory with `npx --yes skills add oleg-koval/factory -a claude-code -a codex -y`. This installs project-local skills in the current repository. The install guide has host-specific commands and first-use examples.

What terminal states does Factory support?▼

Factory supports four terminal states: delivered, delivered-with-gaps, blocked, and intentionally-unchanged. The gate blocks delivered without isolation acceptance and requires all acceptance criteria met for delivered.

How does Factory enforce delivery claims?▼

Factory uses an executable gate that checks state.json, open questions, acceptance criteria matrix, isolation, and receipts. The gate rejects unknown states, unresolved blocking questions, invalid acceptance statuses, and isolation violations.

Does Factory work with both Claude Code and Codex?▼

Factory runs on Claude Code and Codex. The Codex skill picker may show a user-wide skill with the same name as the project-local one; the path-directed prompt avoids relying on ambiguous name selection.

What are the limitations of Factory?▼

Factory does not publish, push, open a pull request, deploy, or send a message merely because local checks pass. Those remain separate authorization and delivery gates. It also does not claim independent adoption, performance outcomes, or a complete cross-provider run.