Design Doc Mermaid

1flowchart TD2  Brief["Feature brief: collaborative-plan-comments"] --> O["Orchestrator owns PlanPack JSON"]3 4  O --> P1["Research lane"]5  O --> P2["Idea generation lane"]6  O --> P3["Planning constraints lane"]7  P1 --> C["Consolidate findings into JSON plan"]8  P2 --> C9  P3 --> C10 11  C --> V["Web viewer opens PlanPack"]12  V --> H{"Human reviews readable plan"}13  H -->|"section comments"| CM["Comments tied to plan sections"]14  H -->|"quick actions"| QA["Approve, block, rescope, clarify"]15  CM --> EX["Copy or export comment bundle"]16  QA --> EX17  EX --> O2["Orchestrator applies feedback"]18  O2 --> JP["Updated PlanPack JSON"]19 20  JP --> VC["Write validation contract and test design"]21  VC --> HG{"Human gate: contract clear?"}22  HG -->|"revise"| O223  HG -->|"approved"| IA["Implementation agent builds feature"]24 25  VC --> VA0["Validation agent receives contract only"]26  IA --> IH["Implementation handoff"]27  IH --> VA["Validation agent verifies independently"]28  VA --> VR{"Validation passes?"}29  VR -->|"no"| O230  VR -->|"yes"| CR["Final code review"]31 32  CR --> CRD{"Review decision"}33  CRD -->|"block"| O234  CRD -->|"mortem or process feedback"| M["Structured feedback to orchestrator"]35  M --> O236  CRD -->|"approve"| Done["Ready for merge / release lane"]37 38  classDef human fill:#fff3bf,stroke:#8a6d00,color:#1f1f1f39  classDef json fill:#d9fdd3,stroke:#247a38,color:#102a1440  classDef agent fill:#dbeafe,stroke:#2563eb,color:#10233f41  classDef gate fill:#ffe4e6,stroke:#be123c,color:#3f101842 43  class H,HG human44  class O,C,O2,JP json45  class IA,VA0,VA agent46  class VR,CRD gate