hyperflow-spec — design phase (Antigravity single-agent)
This phase is thinking, not building. No code until the design is approved. Follow the hyperflow doctrine (autonomy, file-first, AskUserQuestion gates).
Steps
- Research first. Read the relevant code,
AGENTS.md, and.hyperflow/memory/*if present. Map the affected surface yourself. Do not ask what the code answers. - Ask 2-5 clarifying questions (floor: 2) via AskUserQuestion — only the what/which/where the code can't resolve. Multi-option questions mark one
(Recommended); binary ones don't. - Propose 2-3 approaches with one-line pros/cons/fit each. Recommend one; let the user pick.
- Design section-by-section. Write the design to
.hyperflow/specs/<slug>.mdwith this shape: status table → TL;DR (2-3 sentences) → Components → 1. Architecture → 2. Data flow → 3. Key decisions (with trade-offs accepted/rejected) → 4. Edge cases → 5. File structure (created/modified). Present it; askApprove all / Revise <section>. - On approval, hand off: invoke the
hyperflow-scopeskill with the spec path.
Rules
- Never write implementation code here.
- Never inflate a small task into a spec — economy matters. Trivial-clear requests skip straight to
hyperflow-scope. - The spec file is the artefact; chat shows only a short pointer to it.