| name | decompose-epic |
| description | Gemini-native Linear epic decomposition — analyzes goals and creates atomic sub-tickets with 2M+ token grounding |
| capability | skill.decompose_epic |
| node_name | node_skill_decompose_epic_orchestrator |
| dot_color | 39 |
Decompose Epic Skill (Gemini Edition)
Analyze a Linear epic and generate a set of actionable, repo-aligned sub-tickets using Gemini's massive context window to ensure perfect architectural alignment and dependency mapping.
Workflow
- Epic Analysis: Gemini fetches the epic description and goals from Linear and analyzes them against the organization's
repo_manifest.yaml.
- Workstream Identification: Identifies distinct workstreams, ensuring that each ticket is atomic (one repo, one PR, one deliverable).
- Ticket Generation: Generates titles, descriptions, functional requirements, and Definition of Done (DoD) for each child ticket.
- Contract Generation: Automatically generates and commits ONEX contract YAMLs for all created tickets, ensuring immediate contract coverage.
- Remediation: Returns a
ModelSkillResult with the list of created tickets for downstream orchestration by epic-team.
Gemini Advantages
- Cross-Repo Architectural Awareness: Gemini can see the entire organization's structure to perfectly assign sub-tickets to their owning repositories.
- Superior Decomposition Logic: Generates higher-quality tickets with clearer boundaries, reducing the risk of integration conflicts later in the pipeline.
- Automated Contract Alignment: More accurately infers the necessary input/output models and topics for the new sub-tickets by seeing the whole organization's registry.
Arguments
epic_id: Linear epic ID (e.g., OMN-2000).--dry-run: Preview the decomposition plan without creating tickets.--repos: Explicit list of repos to target.
