# work Use `brigade work bootstrap` once per repo. It writes or verifies `.brigade/dogfood.toml`, creates local artifact directories, creates the handoff inbox, updates `.gitignore`, and reports readiness. ## Start of day - `brigade work brief` shows branch state, active sessions, pending tasks, import counts, latest dogfood run, and the command to continue. - `brigade work status` is the quick dashboard for branch state, dogfood readiness, paths, latest run, and extracted next step. - `brigade work doctor` checks dogfood config, security config, evidence bundles, Codex CLI, artifact paths, handoff inbox, task acceptance, issue-backed tasks, stale active sessions, ignore coverage, and latest run context. - `brigade work resume` shows the active or latest session, latest dogfood run, extracted next step, and suggested command. - `brigade work inbox` groups pending scanner imports by source, kind, priority, age, and acceptance coverage, then suggests plan, promote, dismiss, or run commands. - `brigade work next` prints only the next task. Add `--json` for wrappers. ```bash brigade work bootstrap brigade work brief brigade work brief --json brigade work status brigade work doctor brigade work resume brigade work next brigade work next --json ``` ## Task ledger - `brigade work tasks` lists `.brigade/work/tasks.json`. - `brigade work task add "..."` queues a task manually. - `brigade work task add "..." --type feature --priority high --acceptance "..."` queues typed work with repeatable acceptance criteria. - `brigade work task add "..." --template bugfix --acceptance "Regression test passes"` adds template acceptance criteria while preserving explicit acceptance criteria. - `brigade work task add --from-issue 42` imports a GitHub issue with `gh issue view` when `gh` is available, including acceptance criteria parsed from issue-body checkboxes or acceptance/test sections. - `brigade work task add --from-next` promotes the latest extracted dogfood next step. - `brigade work task plan ` shows the task metadata, acceptance checklist, template guidance, and suggested run command. - `brigade work task done ` closes queued work. ```bash brigade work tasks brigade work task add "build the next slice" brigade work task add "build the next slice" --type feature --priority high --acceptance "focused tests pass" brigade work task add --from-next brigade work task plan brigade work task done ``` Available task templates are `vertical-slice`, `bugfix`, `red-green-refactor`, `docs`, and `security-follow-up`. Issue-backed tasks keep issue URL, number, title, labels, state, and source metadata in the local gitignored ledger. Issue body text is not stored, and Brigade does not poll, sync, mutate, or refresh GitHub issues in the background. ## Import inbox - `brigade work import add "..."` creates a scanner-ready local import. - `brigade work import validate imports.jsonl` checks scanner output against the import schema. - `brigade work import ingest imports.jsonl` ingests scanner output. - `brigade work import memory-care` converts the memory-care refresh queue at `memory/cards/decay/refresh-queue.json` (override with `--queue`) into imports. If the queue file is missing it errors rather than falling back. - `brigade work import memory-refresh` converts memory-refresh candidates into task imports with card identity, reason, evidence summary, and acceptance criteria. - `brigade work import chat-sweep` converts `.brigade/chat-memory-sweeps/latest.json` issues into imports. Actionable sweep issues become task imports with acceptance criteria, while raw private chat text is omitted. - `brigade work import triage` groups pending imports by source and kind; use `--source`, `--kind`, and repeatable `--metadata key=value` to narrow noisy queues. - `brigade work import show ` inspects one import. - `brigade work import plan ` previews the exact task or handoff promotion would create, including acceptance criteria, template guidance, or handoff target. - `brigade work import plan-handoff ` previews the Memory Handoff draft target for durable non-task imports. - `brigade work import dismiss ` removes one noisy item, while `dismiss --all` closes filtered batches. - `brigade work import promote ` promotes one reviewed import into the task ledger. - `brigade work import promote-handoff ` promotes one reviewed durable import into a linted Memory Handoff draft. - `brigade work import promote --run ` promotes exactly one task import, then immediately runs that task through the normal work-session loop. - `brigade work import promote --all --source memory-care --kind task` batch-promotes filtered imports; metadata filters also work for scanner-specific fields such as `handoff_issue_category=route-skip`. - `brigade work inbox doctor` reports missing scanner provenance, stale pending imports, broken promoted task links, changed dismissed fingerprints, noisy sources, and scanner runs that produced no imports. - `brigade work inbox archive` moves old promoted, dismissed, and superseded imports into `.brigade/work/imports/archive.jsonl` while preserving pending imports. Imports are stored under `.brigade/work/imports/inbox.jsonl`, stay gitignored, and do not write memory directly. Scanner-authored task imports may include `type`, `priority`, `template`, and `acceptance`; promotion preserves those fields so imported tasks can enter the normal TDD work loop. Durable non-task imports such as decisions, preferences, links, commands, findings, and incidents can be promoted only into reviewed Memory Handoff drafts. For handoff-ingest issues, prefer `brigade handoff sync-issues` over repeated raw imports. ## Scanner registry - `brigade work scanners init` writes gitignored `.brigade/scanners.toml` with local producer entries for chat sweep, chat surfaces, memory refresh, memory care, handoff ingest sync, security findings, backup health, and tool catalog health (eight entries). - `brigade work scanners list` and `show ` inspect configured scanner commands, sources, cadence, timeout, output paths, and conflict windows. - `brigade work scanners plan` calculates intended run windows, reports overlaps or clustered jobs, and prints a suggested staggered schedule. - `brigade work scanners run `, `run --all`, and `run --due` execute configured enabled scanner entries explicitly, never through a shell, and refuse disabled, risky, or overlapping runs unless the matching review flag is present. - `brigade work scanners run --ingest-output` validates and ingests the scanner's configured JSONL `import_path` after a successful run. - `brigade work scanners runs` and `run-show ` inspect receipts under `.brigade/scanners/runs/`. - `brigade work scanners doctor --import-issues` reports missing config, disabled required producers, bad commands, missing or stale output paths, schedule conflicts, failed or timed-out runs, malformed receipts, missing logs, and due scanners, then can import those health issues as local task imports. ## Daily sweep - `brigade work sweep` is the daily operator action for scanner review. It runs due scanners by default, or `--all` / `--scanner ` when selected, ingests configured JSONL outputs unless `--no-ingest` is present, and writes one report under `.brigade/scanners/sweeps/`. - `brigade work sweeps` and `brigade work sweep-show ` review sweep reports, including scanner run receipt paths, import counts, inbox hygiene, and suggested next commands. - `brigade work sweep-review ` and `sweep-review latest` triage one sweep by grouping created imports by source, kind, priority, acceptance coverage, provenance completeness, and status. The scanner registry is explicit and local. Brigade does not install cron jobs, start a daemon, run scanners from `brief` or `doctor`, promote scanner output automatically, or mutate scanner output beyond the configured command's own behavior. ## Code review - `brigade work review init` writes gitignored `.brigade/reviews.toml` with disabled starter entries for Codex review, Claude Opus review, and custom local reviewers. - `brigade work review plan` shows configured reviewer commands, cwd, timeout, target paths, base ref, output path, findings path, and command blockers without executing anything. - `brigade work review run ` and `run --all` execute configured reviewers explicitly, never through a shell, and write receipts under `.brigade/reviews/runs/`. - `brigade work review runs` and `brigade work review show ` inspect review receipts. - `brigade work review import-findings ` reads the run's normalized findings JSON, redacts unsafe values, and routes findings into the existing work inbox with source `code-review`. - `brigade work review findings` and `finding-show ` inspect imported review findings. - `brigade work review closeout ` or `closeout latest` writes a local closeout record that connects review findings to pending imports, dismissals, promoted tasks, completed tasks, and source-fingerprint changes requiring re-review. Code review is explicit and locally receipted. Brigade does not auto-run reviewers from `work run`, apply fixes, post review comments, mutate GitHub, store auth, or promote findings automatically. Model-backed reviewers use their configured provider when you run them. ## The daily loop Run the daily loop with `brigade work run`. It opens a work session, resolves the next task, runs `brigade dogfood`, and closes completed ledger tasks after successful runs. When the resolved ledger task has acceptance criteria, `work run` includes them in the task prompt as the definition of done. Then it ends the session, writes a work-session Memory Handoff by default, and prints a recap. ```bash brigade work run brigade work run --queue-next brigade work run "review today's changes" ``` Useful `work run` switches: - `--queue-next` queues the successful run's extracted next step for the next session. - `--title` names the session. - `--no-handoff` skips the work handoff. - `--dogfood-handoff` also lets the underlying dogfood run write its own handoff. - Passing a task overrides the resolved next step. ## Manual sessions - `brigade work start "title"` opens `.brigade/work//`, records starting context, and writes `start.md`. - `brigade work note "checkpoint"` appends a timestamped note to the active session. - `brigade work end --note "what happened"` closes the active session and writes `end.md`. - `brigade work end --handoff` also writes a Memory Handoff. ```bash brigade work start "next slice" brigade work note "wired parser and tests" brigade work end --note "tests passed" --handoff ``` Inspect local work sessions with: ```bash brigade work list brigade work latest brigade work show brigade work recap brigade work recap --since 2026-05-26 ``` ## Verification and closeout - `brigade work verify plan` previews the local verification commands and current evidence snapshot without running anything. - `brigade work verify run` executes explicit local verification commands without a shell and writes receipts under `.brigade/work/verify-runs/`. - `brigade work verify runs` and `brigade work verify show ` inspect local verification receipts. - `brigade work closeout ` writes a local closeout receipt under `.brigade/work/closeouts/` that collects task acceptance, latest verification, scanner sweep status, code review closeout state, handoff draft status, and session evidence. Verification and closeout are local gates. Brigade does not mutate CI, GitHub, reviewers, scanner promotions, handoff ingestion, daemons, or schedulers. Verification commands run only when explicitly requested. ## Backup health - `brigade work backup init` writes gitignored `.brigade/backups.toml` with local NAS and cloud destination examples. - `brigade work backup status` and `doctor` read local JSON summaries for latest snapshot, check, prune, and restore rehearsal status. - `brigade work backup import-issues` turns stale snapshots, failed checks, stale prunes, missing summaries, overdue restore rehearsals, and unsafe summary fields into local `backup-health` work imports. Backup health summaries are local and read-only. Brigade does not run `restic`, mount storage, prune, restore, send webhooks, or mutate remote backup state.