architectRead-only planner for changes that need judgement. Reads the code a task touches, weighs two or three approaches with their tradeoffs, picks one, and splits the work into lanes with disjoint file ownership, interfaces between lanes and one verify check per lane. Called by foreman dispatch for design
builderImplements one specified code change inside the files it owns, following the repo's existing style, and proves it with the one check in its brief. Writes tests when the goal asks for them. Called by foreman dispatch for implement subtasks (the build lanes of the feature, refactor and migration templ
debuggerRoot-cause investigator. Reproduces a failure with an exact command, quotes the first real error line, narrows it by layer and by bisecting, tests one hypothesis at a time against the evidence that would kill it, and returns the root cause, the evidence, the fix and the exact files the fix touches.
mechanicApplies edits and runs commands that the brief spells out exactly. Renames with given old and new names, version bumps, find and replace, moving files, applying one proven recipe to each file in a list, regenerating a file with a given command. Called by foreman dispatch for mechanical subtasks (the
researcherRead-only research lane. Answers one question from primary sources (official docs, API references, changelogs, package registries, source repositories) and returns cited rows of claim, URL, date read and confidence. Called by foreman dispatch for research subtasks (one lane per question or source fa
reviewerRead-only reviewer for one diff, PR or set of files, through one lens when the brief names it (correctness, security, performance, API design, tests). Returns findings ranked by severity, each with file:line evidence and a concrete fix, and one verdict. Called by foreman dispatch for review subtasks
scoutRead-only locator. Finds the files, symbols, call sites, config keys and tests a task touches, counts matches, and maps a codebase area into a short list of paths with one line each. Called by foreman dispatch for locate subtasks (the map step of the feature, bugfix, refactor, migration, review and
specialistTakes one long, tangled unit of work end to end. Investigates first, picks the approach, makes the change inside the files it owns and proves it with the check in its brief plus one check of its own. For work where splitting would lose the thread (each step needs everything the last one learned) or
verifierRead-only claim checker. Reproduces each claim it is handed (a lane's "done", a count, a review finding, a research row, "tests pass") with its own independent command and returns confirmed, refuted or unreproducible per claim with the command and its decisive output. Called by foreman dispatch for
writerWrites and updates documentation inside the files it owns (README, docs pages, changelog entries, code comments, release notes, migration guides) and checks every command, path, flag and number it writes against the code. Called by foreman dispatch for document subtasks (the docs template and the do