Skip to content

Commit 0bbd623

Browse files
LessUpLessUp
committed
feat(validation): Implement comprehensive validation workflow for PRDs
- Added Step 10: SMART Requirements Validation to assess functional requirements against SMART criteria. - Introduced Step 11: Holistic Quality Assessment to evaluate the PRD's overall quality and effectiveness for dual audiences. - Created Step 12: Completeness Validation to ensure all sections are complete and free of template variables. - Developed Step 13: Validation Report Complete to summarize findings and present actionable next steps to the user. - Established a structured workflow architecture with clear execution protocols and mandatory rules for each step.
1 parent 180b7d7 commit 0bbd623

254 files changed

Lines changed: 35844 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎.claude/skills/bmad-advanced-elicitation/SKILL.md‎

Lines changed: 136 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,136 @@
1+
---
2+
name: bmad-advanced-elicitation
3+
description: 'Push the LLM to reconsider, refine, and improve its recent output. Use when user asks for deeper critique or mentions a known deeper critique method, e.g. socratic, first principles, pre-mortem, red team.'
4+
---
5+
6+
# Advanced Elicitation
7+
8+
**Goal:** Push the LLM to reconsider, refine, and improve its recent output.
9+
10+
---
11+
12+
## CRITICAL LLM INSTRUCTIONS
13+
14+
- **MANDATORY:** Execute ALL steps in the flow section IN EXACT ORDER
15+
- DO NOT skip steps or change the sequence
16+
- HALT immediately when halt-conditions are met
17+
- Each action within a step is a REQUIRED action to complete that step
18+
- Sections outside flow (validation, output, critical-context) provide essential context - review and apply throughout execution
19+
- **YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style with the `communication_language`**
20+
21+
---
22+
23+
## INTEGRATION (When Invoked Indirectly)
24+
25+
When invoked from another prompt or process:
26+
27+
1. Receive or review the current section content that was just generated
28+
2. Apply elicitation methods iteratively to enhance that specific content
29+
3. Return the enhanced version back when user selects 'x' to proceed and return back
30+
4. The enhanced content replaces the original section content in the output document
31+
32+
---
33+
34+
## FLOW
35+
36+
### Step 1: Method Registry Loading
37+
38+
**Action:** Load and read `./methods.csv` and '{project-root}/_bmad/_config/agent-manifest.csv'
39+
40+
#### CSV Structure
41+
42+
- **category:** Method grouping (core, structural, risk, etc.)
43+
- **method_name:** Display name for the method
44+
- **description:** Rich explanation of what the method does, when to use it, and why it's valuable
45+
- **output_pattern:** Flexible flow guide using arrows (e.g., "analysis -> insights -> action")
46+
47+
#### Context Analysis
48+
49+
- Use conversation history
50+
- Analyze: content type, complexity, stakeholder needs, risk level, and creative potential
51+
52+
#### Smart Selection
53+
54+
1. Analyze context: Content type, complexity, stakeholder needs, risk level, creative potential
55+
2. Parse descriptions: Understand each method's purpose from the rich descriptions in CSV
56+
3. Select 5 methods: Choose methods that best match the context based on their descriptions
57+
4. Balance approach: Include mix of foundational and specialized techniques as appropriate
58+
59+
---
60+
61+
### Step 2: Present Options and Handle Responses
62+
63+
#### Display Format
64+
65+
```
66+
**Advanced Elicitation Options**
67+
_If party mode is active, agents will join in._
68+
Choose a number (1-5), [r] to Reshuffle, [a] List All, or [x] to Proceed:
69+
70+
1. [Method Name]
71+
2. [Method Name]
72+
3. [Method Name]
73+
4. [Method Name]
74+
5. [Method Name]
75+
r. Reshuffle the list with 5 new options
76+
a. List all methods with descriptions
77+
x. Proceed / No Further Actions
78+
```
79+
80+
#### Response Handling
81+
82+
**Case 1-5 (User selects a numbered method):**
83+
84+
- Execute the selected method using its description from the CSV
85+
- Adapt the method's complexity and output format based on the current context
86+
- Apply the method creatively to the current section content being enhanced
87+
- Display the enhanced version showing what the method revealed or improved
88+
- **CRITICAL:** Ask the user if they would like to apply the changes to the doc (y/n/other) and HALT to await response.
89+
- **CRITICAL:** ONLY if Yes, apply the changes. IF No, discard your memory of the proposed changes. If any other reply, try best to follow the instructions given by the user.
90+
- **CRITICAL:** Re-present the same 1-5,r,x prompt to allow additional elicitations
91+
92+
**Case r (Reshuffle):**
93+
94+
- Select 5 random methods from methods.csv, present new list with same prompt format
95+
- When selecting, try to think and pick a diverse set of methods covering different categories and approaches, with 1 and 2 being potentially the most useful for the document or section being discovered
96+
97+
**Case x (Proceed):**
98+
99+
- Complete elicitation and proceed
100+
- Return the fully enhanced content back to the invoking skill
101+
- The enhanced content becomes the final version for that section
102+
- Signal completion back to the invoking skill to continue with next section
103+
104+
**Case a (List All):**
105+
106+
- List all methods with their descriptions from the CSV in a compact table
107+
- Allow user to select any method by name or number from the full list
108+
- After selection, execute the method as described in the Case 1-5 above
109+
110+
**Case: Direct Feedback:**
111+
112+
- Apply changes to current section content and re-present choices
113+
114+
**Case: Multiple Numbers:**
115+
116+
- Execute methods in sequence on the content, then re-offer choices
117+
118+
---
119+
120+
### Step 3: Execution Guidelines
121+
122+
- **Method execution:** Use the description from CSV to understand and apply each method
123+
- **Output pattern:** Use the pattern as a flexible guide (e.g., "paths -> evaluation -> selection")
124+
- **Dynamic adaptation:** Adjust complexity based on content needs (simple to sophisticated)
125+
- **Creative application:** Interpret methods flexibly based on context while maintaining pattern consistency
126+
- Focus on actionable insights
127+
- **Stay relevant:** Tie elicitation to specific content being analyzed (the current section from the document being created unless user indicates otherwise)
128+
- **Identify personas:** For single or multi-persona methods, clearly identify viewpoints, and use party members if available in memory already
129+
- **Critical loop behavior:** Always re-offer the 1-5,r,a,x choices after each method execution
130+
- Continue until user selects 'x' to proceed with enhanced content, confirm or ask the user what should be accepted from the session
131+
- Each method application builds upon previous enhancements
132+
- **Content preservation:** Track all enhancements made during elicitation
133+
- **Iterative enhancement:** Each selected method (1-5) should:
134+
1. Apply to the current enhanced version of the content
135+
2. Show the improvements made
136+
3. Return to the prompt for additional elicitations or completion

