aa-execute-epic

aa-execute-epic is a skill for Claude Code from Peeyushmeher/agent-agile. It costs 35 tokens per session (1,516 once invoked), scanned A, original, MIT.

A workflow for building an epic whose smaller story cards and implementation contracts have already been prepared. An epic is a larger piece of work split into smaller deliverables.

In plain words
What is it for?
Use it to execute a sliced epic, coordinate its stories, integrate their changes, and run the required verification and review gates.
Why use it?
It organizes contract checks, parallel story implementation, integration, verification, and review so the prepared work is built consistently.

Skill for Claude Code

Written for Claude Code: ${CLAUDE_PLUGIN_ROOT} variable. Also seen: reads .claude/ paths; mentions subagents.

Runs only inside its plugin — its command needs a path that Claude Code sets for a plugin’s own hooks and for nothing else. Install the plugin, not this.

Part of the agent-agile plugin — 11 skills, 11 agents shipped together

Good fit Use it to execute a sliced epic, coordinate its stories, integrate their changes, and run the required verification and review gates.

Compare 6 skills from other repositories ↓
Install

Getting it into your agent

This one installs as part of its plugin. Adding the marketplace and installing the plugin brings it with everything else the plugin ships.

Claude Code
/plugin marketplace add Peeyushmeher/agent-agile
Claude Code
/plugin install agent-agile

Made for: Claude Code.

Or install agent-agile, the plugin that ships this one along with the rest of its 11 skills, 11 agents.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for aa-execute-epic

