build-dark-factory

Build an autonomous repository that turns issues into validated, merged code from a PRD.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/az9713/claude-code-hooks-tutorial --skill build-dark-factory-az9713
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-dark-factory
Source: https://github.com/az9713/claude-code-hooks-tutorial/tree/main/skills/.claude/skills/build-dark-factory
Command: npx skills add https://github.com/az9713/claude-code-hooks-tutorial --skill build-dark-factory-az9713

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? It removes the human bottleneck from AI-assisted coding by constructing a "dark factory" inside your repository: work enters as an issue and ships as validated, merged code with nobody at the keyboard, encoding the AI coding process you already run rather than replacing it. ## Core Features & Use Cases - Five-component construction: Builds the guidance layer (MISSION.md, FACTORY_RULES.md, conventions file), the validation harness, the workflow-driven repo, deployment, and finally the autonomy trigger, in a deliberate order that earns the right to walk away. - Structured interview and refusal logic: Reads your PRD, inspects the repo for observability, refuses unsafe builds early, and runs a three-round question-tool interview with recommended defaults. - Agent-agnostic templates and audits: Ships runner and harness templates (http, cli, and library drivers) plus audit scripts that verify the factory machinery itself, working with Claude Code, Codex, Cline, Goose, and other coding agents. - Use Case: You have a PRD for a new service and want overnight, unattended development. Run the skill with the PRD path and repo path; it interviews you, writes the governance files, scaffolds the validation harness and workflows, and stops before enabling the cron trigger until every gate is proven. ## Quick Start Ask the agent to build a dark factory from your PRD file into your repository by providing the PRD path and the repo path.

Frequently Asked Questions about build-dark-factory

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

FAQPage Schema
How do I build an autonomous coding repository from a PRD?▼

Provide the PRD path and repository path to the skill, which reads the PRD, interviews you in three rounds, then builds the guidance layer, validation harness, workflows, and deployment in order. The autonomy trigger is enabled last, only after every gate is proven.

What is a dark factory in AI coding?▼

A dark factory is a repository where work arrives as an issue and ships as validated, merged code with no human reviewing the diff. Workflows plan, build, validate, and merge changes while deployment carries them to real users.

Does build-dark-factory work with coding agents other than Claude Code?▼

Yes, it is agent-agnostic and supports Claude Code, Codex, Archon, the Agent SDK, Cline, Goose, Amp, and Pi. It encodes your existing AI coding process rather than imposing a specific agent or framework.

Can I build a dark factory on a greenfield repo with no code yet?▼

Yes, greenfield is the common case. The skill builds the guidance layer first, then a deliberately tiny walking skeleton with one assertable behavior, requiring logic to live behind a headless, scriptable surface an end-to-end test can drive.

When should I not use an autonomous coding factory?▼

Avoid it when there is no PRD, no way to observe the software working, no tests or CI, or when the agent would touch auth, payments, or other blast-radius areas you cannot absorb. The skill refuses these cases and offers a smaller guidance-layer-only build.

What autonomy level does the dark factory target by default?▼

Level 3 is the recommended default, where the validator auto-merges when every structural gate is green. Levels 0-2 are stages on the way, while levels 4 and 5 hand over triage and issue-writing and are separate decisions.