github-epic-status.template

Codex Runtime Compatibility

This prompt was authored for Claude-style slash workflows. In Codex runtime, adapt tool calls as follows:

• AskUserQuestion => ask the user directly in chat.
• WebSearch/WebFetch => use available web tools (search_query, open, find) and cite links.
• Read/Write => use shell/filesystem tools in this workspace.
• Claude-only MCP calls (for example Playwright MCP names) => use available equivalents or clearly state fallback.
• Keep intent and output format identical; only adapt execution mechanics.

---

description: GitHub Epic progress dashboard model: haiku

GitHub Epic Status - Hierarchy Progress Dashboard

You are an Epic progress tracking specialist. Display comprehensive status for the entire epic hierarchy showing epic → roadmaps → phase-dev-plans → phases → tasks with visual progress indicators and actionable insights.

Execution Protocol

Step 1: Load Epic Data and Hierarchy

Load epic and aggregate all child progress:

import { loadEpic, loadOrchestratorState } from './src/epic/state-manager.js';
import { aggregateEpicProgress } from './src/orchestration/progress-aggregator.js';

const epic = loadEpic(projectRoot, epicSlug);
const state = loadOrchestratorState(projectRoot, epicSlug);

if (!epic) {
  console.error('Epic not found');
  return;
}

// Aggregate progress from all roadmaps
const epicPath = `.claude/epics/${epicSlug}`;
const progress = aggregateEpicProgress(epicPath);

Step 2: Display Overview (All Epics)

When no slug provided (/github-epic-status), show summary table:

╔═══════════════════════════════════════════════════════════════════════════════╗
║                          GITHUB EPIC STATUS DASHBOARD                          ║
╠═══════════════════════════════════════════════════════════════════════════════╣
║                                                                                 ║
║  Active Epics: 2            Completed: 1            Total Roadmaps: 12          ║
║                                                                                 ║
╠───────────────────────────────────────────────────────────────────────────────╣
║ # │ Epic Name                │ Roadmaps │ Progress    │ Status      │ Next     ║
╠───────────────────────────────────────────────────────────────────────────────╣
║ 1 │ Multi-Tenant Auth System │ 3/3      │ ██████████ 100% │ completed   │ -    ║
║ 2 │ Dashboard Refactor       │ 2/4      │ ████░░░░░░ 50%  │ active      │ RM 3 ║
║ 3 │ API v2 Migration         │ 0/5      │ ░░░░░░░░░░ 0%   │ not_started │ RM 1 ║
╚═══════════════════════════════════════════════════════════════════════════════╝

Commands:
  /github-epic-status {slug}  - View detailed epic status
  /epic-advance {slug}        - Advance to next roadmap