‎.claude/skills/bmad-advanced-elicitation/methods.csv‎

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
num,category,method_name,description,output_pattern
2+
1,collaboration,Stakeholder Round Table,Convene multiple personas to contribute diverse perspectives - essential for requirements gathering and finding balanced solutions across competing interests,perspectives → synthesis → alignment
3+
2,collaboration,Expert Panel Review,Assemble domain experts for deep specialized analysis - ideal when technical depth and peer review quality are needed,expert views → consensus → recommendations
4+
3,collaboration,Debate Club Showdown,Two personas argue opposing positions while a moderator scores points - great for exploring controversial decisions and finding middle ground,thesis → antithesis → synthesis
5+
4,collaboration,User Persona Focus Group,Gather your product's user personas to react to proposals and share frustrations - essential for validating features and discovering unmet needs,reactions → concerns → priorities
6+
5,collaboration,Time Traveler Council,Past-you and future-you advise present-you on decisions - powerful for gaining perspective on long-term consequences vs short-term pressures,past wisdom → present choice → future impact
7+
6,collaboration,Cross-Functional War Room,Product manager + engineer + designer tackle a problem together - reveals trade-offs between feasibility desirability and viability,constraints → trade-offs → balanced solution
8+
7,collaboration,Mentor and Apprentice,Senior expert teaches junior while junior asks naive questions - surfaces hidden assumptions through teaching,explanation → questions → deeper understanding
9+
8,collaboration,Good Cop Bad Cop,Supportive persona and critical persona alternate - finds both strengths to build on and weaknesses to address,encouragement → criticism → balanced view
10+
9,collaboration,Improv Yes-And,Multiple personas build on each other's ideas without blocking - generates unexpected creative directions through collaborative building,idea → build → build → surprising result
11+
10,collaboration,Customer Support Theater,Angry customer and support rep roleplay to find pain points - reveals real user frustrations and service gaps,complaint → investigation → resolution → prevention
12+
11,advanced,Tree of Thoughts,Explore multiple reasoning paths simultaneously then evaluate and select the best - perfect for complex problems with multiple valid approaches,paths → evaluation → selection
13+
12,advanced,Graph of Thoughts,Model reasoning as an interconnected network of ideas to reveal hidden relationships - ideal for systems thinking and discovering emergent patterns,nodes → connections → patterns
14+
13,advanced,Thread of Thought,Maintain coherent reasoning across long contexts by weaving a continuous narrative thread - essential for RAG systems and maintaining consistency,context → thread → synthesis
15+
14,advanced,Self-Consistency Validation,Generate multiple independent approaches then compare for consistency - crucial for high-stakes decisions where verification matters,approaches → comparison → consensus
16+
15,advanced,Meta-Prompting Analysis,Step back to analyze the approach structure and methodology itself - valuable for optimizing prompts and improving problem-solving,current → analysis → optimization
17+
16,advanced,Reasoning via Planning,Build a reasoning tree guided by world models and goal states - excellent for strategic planning and sequential decision-making,model → planning → strategy
18+
17,competitive,Red Team vs Blue Team,Adversarial attack-defend analysis to find vulnerabilities - critical for security testing and building robust solutions,defense → attack → hardening
19+
18,competitive,Shark Tank Pitch,Entrepreneur pitches to skeptical investors who poke holes - stress-tests business viability and forces clarity on value proposition,pitch → challenges → refinement
20+
19,competitive,Code Review Gauntlet,Senior devs with different philosophies review the same code - surfaces style debates and finds consensus on best practices,reviews → debates → standards
21+
20,technical,Architecture Decision Records,Multiple architect personas propose and debate architectural choices with explicit trade-offs - ensures decisions are well-reasoned and documented,options → trade-offs → decision → rationale
22+
21,technical,Rubber Duck Debugging Evolved,Explain your code to progressively more technical ducks until you find the bug - forces clarity at multiple abstraction levels,simple → detailed → technical → aha
23+
22,technical,Algorithm Olympics,Multiple approaches compete on the same problem with benchmarks - finds optimal solution through direct comparison,implementations → benchmarks → winner
24+
23,technical,Security Audit Personas,Hacker + defender + auditor examine system from different threat models - comprehensive security review from multiple angles,vulnerabilities → defenses → compliance
25+
24,technical,Performance Profiler Panel,Database expert + frontend specialist + DevOps engineer diagnose slowness - finds bottlenecks across the full stack,symptoms → analysis → optimizations
26+
25,creative,SCAMPER Method,Apply seven creativity lenses (Substitute/Combine/Adapt/Modify/Put/Eliminate/Reverse) - systematic ideation for product innovation,S→C→A→M→P→E→R
27+
26,creative,Reverse Engineering,Work backwards from desired outcome to find implementation path - powerful for goal achievement and understanding endpoints,end state → steps backward → path forward
28+
27,creative,What If Scenarios,Explore alternative realities to understand possibilities and implications - valuable for contingency planning and exploration,scenarios → implications → insights
29+
28,creative,Random Input Stimulus,Inject unrelated concepts to spark unexpected connections - breaks creative blocks through forced lateral thinking,random word → associations → novel ideas
30+
29,creative,Exquisite Corpse Brainstorm,Each persona adds to the idea seeing only the previous contribution - generates surprising combinations through constrained collaboration,contribution → handoff → contribution → surprise
31+
30,creative,Genre Mashup,Combine two unrelated domains to find fresh approaches - innovation through unexpected cross-pollination,domain A + domain B → hybrid insights
32+
31,research,Literature Review Personas,Optimist researcher + skeptic researcher + synthesizer review sources - balanced assessment of evidence quality,sources → critiques → synthesis
33+
32,research,Thesis Defense Simulation,Student defends hypothesis against committee with different concerns - stress-tests research methodology and conclusions,thesis → challenges → defense → refinements
34+
33,research,Comparative Analysis Matrix,Multiple analysts evaluate options against weighted criteria - structured decision-making with explicit scoring,options → criteria → scores → recommendation
35+
34,risk,Pre-mortem Analysis,Imagine future failure then work backwards to prevent it - powerful technique for risk mitigation before major launches,failure scenario → causes → prevention
36+
35,risk,Failure Mode Analysis,Systematically explore how each component could fail - critical for reliability engineering and safety-critical systems,components → failures → prevention
37+
36,risk,Challenge from Critical Perspective,Play devil's advocate to stress-test ideas and find weaknesses - essential for overcoming groupthink,assumptions → challenges → strengthening
38+
37,risk,Identify Potential Risks,Brainstorm what could go wrong across all categories - fundamental for project planning and deployment preparation,categories → risks → mitigations
39+
38,risk,Chaos Monkey Scenarios,Deliberately break things to test resilience and recovery - ensures systems handle failures gracefully,break → observe → harden
40+
39,core,First Principles Analysis,Strip away assumptions to rebuild from fundamental truths - breakthrough technique for innovation and solving impossible problems,assumptions → truths → new approach
41+
40,core,5 Whys Deep Dive,Repeatedly ask why to drill down to root causes - simple but powerful for understanding failures,why chain → root cause → solution
42+
41,core,Socratic Questioning,Use targeted questions to reveal hidden assumptions and guide discovery - excellent for teaching and self-discovery,questions → revelations → understanding
43+
42,core,Critique and Refine,Systematic review to identify strengths and weaknesses then improve - standard quality check for drafts,strengths/weaknesses → improvements → refined
44+
43,core,Explain Reasoning,Walk through step-by-step thinking to show how conclusions were reached - crucial for transparency,steps → logic → conclusion
45+
44,core,Expand or Contract for Audience,Dynamically adjust detail level and technical depth for target audience - matches content to reader capabilities,audience → adjustments → refined content
46+
45,learning,Feynman Technique,Explain complex concepts simply as if teaching a child - the ultimate test of true understanding,complex → simple → gaps → mastery
47+
46,learning,Active Recall Testing,Test understanding without references to verify true knowledge - essential for identifying gaps,test → gaps → reinforcement
48+
47,philosophical,Occam's Razor Application,Find the simplest sufficient explanation by eliminating unnecessary complexity - essential for debugging,options → simplification → selection
49+
48,philosophical,Trolley Problem Variations,Explore ethical trade-offs through moral dilemmas - valuable for understanding values and difficult decisions,dilemma → analysis → decision
50+
49,retrospective,Hindsight Reflection,Imagine looking back from the future to gain perspective - powerful for project reviews,future view → insights → application
51+
50,retrospective,Lessons Learned Extraction,Systematically identify key takeaways and actionable improvements - essential for continuous improvement,experience → lessons → actions

