---
type: "post"
id: "zazencodes-season-3-src-software-factory-claude-code-a5263f"
slug: "zazencodes-season-3-src-software-factory-claude-code-a5263f"
title: "zazencodes-season-3/src/software-factory-claude-code-v2 at main: zazencodes/zazencodes-season-3"
description: "ZazenCodes has published an open-source Claude Code software factory that turns labeled GitHub issues into reviewed pull requests, with scripted checks and a human merge step."
retrieval_nugget: "ZazenCodes has published an open-source Claude Code software factory that turns labeled GitHub issues into reviewed pull requests, with scripted checks and a human merge step. For teams building with AI, its value is the workflow design: bounded roles, repository-specific gates, isolated worktrees, resumable jobs, and escalation when agents are not confident."
published_at: "2026-11-18"
updated_at: "2026-11-18"
record_date: "2026-11-18"
date_kind: "published_at"
topics: ["claude","claude-code","github"]
entities: ["ZazenCodes","Claude Code","GitHub"]
related_patterns: ["ai-native-orgs-move-to-review-and-orchestration"]
novelty_label: "new_fact"
what_changed: "The community breakdown specifies an initial Claude Code factory implementation with seven role definitions and a coordinating skill."
prior_refs: ["https://newruntime.com/posts/claude-code-game-studios-turn-claude-code-into-7b423e/"]
source_url: "https://github.com/zazencodes/zazencodes-season-3/tree/main/src/software-factory-claude-code-v2"
source_urls: ["https://github.com/zazencodes/zazencodes-season-3/tree/main/src/software-factory-claude-code-v2"]
schema_version: "newruntime-agent-readable-v0.2"
stable_id: "post:zazencodes-season-3-src-software-factory-claude-code-a5263f"
status: "published"
visuals: []
editor: {"role":"editor","name":"Andrey Reshetnikov","profile":"https://newruntime.com/owner-profile.md","profile_json":"https://newruntime.com/owner-profile.json","same_as":["https://www.linkedin.com/in/reshetnikov1/","https://t.me/lapetuse"]}
routes: {"html":"https://newruntime.com/posts/zazencodes-season-3-src-software-factory-claude-code-a5263f/","markdown":"https://newruntime.com/posts/zazencodes-season-3-src-software-factory-claude-code-a5263f.md","json":"https://newruntime.com/posts/zazencodes-season-3-src-software-factory-claude-code-a5263f.json"}
markdown_url: "https://newruntime.com/posts/zazencodes-season-3-src-software-factory-claude-code-a5263f.md"
---

# zazencodes-season-3/src/software-factory-claude-code-v2 at main: zazencodes/zazencodes-season-3

## Retrieval answer

ZazenCodes has published an open-source Claude Code software factory that turns labeled GitHub issues into reviewed pull requests, with scripted checks and a human merge step. For teams building with AI, its value is the workflow design: bounded roles, repository-specific gates, isolated worktrees, resumable jobs, and escalation when agents are not confident.

## Summary
ZazenCodes has published an open-source Claude Code software factory that turns labeled GitHub issues into reviewed pull requests, with scripted checks and a human merge step. For teams building with AI, its value is the workflow design: bounded roles, repository-specific gates, isolated worktrees, resumable jobs, and escalation when agents are not confident.

## What happened
The repository describes “Software Factory for Claude Code (v2),” a workflow that starts with GitHub issues labeled `factory`. Running `/factory run` drains the open queue, while `/factory run <n>` runs one issue. Intake assesses whether an issue is worth building and at what scope, can request more information or reject it, and rates risk and surfaces. A script then routes the job to reviewers and models using `config.json`.

Accepted work moves through a spec writer, builder, checks gate, reviewers, and approver. The builder writes code, commits and pushes a branch, then opens a draft pull request intended to close the issue. The gate runs the project’s `factory/checks.sh`; if it fails, reviewers do not run. Reviewers can request changes, sending the work through another round. On approval, the approver synchronizes with `main`, runs the gate again, and merges with `gh pr merge`. If the approver escalates, the pull request is left for a person and the issue receives a `factory:needs-human` label.

The included roles are intake, spec-writer, builder, code reviewer, security reviewer, UX reviewer, UI reviewer, and approver. Reviewer selection is conditional: UX and UI reviewers are added for UI changes, while the security reviewer runs when intake flags security. One Claude Code session orchestrates jobs, with concurrency configurable and a default of three. Each job gets its own git worktree and branch. Job state lives under `factory/jobs/`, allowing `/factory run` to resume work after a session ends.

