gf-expand

What problem does it solve?

GateFlow's Expand mode handles ambiguous or under-specified requests by guiding the user through concise clarifying questions, presenting trade-off options, and assembling a rich handoff context for downstream skills or agents.

Core Features & Use Cases

• Clarification Dialogue: When intent is unclear, gf-expand prompts the user with up to 3 targeted questions using AskUserQuestion to refine the task.
• Option Presentation: After answers, it proposes 2–3 implementation options with clear trade-offs.
• Enriched Hand-off Context: Builds a structured context object containing original query, clarifications, selected option, resolved intent, specifications, and constraints for downstream execution.
• Deterministic Handoff: Transfers control to the selected skill or agent with all necessary context to proceed without re-asking basic questions.
• Use Case: A user asks to create a FIFO; gf-expand gathers interface and TB preferences, then hands off to a codegen or task agent with full context.

Quick Start

Use the expand mode to disambiguate intents before proceeding with any creation, debugging, or planning tasks. For example, when a user asks to "build a FIFO," gf-expand should ask about interface protocol, TB inclusion, and depth, then present 2-3 options and hand off to the appropriate tool.