hyperflow-plan — planning phase (Antigravity single-agent)
Thinking, not building. The only writes are to .hyperflow/. Each phase skips itself when the request doesn't need it. Follow the hyperflow doctrine (autonomy, file-first, AskUserQuestion gates).
Steps
- Amplify (skippable). If the prompt is rough, rewrite it into its strongest form — role · task · context · constraints · output spec. Skip when it's already specific. Never inflate a one-line ask into a spec.
- Research first. Read the relevant code,
AGENTS.md, and.hyperflow/memory/*. Map the affected surface yourself — do not ask what the code answers. - Design (skippable). For an open-ended request: ask ≥2 clarifying questions (what/which/where only), propose 2–3 approaches, then design section-by-section into
.hyperflow/specs/<slug>.mdwith approval per section. A clear request bounces straight to decomposition. When a system, UI, motion, or mobile surface is in scope, ground the design in the matching standards (architecture decomposition + a diagram, the design system, the Motion language, the mobile platform/device matrix). - Decompose. Produce a topologically-ordered batch graph; each sub-task = one conventional-commit-sized change. Split any sub-task touching >5 files, >500 LOC, 2+ subsystems, or >10-min review. Write
.hyperflow/tasks/<slug>.md: status table → Goal → Why → Scope-at-a-glance → Affected files → Execution plan → Batches (role, files, complexity, acceptance criteria, commit stub) → Verification plan. - Print
Plan ready — .hyperflow/tasks/<slug>.md (N batches, M sub-tasks). - Hand off: invoke the
hyperflow-dispatchskill with the task slug — or, in two-session mode, write a committed handoff package and stop.
Rules
- No implementation code; no source edits.
- Floor of 2 clarifying questions on the design path; 0–3 on the bounce (decompose-only) path.
- Single-batch plans for multi-file work are an anti-pattern — decompose.
- Always include a concrete verification plan.
Source: jeremylongshore/claude-code-plugins-plus-skills → plugins/ai-agency/hyperflow/templates/antigravity/skills/hyperflow-plan/SKILL.md