Factory Spec

by addyosmani

Factory Spec is an AI Engineering skill for Claude Code, published by addyosmani in factory.

174 stars13 forkson addyosmani/factoryAdded 2026/09/07+1% in starsRepository updated 2026/08/21

View source on GitHub Download repo ZIP

agentic-engineeringclaude-codecodexsoftware-factory

Install in seconds

Install Factory Spec

Copy Factory Spec into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/addyosmani/factory/tree/main/template/.claude/skills/factory-spec ~/.claude/skills/factory-spec

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/addyosmani/factory.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: template/.claude/skills/factory-spec/SKILL.md in addyosmani/factory
Installs to: ~/.claude/skills/factory-spec
Collection: One of 12 skills cataloged from this repository
Category: AI Engineering — 3475 skills

What Factory Spec does

Factory Spec turns a ready-to-spec queue item into an approved plan through four human review gates. Use it when scope must be decided before code exists, such as for a feature, migration, or other interactive planning task.

Factory Spec is cataloged under AI Engineering on DirSkills. Factory Spec comes from a repository tagged agentic-engineering, claude-code, codex and software-factory.

Documentation

README

Excerpt

Factory spec

This skill exists because the cheapest place to fix a decision is before any code encodes it. Once a model has written a thousand lines, changing direction is expensive and every instinct is to patch instead.

This skill is interactive. It stops and waits for a human. Do not run it inside an unattended routine; a routine that approves its own spec has no gates at all.

Read docs/factory/CONTRACT.md and docs/factory/CHARTER.md before gate 1.

Gates

Four, in order. Stop at each one. Never merge two gates into a single pass. Never proceed on an inferred approval: "looks good" on gate 1 is not approval of gate 2.

Write each gate's output into docs/factory/specs/FQ-<n>/ as its own file, and track approvals in docs/factory/specs/FQ-<n>/00-status.md.

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Factory Spec

What else does addyosmani publish alongside Factory Spec?
Factory Spec is one of 12 skills that DirSkills catalogs from addyosmani/factory, the repository it ships in. Its siblings there include Factory Implement, Factory Implementation and Factory Monitor. Each one is a separate skill with its own page in this directory, installs the same way Factory Spec does, and is maintained by addyosmani in that same repository. The rest of the collection is listed on the addyosmani/factory page.
How does Factory Spec compare to other AI Engineering skills?
Factory Spec ranks #3218 by stars among the 3475 AI Engineering skills in this catalog. The most-starred ones next to it are Architecture Decision Records, AI-First Engineering and Agentic OS. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Factory Spec against them. Open each page to compare what they document and how they install.