fix(skills): address re-validation findings in edit-prd, validate-prd, brainstorming

- STEP-06: Remove name/description from step frontmatter in edit-prd (5 files)
  and validate-prd (14 files) — these belong only in SKILL.md
- REF-02: Fix brainstorming step-02a/b/c/d CSV parse instructions to match
  actual brain-methods.csv columns (3 cols, not 7)
- SEQ-02: Remove time estimates from brainstorming step-02a/b/c/d and step-03,
  replace time-based thresholds with idea-count criteria

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
Alex Verkhovsky 2026-03-15 10:53:47 -06:00
parent 098c96740c
commit a2f4bfea8f
24 changed files with 20 additions and 92 deletions

View File

@ -1,7 +1,4 @@
---
name: 'step-e-01-discovery'
description: 'Discovery & Understanding - Understand what user wants to edit and detect PRD format'
# File references (ONLY variables used in this step)
prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'
---

View File

@ -1,7 +1,4 @@
---
name: 'step-e-01b-legacy-conversion'
description: 'Legacy PRD Conversion Assessment - Analyze legacy PRD and propose conversion strategy'
# File references (ONLY variables used in this step)
prdFile: '{prd_file_path}'
prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'

View File

@ -1,7 +1,4 @@
---
name: 'step-e-02-review'
description: 'Deep Review & Analysis - Thoroughly review existing PRD and prepare detailed change plan'
# File references (ONLY variables used in this step)
prdFile: '{prd_file_path}'
validationReport: '{validation_report_path}' # If provided

View File

@ -1,7 +1,4 @@
---
name: 'step-e-03-edit'
description: 'Edit & Update - Apply changes to PRD following approved change plan'
# File references (ONLY variables used in this step)
prdFile: '{prd_file_path}'
prdPurpose: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/data/prd-purpose.md'

View File

@ -1,7 +1,4 @@
---
name: 'step-e-04-complete'
description: 'Complete & Validate - Present options for next steps including full validation'
# File references (ONLY variables used in this step)
prdFile: '{prd_file_path}'
validationWorkflow: '{project-root}/_bmad/bmm/workflows/2-plan-workflows/create-prd/steps-v/step-v-01-discovery.md'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-01-discovery'
description: 'Document Discovery & Confirmation - Handle fresh context validation, confirm PRD path, discover input documents'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-02-format-detection.md'
prdPurpose: '../data/prd-purpose.md'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-02-format-detection'
description: 'Format Detection & Structure Analysis - Classify PRD format and route appropriately'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-03-density-validation.md'
altStepFile: './step-v-02b-parity-check.md'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-02b-parity-check'
description: 'Document Parity Check - Analyze non-standard PRD and identify gaps to achieve BMAD PRD parity'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-03-density-validation.md'
prdFile: '{prd_file_path}'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-03-density-validation'
description: 'Information Density Check - Scan for anti-patterns that violate information density principles'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-04-brief-coverage-validation.md'
prdFile: '{prd_file_path}'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-04-brief-coverage-validation'
description: 'Product Brief Coverage Check - Validate PRD covers all content from Product Brief (if used as input)'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-05-measurability-validation.md'
prdFile: '{prd_file_path}'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-05-measurability-validation'
description: 'Measurability Validation - Validate that all requirements (FRs and NFRs) are measurable and testable'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-06-traceability-validation.md'
prdFile: '{prd_file_path}'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-06-traceability-validation'
description: 'Traceability Validation - Validate the traceability chain from vision → success → journeys → FRs is intact'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-07-implementation-leakage-validation.md'
prdFile: '{prd_file_path}'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-07-implementation-leakage-validation'
description: 'Implementation Leakage Check - Ensure FRs and NFRs don\'t include implementation details'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-08-domain-compliance-validation.md'
prdFile: '{prd_file_path}'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-08-domain-compliance-validation'
description: 'Domain Compliance Validation - Validate domain-specific requirements are present for high-complexity domains'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-09-project-type-validation.md'
prdFile: '{prd_file_path}'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-09-project-type-validation'
description: 'Project-Type Compliance Validation - Validate project-type specific requirements are properly documented'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-10-smart-validation.md'
prdFile: '{prd_file_path}'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-10-smart-validation'
description: 'SMART Requirements Validation - Validate Functional Requirements meet SMART quality criteria'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-11-holistic-quality-validation.md'
prdFile: '{prd_file_path}'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-11-holistic-quality-validation'
description: 'Holistic Quality Assessment - Assess PRD as cohesive, compelling document - is it a good PRD?'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-12-completeness-validation.md'
prdFile: '{prd_file_path}'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-12-completeness-validation'
description: 'Completeness Check - Final comprehensive completeness check before report generation'
# File references (ONLY variables used in this step)
nextStepFile: './step-v-13-report-complete.md'
prdFile: '{prd_file_path}'

