feat: add issue-backed work task flow

Author: solomonneas

CHANGELOG.md

@@ -44,6 +44,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `brigade work bootstrap` to initialize and verify the dogfood-backed daily work loop in one command.
 - `brigade work brief` and `brigade work brief --json` as a start-of-day entrypoint with git state, latest sessions, latest dogfood run, resolved next task, and suggested command.
 - `brigade work tasks` plus `brigade work task add/show/done` to manage a gitignored local task ledger under `.brigade/work/tasks.json`.
+- `brigade work task add --template` for `vertical-slice`, `bugfix`, `red-green-refactor`, `docs`, and `security-follow-up` defaults, with repeatable `--acceptance` criteria preserved.
+- `brigade work task plan <task-id>` to show task acceptance criteria and template-specific execution guidance.
+- `brigade work task add --from-issue <issue-url-or-number>` to import GitHub issue title and metadata through the existing `gh` CLI when available.
 - `brigade work run --queue-next` to queue the successful run's extracted next step, with duplicate pending task protection.
 - `brigade work import add/list/show/promote` to manage a gitignored local import inbox for scanner-discovered candidate work.
 - `brigade work import validate` and `brigade work import ingest` for scanner-authored JSONL import files.
@@ -82,6 +85,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `brigade work run` now consumes the oldest pending ledger task before falling back to the latest extracted dogfood next step, and marks consumed tasks done after successful runs.
 - `brigade work task add --from-next` now reuses an equivalent pending task instead of adding duplicates.
 - `brigade work brief` now includes pending local work imports and import counts in both text and JSON output.
+- `brigade work brief` now surfaces issue-backed next-task context.
+- `brigade work doctor` now warns on pending tasks without acceptance criteria, unchecked or closed issue-backed tasks, and active work sessions left open too long.
 - The managed gitignore block now treats `.brigade/dogfood.toml`, `.brigade/security.toml`, `.brigade/runs/`, and `.brigade/security/` as local state.
 - Live smoke docs now keep Codex agent execution in a trusted repo cwd while writing temporary roster, artifacts, and handoff output under `/tmp`.
 - Handoff write failures now preserve final run artifacts, print the final answer, return nonzero, and mark `run.json` as `handoff-failed`.

README.md

@@ -256,17 +256,23 @@ Start-of-day commands:
 
 - `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, ignore coverage, and latest run context.
+- `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 next` prints only the next task. Add `--json` for wrappers.
 
 Task ledger commands:
 
 - `brigade work tasks` lists `.brigade/work/tasks.json`.
 - `brigade work task add "..."` queues a task manually.
+- `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.
 - `brigade work task add --from-next` promotes the latest extracted dogfood next step.
+- `brigade work task plan <task-id>` shows acceptance criteria and template-specific execution guidance.
 - `brigade work task done <task-id>` closes queued work.
 
+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.
+
 Import inbox commands:
 
 - `brigade work import add "..."` creates a scanner-ready local import.

ROADMAP.md

@@ -69,14 +69,15 @@ Brigade-specific additions:
 - Enrich reviewed indicators and suspicious package or domain findings through optional providers such as MISP, then route enriched findings into local evidence bundles and work imports. Status: started with `security-enrichment.json`, `security-enrichment.md`, and review/doctor visibility.
 - Track false-positive taxonomy, runtime-confidence rules, suppressions, and regression fixtures as first-class project artifacts. Status: started with `brigade security review`, reasoned suppressions, unsuppress, and stale-suppression doctor warnings.
 
-## Later Phase: Issue And TDD Work Loop
+## Current Phase: Issue And TDD Work Loop
 
 Goal: make Brigade support a narrow issue lifecycle for daily work: pick one task, define acceptance, test first when practical, implement, review, refactor, and close.
 
-- Add task templates for vertical-slice work, bugfix work, and RED/GREEN/REFACTOR loops.
-- Let `brigade work run` consume structured acceptance criteria from the local task ledger or a GitHub issue mirror.
+- Add task templates for vertical-slice work, bugfix work, RED/GREEN/REFACTOR loops, docs work, and security follow-ups. Status: implemented in the local task ledger.
+- Import GitHub issues into the local task ledger without building a sync engine. Status: implemented through the existing `gh` CLI.
+- Let `brigade work run` consume structured acceptance criteria from the local task ledger or a GitHub issue mirror. Status: started with local ledger acceptance criteria and issue metadata.
 - Keep repo-shareable workflow rules separate from gitignored personal/global preferences.
-- Add doctor checks for missing acceptance criteria or stale active issue context.
+- Add doctor checks for missing acceptance criteria or stale active issue context. Status: started with missing acceptance, closed remote issues, unchecked issue-backed tasks, and stale active sessions.
 
 First build slice:
 

src/brigade/cli.py

@@ -150,6 +150,24 @@ def _build_parser() -> argparse.ArgumentParser:
     p_work_task_add.add_argument("text", nargs="*", help="Task text.")
     p_work_task_add.add_argument("--target", "-t", type=Path, default=Path("."), help="Repo or workspace to update.")
     p_work_task_add.add_argument("--from-next", action="store_true", help="Add the latest extracted dogfood next step.")
+    p_work_task_add.add_argument("--from-issue", default=None, help="Import a GitHub issue by URL or number using gh.")
+    p_work_task_add.add_argument("--type", dest="task_type", default=None, help="Optional task type metadata.")
+    p_work_task_add.add_argument("--priority", default=None, help="Optional task priority metadata.")
+    p_work_task_add.add_argument(
+        "--acceptance",
+        action="append",
+        default=[],
+        help="Acceptance criterion. May be repeated.",
+    )
+    p_work_task_add.add_argument(
+        "--template",
+        choices=["vertical-slice", "bugfix", "red-green-refactor", "docs", "security-follow-up"],
+        default=None,
+        help="Add template acceptance criteria and planning guidance.",
+    )
+    p_work_task_plan = task_sub.add_parser("plan", help="Show execution guidance for one work task.")
+    p_work_task_plan.add_argument("task_id", help="Task id or unique prefix.")
+    p_work_task_plan.add_argument("--target", "-t", type=Path, default=Path("."), help="Repo or workspace to inspect.")
     p_work_task_show = task_sub.add_parser("show", help="Show one work task.")
     p_work_task_show.add_argument("task_id", help="Task id or unique prefix.")
     p_work_task_show.add_argument("--target", "-t", type=Path, default=Path("."), help="Repo or workspace to inspect.")
@@ -645,7 +663,18 @@ def main(argv=None) -> int:
         if args.work_command == "task":
             if args.task_command == "add":
                 text = " ".join(args.text) if args.text else None
-                return work_cmd.task_add(target=args.target, text=text, from_next=args.from_next)
+                return work_cmd.task_add(
+                    target=args.target,
+                    text=text,
+                    from_next=args.from_next,
+                    from_issue=args.from_issue,
+                    task_type=args.task_type,
+                    priority=args.priority,
+                    acceptance=args.acceptance,
+                    template=args.template,
+                )
+            if args.task_command == "plan":
+                return work_cmd.task_plan(target=args.target, task_id=args.task_id)
             if args.task_command == "show":
                 return work_cmd.task_show(target=args.target, task_id=args.task_id)
             if args.task_command == "done":