blueprint-prp-execute

/blueprint:prp-execute

Execute a PRP (Product Requirement Prompt) with systematic implementation, validation gates, TDD workflow, and quality assurance.

Usage: /blueprint:prp-execute [prp-name]

Prerequisites:

• PRP exists in docs/prps/[prp-name].md
• Confidence score >= 7 (if lower, suggest /blueprint:prp-create refinement)

For detailed report templates, deferred items workflow, feature tracker sync, and error handling patterns, see REFERENCE.md.

When to Use This Skill

Use this skill when...	Use alternative when...
Ready to implement a planned feature from a PRP	PRP is not yet ready (confidence < 7)
Want to execute with full validation and TDD workflow	Implementing ad-hoc features without documentation
Need feature tracker and GitHub issue tracking	Working on isolated bug fixes
Want automatic progress reporting and deferred items tracking	Quick prototyping without formal tracking

Context

• PRP file path: !find . -maxdepth 1 -name \'docs/prps/${1:-unknown}.md\'
• PRP confidence score: !grep -m1 "^confidence:" docs/prps/${1:-unknown}.md
• Feature tracker enabled: !find docs/blueprint -maxdepth 1 -name 'feature-tracker.json' -type f
• Current branch: !git rev-parse --abbrev-ref HEAD
• Uncommitted changes: !git status --porcelain

Parameters

Parse $ARGUMENTS:

• prp-name (required): Name of PRP file in docs/prps/ (without .md extension)
  • Example: feature-auth-oauth2 → loads docs/prps/feature-auth-oauth2.md

Execution

Execute the complete PRP implementation workflow:

Step 1: Load and validate PRP

1. Read PRP file: docs/prps/{prp-name}.md
2. Extract confidence score from frontmatter
3. If confidence < 7 → Error: "PRP confidence too low. Run /blueprint:prp-create {prp-name} to refine"
4. If confidence >= 9 → Offer delegation: "This PRP has high confidence. Execute now (current session) or create work-order for delegation?"
   • If work-order chosen → Run /blueprint:work-order --from-prp {prp-name} and exit
   • If delegation to multiple subagents chosen → Create focused work-orders per module from Implementation Blueprint and exit
5. Continue to Step 2 if executing now OR confidence 7-8
6. Load all referenced ai_docs entries for context
7. Parse Implementation Blueprint and create TodoWrite entries ordered by dependencies

Step 2: Establish baseline with validation gates

Run pre-implementation validation gates (see REFERENCE.md) to establish clean starting state:

1. Linting gate: [command from PRP] - Expected: PASS
2. Existing tests gate: [command from PRP] - Expected: PASS

If gates fail:

• Document existing issues
• Decide: fix first or proceed with note
• Continue when ready

Step 3: Execute TDD implementation cycle

For each task in Implementation Blueprint:

1. RED phase: Write failing test matching PRP TDD Requirements

   • Create test file if needed
   • Run tests → Confirm FAILURE (test is meaningful)

2. GREEN phase: Implement minimal code to pass test

   • Follow Codebase Intelligence patterns from PRP
   • Apply patterns from ai_docs references
   • Watch for Known Gotchas
   • Run tests → Confirm SUCCESS

3. REFACTOR phase: Improve code while keeping tests green

   • Extract common patterns
   • Improve naming, add type hints
   • Follow project conventions
   • Run tests → Confirm PASS
   • Run validation gates frequently (not just at end)

4. Mark progress: Update TodoWrite: ✅ Task N: [Description]

Step 4: Run comprehensive final validation

Execute all validation gates from PRP (see REFERENCE.md):

• Linting: [cmd] - Expected: PASS
• Type checking: [cmd] - Expected: PASS
• Unit tests: [cmd] - Expected: PASS (all tests)
• Integration tests: [cmd] - Expected: PASS (if applicable)
• Coverage check: [cmd] - Expected: Meets threshold
• Security scan: [cmd] - Expected: No high/critical issues (if applicable)
• Performance tests: [cmd] - Expected: Meets baseline (if defined)

Verify each success criterion from PRP.

Step 5: Document deferred items

Identify and track any deferred work:

1. Review Implementation Blueprint - items not completed
2. Categorize each deferred item:
   • Phase 2 (Required): Must have GitHub issues created
   • Nice-to-Have: Optional, no issue required
   • Blocked: Cannot complete - document blocker, create issue
3. Create GitHub issues for all Phase 2 and Blocked items (see REFERENCE.md)
4. Update PRP with deferred items section linking to GitHub issues
5. Do NOT proceed to Step 6 until all required issues are created

Step 6: Sync feature tracker (if enabled)

If feature tracker exists (docs/blueprint/feature-tracker.json):

1. Identify which feature codes (e.g., FR2.1) were addressed from PRP
2. Update feature tracker for each code:
   • Status: complete (all criteria met) or partial (some criteria met) or in_progress
   • Files: List of modified/created files
   • Tests: List of test files
   • Commits: Commit hashes
   • Notes: Implementation notes
3. Recalculate statistics: completion percentages, phase status
4. Update TODO.md: Check boxes for completed features
5. Report feature tracker changes

Step 7: Report results and next steps

Generate comprehensive execution summary report:

• Tasks completed: X/Y
• Tests added: N
• Files modified: [list]
• Validation results: Table of all gates (PASS/FAIL status)
• Success criteria: All verified
• Deferred items summary: Count and GitHub issue numbers
• Feature tracker updates: Features updated and percentages
• New gotchas discovered: [documented for future reference]
• Recommendations: Follow-up work or ai_docs updates

Prompt user for next action:

• Commit changes (Recommended) → Run /git:commit
• Create work-order for follow-up → Run /blueprint:work-order
• Update ai_docs with patterns → Run /blueprint:curate-docs
• Continue to next PRP → Run /blueprint:prp-execute [next]
• Done for now → Exit

Agentic Optimizations

Context	Command
Check PRP exists	test -f docs/prps/${1}.md && echo "EXISTS" || echo "MISSING"
Extract confidence	head -50 docs/prps/${1}.md | grep -m1 "^confidence:" | sed 's/^[^:]*:[[:space:]]*//'
List all PRPs	ls docs/prps/*.md 2>/dev/null | xargs basename -s .md
Check feature tracker	test -f docs/blueprint/feature-tracker.json && echo "YES" || echo "NO"
Fast validation	Run validation gates in parallel when possible

---

For detailed validation gate definitions, deferred items workflow, error handling procedures, and agent team coordination, see REFERENCE.md.