README.md
[![agentmods](https://agentmods.dev/badge/skills/peeyushmeher/agent-agile/aa-execute-epic/github.svg)](https://agentmods.dev/skills/peeyushmeher/agent-agile/aa-execute-epic)
Your own site
<a href="https://agentmods.dev/skills/peeyushmeher/agent-agile/aa-execute-epic"><img src="https://agentmods.dev/badge/skills/peeyushmeher/agent-agile/aa-execute-epic/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for aa-execute-epic

Your own site · 80×15
<a href="https://agentmods.dev/skills/peeyushmeher/agent-agile/aa-execute-epic"><img src="https://agentmods.dev/badge/skills/peeyushmeher/agent-agile/aa-execute-epic.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 35 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,516 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00035 $0.01516
Opus 5 $0.00017 $0.00758
Sonnet 5 $0.00007 $0.00303
Haiku 4.5 $0.00003 $0.00152

Measured 9d ago against content hash 5595637e311d, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

aa-execute-epic scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/aa-execute-epic/SKILL.md · 39 lines

How it starts

The opening of the file, as written. The whole thing — 39 lines — stays where its author put it; the contents beside it link to each section on GitHub.

aa-execute-epic

Resolve the Agent-Agile playbook root: use the first of these that exists — (1) ${CLAUDE_PLUGIN_ROOT}/playbooks, (2) ./.claude/agent-agile/playbooks, (3) ./.agents/agent-agile/playbooks, (4) ~/.claude/agent-agile/playbooks, (5) ~/.agents/agent-agile/playbooks, (6) ./playbooks.

Read playbooks/execution.md sections "Wave 0 — contracts", "Pre-flight", "Wave 1 — stories", "Wave 2 — integrate", "Verification", and "The review gate", and follow them exactly; do not re-derive or improvise the sequence.

This skill stays lean: it dispatches subagents and collects their output. It never writes application code itself.

Wiring

  1. Wave 0 — contracts. Spawn a fresh aa-contractor subagent with the model configured for the smart tier in .planning/CONFIG.md. Give it every story card's Contracts consumed field. It writes .planning/epics/EPIC-NN/CONTRACTS.md. Once written, treat it as frozen — do not let any later step edit it.
  2. Pre-flight. Both checks must pass before Wave 1 launches:
    • Run the collision check: node <playbook-root>/../scripts/collision-check.js <epic-dir>, where <playbook-root> is the playbook root resolved above (in a source checkout of this repo that is simply node scripts/collision-check.js <epic-dir>). A clean run exits 0 with {"ok":true}. A collision exits 1 with a JSON report naming every contested file and the stories that claim it. On a collision, refuse to launch Wave 1 — report the exact colliding files and stories, and send the epic back to slicing so the shared file moves into CONTRACTS.md or the stories get merged.
    • Read .planning/PREREQS.md. Every row must be verified, or done in the specific case where verified isn't actually checkable. Run any stated verification command now — don't trust the checkbox. A pending row, or a done row whose verification command fails, blocks launch: stop and treat it exactly like the missing-prerequisite circuit breaker in playbooks/execution.md "Circuit breakers" rather than pushing forward.
    • Print the readiness dashboard from playbooks/execution.md "Pre-flight" — the gate table (contracts pinned, collisions, prerequisites, graders on every card, control-set size) and its CLEARED/BLOCKED verdict — before dispatching anything. Any ✗ row is the refuse behavior above; the dashboard renders the decision, it never softens it.
  3. Wave 1 — stories. Spawn one fresh aa-worker subagent per story card, in parallel, each with the model configured for the cheap tier in .planning/CONFIG.md. Give each worker exactly two inputs — its own story card and CONTRACTS.md — nothing else: no other story's card, no wider exploration mandate. Each worker builds against its Files it owns list, runs its own acceptance check, and writes .planning/epics/EPIC-NN/stories/SN.report.md as a typed report from playbooks/templates/REPORT.md. A failed check starts the worker's bounded repair loop — fix and re-run, up to 3 repair rounds within the same dispatch; only an exhausted loop reports FAIL, and that story is flagged and not merged.
  4. Wave 2 — integrate. Spawn a fresh aa-integrator subagent with the model configured for the smart tier in .planning/CONFIG.md. It parses every SN.report.md's typed fields (flagging mechanically: FAIL status, files touched outside ownership, deviations, contract change requests), wires the cross-story seams, runs the epic-level acceptance check (the demo sentence, exercised for real — with up to 3 seam-repair rounds on failures it owns), runs every row of .planning/CONTROL.md when the file exists, writes DEMO.md and LEARNINGS.md, flips the epic's ROADMAP.md row, and updates STATE.md. Any flagged story from Wave 1 is its problem to resolve or note in LEARNINGS.md — never quietly dropped from the merge.
  5. Verification. Spawn a fresh aa-verifier subagent with the model configured for the smart tier in .planning/CONFIG.md — someone who wrote none of the epic's code. It checks whether the demo sentence is actually true, re-runs acceptance checks rather than trusting the reports, pokes the edge cases in DEMO.md's "what to look for" section, and returns a plain verdict: pass, or a redo-list of specific findings.
  6. The review gate. Present DEMO.md and the verifier's verdict at the gate, per the mode set in .planning/CONFIG.md's gate field (interactive/checkpoint/full-auto — see playbooks/execution.md "Autopilot" for what each mode means for who reads the gate). The gate has exactly three outcomes:
    • Approve — the epic is done. Append its epic-level check to .planning/CONTROL.md (create from playbooks/templates/CONTROL.md on first approval).
    • Redo — convert every tip and finding into a new, concrete acceptance check on the specific story or stories it affects, re-run Wave 1 for those stories and Wave 2 to re-integrate, then verify again. If the redo-list qualifies for the scoped redo in playbooks/execution.md "The review gate" (every finding file-specific, all files owned by one story, contracts untouched), take that path instead: one cheap-tier fix worker plus re-verification, no wave re-run — one scoped attempt only, then escalate to the full redo.
    • Replan — send the epic back to slicing entirely; the roadmap after it gets re-examined.

Read the full file on GitHub · 39 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 9d ago First seen · 39 lines · 35 tokens per session scan A 5595637e311d

Subscribe to this mod's changes

aa-execute-epic is a skill published in the GitHub repository Peeyushmeher/agent-agile (3 stars, last pushed 1mo ago), licensed MIT. It adds 35 tokens to every session and 1,516 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

project-manager

This skill has been upgraded with agentic AI capabilities, OKR/KPI integration patterns, and async-first workflows based on 2026 PM best practices research.

buiphucminhtam/forgewright · 68 tokens

team-okrs

An OKR tracking page for a quarter. OKRs, or objectives and key results, are goals paired with measurable results.

nexu-io/html-anything · 23 tokens

product-frameworks

Product management frameworks for business cases, market analysis, strategy, prioritization, OKRs/KPIs, personas, requirements, and user research. Use when building ROI projections, competitive analysis, RICE scoring, OKR trees, user personas, PRDs, or usability testing plans.

yonatangross/orchestkit · 61 tokens

gr-product-dev-ops

🇺🇸 Your dev team ships features nobody asked for while user-reported bugs pile up for months. Operations blames engineering for ignoring users; engineering blames operations for not understanding technical constraints. This gives you the complete Product × Engineering × Operations alignment SOP — from unified…

Gingiris-1031/gingiris-skills · 576 tokens

derive-capacity

Work out how many points a week each person on the aeman board actually gets through, from the cards they have closed, and set it as their capacity after the lead confirms. Use when a team lead asks about throughput, weekly capacity, how much a person or a team can take, or wants the numbers over the columns filled in.

aenix-io/aeman · 72 tokens

size-cards

Size the unsized cards of a team or a person on the aeman board — S/M/L/XL by a fixed rubric, written back through the aeman MCP after the lead confirms. Use when a team lead asks to estimate, size or weigh cards, or before a planning meeting.

aenix-io/aeman · 63 tokens