Skip to content

feat(repo): flow-pack E3 — /flow-umbrella (7-field umbrella body, approval-gated write) #372

Description

@w7-mgfcode

Sub-issue of #368 (umbrella: feat(repo): integrate flow-pack methodology as the flow: command suite). Parallel after Foundation — runs concurrently with E2 and E4 after E1 #369 closes.

Purpose

Implement the /flow-umbrella command: rule-driven generation of the umbrella GitHub issue from the approved V2 ship list produced by /flow-brainstorm. End state: a user can run /flow-umbrella <initiative> and receive a dry-run echo of the full 7-field umbrella body, approve it, and have the issue created with labels and milestone attached.

Scope

  • Read the approved V2 ship list and defer list (from .flow/brainstorm-log.md or inline)
  • Generate the full 7-field umbrella body: Summary, Approach, Decomposition, Out of scope (explicit), Success criteria, Risks, Tracking (+ X/10 one-pass confidence score)
  • Dry-run echo the complete issue body before any write
  • Idempotent check: gh issue list --search "<title>" before creating — skip if already exists
  • Approval-gated write: gh issue create executes only after explicit user "approve"
  • Attach labels umbrella + flow and the project milestone
  • Next-command pointer printed at end: → /flow-epics #<umbrella>

Out of scope

  • Epic creation or sub-issue linking — that is E4
  • Milestone or label creation — must exist before running; guarded check at command start
  • Any implementation of the epics themselves

Sub-tasks

To be decomposed via issue-to-subtasks when E3 is picked up.

Durable-source split

  • Tracked template (to be created): docs/flow-pack/commands/flow-umbrella.md
  • Local install (gitignored, regenerable): .claude/commands/flow/flow-umbrella.md

Metadata

Metadata

Assignees

No one assigned

    Labels

    epicEpic — a delivery surface under an umbrellaflowflow: command-suite work

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions