- Version: 2.0
Creates comprehensive project briefs with intelligent story breakdown and version management.
/plugin marketplace add ninthspace/claude-code-marketplace/plugin install sdd@ninthspace-marketplacePurpose: Generate comprehensive project briefs that intelligently break down complex features into multiple related stories, building upon existing project context when available.
Syntax: /sdd:project-brief [project_title]
| Parameter | Type | Required | Default | Description | Validation |
|---|---|---|---|---|---|
| project_title | string | No | prompted | Name of the project or feature set | Non-empty string |
/docs/project-context/project-brief.md (current brief)/docs/project-context/story-relationships.md (story dependencies)/docs/project-context/versions/ (historical versions)/docs/project-context/project-brief.md/docs/project-context/versions/ directory if not present.gitkeep file to versions directory/docs/project-context/versions/project-brief-v[N]-[timestamp].md/docs/project-context/story-relationships.md/docs/project-context/versions/story-relationships-v[N]-[timestamp].mdIF project_title not provided:
IF existing brief found:
ELSE (no existing brief):
ANALYZE requirements to identify:
FOR EACH identified story:
DETERMINE logical dependencies between stories
ESTIMATE relative effort using scale: S / M / L / XL
GENERATE project brief content using project brief template
INCLUDE sections:
WRITE to /docs/project-context/project-brief.md
/docs/project-context/project-brief.md/docs/stories/development/IF stories have dependencies:
/docs/project-context/story-relationships.mdFORMAT Story Priority Matrix:
| Story ID | Title | Priority | Dependencies | Effort | Status |
|----------|-------|----------|--------------|--------|--------|
| STORY-XX | ... | Core | None | M | development |
| STORY-YY | ... | Core | STORY-XX | L | backlog |
GROUP stories by implementation phase:
DISPLAY summary report:
✅ Project Brief Created
═══════════════════════════════════
Project: [project_title]
Brief Location: /docs/project-context/project-brief.md
Relationships: /docs/project-context/story-relationships.md
Stories Identified: [count]
- Core Stories: [count]
- Enhancement Stories: [count]
- Future Stories: [count]
Dependencies: [count] identified
Implementation Phases: [count]
SUGGEST next steps:
/sdd:project-init to set up development environment/sdd:story-new to start with core stories/docs/project-context/project-brief.md - Comprehensive project brief/docs/project-context/story-relationships.md - Story dependencies and implementation order (if applicable)/docs/project-context/versions/project-brief-v[N]-[timestamp].md - Versioned backup (if updating existing)/docs/project-context/versions/story-relationships-v[N]-[timestamp].md - Versioned relationships backup (if exists)/docs/stories/development/ directoryEach story MUST include:
Detailed Description
User Scenarios
Technical Requirements
Acceptance Criteria
Edge Cases & Error Handling
UI/UX Considerations (if applicable)
Testing Requirements
Integration Points
/docs/project-context/
├── project-brief.md # Main project brief (REQUIRED)
└── story-relationships.md # Story dependencies (OPTIONAL)
/docs/project-context/versions/
├── .gitkeep # Ensures directory is tracked
├── project-brief-v1-20250101-143000.md
├── project-brief-v2-20250115-091500.md
└── story-relationships-v1-20250101-143000.md
# Project Brief: [Project Title]
## Overview
[High-level project description]
## Objectives
- [Objective 1]
- [Objective 2]
## Stakeholders
- **Primary Users**: [description]
- **Business Stakeholders**: [description]
- **Technical Team**: [description]
## Core Features
1. [Feature 1]
2. [Feature 2]
## Story Breakdown
### STORY-XXX-001: [Story Title]
**Priority**: Core | **Effort**: M | **Status**: backlog
**Description**: [What this story accomplishes]
**User Scenarios**:
- [Scenario 1]
- [Scenario 2]
**Technical Requirements**:
- [Requirement 1]
- [Requirement 2]
**Acceptance Criteria**:
- [ ] [Criterion 1]
- [ ] [Criterion 2]
**Edge Cases**:
- [Edge case 1 and handling]
**Testing Requirements**:
- [Test scenario 1]
**Dependencies**: None
---
[Additional stories follow same format]
## Success Criteria
- [Success metric 1]
- [Success metric 2]
# Story Relationships
## Dependency Graph
STORY-XXX-001 (Core) └── STORY-XXX-002 (Core, depends on 001) ├── STORY-XXX-003 (Enhancement, depends on 002) └── STORY-XXX-004 (Enhancement, depends on 002)
STORY-XXX-005 (Core, independent) └── STORY-XXX-006 (Polish, depends on 005)
## Story Priority Matrix
| Story ID | Title | Priority | Dependencies | Effort | Status |
|----------|-------|----------|--------------|--------|--------|
| STORY-XXX-001 | Foundation Setup | Core | None | M | development |
| STORY-XXX-002 | Core Feature | Core | STORY-XXX-001 | L | backlog |
| STORY-XXX-003 | Enhancement A | Enhancement | STORY-XXX-002 | M | backlog |
## Implementation Order
**Phase 1 (Core - Week 1-2)**
- STORY-XXX-001: Foundation Setup
- STORY-XXX-005: Independent Core Feature
**Phase 2 (Core - Week 3-4)**
- STORY-XXX-002: Core Feature (after 001)
**Phase 3 (Enhancement - Week 5-6)**
- STORY-XXX-003: Enhancement A (after 002)
- STORY-XXX-004: Enhancement B (after 002)
**Phase 4 (Polish - Week 7)**
- STORY-XXX-006: Polish Feature (after 005)
/docs/stories/development//sdd:project-brief
→ Prompts for project title
→ Gathers requirements interactively
→ Creates /docs/project-context/project-brief.md
→ Creates /docs/project-context/story-relationships.md
Output:
✅ Project Brief Created
Project: E-commerce Checkout Flow
Stories Identified: 5
- Core Stories: 3
- Enhancement Stories: 2
/sdd:project-brief "Enhanced Checkout"
→ Finds existing /docs/project-context/project-brief.md
→ Creates backup: /docs/project-context/versions/project-brief-v1-20250101-143000.md
→ Loads existing objectives and stories
→ Builds upon existing content
→ Creates enhanced version
Output:
✅ Project Brief Updated
Previous version backed up to: /docs/project-context/versions/project-brief-v1-20250101-143000.md
New stories added: 3
Updated stories: 2
/sdd:project-brief "Mobile App Dashboard"
→ Uses provided title
→ Gathers requirements
→ Creates comprehensive brief
→ No version management needed (new project)
/sdd:project-init - Initialize development environment after brief creation/sdd:story-new - Create individual story from brief/sdd:story-qa - Quality assurance for completed stories