Skip to content

Commit c8d20ff

Browse files
committed
feat: Merge PRD-008 - Version Reset & Workflow Overhaul v0.3.0
Complete implementation of PRD-008: ## Phase 1: Core Workflow Fixes - Simplified folder structure (02-review removed) - Updated 9 commands with new folder references - Auto-assignment in /setup-prd - Progress tracking in /code-prd - Metadata-only updates in /review-prd ## Phase 2: New Features - /create-prd-env command (environment initialization) - Feature type auto-detection - Enhanced dependencies tracking ## Documentation - VERSION_RESET.md (v2.8 → v0.3 rationale) - MIGRATION_v2_to_v0.md (migration guide) - CHANGELOG.md updated - README.md updated Breaking Changes: - Folder structure changed - Workflow separation (/setup-prd vs /code-prd) - Review no longer moves files See CHANGELOG.md for complete details. Closes PRD-008
2 parents 6db8a86 + 7cc5c3b commit c8d20ff

19 files changed

+1281
-127
lines changed

.claude-plugin/marketplace.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@
1616
{
1717
"name": "claude-prd-workflow",
1818
"displayName": "PRD Workflow Manager",
19-
"version": "2.8.0",
19+
"version": "0.3.0",
2020
"description": "Complete PRD lifecycle management with orchestration, security, quality assurance, and guided development. Includes Git worktree support for parallel development.",
2121
"source": {
2222
"source": "github",

.claude-plugin/plugin.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "claude-prd-workflow",
3-
"version": "2.8.0",
3+
"version": "0.3.0",
44
"displayName": "PRD Workflow Manager",
55
"description": "Complete PRD lifecycle management with orchestration, security, quality assurance, and guided development. Includes Git worktree support for parallel development.",
66
"author": {

.claude/commands/archive-prd.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Keep PRD directories clean while preserving historical context:
2121
### Step 1: List Archivable PRDs
2222

2323
Show PRDs from:
24-
- `05-complete/` - Completed and merged
24+
- `04-complete/` - Completed and merged
2525
- Any directory if user wants to cancel/deprecate
2626

2727
```markdown
@@ -91,7 +91,7 @@ Add archive metadata to PRD:
9191

9292
Move file:
9393
```bash
94-
mv product/prds/05-complete/250915-project-setup-v1.md \
94+
mv product/prds/04-complete/250915-project-setup-v1.md \
9595
product/prds/99-archived/250915-project-setup-v1.md
9696
```
9797

@@ -114,7 +114,7 @@ Add to archive log (if exists):
114114
```markdown
115115
**PRD Archived: PRD-005 - Database Schema**
116116

117-
**From**: product/prds/05-complete/
117+
**From**: product/prds/04-complete/
118118
**To**: product/prds/99-archived/
119119
**Reason**: Completed and shipped
120120

.claude/commands/code-prd.md

Lines changed: 90 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ git branch --show-current
3333

3434
**Method B**: Ask user if detection fails
3535

36-
Find corresponding PRD file in `product/prds/04-in-progress/`
36+
Find corresponding PRD file in `product/prds/03-in-progress/`
3737

3838
#### Step 2: Load PRD Content
3939

@@ -43,7 +43,95 @@ Read and parse:
4343
- Dependencies and constraints
4444
- Success metrics
4545

46-
#### Step 3: Check for Existing Progress & Auto-Recovery
46+
#### Step 3: Verify PRD is in Ready State
47+
48+
**NEW: Enforce Ready-First Workflow**
49+
50+
```bash
51+
# Check if PRD exists in 02-ready/
52+
if [ ! -f "product/prds/02-ready/PRD-${ID}*.md" ]; then
53+
echo "❌ PRD-${ID} is not in Ready state"
54+
echo ""
55+
echo "Current location:"
56+
find product/prds/ -name "PRD-${ID}*.md" -type f
57+
echo ""
58+
echo "❓ Did you run /setup-prd PRD-${ID} first?"
59+
echo ""
60+
echo "📖 Workflow:"
61+
echo " 1. /setup-prd PRD-${ID} → Moves to Ready + creates branch"
62+
echo " 2. /code-prd PRD-${ID} → Starts implementation"
63+
exit 1
64+
fi
65+
```
66+
67+
#### Step 4: Check Dependencies
68+
69+
**NEW: Dependency Validation**
70+
71+
Parse PRD metadata for dependencies:
72+
```yaml
73+
depends_on:
74+
- PRD-003: Database schema
75+
- PRD-005: Auth system
76+
```
77+
78+
Check each dependency status:
79+
```bash
80+
for dep in "${DEPS[@]}"; do
81+
DEP_ID=$(echo "$dep" | cut -d: -f1)
82+
83+
# Check if dependency is complete
84+
if [ -f "product/prds/04-complete/$DEP_ID*.md" ]; then
85+
echo "✅ $dep is complete"
86+
else
87+
echo "⚠️ WARNING: $dep is NOT complete"
88+
BLOCKERS+=("$dep")
89+
fi
90+
done
91+
```
92+
93+
If blockers found:
94+
```markdown
95+
⚠️ **Dependency Blockers Detected**
96+
97+
This PRD depends on:
98+
❌ PRD-003: Database schema (Status: In Progress)
99+
❌ PRD-005: Auth system (Status: Draft)
100+
101+
**Recommendation**: Wait for dependencies to complete first.
102+
103+
Continue anyway? (not recommended) (y/n)
104+
> _
105+
```
106+
107+
#### Step 5: Move PRD to In-Progress (First Run Only)
108+
109+
**NEW: Auto-Move on First Run**
110+
111+
Only move if this is the first time /code-prd is run:
112+
```bash
113+
# Check if PRD is still in Ready
114+
if [ -f "product/prds/02-ready/PRD-${ID}*.md" ]; then
115+
echo "📦 Moving PRD to In-Progress..."
116+
117+
mv product/prds/02-ready/PRD-${ID}*.md \
118+
product/prds/03-in-progress/PRD-${ID}*.md
119+
120+
# Update metadata
121+
sed -i 's/Status: Ready for Development/Status: In Progress/' \
122+
product/prds/03-in-progress/PRD-${ID}*.md
123+
124+
sed -i "/\*\*Status\*\*/a **Started**: $(date +%Y-%m-%d)" \
125+
product/prds/03-in-progress/PRD-${ID}*.md
126+
127+
echo "✅ PRD moved to 03-in-progress/"
128+
else
129+
echo "ℹ️ PRD already in In-Progress, resuming..."
130+
fi
131+
```
132+
133+
134+
#### Step 6: Check for Existing Progress & Auto-Recovery
47135

48136
**NEW: Automatic Progress Checkpoints**
49137

.claude/commands/complete-prd.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ Mark a PRD as complete after its PR has been merged and deployed to production.
1313
Close the PRD lifecycle loop:
1414
- Verify PR is merged
1515
- Update PRD status to "Complete"
16-
- Move PRD to `05-complete/` directory
16+
- Move PRD to `04-complete/` directory
1717
- Clean up Git worktree (optional)
1818
- Update WORK_PLAN.md
1919
- Record completion metrics
@@ -255,9 +255,9 @@ Add completion metadata to PRD header:
255255
PRD_FILE="product/prds/03-in-progress/250915-oauth2-integration-v1.md"
256256

257257
# Move to complete
258-
mv "$PRD_FILE" "product/prds/05-complete/250915-oauth2-integration-v1.md"
258+
mv "$PRD_FILE" "product/prds/04-complete/250915-oauth2-integration-v1.md"
259259

260-
echo "✅ Moved PRD to 05-complete/"
260+
echo "✅ Moved PRD to 04-complete/"
261261
```
262262

263263
### Step 6: Clean Up Git Worktree (Optional)
@@ -349,7 +349,7 @@ Show final summary:
349349
- Security: All checks passed ✅
350350

351351
🧹 **Cleanup**:
352-
- ✅ PRD moved to 05-complete/
352+
- ✅ PRD moved to 04-complete/
353353
- ✅ Worktree removed
354354
- ✅ Branches deleted
355355
- ✅ WORK_PLAN.md updated
@@ -429,7 +429,7 @@ If no PR was needed (hotfix, etc.):
429429

430430
**PRD already complete**:
431431
```
432-
ℹ️ PRD-003 is already in 05-complete/
432+
ℹ️ PRD-003 is already in 04-complete/
433433
434434
Completed: 2025-10-25
435435
PR: #42

0 commit comments

Comments
 (0)