piv-slice-epic

Decompose an epic and its architecture decisions into dependency-mapped, PIV-sized implementation tickets.

Updated Aug 28, 2026
One-click install
npx skills add https://github.com/az9713/claude-code-hooks-tutorial --skill piv-slice-epic-az9713
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: piv-slice-epic
Source: https://github.com/az9713/claude-code-hooks-tutorial/tree/main/skills/.claude/skills/piv-slice-epic
Command: npx skills add https://github.com/az9713/claude-code-hooks-tutorial --skill piv-slice-epic-az9713

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Large strategic documents like epics and PRDs are too big for an AI coding loop to execute in one pass. This Skill bridges the gap by slicing an epic (along with its architecture decisions) into discrete, testable tickets with a dependency graph, so each unit of work can be executed independently by an agent loop. ## Core Features & Use Cases - Architecture-aware slicing: Reads the epic plus its architecture section or linked architecture page (via Confluence/Jira URLs through the Atlassian MCP) so slices respect named seams, data models, and missing pieces. - AI-scoped tickets: Sizes tickets for agent execution (roughly 500-1500 lines of change including tests, one testable concern each) rather than traditional human backlog items. - Dependency mapping and parallelization: Produces a dependency graph and suggested execution waves, marking which tickets can run in parallel worktrees and which must wait for dependencies to be implemented. - Tracker-agnostic output: Writes tickets to Jira via the Atlassian MCP, Linear, GitHub Issues, or a local docs/tickets/<epic-slug>.md file. - Use Case: You have a Confluence epic with a linked architecture page for a new ingestion pipeline. Pass both URLs to the Skill, and it produces a ticket breakdown where each ticket carries its own context, acceptance criteria, file estimates, and dependency links, ready for implementation loops. ## Quick Start Run /piv-slice-epic with the path or URL of your epic and its linked architecture page to generate a dependency-mapped ticket breakdown in your tracker.

Frequently Asked Questions about piv-slice-epic

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I break an epic into tickets for AI coding agents?▼

Pass the epic and its architecture page to /piv-slice-epic. It decomposes the work into tickets of roughly 500-1500 lines of change each, each with one testable concern, acceptance criteria, per-ticket context, and a dependency graph for execution ordering.

How to slice an epic from Confluence or Jira automatically?▼

Provide the Confluence or Jira URLs as arguments. The Skill fetches both the epic and its linked architecture page through the Atlassian MCP, reads them fully, and writes the resulting ticket breakdown back to your tracker.

Does epic slicing require a primed codebase session first?▼

No, priming is optional. If the codebase surface is not loaded, the Skill orients itself by reading the relevant files starting from the architecture's named seams and data model, just enough to judge ticket independence.

Can I use epic slicing without Jira or Linear?▼

Yes, the Skill is tracker-agnostic. If you have no tracker or work solo, it writes the full ticket breakdown, dependency graph, and execution waves to a local markdown file at docs/tickets/<epic-slug>.md.

What ticket size works best for autonomous coding loops?▼

Tickets are scoped for AI execution rather than human backlogs: one testable concern, about 8-10 subtasks, and 500-1500 lines of change including 20-50% tests. Each ticket must be provable in one focused loop without context rot.