Repository navigation
Epics
This guide provides guidance for Product Engineers (PEs) responsible for managing epics. Epics help organize larger initiatives that span multiple issues, contributors, or milestones.
The goal of epic ownership is coordination and visibility, not implementation.
An Epic represents a larger body of work that contains multiple related issues. These issues may include:
- Feature development
- Refactors
- Bug fixes
- Design updates
- Documentation updates
Epics help group related work together so the team can track progress on broader initiatives.
Example epic scope:
- Refactoring a component family
- Implementing a design refresh
- Introducing new functionality across multiple components
Epics are typically assigned to a Product Engineer (PE) for coordination.
The epic owner is not necessarily responsible for implementing the work within the epic. Instead, the owner ensures the effort stays organized and continues moving forward. Epic ownership is primarily about keeping the initiative organized, visible, and moving forward.
Individual issues under the epic should still be assigned to developers as normal.
Epic owners typically:
- Monitor the issues contained in the epic
- Ensure issues are progressing toward completion
- Identify blockers or stalled work
- Help create or organize new issues related to the epic
- Coordinate discussions when design or technical decisions are needed
- Keep the epic description updated as scope evolves
Think of epic ownership as project stewardship rather than task ownership.
Epic owners should periodically review the issues within the epic to ensure progress is being made. The goal is not strict oversight, but maintaining momentum and awareness.
Some helpful checks include:
- Are issues assigned to someone?
- Are issues moving through labels or workflow stages?
- Are any issues blocked?
- Are new issues emerging that should be added to the epic?
If work appears stalled, the epic owner may:
- Ask for updates from the assigned developer
- Raise the topic during team syncs
- Help unblock discussions or decisions
As work progresses, additional issues may be identified that relate to the epic.
Epic owners should:
- Add relevant issues to the epic
- Ensure issues have clear descriptions
- Confirm the issue scope fits the epic’s goals
Not every "related" issue needs to be included, but issues that fit the scope and are similar to the work being done in the epic should be tracked there.
- Apply the appropriate lifecycle label (e.g.,
1 - in design,3 - in development, etc.) based on the overall state of the work. - Do not apply estimate labels to the epic itself, to avoid duplicate estimation.
- Individual issues under the epic should follow the normal workflow labels used by the team.
Typically, an epic spans multiple milestones. If all sub-issues have a milestone, the epic should be placed in the furthest milestone. If not, the epic should be placed in the Backlog.
Like standard issues, the epic can be assigned a Release Target in Monday.com to ensure it and its sub-issues are planned for the needed release.
Epic management may involve things like:
- Scheduling a discussion meeting to align on implementation direction
- Monitoring related issues to ensure they move through the workflow
- Adding newly discovered issues to the epic
- Noticing related bugs or improvements that should be included
- Tracking dependencies or blockers across multiple issues
- Monorepo
- Global Config
- Coding Conventions
- Testing Conventions
- Patching Packages
- Deprecation Guidance
- Continuous Integration
- GitHub Secrets
- Troubleshoot Build Errors
- Tips and Tricks
- NPM FAQ
- Issue Verification
- Wiki Conventions
- Styling Conventions
- CSS Transitions
- Restricting User Input
- ItemHidden Property
- What Happens When You Scale Vector-Based Icons
- Internationalization
- Introduction
- Getting Started
- Naming Schema
- Semantic Tokens
- Component Tokens
- Web Platform
- Build
- Documentation
- Testing
- Contributing