What problem does it solve?
It solves the common pain points of incomplete, vague user stories and disorganized project documentation that lead to requirement misalignment, unclear acceptance criteria, and wasted development time.
Core Features & Use Cases
- Guided User Story Generation: Uses a structured interview protocol to extract missing requirement context (background, goals, acceptance criteria) and generates INVEST-compliant user story documents, eliminating vague or incomplete requirements.
- Automated Document Placement: Infers the target project sub-module from file paths or git status to place generated user stories in the correct docs/04-user-stories/ directory, avoiding manual file organization errors.
- Standard Docs Structure Initialization: Creates the full 5-folder standard project documentation directory structure with .gitkeep files and maintenance guidelines for new projects, ensuring consistent documentation organization across teams.
Use case: For example, when a product team needs to document a new alarm filtering feature, the skill guides stakeholders to clarify pain points (500+ daily heartbeat probe alarms causing operator alert fatigue), quantifiable success metrics (reduce fault response time from 15 minutes to 2 minutes), and verifiable acceptance criteria, then saves the standardized document to the correct operations module docs folder.
Quick Start
Ask the story-craftsman skill to help you write a user story for the new alarm silence rule feature, and it will guide you through confirming missing requirements and generate the standardized document in the correct project directory.