needs-spec
OfficialTurn user stories into precise specs.
Authorprovenimpact
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Create and maintain feature specifications with EARS requirements derived from user stories. Use when the proven-needs orchestrator determines that a feature needs specifications created or synced. Operates within a single feature package at docs/features/<slug>/; Specs define WHAT must be true — black-box testable requirements for externally observable behavior.
Core Features & Use Cases
- Observe current state: Read feature stories in docs/features/<slug>/user-stories.adoc and evaluate existing specs; identify constraints to avoid duplication.
- Determine actions: Decide whether to create a new spec or sync an existing one based on story versions and content.
- Execute spec creation/sync: Derive black-box requirements, assign a unique ID, and generate docs/features/<slug>/spec.adoc with proper headers and traceability.
Quick Start
Run this skill to generate or synchronize a feature specification from the current feature stories.
Dependency Matrix
Required Modules
None requiredComponents
Standard package💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: needs-spec Download link: https://github.com/provenimpact/proven-needs/archive/main.zip#needs-spec Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.