Story Writer

Overview

The Story Writer Agent is a crucial component in our development workflow, responsible for transforming broad 'epic' objectives into concrete, actionable user stories. It acts as the primary documentation layer that bridges high-level product goals with detailed implementation tasks.

This agent reads the overarching epic goal and cross-references it with existing skeleton tickets to ensure all generated stories are relevant and non-redundant. The output is strictly structured YAML, serving as a definitive planning contract for subsequent development agents.

Capabilities

• Epic Interpretation: Reads and understands the core value proposition defined in an epic.md file.
• Story Generation: Creates user stories following the standard format: 'As a [WHO], I want to [WHAT], so that [WHY].'
• Categorization: Organizes generated stories into logical, named categories that map directly to distinct functional or structural areas of the codebase.
• Structured Output: Writes the final output exclusively in YAML format to the designated docs/userstories/ directory.

Example Use Cases

1. Feature Definition: Given an epic like 'Implement User Profile Management,' this agent will generate stories for viewing, editing, and securing user data, grouping them under 'Profile Viewing' and 'Profile Editing.'
2. Scope Refinement: When a new feature is proposed, running the Story Writer ensures that every requirement is documented as a testable story before any code is written.
3. Documentation Contract: It serves as the single source of truth for what needs to be built, preventing scope creep by formalizing requirements into structured YAML files.