32 roles

Every job the conductor knows how to start.

A role is one job, run as one supervised session with one task. You choose which roles a project may run and how many may run at once; the conductor starts one only when there is something for it to do. The pill on each card says what that role is allowed to do when it runs, and the card names the Ironway permission row that governs it — the row whose switch and daily caps a project owner sets in Governance — or says it is ungoverned.

Build

Takes a buildable item and delivers it as a pull request.

builder

formerly brakeman

claims work

Claims one buildable bead, builds it in a supervised session and opens the pull request; a phase whose criteria form a chain is built as one request.

permission row: builder

rework

claims work

Answers a request-changes review, a merge conflict or red CI on a conductor pull request, on its own branch, with capped attempts.

permission row: builder

pr-fixer

claims work

Works an escalated pull request — pushes a fix, resolves it, or asks one question.

permission row: builder

issue-fixer

claims work

Takes a batch of approved issues; each becomes a verified fix request, one question, or a coded close.

permission row: builder

idea-builder

claims work

The same engine on approved ideas; one too big for a bead becomes a checked PRD draft.

permission row: builder

swarm

claims work

Builds one PRD as several concurrent sessions — one branch, one pull request.

permission row: builder

decompose

propose-only

Proposes a swarm plan a person may edit before it runs.

permission row: builder

Validate

Checks delivered work against its criterion. Never the agent that built it.

validator

formerly judge

claims work

Reads a merged delivery read-only and posts pass or fail with evidence citations.

permission row: validator

verifier

formerly validate

no LLM

Runs the criterion's verify command and posts the verdict — pure Go, no session.

permission row: validator

reviewer

claims work

Reviews an open pull request at its head and posts a verdict.

permission row: reviewer

combination

claims work

Trial-merges every mergeable request on a throwaway branch and names the one that breaks the build; merges nothing.

ungoverned — no permission row

post-merge

claims work

Verifies the integration branch as integrated, not as a diff.

ungoverned — no permission row

harness-read

claims work

Measures a harness-edit request against the regression set.

ungoverned — no permission row

Converse

Answers a person, in the place they asked.

shaper

formerly replier

acts

One reply on an ask-* or shaper-* thread.

permission row: shaper

answerer

acts

Stakes one open PRD question and posts a recommendation.

permission row: answerer

directive

acts

Answers @Conductor in the project's Buzz channel.

ungoverned — no permission row

assistant

formerly meta

acts

One turn of the factory-floor conversation — answers, drafts a PRD, or performs an explicit reviewed approval.

permission row: shaper

Curate

Keeps the backlog and the repository honest. Propose-only unless the pill says otherwise.

triager

propose-only

Categorizes new issues against open PRDs, in batches.

permission row: triager

dedup-scout

propose-only

Proposes merge and covered-by links between duplicate items.

permission row: triager

idea-scout

propose-only

One advisory recommendation per untriaged idea.

permission row: triager

security-scout

propose-only

Reviews integration-head changes for security defects and files each as an idea.

permission row: triager

refactor-scout

propose-only

Proposes refactors the repository's own history proves are needed.

permission row: triager

doc-scout

acts

Fixes docs that merged changes made false, as one docs-only pull request.

permission row: builder

fresh-audit

propose-only

At most weekly, a fresh session scores how legible the repository is to an agent.

permission row: triager

steward

acts

Posts the previous day's report.

permission row: steward

retro

propose-only

A daily review of the conductor's own logs; proposes, never applies.

permission row: triager

Ship and host lanes

Lands what passed, and says what is waiting on a person.

shipper

no LLM

In-process deploy verification: runs the golden journeys.

permission row: shipper

merge

no LLM

Merges reviewed, green requests onto the integration branch; promotion to release is its own request.

ungoverned — no permission row

sweep

no LLM

Attaches merged requests to their PRDs by the forge's merged_at.

ungoverned — no permission row

patrol

acts

One deduped human task per host fault; never repairs.

permission row: steward — its daily action cap only; patrol.disabled is its off switch

stationmaster

acts

Reports what is waiting on a person and what is wrong with the host.

ungoverned — no permission row

task-review

acts

Retracts human tasks the fleet has since cleared.

ungoverned — no permission row

Operator commands

What you run against a host yourself, beside the roles it runs on its own.

CommandWhat it does
conductor doctorReports every resolved fact about this host — and prints no secret.
conductor dashboardOpens the local dashboard (loopback only).
conductor tunnel <user@host>Opens a remote host's dashboard and TeamClaude pages in this browser over ssh.
conductor pause / resumeStops starting new sessions; running ones finish.
conductor throttle clearLifts an open host-wide API throttle hold, and records who lifted it.
conductor balanceShapes one project at runtime: holds its new work, resizes a role, or restores the configured caps.
conductor refreshRe-reads projects and roles from Ironway now.
conductor gcRemoves finished worktrees and old session records.
conductor faultsHost faults this machine has filed, and their state.
conductor faultline login / status / rotateConfigures the Faultline collector faults reads from.

Pick the roles a project may run.

Install the conductor, then choose per project.