Skip to content

Conversation

@IanMayo
Copy link
Member

@IanMayo IanMayo commented Jan 23, 2026

Summary

  • Add /epic command to break down large features into 3-10 deliverable backlog items
  • Add Epics section to BACKLOG.md with tracking table
  • Implement [Ex] nomenclature for item-to-epic traceability
  • Support text, local path, and GitHub URL inputs with offline fallback

Changes

Phase 1: Infrastructure

  • Added Epics table to BACKLOG.md (between Workflow and Items sections)

Phase 2: Core Skill Implementation

  • Created /epic skill at .claude/commands/epic.md
  • Input parsing: text description, local .md path, GitHub URL
  • Opus-powered BA + Architect analysis for breakdown
  • Sequential epic ID assignment (E01, E02...)
  • BACKLOG.md updates (epic row + item rows with [Ex] prefix)
  • GitHub issue creation with offline fallback to local files
  • Summary report with next steps

Phase 3: Validation

  • Implementation review documented in evidence/
  • Usage examples documented for all three input modes

Phase 4: Documentation & Media

  • Quickstart guide with examples
  • Shipped blog post and LinkedIn summary

Evidence

Implementation Review

All acceptance criteria verified:

Criterion Status
BACKLOG.md has Epics section PASS
Epic table has 5 columns PASS
/epic skill exists PASS
Accepts text/path/URL PASS
Opus analysis specified PASS
3-10 items target PASS
[Ex] prefix on items PASS
GitHub issues with fallback PASS

Usage Example

# From text description
/epic Add storyboard briefing capability for analysts

# From local document
/epic docs/storyboard-spec.md

# From GitHub URL
/epic https://github.com/debrief/debrief-future/blob/main/docs/storyboard-spec.md

Test Plan

  • Skill file follows /idea command pattern
  • BACKLOG.md Epics section in correct location
  • All 8 execution steps documented
  • Error handling for all edge cases
  • Offline fallback documented

Related

Add item 023 for epic support in speckit workflow.
- Epics section in BACKLOG.md
- New /epic command using Opus for breakdown
- Ex nomenclature for item traceability

Links to #79. Approved for implementation.
Defines:
- Epics section in BACKLOG.md
- /epic skill for breaking down large features
- [Ex] nomenclature for item traceability
- Breakdown guidelines and example output
Phase 0 (Research):
- Skill/command file patterns from existing /idea command
- BACKLOG.md table parsing approach
- Opus prompting strategy for BA/Architect analysis
- GitHub CLI best practices

Phase 1 (Design):
- data-model.md: Epic and Item schemas, Epics table structure
- quickstart.md: Usage guide for /epic command
- plan.md: Implementation plan with constitution check

Phase 2 (Media):
- planning-post.md: Blog announcement draft
- linkedin-planning.md: Social summary
15 tasks across 5 phases:
- Infrastructure: BACKLOG.md Epics section
- Core: /epic skill implementation (8 tasks)
- Validation: manual testing (3 parallel)
- Documentation: quickstart and blog updates
- Integration: PR creation
- Add Epics table to BACKLOG.md (between Workflow and Items)
- Create /epic skill with full workflow:
  - Input parsing (text, local path, GitHub URL)
  - Opus-driven BA + Architect analysis
  - Sequential epic ID assignment (E01, E02...)
  - BACKLOG.md updates (epic row + item rows)
  - GitHub issue creation with fallback to local files
  - Summary report with next steps
- Mark Phase 1-2 tasks complete in tasks.md
Evidence:
- implementation-review.md: acceptance criteria verification
- usage-example.md: example command outputs

Media:
- shipped-post.md: blog announcement
- linkedin-shipped.md: social summary

All Phase 1-4 tasks complete.
@IanMayo IanMayo merged commit 7645ba7 into main Jan 23, 2026
1 check passed
@IanMayo IanMayo deleted the 023-epic-workflow-support branch January 23, 2026 18:04
IanMayo pushed a commit that referenced this pull request Feb 11, 2026
Vega-Lite based results viewing infrastructure: renderer component,
tabbed bottom panel, logical result ID registry, custom editor for
drag-to-float, and auto-refresh. Absorbs E03 #83 into E04 #89.
Updates E03 cross-epic dependencies (only #82 and #84 need E04).

https://claude.ai/code/session_015jzC8noATYLoama7VdveuR
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant