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.