# software-factory

software-factory is a Claude Code skill that establishes a strict architectural vocabulary for agentic coding factories. Organizes services into slots and breaks workflows into isolated task runs.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 88 repo stars
- Author: alexj11324
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/skills/software-factory/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/software-factory

## What it does

The skill standardizes system design for autonomous development setups where agents convert issue tickets and pull requests into merged code. It eliminates vague terms such as workflow, sandbox, or dispatch. The architecture relies on specific concepts: Task, Trigger, Run, and Runner.

Designs separate generic service slots from the custom tasks moving between them. Slots cover the ticket tracker, ticket source, git host, orchestrator, and observability platform. To prevent uncontrolled agent output, the framework mandates clear brakes: deterministic automated tests, cold automated diff review, and human sign-off before merge. Runs execute on ephemeral machines and never pause to wait for live human input.

Frontmatter specifies `disable-model-invocation: true`. The assistant will not activate the skill during ordinary coding tasks, applying it only when whiteboarding factory architecture. Completing a design requires resolving five questions per task: its trigger, service read/writes, next actions, human re-entry point, and concurrency safeguards.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill software-factory -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/software-factory/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/software-factory/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill software-factory -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/software-factory/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill software-factory -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/software-factory/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alexj11324/Mikka .claude/skills/software-factory
```

2. **Manually: put the files in place**
- File: `.github/skills/software-factory/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill software-factory -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/alexj11324/Mikka --path .claude/skills/software-factory
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/software-factory/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/skills/software-factory/SKILL.md

## When to use it
- Design an autonomous agent pipeline for handling issues and pull requests
- Map infrastructure components into standardized service slots
- Implement tiered guardrails with tests, agent review, and human sign-off
- Prevent redundant runs and duplicate ticket creation across runners

## Example prompts
- Design a software factory architecture using Linear and ephemeral runners
- Help me map out the tasks and triggers for an automated PR review loop
- Review my agent pipeline design against the software-factory terminology

## Similar
- [openrig-software-factory](https://affpapa.org/en/nevibecode/skills/openrig-software-factory.md) — skill · ★ 8928 repo stars
- [mastra-factory](https://affpapa.org/en/nevibecode/skills/mastra-factory.md) — skill · 6200 installs
- [factory-deferred-repositories](https://affpapa.org/en/nevibecode/skills/factory-deferred-repositories.md) — skill · ★ 720 repo stars
- [releasing-software](https://affpapa.org/en/nevibecode/skills/releasing-software.md) — skill · ★ 339 repo stars
- [factory-mcp](https://affpapa.org/en/nevibecode/skills/factory-mcp.md) — skill · ★ 720 repo stars
- [factory-guide](https://affpapa.org/en/nevibecode/agents/factory-guide.md) — subagent · ★ 907 repo stars

From the same set: [alexj11324/mikka](https://affpapa.org/en/nevibecode/by/alexj11324/mikka.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
