software-factory

작성자: mattpocock

Shared language for designing a software factory: the tasks it runs and the services it plugs into.

npx skills add https://github.com/mattpocock/skills --skill software-factory

A software factory is a system of agents that turns tickets, PRs and schedules into merged code, deployed on remote infrastructure the user chooses. This skill is the language for designing one. Use these terms, and only these, when discussing or whiteboarding a factory; when the user reaches for a word under Avoid, name the canonical term.

Tasks and runs

Task: A kind of work the factory performs, defined once and run many times: review, explore, implement, ratchet. A task may work on a ticket, a PR, or the codebase as a whole. Avoid: job, workflow, action, as names for the task. A CI vendor's workflow file and its jobs are where a task is wired up, not the task.

Trigger: The event that starts a run: a change in the ticket tracker or git host, a clock in the orchestrator, or another run.

Run: One execution of a task on one runner, from its trigger to its finish, treated as a black box. A run triggers further runs either directly, through logic in the orchestrator, or by changing the ticket tracker or git host. A run never waits for a human: it ends, and the human's later change to the ticket tracker or git host triggers a new run. Avoid: session

Runner: The disposable machine a run executes on. Nothing on it survives the run, even when the machine itself is long-lived: a run's only memory of earlier runs is the ticket tracker, the git host and the orchestrator. Avoid: server, host, box, compute, sandbox

Services

Ticket tracker: Where tickets live, and the factory's human interface: humans schedule work by filing tickets, talk to agents in their comments, and their changes to tickets trigger runs. Avoid: issue tracker, ticket manager, project board

Ticket source: Anything outside the factory that creates tickets in the ticket tracker: a feedback button, a monitor, an error tracker, an inbox. Avoid: data source, trigger source, intake

Git host: Where branches, PRs and reviews live. Avoid: code host, forge, repo

Orchestrator: The component that receives triggers, starts runs on runners, and records which runs are queued, in flight or finished. Avoid: dispatcher, scheduler, control plane

Observability platform: Where runners send logs, traces and status, so a human can see what happened inside each run. Optional: the product filling the runner or orchestrator slot often shows enough on its own. A run never decides on it until something writes it into the ticket tracker or git host. Avoid: observability, logs, monitoring, dashboard

Designing a factory

A design has two halves: the services, each a slot filled with a product, and the tasks whose runs move work through them.

Start from the user's problem, not the factory: untriaged tickets, PRs waiting for automated review, a stricter automated check to migrate to, bugs nobody reads. When the user names a problem or doesn't know what to build, read EXAMPLE-TASKS.md for the tasks that solve common ones.

Start slow

Every trigger is an accelerator. Accelerators without brakes make a slop cannon. There are three brakes:

  • Automated checks: deterministic gates (types, lint, tests) that every run must pass.
  • Automated review: a separate run that reads the diff cold against the codebase's standards and the ticket, when there is one.
  • Human review: a human reads the PR before it merges; what it catches becomes new automated checks and sharper automated review.

Add one automated trigger at a time, throttled at first (one bug report in ten, a clock once a day), with human review on every PR. Open the throttle as the brakes earn trust, and cap every loop of runs at a few tries before a human.

Fill every slot

Each service is a slot. One product can fill several slots, and one server can host several services. Three designs, side by side:

ServiceAll on GitHubLinear ticketsOwn tracker
Ticket trackerGitHub IssuesLinearown app
Ticket sourcefeedback buttonfeedback button, monitorfeedback button, monitor
Git hostGitHubGitHubGitHub
OrchestratorGitHub Actionsown server + databaseown app
RunnerActions runnerActions, E2B, Daytona or a VPSown app, or sandboxes
Observability platformnone: Actions run pages sufficean LLM tracing platformown app

When the user is choosing a product for a slot, read that slot's survey to get oriented, then research the current options yourself; each survey groups the options by type and lists the questions that decide the slot:

Buy the services and build the tasks: the tasks carry the user's design, the services are generic. Favour an off-the-shelf ticket tracker: it is robust, people already know it, and outside users are easy to let in.

Question every task

For each task, answer:

  1. What triggers it?
  2. What does it do, and which services does it read and write?
  3. What does it trigger next?
  4. Where does a human re-enter?
  5. What stops two runs doing the same work?

For each ticket source, answer: what stops it filing the same ticket twice?

A design is finished when every slot names a product (or, for the observability platform, a deliberate none) and every task and ticket source has an answer to every question.

mattpocock의 다른 스킬

ask-matt
mattpocock
어떤 스킬이나 플로우가 상황에 맞는지 물어보세요. 이 저장소의 사용자 호출 스킬을 라우팅합니다.
communicationresearchproductivity
chief-of-staff
mattpocock
Pursue a long-running goal in a single session by co-ordinating subagents.
productivityproject-managementcommunication
claude-handoff
mattpocock
현재 대화를 즉시 작업을 이어받는 새로운 백그라운드 에이전트에게 넘깁니다.
codebase-design
mattpocock
깊은 모듈 설계를 위한 공유 어휘입니다. 사용자가 모듈의 인터페이스를 설계하거나 개선하고, 심화 기회를 찾고, 분할 지점을 결정하며, 코드를 더 테스트 가능하거나 AI가 탐색하기 쉽게 만들고자 할 때, 또는 다른 스킬이 깊은 모듈 어휘를 필요로 할 때 사용합니다.
designdevelopmentcode-review
code-review
mattpocock
고정된 지점(커밋, 브랜치, 태그, 또는 머지 베이스) 이후의 변경 사항을 두 가지 축(Standards: 코드가 이 저장소의 문서화된 코딩 표준을 따르는가? Spec: 코드가 원래 이슈/PRD에서 요청한 내용과 일치하는가?)을 따라 검토합니다. 두 검토를 병렬 하위 에이전트에서 실행하고 나란히 보고합니다. 사용자가 브랜치, PR, 작업 중인 변경 사항을 검토하거나 "X 이후 검토"를 요청할 때 사용하세요.
testingdevelopmentcode-review
design-an-interface
mattpocock
모듈에 대해 병렬 하위 에이전트를 사용하여 근본적으로 다른 여러 인터페이스 디자인을 생성합니다. 사용자가 API를 디자인하거나, 인터페이스 옵션을 탐색하거나, 모듈 형태를 비교하거나, "두 번 디자인하라"고 언급할 때 사용하세요.
developmentdesignapi
diagnosing-bugs
mattpocock
하드 버그 및 성능 회귀를 위한 진단 루프입니다. 사용자가 "진단해줘"/"디버그해줘"라고 말하거나, 무언가 고장/예외/실패/느림을 보고할 때 사용하세요.
testingdevelopmentcode-review
domain-modeling
mattpocock
프로젝트의 도메인 모델을 구축하고 다듬습니다. 사용자가 도메인 용어나 보편적 언어를 확정하거나, 아키텍처 결정을 기록하거나, 다른 스킬이 도메인 모델을 유지해야 할 때 사용합니다.
designdevelopmentdocument