claude plugin marketplace add /Users/tushar/Documents/tushar2708/claude-assets
claude plugin install flow@claude-assets --scope user

flowchart TD
    idea([Feature idea]) --> grill

    subgraph G["/flow:grill — research-backed interview"]
        direction TB
        grill["Map the feature's concepts<br/>in four domains"]
        domains["Architecture · Product · UI/UX · Business"]
        research["Optional web research per chosen domain:<br/>best practices and pitfalls"]
        rounds["Interview in rounds<br/>(up to 4 questions per round)"]
        open{"Open decisions<br/>left?"}
        converge["Shared understanding:<br/>decisions, adopted practices,<br/>avoided pitfalls, open risks"]
        grill --> domains --> research --> rounds --> open
        open -- yes --> rounds
        open -- no --> converge
    end

    %% Main path. Declared first so it stays in the central column.
    converge -->|you confirm the summary| spec["/flow:spec<br/>Write a numbered, validated spec<br/>docs/plans/NN-slug.md<br/>with ordered sub-features SF-1..n"]
    %% Hidden spacer on the left balances the optional branch on the right, so spec stays above plan-it.
    spec ~~~ spacer["/flow:add-to-roadmap<br/>Story + one Subtask per sub-feature<br/>in your tracker"]:::hidden
    spec --> planit["/flow:plan-it (Plan Mode)<br/>One wave per sub-feature<br/>Stages: S1 contracts → S2 tests → S3 implementation<br/>Verify gate after every wave<br/>Also applies any planning skills you name"]
    planit -->|you approve the plan| hook{{"ExitPlanMode hook<br/>Checks the plan against your project rules,<br/>then triggers make-tasks"}}
    hook --> maketasks["/flow:make-tasks<br/>(auto, or run it manually)<br/>Tasks in wave → stage → task order<br/>with blockedBy wiring"]
    maketasks --> execute

    subgraph E["/flow:execute"]
        direction TB
        execute["Run each stage's tasks<br/>with the planned agent"]
        verify{"Verify gate<br/>(you choose: run or skip)"}
        close["Close task (only with a tracker)<br/>Comment on the sub-feature's Subtask<br/>and mark it Done"]
        next{"More waves?"}
        execute --> verify --> close --> next
        next -- yes --> execute
    end

    next -- no --> review["/flow:review<br/>Read-only review of the implementation<br/>against the plan's skills"]
    review --> done([Reviewed code])

    %% Note bubble for the close task. Declared after the main path so it sits to the right.
    close -.- closenote["Runs only if the sub-feature has a Subtask,<br/>created by /flow:add-to-roadmap.<br/>The tracker is the one declared in roadmap.md<br/>(Jira, GitHub, Asana, or other).<br/>Posts a comment with what the wave built,<br/>then sets the Subtask to Done.<br/>If you skipped the verify gate, it asks first."]:::note

    %% Optional branch. Declared last so it sits beside the main path.
    spec -. optional .-> roadmap["/flow:add-to-roadmap<br/>Story + one Subtask per sub-feature<br/>in your tracker"]
    roadmap -.-> tracker[("Tracker<br/>Jira · GitHub · Asana · other")]
    roadmap -.-> rmfile[["roadmap.md<br/>in your project"]]

    classDef hidden fill:none,stroke:none,color:transparent
    classDef note fill:#fff8c5,stroke:#d4a72c,color:#1f2328,stroke-dasharray:4 3