/epic - Epic Management Command

Manage epics within CODITECT projects. Epics are large bodies of work that can be broken down into features.

Usage

# Create epic in project
/epic create P001 "Epic Title" [--description "Desc"] [--priority 1-100]

# List epics
/epic list [P001] [--status STATUS]

# Show epic details with features
/epic show E001

# Update epic
/epic update E001 --status in_progress --priority 90

# Add feature to epic
/epic add-feature E001 "Feature Title"

# View epic progress
/epic progress E001

# Move epic to different project
/epic move E001 P002

System Prompt

System Prompt

⚠️ EXECUTION DIRECTIVE: When the user invokes this command, you MUST:

1. IMMEDIATELY execute - no questions, no explanations first
2. ALWAYS show full output from script/tool execution
3. ALWAYS provide summary after execution completes

DO NOT:

• Say "I don't need to take action" - you ALWAYS execute when invoked
• Ask for confirmation unless requires_confirmation: true in frontmatter
• Skip execution even if it seems redundant - run it anyway

The user invoking the command IS the confirmation.

---

You are managing CODITECT epics using the Work Item Hierarchy system (ADR-006).

ID Convention:

• Epics: E{NNN} (E001, E042, E123)
• Features: F{NNN} (child of epic)

Hierarchy: Project → Sub-Project → Epic → Feature → Task → Subtask

Status Values: backlog, planned, in_progress, blocked, review, completed, cancelled

Priority Scale: 1-100 (higher = more important)

• 90-100: Critical
• 70-89: High
• 40-69: Medium
• 1-39: Low

Available Actions:

Create Epic

python3 scripts/work_items.py epic create "$PROJECT_ID" "$TITLE" \
  --description "$DESC" --priority $PRIORITY

List Epics

python3 scripts/work_items.py epic list [--project "$PROJECT_ID"] [--status "$STATUS"]

Show Epic

python3 scripts/work_items.py epic show "$EPIC_ID"

Update Epic

python3 scripts/work_items.py epic update "$EPIC_ID" $OPTIONS

Epic Progress

python3 scripts/work_items.py progress "$EPIC_ID"

Output Format:

Epic E001 created successfully.

  ID:          E001
  Title:       User Authentication System
  Project:     P001 (CODITECT v2.0)
  Status:      backlog
  Priority:    90 (Critical)
  Progress:    0%
  Features:    0
  Story Points: -
  Created:     2025-12-13T10:30:00Z

Next steps:
  /feature create E001 "Login Flow"     - Add feature
  /epic update E001 --status planned    - Change status

Examples

Create Epic with Priority

/epic create P001 "API Redesign" --description "RESTful to GraphQL migration" --priority 85

View Epic with Features

/epic show E001

Output:

E001: API Redesign (60% complete)
  Project:  P001 (CODITECT v2.0)
  Status:   in_progress
  Priority: 85 (High)
  Points:   34 estimated

  Features:
  ├── F001: Schema Design (100%) ✓
  ├── F002: Query Resolvers (80%)
  │   └── 4/5 tasks complete
  └── F003: Mutation Handlers (0%)
      └── 0/3 tasks complete

List All In-Progress Epics

/epic list --status in_progress

Success Output

When epic management completes:

✅ COMMAND COMPLETE: /epic
Action: <create|list|show|update>
Epic: E<NNN>
Title: <epic-title>
Project: P<NNN>
Status: <status>
Features: N
Progress: N%

Completion Checklist

Before marking complete:

• Action identified
• Epic ID resolved
• Operation executed
• Results displayed

Failure Indicators

This command has FAILED if:

• ❌ No action specified
• ❌ Invalid epic ID
• ❌ Project not found
• ❌ Database error

When NOT to Use

Do NOT use when:

• Managing features (use /feature)
• Managing tasks (use /task)
• Quick status check (use /project)

Anti-Patterns (Avoid)

Anti-Pattern	Problem	Solution
Skip project	Orphaned epic	Always specify project
No priority	Lost in backlog	Set priority explicitly
No description	Unclear scope	Add detailed description

Principles

This command embodies:

• #3 Complete Execution - Full work item workflow
• #6 Clear, Understandable - Clear hierarchy display
• #9 Based on Facts - Track actual progress

Full Standard: CODITECT-STANDARD-AUTOMATION.md

---

Script: scripts/work_items.py Standard: CODITECT-CORE-STANDARDS/CODITECT-STANDARD-WORK-ITEMS.md Version: 1.0.0