needs-stories

Convert feature intent into testable user stories with EARS-style acceptance criteria.

Updated Feb 19, 2026
One-click install
npx skills add https://github.com/provenimpact/proven-needs --skill needs-stories
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: needs-stories
Source: https://github.com/provenimpact/proven-needs/tree/main/skills/needs-stories
Command: npx skills add https://github.com/provenimpact/proven-needs --skill needs-stories

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Stories are often missing or misaligned with user needs, causing scope creep and poor validation. This skill helps teams create and update user stories with precise acceptance criteria from a user's perspective, ensuring alignment with feature intent.

Core Features & Use Cases

  • Generate new user stories from feature intent and context
  • Update existing stories to reflect changes in scope or constraints
  • Validate stories against EARS-style acceptance criteria
  • Read and interpret docs/features/<slug>/user-stories.adoc to extend or refine story sets

Quick Start

Describe the feature briefly and generate a first set of US-001 style stories.

Frequently Asked Questions about needs-stories

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

FAQPage Schema
How do I generate testable user stories from feature intent?

User stories are generated by converting feature intent into US-001 style stories with EARS-style acceptance criteria, ensuring alignment with user needs and feature scope to prevent scope creep and poor validation.

What are EARS-style acceptance criteria for user stories?

EARS-style acceptance criteria are structured conditions used to validate user stories from a user's perspective, ensuring that stories are testable, precise, and aligned with the intended feature state and constraints.

How do I update existing user stories when feature scope changes?

Existing user stories are updated by reading docs/features/<slug>/user-stories.adoc to refine the story set, enforcing constraint checks and versioning throughout the Execute phase to reflect changes in scope or constraints.

Can I use feature packages to manage user story versioning and constraints?

Feature packages at docs/features/<slug>/ support user story versioning and constraint checks, as the skill operates within this context to align stories with the current feature state throughout execution.

Why does missing alignment between user stories and feature intent cause scope creep?

Misaligned user stories cause scope creep because they lack precise acceptance criteria, leading to poor validation and uncontrolled feature expansion during development.

What's the best way to validate user stories against current feature state?

Validating user stories against current feature state is best done by enforcing constraint checks and versioning within a single feature package, ensuring stories remain aligned with feature intent throughout the Execute phase.