DHF Lifecycle Flow from intake to handoff.

flowchart TD
  Start(["User request enters DHF"])
  Recover["Recover facts
AGENTS.md, README, repo state
harness_recover.py"]
  Env["Probe runtime
harness_env_probe.py"]
  Clear{"Are goal, scope,
and acceptance clear?"}
  Req["Requirements
planner / req-to-dev
CONTEXT / ADR"]
  Plan["Planning
vertical slice / AFK / HITL"]
  Dev["Implementation
TDD / ATDD / scoped workers"]
  Verify["Verification evidence
command, exit_code,
key_output, timestamp"]
  Review["QA / security / review
gstack-qa / gstack-cso / gstack-review"]
  Ship["Ship / deploy / canary
gstack-ship / land-and-deploy"]
  Docs["Docs release
document-release / doc-updater"]
  Handoff["Handoff
harness_checkpoint.py append"]
  Done(["DHF output
route, evidence, next safe task"])

  Start --> Recover --> Env --> Clear
  Clear -- "No" --> Req --> Plan
  Clear -- "Yes" --> Plan
  Plan --> Dev --> Verify
  Verify --> Review --> Ship --> Docs --> Handoff --> Done
  Verify --> Handoff

  classDef runtime fill:#e9f7f5,stroke:#0f9b8e,color:#17241f;
  classDef decision fill:#f0eaff,stroke:#8a4fff,color:#17241f;
  classDef build fill:#fbf0dc,stroke:#b26a00,color:#17241f;
  classDef verify fill:#eaf6f0,stroke:#12805c,color:#17241f;
  classDef ship fill:#faeaf1,stroke:#d13574,color:#17241f;

  class Recover,Env,Handoff runtime;
  class Clear decision;
  class Req,Plan,Dev build;
  class Verify,Review,Docs verify;
  class Ship ship;