View File

@ -1,7 +1,4 @@
---
name: 'step-v-13-report-complete'
description: 'Validation Report Complete - Finalize report, summarize findings, present to user, offer next steps'
# File references (ONLY variables used in this step)
validationReportPath: '{validation_report_path}'
prdFile: '{prd_file_path}'

View File

@ -41,7 +41,7 @@ Load techniques from CSV on-demand:
**Load CSV and parse:**
- Read `../brain-methods.csv`
- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration
- Parse: category, technique_name, description
- Organize by categories for browsing
### 2. Present Technique Categories
@ -100,19 +100,19 @@ After user selects category:
**Present 3-5 techniques from selected category:**
For each technique:
- **Technique Name** (Duration: [time], Energy: [level])
- **Technique Name**
- Description: [Brief clear description]
- Best for: [What this technique excels at]
- Example prompt: [Sample facilitation prompt]
**Example presentation format:**
"**1. SCAMPER Method** (Duration: 20-30 min, Energy: Moderate)
"**1. SCAMPER Method**
- Systematic creativity through seven lenses (Substitute/Combine/Adapt/Modify/Put/Eliminate/Reverse)
- Best for: Product improvement, innovation challenges, systematic idea generation
- Example prompt: "What could you substitute in your current approach to create something new?"
**2. Six Thinking Hats** (Duration: 15-25 min, Energy: Moderate)
**2. Six Thinking Hats**
- Explore problems through six distinct perspectives for comprehensive analysis
- Best for: Complex decisions, team alignment, thorough exploration
@ -148,7 +148,7 @@ When user selects techniques:
- [Technique 3]: [If selected, how it builds on others]
**Session Plan:**
This combination will take approximately [total_time] and focus on [expected outcomes].
This combination will focus on [expected outcomes].
**Confirm these choices?**
[C] Continue - Begin technique execution

View File

