Kiln
Pages

State machine

.claude/state-machine.md of the hub is the only place for the states of the factory, and the rules that move work between them. The skills follow it. This page gives its statuses. Read the file for each rule.

#Change task

StatusIt means
draftThe task is written. It has open questions.
probingYou and probe settle the questions.
readyNothing is open. A build can take it.
buildingA build runs.
reviewThe pull request is open, and you review it.
blockedA build or triage needs your decision. The question is under ## Questions.
acceptingEach pull request is merged, and accept runs.
doneAccepted. The issue is closed.
discardedYou dropped the task. The issue is closed.
FromToWho
An inputdraftintake
draft, blockedprobingprobe
probingreadyprobe
readybuildingThe builder script, when it claims the task
buildingreviewbuild
buildingblockedbuild
reviewreadytriage, for rework
reviewblockedtriage
blockedreadytriage, when you answer each question on the pull request
reviewacceptingThe watcher script, when each pull request is merged
reviewdraftThe watcher script, when a pull request is closed with no merge
acceptingdoneaccept
reviewdoneaccept, run by you
Each statusdiscardedYou

The builder and the watcher are scripts of the worker, and Kiln has no worker. In Kiln, the panel claims the task when you press Build, and you run accept yourself. See Kiln and factories-hub.

#Exploration

FromToWho
An inputreadyintake
readybuildingbuild
buildingreviewbuild
reviewdone, ready or discardedaccept, run by you
doneconsumedaccept, when each change task of the exploration is done

An exploration has no pull request and no issue.

#Each change of status

Each change of status is a commit of the task file, pushed to the hub. Then, when the hub has scripts/sync-issues.mjs, the script updates the issue of the task.