Skill3.7k repo starsupdated 6d ago

feature-spec

The feature-spec skill generates comprehensive product specifications including user stories, acceptance criteria, scope boundaries, dependencies, and risk assessment by delegating to a PM agent. Use this when defining new features, documenting business requirements, or preparing structured handoffs to development teams before implementation begins.

View source Repository: buildwithclaude

Install in Claude Code

Copy

git clone --depth 1 https://github.com/davepoon/buildwithclaude /tmp/feature-spec && cp -r /tmp/feature-spec/plugins/agent-triforce/skills/feature-spec ~/.claude/skills/feature-spec

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# Feature Spec

Creates a complete product feature specification using the Prometeo (PM) agent.

## When to Use This Skill

- Defining a new feature or product requirement
- Writing user stories with acceptance criteria
- Planning product work that needs a structured spec
- Documenting business requirements before implementation

## What This Skill Does

1. Runs the SIGN IN checklist (identity, task, memory review)
2. Researches existing specs to avoid conflicts
3. Creates a comprehensive spec at `docs/specs/{feature-name}.md`
4. Runs the Spec Completion checklist (TIME OUT)
5. Prepares a structured handoff to the Dev agent
6. Runs the SIGN OUT checklist (memory update, deliverables)

## How to Use

### Basic Usage

```
/feature-spec user authentication with JWT tokens
```

### Detailed Usage

```
/feature-spec multi-tenant billing system with Stripe integration
```

## Example

**User**: `/feature-spec webhook event system`

**Output**: A complete spec at `docs/specs/webhook-event-system.md` containing:
- Problem statement and success metrics
- User stories with GIVEN/WHEN/THEN acceptance criteria
- In-scope and out-of-scope items
- Dependencies, risks, and open questions
- Handoff notes for the Dev agent

## Tips

- Be specific about the feature scope in your description
- The agent will ask clarifying questions rather than guess
- Review the generated spec before passing to implementation