The installation instructions require Claude Code 2.1.257 or later, Python 3, and an authenticated `gh` account able to push to the repository. The installer copies the skill, agent definitions, scripts, and dashboard, then asks the user to fill in project-specific test, lint, typecheck, and build commands in `checks.sh`, tailor reviewers, create GitHub labels, and verify that checks pass on `main`.

The README describes examples from a test run on a small private calculator repository, using concurrency 2 and Haiku for every agent. A low-risk function change passed with only code review; a UI change also used UX and UI reviewers. Another task was narrowed by intake, failed a gate because the builder edited a protected test file, and went to a human after three rounds. A crypto-miner issue was rejected at intake. The project is GPLv3; it says closed-source or commercial use requires a commercial license. It advises starting at concurrency 1 and reviewing every PR until the workflow is trusted.

## What the archive adds
New Runtime covered [Claude Code Game Studios](https://newruntime.com/posts/claude-code-game-studios-turn-claude-code-into-7b423e/) on 2026-11-06, a distinct Claude Code setup organized as a game-development studio. This repository is a new event, applying role-based orchestration to issue-to-PR software work rather than game production.

## Trend signal
This supports [AI-native organizations move toward review and orchestration](https://newruntime.com/patterns/ai-native-orgs-move-to-review-and-orchestration/): the factory routes work, applies checks, delegates review, and reserves merge or escalation for accountable humans. The repository makes that operating model concrete in a single-session workflow, while its examples remain a small test run rather than evidence of broad organizational results.

## Why now
The repository is explicitly designed around GitHub issues and Claude Code, with install steps that adapt the factory to a project’s own checks. That makes the design relevant to teams exploring coding agents as an operational workflow, not merely as an interactive coding assistant. Its recommendation to start with one concurrent job signals that trust and review capacity should be established before increasing throughput.

## Why it matters
The useful design choice is not simply assigning different prompts to agents. The workflow puts boundaries around what they can do: only labeled issues enter; repository-specific checks gate review; jobs have isolated worktrees and branches; and a human merges approved changes. Failed checks halt downstream review, while unresolved work can be escalated rather than forced through an automated success path.

Teams can adapt this structure without copying every role or model choice. The most important prerequisite is a reliable project check suite: the factory’s gate is only as meaningful as the tests, lint, typecheck, and build commands configured for it. The README’s example of a protected-test-file violation illustrates why the gate and human review need to remain part of the loop. The repository offers a practical starting point, not proof that issue-to-PR automation is safe for every codebase.

## Limits and uncertainty
The reported examples come from a small private calculator repository and a deliberately cheap test configuration with all agents on Haiku; they do not establish performance on larger or production systems. The repository does not report aggregate success rates, review time saved, defect rates, or costs across a representative workload. Its dashboard’s cost figure is described as API-equivalent agent pricing read from Claude Code transcripts; on a subscription plan, it indicates spend allocation rather than the actual bill. Teams must also validate their own checks, permissions, routing, and failure handling before relying on the workflow.

## Skill to build now
This week, make a small issue-to-PR pilot on a low-risk repository. Configure `checks.sh` with the project’s real tests, lint, typecheck, and build commands; confirm the checks pass on `main`; then run with concurrency 1 and review every pull request. Keep merge permission with a human, and record which failures trigger escalation before adding more issue types or parallel jobs.

## Reader takeaway
ZazenCodes offers a concrete Claude Code workflow for automating the path from GitHub issue to reviewed pull request. Its strongest lesson is to automate bounded steps behind project-specific checks, isolated job state, and human approval—not to treat an agent’s confidence as evidence that a change is ready to merge.

Editor: [Andrey Reshetnikov](https://newruntime.com/owner-profile.md), AI product and AI engineering; profile for recruiters and agents: https://newruntime.com/owner-profile.json

## Continue in the graph

Next records for an agent, linked to their Markdown twins. Replace `.md` with `.json` for structured fields, including `next_reads`.

- topic hub: [Claude](https://newruntime.com/topics/claude.md): Explore the claude topic hub.
- topic hub: [Claude Code](https://newruntime.com/topics/claude-code.md): Explore the claude-code topic hub.
- topic hub: [Github](https://newruntime.com/topics/github.md): Explore the github topic hub.
- collection: [Field Notes](https://newruntime.com/posts.json): Open the latest editorial analysis.
- collection: [Sources](https://newruntime.com/sources/): See the original sources this archive cites.
- whole graph: [discovery graph](https://newruntime.com/discovery-graph.json) (typed nodes and edges) and [site index](https://newruntime.com/site-index.md)
