start-epic

Review architecture proposals and activate epics after approval gates.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/ian97531/goodplan --skill start-epic
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: start-epic
Source: https://github.com/ian97531/goodplan/tree/main/skills/start-epic
Command: npx skills add https://github.com/ian97531/goodplan --skill start-epic

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Epics often stall while architecture decisions are pending, causing misalignment and duplicated effort. This Skill orchestrates loading an epic's architecture proposal, obtaining user approval, and activating the epic only after the formal gate is passed.

Core Features & Use Cases

  • Load and resolve architecture proposals, validate epic state, and present a clear decision path.
  • Require explicit user approval to activate successive epics, ensuring governance and consistency.
  • Create or merge the target architecture for the epic and propagate required changes to downstream skills.
  • Guide users through the proposal review workflow, including skipping or revising proposals when appropriate.

Quick Start

Provide the epic name to start the approval and activation workflow.

Frequently Asked Questions about start-epic

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

FAQPage Schema
How do I prevent premature epic activation in project management workflows?

You prevent premature epic activation by enforcing architecture proposal review and explicit approval gates. The workflow validates epic states like proposal-pending, requiring governance checks before transitioning the epic to active.

What is an architecture proposal gate and how does it control epic progress?

An architecture proposal gate controls epic progress by loading the proposal, demanding user approval, and only activating the epic after the formal gate is passed. This prevents misalignment and duplicated effort.

How do I start the approval and activation workflow for an epic?

Start the approval and activation workflow by providing the epic name. The system orchestrates loading the architecture proposal, guides you through the review, and records approval and activation in the project state log.

Can I skip or revise an architecture proposal during the epic review process?

Yes, you can skip or revise architecture proposals during the review process. The workflow guides users through proposal evaluation, allowing changes or skipping when appropriate before seeking explicit activation approval.

How does the state machine handle epic states like needs-architecture-proposal?

The state machine enforces state checks for epic states like needs-architecture-proposal, preventing invalid transitions. It creates architecture directories when needed and records approval and activation in the project state and activity log.

What happens to downstream skills after an epic architecture is approved?

After architecture approval, the system merges the target architecture for the epic and propagates required changes to downstream skills. This ensures consistency across the workflow and prevents duplicated effort.