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/.agents/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/.agents/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 an ambiguous factory issue into human-approved product, behavior, design, and implementation slices. Use it interactively before implementation and keep approval gates in the loop.

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

From the original repository

Factory specification for Codex

Read docs/factory/CONTRACT.md, docs/factory/CHARTER.md, and then the canonical workflow in .claude/skills/factory-spec/SKILL.md. Keep every human approval gate interactive. Use a fresh subagent for the critic pass when the workflow requires one.

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 #3217 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.