aped-story

Convert product intent into an implementation-ready story file with acceptance criteria and tasks.

2|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/yabafre/aped-claude --skill aped-story
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aped-story
Source: https://github.com/yabafre/aped-claude/tree/main/src/templates/skills/aped-story
Command: npx skills add https://github.com/yabafre/aped-claude --skill aped-story

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents vague, under-specified “create story” requests by converting user intent plus existing PRD/UX/architecture context into an exact, dev-ready story artifact with disciplined file paths, tasks, and acceptance criteria.

Core Features & Use Cases

  • Creates an implementation-ready single story: produces one story at a time with detailed Given/When/Then acceptance criteria.
  • Enforces branch-per-story discipline: gates execution to avoid protected branches and ensures the story lives on its own feature branch (especially in solo mode).
  • Leverages existing epic context and guidance: loads epics/PRD/UX/architecture/project-context and applies scoped lessons and prior-story outcomes to maintain consistency within an epic.

Quick Start

Tell your agent: Run aped-story to prepare the next story for the current epic, using the existing epics.md, PRD/UX/architecture context, and ticket information, and then produce the ready-for-dev story artifact.

Frequently Asked Questions about aped-story

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

FAQPage Schema
How do I generate an implementation-ready story from product requirements?

Implementation-ready story generation converts product intent and existing architecture context into a structured story file with Given/When/Then acceptance criteria and defined tasks. It enforces branch safety by preventing writes to protected branches.

How do I enforce branch-per-story discipline when creating dev pipeline tickets?

Branch-per-story discipline ensures each story lives on its own feature branch. The generation process validates branch safety, gates user approval before writing, and supports deferred feature-branch creation in solo mode to avoid protected branches.

What context do I need to prepare before generating a story from epic context?

Story generation requires strict epic-context loading from epics.md plus PRD, UX, and architecture references. It applies scoped lessons and prior-story outcomes from these sources to maintain consistency within an epic.

Can I create a single story at a time with detailed acceptance criteria?

Yes, single story creation produces one story at a time with detailed Given/When/Then acceptance criteria. It updates state.yaml to advance the story lifecycle and gates user approval before writing the ready-for-dev artifact.

Why does story generation fail without strict epic-context loading?

Story generation requires strict epic-context loading from epics.md plus PRD and architecture references to prevent vague, under-specified requests. Without this context, it cannot maintain consistency within an epic or apply prior-story outcomes.

Does aped-story work with worktree mode for deferred feature-branch creation?

Aped-story supports both worktree mode and solo mode with deferred feature-branch creation. It prepares the next story for the current epic by loading existing context and ticket information before producing the ready-for-dev story artifact.