@ -48,7 +48,7 @@ Load techniques from CSV for analysis:
**Load CSV and parse:**
- Read `../brain-methods.csv`
- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration
- Parse: category, technique_name, description
### 2. Context Analysis for Technique Matching
@ -76,12 +76,6 @@ Analyze user's session context across multiple dimensions:
- User language playful → creative, theatrical, wild techniques
- User language reflective → introspective_delight, deep techniques
**4. Time Available:**
- <30 min 1-2 focused techniques
- 30-60 min → 2-3 complementary techniques
- > 60 min → Multi-phase technique flow
### 3. Generate Technique Recommendations
Based on context analysis, create tailored recommendations:
@ -91,24 +85,20 @@ Based on context analysis, create tailored recommendations:
Based on your session context, I recommend this customized technique sequence:
**Phase 1: Foundation Setting**
**[Technique Name]** from [Category] (Duration: [time], Energy: [level])
**[Technique Name]** from [Category]
- **Why this fits:** [Specific connection to user's goals/context]
- **Expected outcome:** [What this will accomplish for their session]
**Phase 2: Idea Generation**
**[Technique Name]** from [Category] (Duration: [time], Energy: [level])
**[Technique Name]** from [Category]
- **Why this builds on Phase 1:** [Complementary effect explanation]
- **Expected outcome:** [How this develops the foundation]
**Phase 3: Refinement & Action** (If time allows)
**[Technique Name]** from [Category] (Duration: [time], Energy: [level])
**[Technique Name]** from [Category]
- **Why this concludes effectively:** [Final phase rationale]
- **Expected outcome:** [How this leads to actionable results]
**Total Estimated Time:** [Sum of durations]
**Session Focus:** [Primary benefit and outcome description]"
### 4. Present Recommendation Details

View File

@ -48,7 +48,7 @@ Create anticipation for serendipitous technique discovery:
**Load CSV and parse:**
- Read `../brain-methods.csv`
- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration
- Parse: category, technique_name, description
- Prepare for intelligent random selection
### 2. Intelligent Random Selection
@ -74,27 +74,23 @@ Reveal the randomly selected techniques with enthusiasm:
"**🎲 Your Randomly Selected Creative Techniques! 🎲**
**Phase 1: Exploration**
**[Random Technique 1]** from [Category] (Duration: [time], Energy: [level])
**[Random Technique 1]** from [Category]
- **Description:** [Technique description]
- **Why this is exciting:** [What makes this technique surprising or powerful]
- **Random discovery bonus:** [Unexpected insight about this technique]
**Phase 2: Connection**
**[Random Technique 2]** from [Category] (Duration: [time], Energy: [level])
**[Random Technique 2]** from [Category]
- **Description:** [Technique description]
- **Why this complements the first:** [How these techniques might work together]
- **Random discovery bonus:** [Unexpected insight about this combination]
**Phase 3: Synthesis**
**[Random Technique 3]** from [Category] (Duration: [time], Energy: [level])
**[Random Technique 3]** from [Category]
- **Description:** [Technique description]
- **Why this completes the journey:** [How this ties the sequence together]
- **Random discovery bonus:** [Unexpected insight about the overall flow]
**Total Random Session Time:** [Combined duration]
**Serendipity Factor:** [Enthusiastic description of creative potential]"
### 4. Highlight the Creative Potential

View File

@ -67,7 +67,7 @@ Explain the value of systematic creative progression:
**Load CSV and parse:**
- Read `../brain-methods.csv`
- Parse: category, technique_name, description, facilitation_prompts, best_for, energy_level, typical_duration
- Parse: category, technique_name, description
- Map techniques to each phase of the creative journey
### 2. Design Phase-Specific Technique Selection
@ -128,10 +128,9 @@ Show the full progressive flow with timing and transitions:
"**Your Complete Creative Journey Map:**
**⏰ Total Journey Time:** [Combined duration]
**🎯 Session Focus:** Systematic development from ideas to action
**Phase 1: Expansive Exploration** ([duration])
**Phase 1: Expansive Exploration**
- **Technique:** [Selected technique]
- **Goal:** Generate [number]+ diverse ideas without limits
@ -139,7 +138,7 @@ Show the full progressive flow with timing and transitions:
**→ Phase Transition:** We'll review and cluster ideas before moving deeper
**Phase 2: Pattern Recognition** ([duration])
**Phase 2: Pattern Recognition**
- **Technique:** [Selected technique]
- **Goal:** Identify themes and prioritize most promising directions
@ -147,7 +146,7 @@ Show the full progressive flow with timing and transitions:
**→ Phase Transition:** Select top concepts for detailed development
**Phase 3: Idea Development** ([duration])
**Phase 3: Idea Development**
- **Technique:** [Selected technique]
- **Goal:** Refine priority ideas with depth and practicality
@ -155,7 +154,7 @@ Show the full progressive flow with timing and transitions:
**→ Phase Transition:** Choose final concepts for implementation planning
**Phase 4: Action Planning** ([duration])
**Phase 4: Action Planning**
- **Technique:** [Selected technique]
- **Goal:** Create concrete implementation plans and next steps

View File

@ -12,7 +12,7 @@
- 🧠 **THOUGHT BEFORE INK (CoT):** Before generating each idea, you must internally reason: "What domain haven't we explored yet? What would make this idea surprising or 'uncomfortable' for the user?"
- 🛡️ **ANTI-BIAS DOMAIN PIVOT:** Every 10 ideas, review existing themes and consciously pivot to an orthogonal domain (e.g., UX -> Business -> Physics -> Social Impact).
- 🌡️ **SIMULATED TEMPERATURE:** Act as if your creativity is set to 0.85 - take wilder leaps and suggest "provocative" concepts.
- ⏱️ Spend minimum 30-45 minutes in active ideation before offering to conclude
- ⏱️ Generate at least 100 ideas in active ideation before offering to conclude
- 🎯 EXECUTE ONE TECHNIQUE ELEMENT AT A TIME with interactive exploration
- 📋 RESPOND DYNAMICALLY to user insights and build upon their ideas
- 🔍 ADAPT FACILITATION based on user engagement and emerging directions
@ -176,7 +176,7 @@ Remember: The goal is quantity first - we can organize later. What feels right?"
**IMPORTANT:** Default to continuing exploration. Only suggest organization if:
- User has explicitly asked to wrap up, OR
- You've been exploring for 45+ minutes AND generated 100+ ideas, OR
- You've generated 100+ ideas, OR
- User's energy is clearly depleted (short responses, "I don't know", etc.)
### 4a. Handle Immediate Technique Transition