hyper-plan

Generates ordered implementation plans or epic roadmaps into .hyperclaude directories.

3|Updated May 10, 2026
One-click install
npx skills add https://github.com/zeikar/hyperclaude --skill hyper-plan-zeikar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hyper-plan
Source: https://github.com/zeikar/hyperclaude/tree/main/skills/hyper-plan
Command: npx skills add https://github.com/zeikar/hyperclaude --skill hyper-plan-zeikar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

hyper-plan helps you break down a non-trivial coding task into a structured, bite-sized implementation plan so you can move forward without getting stuck on scope and ordering.

Core Features & Use Cases

  • Task decomposition into a runnable plan: Produces either a detailed multi-task plan or an epic roadmap (for oversized work) saved under .hyperclaude/plans/ or .hyperclaude/epics/.
  • Research-to-plan traceability: Reuses the canonical slug from matching .hyperclaude/research/*.md artifacts so plan, review, and research stay linked.
  • Epic-aware milestone expansion: For oversized tasks, expands Milestone K using the roadmap’s milestone scope and Depends on context so later milestones remain connected.
  • Practical skip rules: Avoids unnecessary replanning for one-step tasks and when a recent plan already covers the work.

Quick Start

Run the skill to turn a new feature request into a plan by typing: /hyperclaude:hyper-plan add OAuth login to the API.

Frequently Asked Questions about hyper-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break down a large coding task into an executable implementation plan?

To break down a coding task into an implementation plan, this skill dispatches a planner agent to generate an ordered, bite-sized decomposition saved under .hyperclaude/plans/. It transforms non-trivial feature requests into structured, runnable steps without getting stuck on scope.

How do I generate an epic roadmap for oversized software engineering tasks?

For oversized software engineering tasks, this skill generates an epic roadmap saved under .hyperclaude/epics/ instead of a standard plan. It structures massive workloads into manageable milestones while preserving dependency context for later expansion.

How does task planning maintain research traceability for code implementation?

Task planning maintains research traceability by deterministically matching research artifacts via frontmatter slug. This ensures your code implementation plan, review, and research documents stay linked throughout the agent orchestration workflow.

Can I expand an existing epic roadmap milestone without losing dependency context?

Yes, you can expand an existing epic roadmap milestone while carrying the roadmap's Depends on context into later detailed plans. This epic-aware milestone expansion ensures subsequent implementation tasks remain connected to the original scope.

When should I avoid automated task decomposition for coding projects?

You should avoid automated task decomposition for one-step tasks or when a recent plan already covers the work. The skill applies practical skip rules to avoid unnecessary replanning for simple coding implementations.

What is the best way to plan an OAuth login feature for an API?

The best way to plan an OAuth login feature is to run the skill with your task description to generate a structured, ordered decomposition plan. This produces a multi-task implementation roadmap that handles the non-trivial scope of API authentication.