aiwfx-plan-epic

Scopes and documents a new aiwf epic with allocated id and spec template.

Updated May 9, 2026
One-click install
npx skills add https://github.com/23min/aiwf --skill aiwfx-plan-epic-23min
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aiwfx-plan-epic
Source: https://github.com/23min/aiwf/tree/main/internal/skills/embedded-rituals/plugins/aiwf-extensions/skills/aiwfx-plan-epic
Command: npx skills add https://github.com/23min/aiwf --skill aiwfx-plan-epic-23min

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a large feature or initiative without a structured planning artifact leads to scattered decisions, unclear scope, and lost context across sessions. This Skill turns a vague request like "plan feature X" into a versioned epic spec with a stable id, committed through the aiwf framework's trailered git workflow. ## Core Features & Use Cases - Guided scoping conversation: Asks about problem, beneficiaries, scope, constraints, and success criteria before writing anything, then confirms understanding with the user. - Id allocation and spec scaffolding: Runs aiwf add epic to allocate the next E-NNNN id, fills the epic spec template (goal, context, scope, constraints, risks, milestones), and commits the body via aiwf edit-body with provenance trailers. - Roadmap regeneration: Updates ROADMAP.md via aiwf render roadmap --write and closes the planning session with a merge-to-main prompt or handoff to milestone planning. - Use Case: A user says "I need to build a notification system." The Skill interviews them about scope, allocates E-0007, writes the full epic spec, regenerates the roadmap, and offers to continue into milestone breakdown. ## Quick Start Ask the assistant to plan a new epic for the feature you want to build, for example by saying "plan feature X" or "start an epic for the notification system".

Frequently Asked Questions about aiwfx-plan-epic

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

FAQPage Schema
How do I plan a new epic with aiwf?

Invoke the skill with a phrase like "plan feature X" or "start an epic for Y". It interviews you about scope and constraints, runs aiwf add epic to allocate an E-NNNN id, fills the epic spec template, and commits it with provenance trailers.

When should I use epic planning instead of milestone planning?

Use epic planning when the work does not fit inside a single milestone. If the work fits in one milestone, skip this skill and use aiwfx-plan-milestones directly under an existing epic.

Does planning an epic activate it or break it into milestones?

No. The epic stays in proposed status until you run aiwf promote E-NNNN active. Breaking it into milestones is handled by the separate aiwfx-plan-milestones skill, and aiwfx-start-epic performs the promote.

What dependencies does the aiwf epic planning skill require?

It requires the aiwf binary installed in the repository, since it calls aiwf add epic, aiwf edit-body, and aiwf render roadmap. The epic spec template is materialized by aiwf update at .claude/templates/epic-spec.md.

Why does a plain git commit fail after editing an epic spec?

The aiwf kernel flags entity commits lacking provenance trailers with a provenance-untrailered-entity-commit finding. Use aiwf edit-body E-NNNN to commit body edits atomically with the required aiwf-verb, aiwf-entity, and aiwf-actor trailers.