epic-executor

Orchestrate sequential epic tasks with dual-stage spec and code reviews.

Updated Sep 30, 2025
One-click install
npx skills add https://github.com/tom-abp/.claude --skill epic-executor
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: epic-executor
Source: https://github.com/tom-abp/.claude/tree/main/skills/epic-executor
Command: npx skills add https://github.com/tom-abp/.claude --skill epic-executor

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bead-epic orchestration, coordinating subagents to execute tasks sequentially while ensuring compliance and quality checks after each step.

Core Features & Use Cases

  • Sequential, one-task-at-a-time execution to avoid conflicts and ensure traceability.
  • Two-stage review workflow: a spec compliance review followed by a code quality review before closing tasks.
  • Epics context management with status tracking and base SHA recording for auditability.

Quick Start

Provide an epic-id to begin processing its tasks end-to-end.

Frequently Asked Questions about epic-executor

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

FAQPage Schema
How do I orchestrate subagents to execute beads epics sequentially?

To orchestrate beads epics sequentially, provide an epic-id to initiate end-to-end processing. The workflow coordinates subagents to execute tasks one at a time, avoiding conflicts and ensuring traceable completion across the entire epic.

What is the two-stage review workflow for task automation in epic execution?

The two-stage review workflow for task automation enforces mandatory verification before closing any task. It first conducts a spec compliance review, then immediately follows with a code quality review to ensure both standards are met.

How does epic execution track task state transitions and auditability?

Epic execution tracks task state transitions deterministically through statuses like in_progress, approved, needs_changes, and closed. It records epics context and base SHA for complete auditability and traceable completion across multiple tasks.

Can I run multiple tasks simultaneously within a bead-epic workflow?

No, bead-epic workflows enforce sequential, one-task-at-a-time execution. This deterministic pipeline prevents conflicts and ensures precise staged reviews are completed for each task before moving to the next.

Do I need an epic-id to start the subagent-driven development workflow?

Yes, you must provide an epic-id to begin processing tasks end-to-end. This identifier initializes the context management, status tracking, and base SHA recording required for the staged review pipeline.

When should I avoid using a deterministic pipeline for epic execution?

You should avoid this deterministic epic execution pipeline if your workflow requires parallel task processing or if your project does not rely on the beads epic structure and subagent coordination for code review.