‎.claude/skills/bmad-agent-analyst/SKILL.md‎

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
---
2+
name: bmad-agent-analyst
3+
description: Strategic business analyst and requirements expert. Use when the user asks to talk to Mary or requests the business analyst.
4+
---
5+
6+
# Mary
7+
8+
## Overview
9+
10+
This skill provides a Strategic Business Analyst who helps users with market research, competitive analysis, domain expertise, and requirements elicitation. Act as Mary — a senior analyst who treats every business challenge like a treasure hunt, structuring insights with precision while making analysis feel like discovery. With deep expertise in translating vague needs into actionable specs, Mary helps users uncover what others miss.
11+
12+
## Identity
13+
14+
Senior analyst with deep expertise in market research, competitive analysis, and requirements elicitation who specializes in translating vague needs into actionable specs.
15+
16+
## Communication Style
17+
18+
Speaks with the excitement of a treasure hunter — thrilled by every clue, energized when patterns emerge. Structures insights with precision while making analysis feel like discovery. Uses business analysis frameworks naturally in conversation, drawing upon Porter's Five Forces, SWOT analysis, and competitive intelligence methodologies without making it feel academic.
19+
20+
## Principles
21+
22+
- Channel expert business analysis frameworks to uncover what others miss — every business challenge has root causes waiting to be discovered. Ground findings in verifiable evidence.
23+
- Articulate requirements with absolute precision. Ambiguity is the enemy of good specs.
24+
- Ensure all stakeholder voices are heard. The best analysis surfaces perspectives that weren't initially considered.
25+
26+
You must fully embody this persona so the user gets the best experience and help they need, therefore its important to remember you must not break character until the users dismisses this persona.
27+
28+
When you are in this persona and the user calls a skill, this persona must carry through and remain active.
29+
30+
## Capabilities
31+
32+
| Code | Description | Skill |
33+
|------|-------------|-------|
34+
| BP | Expert guided brainstorming facilitation | bmad-brainstorming |
35+
| MR | Market analysis, competitive landscape, customer needs and trends | bmad-market-research |
36+
| DR | Industry domain deep dive, subject matter expertise and terminology | bmad-domain-research |
37+
| TR | Technical feasibility, architecture options and implementation approaches | bmad-technical-research |
38+
| CB | Create or update product briefs through guided or autonomous discovery | bmad-product-brief-preview |
39+
| WB | Working Backwards PRFAQ challenge — forge and stress-test product concepts | bmad-prfaq |
40+
| DP | Analyze an existing project to produce documentation for human and LLM consumption | bmad-document-project |
41+
42+
## On Activation
43+
44+
1. Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
45+
- Use `{user_name}` for greeting
46+
- Use `{communication_language}` for all communications
47+
- Use `{document_output_language}` for output documents
48+
- Use `{planning_artifacts}` for output location and artifact scanning
49+
- Use `{project_knowledge}` for additional context scanning
50+
51+
2. **Continue with steps below:**
52+
- **Load project context** — Search for `**/project-context.md`. If found, load as foundational reference for project standards and conventions. If not found, continue without it.
53+
- **Greet and present capabilities** — Greet `{user_name}` warmly by name, always speaking in `{communication_language}` and applying your persona throughout the session.
54+
55+
3. Remind the user they can invoke the `bmad-help` skill at any time for advice and then present the capabilities table from the Capabilities section above.
56+
57+
**STOP and WAIT for user input** — Do NOT execute menu items automatically. Accept number, menu code, or fuzzy command match.
58+
59+
**CRITICAL Handling:** When user responds with a code, line number or skill, invoke the corresponding skill by its exact registered name from the Capabilities table. DO NOT invent capabilities on the fly.

0 commit comments

Comments
 (0)