epic-grooming

Map orphaned epics to registered definitions and update epics.md with approvals.

Updated Mar 10, 2026
One-click install
npx skills add https://github.com/iamsteveholmes/momentum --skill epic-grooming
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: epic-grooming
Source: https://github.com/iamsteveholmes/momentum/tree/main/skills/momentum/skills/epic-grooming
Command: npx skills add https://github.com/iamsteveholmes/momentum --skill epic-grooming

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Epic grooming provides a structured workflow to identify orphaned epics, map them to registered definitions, and reclassify stories to maintain a clean, navigable project taxonomy.

Core Features & Use Cases

  • Taxonomy discovery: scan story and epic definitions to surface registered vs orphaned epics.
  • Proposal-driven governance: generate merge, create, or split proposals with rationale, awaiting explicit developer approval.
  • Traceable changes: apply updates to epics.md and reassign stories through momentum-tools with complete completion notes.

Quick Start

Review the Epic Grooming workflow in workflow.md and begin by proposing taxonomy changes with explicit approvals.

Frequently Asked Questions about epic-grooming

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

FAQPage Schema
How do I fix orphaned epics in my project taxonomy?

To fix orphaned epics in your project taxonomy, you can scan momentum artifacts to identify unmapped epics, propose mapping them to registered definitions or creating new ones, and reassign stories after explicit approval. Updates are then applied to epics.md.

What is the best way to reassign stories across different epics?

The best way to reassign stories across different epics is to use momentum-tools epic-membership functionality, which applies story reassignment systematically while ensuring all architectural context and FR/NFR coverage changes are recorded in completion notes.

How does epic grooming handle story slugs and FR/NFR coverage?

Epic grooming handles story slugs and FR/NFR coverage by applying systematic analysis across momentum artifacts to detect gaps, ensuring every story maintains proper functional and non-functional requirements alignment before any taxonomy mutations are proposed.

Do I need explicit developer approval before updating epic definitions?

Yes, you need explicit developer approval before updating epic definitions because the workflow is proposal-driven; it generates merge, create, or split proposals with rationale and awaits direct confirmation before mutating epics.md or reassigning any stories.

When should I use an epic grooming workflow for taxonomy harmonization?

You should use an epic grooming workflow for taxonomy harmonization when your project has accumulated orphaned slugs and misaligned stories across momentum artifacts, requiring structured discovery and proposal-driven governance to restore navigability.

Can I update epics.md templates automatically without manual review?

No, you cannot update epics.md templates automatically without manual review; the workflow requires explicit developer approval before applying any template updates or story reassignments to ensure all taxonomy changes remain traceable and governed.