Compare commits
3 Commits
523f54ccd8
...
02e6a9fe8f
| Author | SHA1 | Date |
|---|---|---|
|
|
02e6a9fe8f | |
|
|
35c7ec55d1 | |
|
|
7746b8f066 |
|
|
@ -117,7 +117,8 @@ Try to discover the following:
|
|||
#### C. Present Initialization Results
|
||||
|
||||
**Setup Report to User:**
|
||||
"Welcome {{user_name}}! I've set up your product brief workspace for {{project_name}}.
|
||||
<display>
|
||||
Welcome {{user_name}}! I've set up your product brief workspace for {{project_name}}.
|
||||
|
||||
**Document Setup:**
|
||||
|
||||
|
|
@ -133,11 +134,14 @@ Try to discover the following:
|
|||
|
||||
**Files loaded:** {list of specific file names or "No additional documents found"}
|
||||
|
||||
Do you have any other documents you'd like me to include, or shall we continue to the next step?"
|
||||
Do you have any other documents you'd like me to include, or shall we continue to the next step?
|
||||
</display>
|
||||
|
||||
### 4. Present MENU OPTIONS
|
||||
|
||||
Display: "**Proceeding to product vision discovery...**"
|
||||
<display>
|
||||
**Proceeding to product vision discovery...**
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
|
||||
|
|
|
|||
|
|
@ -75,7 +75,8 @@ Review the frontmatter to understand:
|
|||
### 3. Present Current Progress
|
||||
|
||||
**Progress Report to User:**
|
||||
"Welcome back {{user_name}}! I'm resuming our product brief collaboration for {{project_name}}.
|
||||
<display>
|
||||
Welcome back {{user_name}}! I'm resuming our product brief collaboration for {{project_name}}.
|
||||
|
||||
**Current Progress:**
|
||||
|
||||
|
|
@ -88,7 +89,8 @@ Review the frontmatter to understand:
|
|||
- Current product brief is ready with all completed sections
|
||||
- Ready to continue from where we left off
|
||||
|
||||
Does this look right, or do you want to make any adjustments before we proceed?"
|
||||
Does this look right, or do you want to make any adjustments before we proceed?
|
||||
</display>
|
||||
|
||||
### 4. Determine Continuation Path
|
||||
|
||||
|
|
@ -104,7 +106,8 @@ Based on `lastStep` value, determine which step to load next:
|
|||
### 5. Handle Workflow Completion
|
||||
|
||||
**If workflow already complete (`lastStep = 6`):**
|
||||
"Great news! It looks like we've already completed the product brief workflow for {{project_name}}.
|
||||
<display>
|
||||
Great news! It looks like we've already completed the product brief workflow for {{project_name}}.
|
||||
|
||||
The final document is ready at `{outputFile}` with all sections completed through step 6.
|
||||
|
||||
|
|
@ -114,14 +117,17 @@ Would you like me to:
|
|||
- Suggest next workflow steps (like PRD creation)
|
||||
- Start a new product brief revision
|
||||
|
||||
What would be most helpful?"
|
||||
What would be most helpful?
|
||||
</display>
|
||||
|
||||
### 6. Present MENU OPTIONS
|
||||
|
||||
**If workflow not complete:**
|
||||
Display: "Ready to continue with Step {nextStepNumber}: {nextStepTitle}?
|
||||
<display>
|
||||
Ready to continue with Step {nextStepNumber}: {nextStepTitle}?
|
||||
|
||||
**Select an Option:** [C] Continue to Step {nextStepNumber}"
|
||||
**Select an Option:** [C] Continue to Step {nextStepNumber}
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
|
||||
|
|
|
|||
|
|
@ -61,7 +61,8 @@ Conduct comprehensive product vision discovery to define the core problem, solut
|
|||
### 1. Begin Vision Discovery
|
||||
|
||||
**Opening Conversation:**
|
||||
"As your PM peer, I'm excited to help you shape the vision for {{project_name}}. Let's start with the foundation.
|
||||
<display>
|
||||
As your PM peer, I'm excited to help you shape the vision for {{project_name}}. Let's start with the foundation.
|
||||
|
||||
**Tell me about the product you envision:**
|
||||
|
||||
|
|
@ -70,7 +71,8 @@ Conduct comprehensive product vision discovery to define the core problem, solut
|
|||
- What would success look like for the people you're helping?
|
||||
- What excites you most about this solution?
|
||||
|
||||
Let's start with the problem space before we get into solutions."
|
||||
Let's start with the problem space before we get into solutions.
|
||||
</display>
|
||||
|
||||
### 2. Deep Problem Understanding
|
||||
|
||||
|
|
@ -147,12 +149,14 @@ Prepare the following structure for document append:
|
|||
### 7. Present MENU OPTIONS
|
||||
|
||||
**Content Presentation:**
|
||||
"I've drafted the executive summary and core vision based on our conversation. This captures the essence of {{project_name}} and what makes it special.
|
||||
<display>
|
||||
I've drafted the executive summary and core vision based on our conversation. This captures the essence of {{project_name}} and what makes it special.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
[Show the complete markdown content from step 6]
|
||||
|
||||
**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue"
|
||||
**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
|
||||
|
|
|
|||
|
|
@ -61,7 +61,8 @@ Define target users with rich personas and map their key interactions with the p
|
|||
### 1. Begin User Discovery
|
||||
|
||||
**Opening Exploration:**
|
||||
"Now that we understand what {{project_name}} does, let's define who it's for.
|
||||
<display>
|
||||
Now that we understand what {{project_name}} does, let's define who it's for.
|
||||
|
||||
**User Discovery:**
|
||||
|
||||
|
|
@ -70,7 +71,8 @@ Define target users with rich personas and map their key interactions with the p
|
|||
- Who gets the most value from this solution?
|
||||
- Are there primary users and secondary users we should consider?
|
||||
|
||||
Let's start by identifying the main user groups."
|
||||
Let's start by identifying the main user groups.
|
||||
</display>
|
||||
|
||||
### 2. Primary User Segment Development
|
||||
|
||||
|
|
@ -150,12 +152,14 @@ Prepare the following structure for document append:
|
|||
### 6. Present MENU OPTIONS
|
||||
|
||||
**Content Presentation:**
|
||||
"I've mapped out who {{project_name}} serves and how they'll interact with it. This helps us ensure we're building something that real people will love to use.
|
||||
<display>
|
||||
I've mapped out who {{project_name}} serves and how they'll interact with it. This helps us ensure we're building something that real people will love to use.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
[Show the complete markdown content from step 5]
|
||||
|
||||
**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue"
|
||||
**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
|
||||
|
|
|
|||
|
|
@ -61,7 +61,8 @@ Define comprehensive success metrics that include user success, business objecti
|
|||
### 1. Begin Success Metrics Discovery
|
||||
|
||||
**Opening Exploration:**
|
||||
"Now that we know who {{project_name}} serves and what problem it solves, let's define what success looks like.
|
||||
<display>
|
||||
Now that we know who {{project_name}} serves and what problem it solves, let's define what success looks like.
|
||||
|
||||
**Success Discovery:**
|
||||
|
||||
|
|
@ -69,7 +70,8 @@ Define comprehensive success metrics that include user success, business objecti
|
|||
- What would make users say 'this was worth it'?
|
||||
- What metrics show we're creating real value?
|
||||
|
||||
Let's start with the user perspective."
|
||||
Let's start with the user perspective.
|
||||
</display>
|
||||
|
||||
### 2. User Success Metrics
|
||||
|
||||
|
|
@ -153,12 +155,14 @@ Prepare the following structure for document append:
|
|||
### 7. Present MENU OPTIONS
|
||||
|
||||
**Content Presentation:**
|
||||
"I've defined success metrics that will help us track whether {{project_name}} is creating real value for users and achieving business objectives.
|
||||
<display>
|
||||
I've defined success metrics that will help us track whether {{project_name}} is creating real value for users and achieving business objectives.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
[Show the complete markdown content from step 6]
|
||||
|
||||
**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue"
|
||||
**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
|
||||
|
|
|
|||
|
|
@ -61,7 +61,8 @@ Define MVP scope with clear boundaries and outline future vision through collabo
|
|||
### 1. Begin Scope Definition
|
||||
|
||||
**Opening Exploration:**
|
||||
"Now that we understand what {{project_name}} does, who it serves, and how we'll measure success, let's define what we need to build first.
|
||||
<display>
|
||||
Now that we understand what {{project_name}} does, who it serves, and how we'll measure success, let's define what we need to build first.
|
||||
|
||||
**Scope Discovery:**
|
||||
|
||||
|
|
@ -69,7 +70,8 @@ Define MVP scope with clear boundaries and outline future vision through collabo
|
|||
- What features would make users say 'this solves my problem'?
|
||||
- How do we balance ambition with getting something valuable to users quickly?
|
||||
|
||||
Let's start with the MVP mindset: what's the smallest version that creates real value?"
|
||||
Let's start with the MVP mindset: what's the smallest version that creates real value?
|
||||
</display>
|
||||
|
||||
### 2. MVP Core Features Definition
|
||||
|
||||
|
|
@ -167,12 +169,14 @@ Prepare the following structure for document append:
|
|||
### 7. Present MENU OPTIONS
|
||||
|
||||
**Content Presentation:**
|
||||
"I've defined the MVP scope for {{project_name}} that balances delivering real value with realistic boundaries. This gives us a clear path forward while keeping our options open for future growth.
|
||||
<display>
|
||||
I've defined the MVP scope for {{project_name}} that balances delivering real value with realistic boundaries. This gives us a clear path forward while keeping our options open for future growth.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
[Show the complete markdown content from step 6]
|
||||
|
||||
**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue"
|
||||
**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
|
||||
|
|
|
|||
|
|
@ -56,22 +56,24 @@ Complete the product brief workflow, update status files, and provide guidance o
|
|||
### 1. Announce Workflow Completion
|
||||
|
||||
**Completion Announcement:**
|
||||
"🎉 **Product Brief Complete, {{user_name}}!**
|
||||
<display>
|
||||
**Product Brief Complete, {{user_name}}!**
|
||||
|
||||
I've successfully collaborated with you to create a comprehensive Product Brief for {{project_name}}.
|
||||
|
||||
**What we've accomplished:**
|
||||
|
||||
- ✅ Executive Summary with clear vision and problem statement
|
||||
- ✅ Core Vision with solution definition and unique differentiators
|
||||
- ✅ Target Users with rich personas and user journeys
|
||||
- ✅ Success Metrics with measurable outcomes and business objectives
|
||||
- ✅ MVP Scope with focused feature set and clear boundaries
|
||||
- ✅ Future Vision that inspires while maintaining current focus
|
||||
- Executive Summary with clear vision and problem statement
|
||||
- Core Vision with solution definition and unique differentiators
|
||||
- Target Users with rich personas and user journeys
|
||||
- Success Metrics with measurable outcomes and business objectives
|
||||
- MVP Scope with focused feature set and clear boundaries
|
||||
- Future Vision that inspires while maintaining current focus
|
||||
|
||||
**The complete Product Brief is now available at:** `{outputFile}`
|
||||
|
||||
This brief serves as the foundation for all subsequent product development activities and strategic decisions."
|
||||
This brief serves as the foundation for all subsequent product development activities and strategic decisions.
|
||||
</display>
|
||||
|
||||
### 2. Document Quality Check
|
||||
|
||||
|
|
@ -116,7 +118,9 @@ Provide guidance on logical next workflows:
|
|||
|
||||
### 4. Congrats to the user
|
||||
|
||||
"**Your Product Brief for {{project_name}} is now complete and ready for the next phase!**"
|
||||
<display>
|
||||
**Your Product Brief for {{project_name}} is now complete and ready for the next phase!**
|
||||
</display>
|
||||
|
||||
Recap that the brief captures everything needed to guide subsequent product development:
|
||||
|
||||
|
|
|
|||
|
|
@ -37,7 +37,9 @@ Confirm domain research scope and approach for **{{research_topic}}** with the u
|
|||
### 1. Begin Scope Confirmation
|
||||
|
||||
Start with domain scope understanding:
|
||||
"I understand you want to conduct **domain research** for **{{research_topic}}** with these goals: {{research_goals}}
|
||||
|
||||
<display>
|
||||
I understand you want to conduct **domain research** for **{{research_topic}}** with these goals: {{research_goals}}
|
||||
|
||||
**Domain Research Scope:**
|
||||
|
||||
|
|
@ -53,11 +55,14 @@ Start with domain scope understanding:
|
|||
- Multi-source validation for critical domain claims
|
||||
- Confidence levels for uncertain domain information
|
||||
- Comprehensive domain coverage with industry-specific insights
|
||||
</display>
|
||||
|
||||
### 2. Scope Confirmation
|
||||
|
||||
Present clear scope confirmation:
|
||||
"**Domain Research Scope Confirmation:**
|
||||
|
||||
<display>
|
||||
**Domain Research Scope Confirmation:**
|
||||
|
||||
For **{{research_topic}}**, I will research:
|
||||
|
||||
|
|
@ -71,6 +76,7 @@ For **{{research_topic}}**, I will research:
|
|||
|
||||
**Does this domain research scope and approach align with your goals?**
|
||||
[C] Continue - Begin domain research with this scope
|
||||
</display>
|
||||
|
||||
### 3. Handle Continue Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -41,7 +41,9 @@ Conduct industry analysis focusing on market size, growth, and industry dynamics
|
|||
**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different industry areas simultaneously and thoroughly.
|
||||
|
||||
Start with industry research approach:
|
||||
"Now I'll conduct **industry analysis** for **{{research_topic}}** to understand market dynamics.
|
||||
|
||||
<display>
|
||||
Now I'll conduct **industry analysis** for **{{research_topic}}** to understand market dynamics.
|
||||
|
||||
**Industry Analysis Focus:**
|
||||
|
||||
|
|
@ -51,7 +53,8 @@ Start with industry research approach:
|
|||
- Industry trends and evolution patterns
|
||||
- Economic impact and value creation
|
||||
|
||||
**Let me search for current industry insights.**"
|
||||
**Let me search for current industry insights.**
|
||||
</display>
|
||||
|
||||
### 2. Parallel Industry Research Execution
|
||||
|
||||
|
|
@ -74,7 +77,8 @@ Search the web: "{{research_topic}} industry trends evolution"
|
|||
|
||||
**Collect and analyze findings from all parallel searches:**
|
||||
|
||||
"After executing comprehensive parallel web searches, let me analyze and aggregate industry findings:
|
||||
<display>
|
||||
After executing comprehensive parallel web searches, let me analyze and aggregate industry findings:
|
||||
|
||||
**Research Coverage:**
|
||||
|
||||
|
|
@ -87,7 +91,8 @@ Search the web: "{{research_topic}} industry trends evolution"
|
|||
[Identify patterns connecting market dynamics, segmentation, and trends]
|
||||
|
||||
**Quality Assessment:**
|
||||
[Overall confidence levels and research gaps identified]"
|
||||
[Overall confidence levels and research gaps identified]
|
||||
</display>
|
||||
|
||||
### 4. Generate Industry Analysis Content
|
||||
|
||||
|
|
@ -152,7 +157,8 @@ _Source: [URL]_
|
|||
|
||||
**Show analysis and present continue option:**
|
||||
|
||||
"I've completed **industry analysis** for {{research_topic}}.
|
||||
<display>
|
||||
I've completed **industry analysis** for {{research_topic}}.
|
||||
|
||||
**Key Industry Findings:**
|
||||
|
||||
|
|
@ -164,6 +170,7 @@ _Source: [URL]_
|
|||
|
||||
**Ready to proceed to competitive landscape analysis?**
|
||||
[C] Continue - Save this to document and proceed to competitive landscape
|
||||
</display>
|
||||
|
||||
### 6. Handle Continue Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -41,7 +41,9 @@ Conduct competitive landscape analysis focusing on key players, market share, an
|
|||
**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different competitive areas simultaneously and thoroughly.
|
||||
|
||||
Start with competitive research approach:
|
||||
"Now I'll conduct **competitive landscape analysis** for **{{research_topic}}** to understand the competitive ecosystem.
|
||||
|
||||
<display>
|
||||
Now I'll conduct **competitive landscape analysis** for **{{research_topic}}** to understand the competitive ecosystem.
|
||||
|
||||
**Competitive Landscape Focus:**
|
||||
|
||||
|
|
@ -51,7 +53,8 @@ Start with competitive research approach:
|
|||
- Business models and value propositions
|
||||
- Entry barriers and competitive dynamics
|
||||
|
||||
**Let me search for current competitive insights.**"
|
||||
**Let me search for current competitive insights.**
|
||||
</display>
|
||||
|
||||
### 2. Parallel Competitive Research Execution
|
||||
|
||||
|
|
@ -74,7 +77,8 @@ Search the web: "{{research_topic}} entry barriers competitive dynamics"
|
|||
|
||||
**Collect and analyze findings from all parallel searches:**
|
||||
|
||||
"After executing comprehensive parallel web searches, let me analyze and aggregate competitive findings:
|
||||
<display>
|
||||
After executing comprehensive parallel web searches, let me analyze and aggregate competitive findings:
|
||||
|
||||
**Research Coverage:**
|
||||
|
||||
|
|
@ -87,7 +91,8 @@ Search the web: "{{research_topic}} entry barriers competitive dynamics"
|
|||
[Identify patterns connecting players, strategies, and market dynamics]
|
||||
|
||||
**Quality Assessment:**
|
||||
[Overall confidence levels and research gaps identified]"
|
||||
[Overall confidence levels and research gaps identified]
|
||||
</display>
|
||||
|
||||
### 4. Generate Competitive Landscape Content
|
||||
|
||||
|
|
@ -161,7 +166,8 @@ _Source: [URL]_
|
|||
|
||||
**Show analysis and present continue option:**
|
||||
|
||||
"I've completed **competitive landscape analysis** for {{research_topic}}.
|
||||
<display>
|
||||
I've completed **competitive landscape analysis** for {{research_topic}}.
|
||||
|
||||
**Key Competitive Findings:**
|
||||
|
||||
|
|
@ -173,6 +179,7 @@ _Source: [URL]_
|
|||
|
||||
**Ready to proceed to regulatory focus analysis?**
|
||||
[C] Continue - Save this to document and proceed to regulatory focus
|
||||
</display>
|
||||
|
||||
### 6. Handle Continue Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -39,7 +39,9 @@ Conduct focused regulatory and compliance analysis with emphasis on requirements
|
|||
### 1. Begin Regulatory Analysis
|
||||
|
||||
Start with regulatory research approach:
|
||||
"Now I'll focus on **regulatory and compliance requirements** that impact **{{research_topic}}**.
|
||||
|
||||
<display>
|
||||
Now I'll focus on **regulatory and compliance requirements** that impact **{{research_topic}}**.
|
||||
|
||||
**Regulatory Focus Areas:**
|
||||
|
||||
|
|
@ -49,7 +51,8 @@ Start with regulatory research approach:
|
|||
- Data protection and privacy regulations
|
||||
- Environmental and safety requirements
|
||||
|
||||
**Let me search for current regulatory requirements.**"
|
||||
**Let me search for current regulatory requirements.**
|
||||
</display>
|
||||
|
||||
### 2. Web Search for Specific Regulations
|
||||
|
||||
|
|
@ -136,7 +139,9 @@ _Source: [URL]_
|
|||
### 6. Present Analysis and Continue Option
|
||||
|
||||
Show the generated regulatory analysis and present continue option:
|
||||
"I've completed **regulatory requirements analysis** for {{research_topic}}.
|
||||
|
||||
<display>
|
||||
I've completed **regulatory requirements analysis** for {{research_topic}}.
|
||||
|
||||
**Key Regulatory Findings:**
|
||||
|
||||
|
|
@ -148,6 +153,7 @@ Show the generated regulatory analysis and present continue option:
|
|||
|
||||
**Ready to proceed to technical trends?**
|
||||
[C] Continue - Save this to the document and move to technical trends
|
||||
</display>
|
||||
|
||||
### 7. Handle Continue Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -39,7 +39,9 @@ Conduct comprehensive technical trends analysis using current web data with emph
|
|||
### 1. Begin Technical Trends Analysis
|
||||
|
||||
Start with technology research approach:
|
||||
"Now I'll conduct **technical trends and emerging technologies** analysis for **{{research_topic}}** using current data.
|
||||
|
||||
<display>
|
||||
Now I'll conduct **technical trends and emerging technologies** analysis for **{{research_topic}}** using current data.
|
||||
|
||||
**Technical Trends Focus:**
|
||||
|
||||
|
|
@ -49,7 +51,8 @@ Start with technology research approach:
|
|||
- New business models enabled by technology
|
||||
- Future technology projections and roadmaps
|
||||
|
||||
**Let me search for current technology developments.**"
|
||||
**Let me search for current technology developments.**
|
||||
</display>
|
||||
|
||||
### 2. Web Search for Emerging Technologies
|
||||
|
||||
|
|
@ -148,7 +151,9 @@ _Source: [URL]_
|
|||
### 6. Present Analysis and Complete Option
|
||||
|
||||
Show the generated technical analysis and present complete option:
|
||||
"I've completed **technical trends and innovation analysis** for {{research_topic}}.
|
||||
|
||||
<display>
|
||||
I've completed **technical trends and innovation analysis** for {{research_topic}}.
|
||||
|
||||
**Technical Highlights:**
|
||||
|
||||
|
|
@ -167,6 +172,7 @@ Show the generated technical analysis and present complete option:
|
|||
|
||||
**Ready to proceed to research synthesis and recommendations?**
|
||||
[C] Continue - Save this to document and proceed to synthesis
|
||||
</display>
|
||||
|
||||
### 7. Handle Continue Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -339,7 +339,8 @@ _This comprehensive research document serves as an authoritative reference on {{
|
|||
|
||||
**Document Completion Presentation:**
|
||||
|
||||
"I've completed the **comprehensive research document synthesis** for **{{research_topic}}**, producing an authoritative research document with:
|
||||
<display>
|
||||
I've completed the **comprehensive research document synthesis** for **{{research_topic}}**, producing an authoritative research document with:
|
||||
|
||||
**Document Features:**
|
||||
|
||||
|
|
@ -368,6 +369,7 @@ _This comprehensive research document serves as an authoritative reference on {{
|
|||
|
||||
**Ready to complete this comprehensive research document?**
|
||||
[C] Complete Research - Save final comprehensive document
|
||||
</display>
|
||||
|
||||
### 6. Handle Final Completion
|
||||
|
||||
|
|
|
|||
|
|
@ -39,7 +39,9 @@ Initialize market research by confirming understanding of {{research_topic}} and
|
|||
**INITIALIZE - DO NOT RESEARCH YET**
|
||||
|
||||
Start with research confirmation:
|
||||
"I understand you want to conduct **market research** for **{{research_topic}}** with these goals: {{research_goals}}
|
||||
|
||||
<display>
|
||||
I understand you want to conduct **market research** for **{{research_topic}}** with these goals: {{research_goals}}
|
||||
|
||||
**My Understanding of Your Research Needs:**
|
||||
|
||||
|
|
@ -55,7 +57,8 @@ Start with research confirmation:
|
|||
- Competitive landscape and positioning
|
||||
- Strategic recommendations and implementation guidance
|
||||
|
||||
**Does this accurately capture what you're looking for?**"
|
||||
**Does this accurately capture what you're looking for?**
|
||||
</display>
|
||||
|
||||
### 2. Refine Research Scope
|
||||
|
||||
|
|
@ -117,7 +120,9 @@ Write initial research scope to document:
|
|||
### 4. Present Confirmation and Continue Option
|
||||
|
||||
Show initial scope document and present continue option:
|
||||
"I've documented our understanding and initial scope for **{{research_topic}}** market research.
|
||||
|
||||
<display>
|
||||
I've documented our understanding and initial scope for **{{research_topic}}** market research.
|
||||
|
||||
**What I've established:**
|
||||
|
||||
|
|
@ -131,6 +136,7 @@ Show initial scope document and present continue option:
|
|||
**Ready to begin detailed market research?**
|
||||
[C] Continue - Confirm scope and proceed to customer insights analysis
|
||||
[Modify] Suggest changes to research scope before proceeding
|
||||
</display>
|
||||
|
||||
### 5. Handle User Response
|
||||
|
||||
|
|
|
|||
|
|
@ -41,7 +41,9 @@ Conduct customer behavior and segment analysis with emphasis on patterns and dem
|
|||
**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different customer behavior areas simultaneously and thoroughly.
|
||||
|
||||
Start with customer behavior research approach:
|
||||
"Now I'll conduct **customer behavior analysis** for **{{research_topic}}** to understand customer patterns.
|
||||
|
||||
<display>
|
||||
Now I'll conduct **customer behavior analysis** for **{{research_topic}}** to understand customer patterns.
|
||||
|
||||
**Customer Behavior Focus:**
|
||||
|
||||
|
|
@ -51,7 +53,8 @@ Start with customer behavior research approach:
|
|||
- Behavior drivers and influences
|
||||
- Customer interaction patterns and engagement
|
||||
|
||||
**Let me search for current customer behavior insights.**"
|
||||
**Let me search for current customer behavior insights.**
|
||||
</display>
|
||||
|
||||
### 2. Parallel Customer Behavior Research Execution
|
||||
|
||||
|
|
@ -74,7 +77,8 @@ Search the web: "{{research_topic}} customer behavior drivers"
|
|||
|
||||
**Collect and analyze findings from all parallel searches:**
|
||||
|
||||
"After executing comprehensive parallel web searches, let me analyze and aggregate customer behavior findings:
|
||||
<display>
|
||||
After executing comprehensive parallel web searches, let me analyze and aggregate customer behavior findings:
|
||||
|
||||
**Research Coverage:**
|
||||
|
||||
|
|
@ -88,7 +92,8 @@ Search the web: "{{research_topic}} customer behavior drivers"
|
|||
[Identify patterns connecting demographics, psychographics, and behaviors]
|
||||
|
||||
**Quality Assessment:**
|
||||
[Overall confidence levels and research gaps identified]"
|
||||
[Overall confidence levels and research gaps identified]
|
||||
</display>
|
||||
|
||||
### 4. Generate Customer Behavior Content
|
||||
|
||||
|
|
@ -160,7 +165,8 @@ _Source: [URL]_
|
|||
|
||||
**Show analysis and present continue option:**
|
||||
|
||||
"I've completed **customer behavior analysis** for {{research_topic}}, focusing on customer patterns.
|
||||
<display>
|
||||
I've completed **customer behavior analysis** for {{research_topic}}, focusing on customer patterns.
|
||||
|
||||
**Key Customer Behavior Findings:**
|
||||
|
||||
|
|
@ -172,6 +178,7 @@ _Source: [URL]_
|
|||
|
||||
**Ready to proceed to customer pain points?**
|
||||
[C] Continue - Save this to document and proceed to pain points analysis
|
||||
</display>
|
||||
|
||||
### 6. Handle Continue Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -42,7 +42,9 @@ Conduct customer pain points and needs analysis with emphasis on challenges and
|
|||
**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different customer pain point areas simultaneously and thoroughly.
|
||||
|
||||
Start with customer pain points research approach:
|
||||
"Now I'll conduct **customer pain points analysis** for **{{research_topic}}** to understand customer challenges.
|
||||
|
||||
<display>
|
||||
Now I'll conduct **customer pain points analysis** for **{{research_topic}}** to understand customer challenges.
|
||||
|
||||
**Customer Pain Points Focus:**
|
||||
|
||||
|
|
@ -52,7 +54,8 @@ Start with customer pain points research approach:
|
|||
- Service and support pain points
|
||||
- Customer satisfaction gaps
|
||||
|
||||
**Let me search for current customer pain points insights.**"
|
||||
**Let me search for current customer pain points insights.**
|
||||
</display>
|
||||
|
||||
### 2. Parallel Pain Points Research Execution
|
||||
|
||||
|
|
@ -75,7 +78,8 @@ Search the web: "{{research_topic}} customer barriers to adoption"
|
|||
|
||||
**Collect and analyze findings from all parallel searches:**
|
||||
|
||||
"After executing comprehensive parallel web searches, let me analyze and aggregate customer pain points findings:
|
||||
<display>
|
||||
After executing comprehensive parallel web searches, let me analyze and aggregate customer pain points findings:
|
||||
|
||||
**Research Coverage:**
|
||||
|
||||
|
|
@ -88,7 +92,8 @@ Search the web: "{{research_topic}} customer barriers to adoption"
|
|||
[Identify patterns connecting different types of pain points]
|
||||
|
||||
**Quality Assessment:**
|
||||
[Overall confidence levels and research gaps identified]"
|
||||
[Overall confidence levels and research gaps identified]
|
||||
</display>
|
||||
|
||||
### 4. Generate Customer Pain Points Content
|
||||
|
||||
|
|
@ -171,7 +176,8 @@ _Source: [URL]_
|
|||
|
||||
**Show analysis and present continue option:**
|
||||
|
||||
"I've completed **customer pain points analysis** for {{research_topic}}, focusing on customer challenges.
|
||||
<display>
|
||||
I've completed **customer pain points analysis** for {{research_topic}}, focusing on customer challenges.
|
||||
|
||||
**Key Pain Points Findings:**
|
||||
|
||||
|
|
@ -183,6 +189,7 @@ _Source: [URL]_
|
|||
|
||||
**Ready to proceed to customer decision processes?**
|
||||
[C] Continue - Save this to document and proceed to decision processes analysis
|
||||
</display>
|
||||
|
||||
### 6. Handle Continue Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -42,7 +42,9 @@ Conduct customer decision processes and journey analysis with emphasis on decisi
|
|||
**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different customer decision areas simultaneously and thoroughly.
|
||||
|
||||
Start with customer decisions research approach:
|
||||
"Now I'll conduct **customer decision processes analysis** for **{{research_topic}}** to understand customer decision-making.
|
||||
|
||||
<display>
|
||||
Now I'll conduct **customer decision processes analysis** for **{{research_topic}}** to understand customer decision-making.
|
||||
|
||||
**Customer Decisions Focus:**
|
||||
|
||||
|
|
@ -52,7 +54,8 @@ Start with customer decisions research approach:
|
|||
- Purchase decision influencers
|
||||
- Information gathering patterns
|
||||
|
||||
**Let me search for current customer decision insights.**"
|
||||
**Let me search for current customer decision insights.**
|
||||
</display>
|
||||
|
||||
### 2. Parallel Decisions Research Execution
|
||||
|
||||
|
|
@ -75,7 +78,8 @@ Search the web: "{{research_topic}} decision influencing factors"
|
|||
|
||||
**Collect and analyze findings from all parallel searches:**
|
||||
|
||||
"After executing comprehensive parallel web searches, let me analyze and aggregate customer decision findings:
|
||||
<display>
|
||||
After executing comprehensive parallel web searches, let me analyze and aggregate customer decision findings:
|
||||
|
||||
**Research Coverage:**
|
||||
|
||||
|
|
@ -88,7 +92,8 @@ Search the web: "{{research_topic}} decision influencing factors"
|
|||
[Identify patterns connecting decision factors and journey stages]
|
||||
|
||||
**Quality Assessment:**
|
||||
[Overall confidence levels and research gaps identified]"
|
||||
[Overall confidence levels and research gaps identified]
|
||||
</display>
|
||||
|
||||
### 4. Generate Customer Decisions Content
|
||||
|
||||
|
|
@ -181,7 +186,8 @@ _Source: [URL]_
|
|||
|
||||
**Show analysis and present continue option:**
|
||||
|
||||
"I've completed **customer decision processes analysis** for {{research_topic}}, focusing on customer decision-making.
|
||||
<display>
|
||||
I've completed **customer decision processes analysis** for {{research_topic}}, focusing on customer decision-making.
|
||||
|
||||
**Key Decision Findings:**
|
||||
|
||||
|
|
@ -193,6 +199,7 @@ _Source: [URL]_
|
|||
|
||||
**Ready to proceed to competitive analysis?**
|
||||
[C] Continue - Save this to document and proceed to competitive analysis
|
||||
</display>
|
||||
|
||||
### 6. Handle Continue Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -36,7 +36,9 @@ Conduct comprehensive competitive analysis with emphasis on market positioning.
|
|||
### 1. Begin Competitive Analysis
|
||||
|
||||
Start with competitive research approach:
|
||||
"Now I'll conduct **competitive analysis** to understand the competitive landscape.
|
||||
|
||||
<display>
|
||||
Now I'll conduct **competitive analysis** to understand the competitive landscape.
|
||||
|
||||
**Competitive Analysis Focus:**
|
||||
|
||||
|
|
@ -46,7 +48,8 @@ Start with competitive research approach:
|
|||
- Market differentiation opportunities
|
||||
- Competitive threats and challenges
|
||||
|
||||
**Let me search for current competitive information.**"
|
||||
**Let me search for current competitive information.**
|
||||
</display>
|
||||
|
||||
### 2. Generate Competitive Analysis Content
|
||||
|
||||
|
|
@ -98,7 +101,9 @@ _Source: [URL]_
|
|||
### 3. Present Analysis and Complete Option
|
||||
|
||||
Show the generated competitive analysis and present complete option:
|
||||
"I've completed the **competitive analysis** for the competitive landscape.
|
||||
|
||||
<display>
|
||||
I've completed the **competitive analysis** for the competitive landscape.
|
||||
|
||||
**Key Competitive Findings:**
|
||||
|
||||
|
|
@ -110,6 +115,7 @@ Show the generated competitive analysis and present complete option:
|
|||
|
||||
**Ready to complete the market research?**
|
||||
[C] Complete Research - Save final document and conclude
|
||||
</display>
|
||||
|
||||
### 4. Handle Complete Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -39,7 +39,9 @@ Produce a comprehensive, authoritative market research document on **{{research_
|
|||
### 1. Begin Strategic Synthesis
|
||||
|
||||
Start with strategic synthesis approach:
|
||||
"Now I'll complete our market research with **strategic synthesis and recommendations** .
|
||||
|
||||
<display>
|
||||
Now I'll complete our market research with **strategic synthesis and recommendations** .
|
||||
|
||||
**Strategic Synthesis Focus:**
|
||||
|
||||
|
|
@ -49,7 +51,8 @@ Start with strategic synthesis approach:
|
|||
- Risk assessment and mitigation approaches
|
||||
- Actionable next steps and implementation guidance
|
||||
|
||||
**Let me search for current strategic insights and best practices.**"
|
||||
**Let me search for current strategic insights and best practices.**
|
||||
</display>
|
||||
|
||||
### 2. Web Search for Market Entry Strategies
|
||||
|
||||
|
|
@ -356,7 +359,8 @@ _This comprehensive market research document serves as an authoritative market r
|
|||
|
||||
**Market Research Document Completion Presentation:**
|
||||
|
||||
"I've completed the **comprehensive market research document synthesis** for **{{research_topic}}**, producing an authoritative market research document with:
|
||||
<display>
|
||||
I've completed the **comprehensive market research document synthesis** for **{{research_topic}}**, producing an authoritative market research document with:
|
||||
|
||||
**Document Features:**
|
||||
|
||||
|
|
@ -384,6 +388,7 @@ _This comprehensive market research document serves as an authoritative market r
|
|||
|
||||
**Ready to complete this comprehensive market research document?**
|
||||
[C] Complete Research - Save final comprehensive market research document
|
||||
</display>
|
||||
|
||||
### 6. Handle Complete Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -37,7 +37,9 @@ Confirm technical research scope and approach for **{{research_topic}}** with th
|
|||
### 1. Begin Scope Confirmation
|
||||
|
||||
Start with technical scope understanding:
|
||||
"I understand you want to conduct **technical research** for **{{research_topic}}** with these goals: {{research_goals}}
|
||||
|
||||
<display>
|
||||
I understand you want to conduct **technical research** for **{{research_topic}}** with these goals: {{research_goals}}
|
||||
|
||||
**Technical Research Scope:**
|
||||
|
||||
|
|
@ -53,11 +55,14 @@ Start with technical scope understanding:
|
|||
- Multi-source validation for critical technical claims
|
||||
- Confidence levels for uncertain technical information
|
||||
- Comprehensive technical coverage with architecture-specific insights
|
||||
</display>
|
||||
|
||||
### 2. Scope Confirmation
|
||||
|
||||
Present clear scope confirmation:
|
||||
"**Technical Research Scope Confirmation:**
|
||||
|
||||
<display>
|
||||
**Technical Research Scope Confirmation:**
|
||||
|
||||
For **{{research_topic}}**, I will research:
|
||||
|
||||
|
|
@ -71,6 +76,7 @@ For **{{research_topic}}**, I will research:
|
|||
|
||||
**Does this technical research scope and approach align with your goals?**
|
||||
[C] Continue - Begin technical research with this scope
|
||||
</display>
|
||||
|
||||
### 3. Handle Continue Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -41,7 +41,9 @@ Conduct technology stack analysis focusing on languages, frameworks, tools, and
|
|||
**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different technology stack areas simultaneously and thoroughly.
|
||||
|
||||
Start with technology stack research approach:
|
||||
"Now I'll conduct **technology stack analysis** for **{{research_topic}}** to understand the technology landscape.
|
||||
|
||||
<display>
|
||||
Now I'll conduct **technology stack analysis** for **{{research_topic}}** to understand the technology landscape.
|
||||
|
||||
**Technology Stack Focus:**
|
||||
|
||||
|
|
@ -51,7 +53,8 @@ Start with technology stack research approach:
|
|||
- Development tools and platforms
|
||||
- Cloud infrastructure and deployment platforms
|
||||
|
||||
**Let me search for current technology stack insights.**"
|
||||
**Let me search for current technology stack insights.**
|
||||
</display>
|
||||
|
||||
### 2. Parallel Technology Stack Research Execution
|
||||
|
||||
|
|
@ -74,7 +77,8 @@ Search the web: "{{research_topic}} cloud infrastructure platforms"
|
|||
|
||||
**Collect and analyze findings from all parallel searches:**
|
||||
|
||||
"After executing comprehensive parallel web searches, let me analyze and aggregate technology stack findings:
|
||||
<display>
|
||||
After executing comprehensive parallel web searches, let me analyze and aggregate technology stack findings:
|
||||
|
||||
**Research Coverage:**
|
||||
|
||||
|
|
@ -87,7 +91,8 @@ Search the web: "{{research_topic}} cloud infrastructure platforms"
|
|||
[Identify patterns connecting language choices, frameworks, and platform decisions]
|
||||
|
||||
**Quality Assessment:**
|
||||
[Overall confidence levels and research gaps identified]"
|
||||
[Overall confidence levels and research gaps identified]
|
||||
</display>
|
||||
|
||||
### 4. Generate Technology Stack Content
|
||||
|
||||
|
|
@ -161,7 +166,8 @@ _Source: [URL]_
|
|||
|
||||
**Show analysis and present continue option:**
|
||||
|
||||
"I've completed **technology stack analysis** of the technology landscape for {{research_topic}}.
|
||||
<display>
|
||||
I've completed **technology stack analysis** of the technology landscape for {{research_topic}}.
|
||||
|
||||
**Key Technology Stack Findings:**
|
||||
|
||||
|
|
@ -173,6 +179,7 @@ _Source: [URL]_
|
|||
|
||||
**Ready to proceed to integration patterns analysis?**
|
||||
[C] Continue - Save this to document and proceed to integration patterns
|
||||
</display>
|
||||
|
||||
### 6. Handle Continue Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -41,7 +41,9 @@ Conduct integration patterns analysis focusing on APIs, communication protocols,
|
|||
**UTILIZE SUBPROCESSES AND SUBAGENTS**: Use research subagents, subprocesses or parallel processing if available to thoroughly analyze different integration areas simultaneously and thoroughly.
|
||||
|
||||
Start with integration patterns research approach:
|
||||
"Now I'll conduct **integration patterns analysis** for **{{research_topic}}** to understand system integration approaches.
|
||||
|
||||
<display>
|
||||
Now I'll conduct **integration patterns analysis** for **{{research_topic}}** to understand system integration approaches.
|
||||
|
||||
**Integration Patterns Focus:**
|
||||
|
||||
|
|
@ -51,7 +53,8 @@ Start with integration patterns research approach:
|
|||
- Microservices integration patterns
|
||||
- Event-driven architectures and messaging
|
||||
|
||||
**Let me search for current integration patterns insights.**"
|
||||
**Let me search for current integration patterns insights.**
|
||||
</display>
|
||||
|
||||
### 2. Parallel Integration Patterns Research Execution
|
||||
|
||||
|
|
@ -74,7 +77,8 @@ Search the web: "{{research_topic}} microservices integration patterns"
|
|||
|
||||
**Collect and analyze findings from all parallel searches:**
|
||||
|
||||
"After executing comprehensive parallel web searches, let me analyze and aggregate integration patterns findings:
|
||||
<display>
|
||||
After executing comprehensive parallel web searches, let me analyze and aggregate integration patterns findings:
|
||||
|
||||
**Research Coverage:**
|
||||
|
||||
|
|
@ -87,7 +91,8 @@ Search the web: "{{research_topic}} microservices integration patterns"
|
|||
[Identify patterns connecting API choices, communication protocols, and system design]
|
||||
|
||||
**Quality Assessment:**
|
||||
[Overall confidence levels and research gaps identified]"
|
||||
[Overall confidence levels and research gaps identified]
|
||||
</display>
|
||||
|
||||
### 4. Generate Integration Patterns Content
|
||||
|
||||
|
|
@ -170,7 +175,8 @@ _Source: [URL]_
|
|||
|
||||
**Show analysis and present continue option:**
|
||||
|
||||
"I've completed **integration patterns analysis** of system integration approaches for {{research_topic}}.
|
||||
<display>
|
||||
I've completed **integration patterns analysis** of system integration approaches for {{research_topic}}.
|
||||
|
||||
**Key Integration Patterns Findings:**
|
||||
|
||||
|
|
@ -182,6 +188,7 @@ _Source: [URL]_
|
|||
|
||||
**Ready to proceed to architectural patterns analysis?**
|
||||
[C] Continue - Save this to document and proceed to architectural patterns
|
||||
</display>
|
||||
|
||||
### 6. Handle Continue Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -39,7 +39,9 @@ Conduct comprehensive architectural patterns analysis with emphasis on design de
|
|||
### 1. Begin Architectural Patterns Analysis
|
||||
|
||||
Start with architectural research approach:
|
||||
"Now I'll focus on **architectural patterns and design decisions** for effective architecture approaches for [technology/domain].
|
||||
|
||||
<display>
|
||||
Now I'll focus on **architectural patterns and design decisions** for effective architecture approaches for [technology/domain].
|
||||
|
||||
**Architectural Patterns Focus:**
|
||||
|
||||
|
|
@ -49,7 +51,8 @@ Start with architectural research approach:
|
|||
- Integration and communication patterns
|
||||
- Security and performance architectural considerations
|
||||
|
||||
**Let me search for current architectural patterns and approaches.**"
|
||||
**Let me search for current architectural patterns and approaches.**
|
||||
</display>
|
||||
|
||||
### 2. Web Search for System Architecture Patterns
|
||||
|
||||
|
|
@ -137,7 +140,9 @@ _Source: [URL]_
|
|||
### 6. Present Analysis and Continue Option
|
||||
|
||||
Show the generated architectural patterns and present continue option:
|
||||
"I've completed the **architectural patterns analysis** for effective architecture approaches.
|
||||
|
||||
<display>
|
||||
I've completed the **architectural patterns analysis** for effective architecture approaches.
|
||||
|
||||
**Key Architectural Findings:**
|
||||
|
||||
|
|
@ -149,6 +154,7 @@ Show the generated architectural patterns and present continue option:
|
|||
|
||||
**Ready to proceed to implementation research?**
|
||||
[C] Continue - Save this to the document and move to implementation research
|
||||
</display>
|
||||
|
||||
### 7. Handle Continue Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -36,7 +36,9 @@ Conduct comprehensive implementation research with emphasis on practical impleme
|
|||
### 1. Begin Implementation Research
|
||||
|
||||
Start with implementation research approach:
|
||||
"Now I'll complete our technical research with **implementation approaches and technology adoption** analysis.
|
||||
|
||||
<display>
|
||||
Now I'll complete our technical research with **implementation approaches and technology adoption** analysis.
|
||||
|
||||
**Implementation Research Focus:**
|
||||
|
||||
|
|
@ -46,7 +48,8 @@ Start with implementation research approach:
|
|||
- Team organization and skill requirements
|
||||
- Cost optimization and resource management
|
||||
|
||||
**Let me search for current implementation and adoption strategies.**"
|
||||
**Let me search for current implementation and adoption strategies.**
|
||||
</display>
|
||||
|
||||
### 2. Web Search for Technology Adoption
|
||||
|
||||
|
|
@ -152,7 +155,9 @@ _Source: [URL]_
|
|||
### 6. Present Analysis and Complete Option
|
||||
|
||||
Show the generated implementation research and present complete option:
|
||||
"I've completed the **implementation research and technology adoption** analysis, finalizing our comprehensive technical research.
|
||||
|
||||
<display>
|
||||
I've completed the **implementation research and technology adoption** analysis, finalizing our comprehensive technical research.
|
||||
|
||||
**Implementation Highlights:**
|
||||
|
||||
|
|
@ -171,6 +176,7 @@ Show the generated implementation research and present complete option:
|
|||
|
||||
**Ready to complete the technical research report?**
|
||||
[C] Complete Research - Save final document and conclude
|
||||
</display>
|
||||
|
||||
### 7. Handle Complete Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -382,7 +382,8 @@ _This comprehensive technical research document serves as an authoritative techn
|
|||
|
||||
**Technical Document Completion Presentation:**
|
||||
|
||||
"I've completed the **comprehensive technical research document synthesis** for **{{research_topic}}**, producing an authoritative technical research document with:
|
||||
<display>
|
||||
I've completed the **comprehensive technical research document synthesis** for **{{research_topic}}**, producing an authoritative technical research document with:
|
||||
|
||||
**Technical Document Features:**
|
||||
|
||||
|
|
@ -411,6 +412,7 @@ _This comprehensive technical research document serves as an authoritative techn
|
|||
|
||||
**Ready to complete this comprehensive technical research document?**
|
||||
[C] Complete Research - Save final comprehensive technical document
|
||||
</display>
|
||||
|
||||
### 6. Handle Final Technical Completion
|
||||
|
||||
|
|
|
|||
|
|
@ -91,7 +91,8 @@ Execute research type discovery and routing:
|
|||
|
||||
### Collaborative Research Discovery
|
||||
|
||||
"Welcome {{user_name}}! I'm excited to work with you as your research partner. I bring web research capabilities with rigorous source verification, while you bring the domain expertise and research direction.
|
||||
<display>
|
||||
Welcome {{user_name}}! I'm excited to work with you as your research partner. I bring web research capabilities with rigorous source verification, while you bring the domain expertise and research direction.
|
||||
|
||||
**Let me help you clarify what you'd like to research.**
|
||||
|
||||
|
|
@ -104,6 +105,7 @@ For example:
|
|||
- 'AI implementation in financial services'
|
||||
- 'Sustainable packaging regulations'
|
||||
- 'Or anything else you have in mind...'
|
||||
</display>
|
||||
|
||||
### Topic Exploration and Clarification
|
||||
|
||||
|
|
|
|||
|
|
@ -121,7 +121,8 @@ Try to discover the following:
|
|||
|
||||
**Setup Report to User:**
|
||||
|
||||
"Welcome {{user_name}}! I've set up your PRD workspace for {{project_name}}.
|
||||
<display>
|
||||
Welcome {{user_name}}! I've set up your PRD workspace for {{project_name}}.
|
||||
|
||||
**Document Setup:**
|
||||
|
||||
|
|
@ -141,7 +142,8 @@ Try to discover the following:
|
|||
📋 **Note:** This is a **brownfield project**. Your existing project documentation has been loaded. In the next step, I'll ask specifically about what new features or changes you want to add to your existing system.
|
||||
{/if}
|
||||
|
||||
Do you have any other documents you'd like me to include, or shall we continue to the next step?"
|
||||
Do you have any other documents you'd like me to include, or shall we continue to the next step?
|
||||
</display>
|
||||
|
||||
### 4. Present MENU OPTIONS
|
||||
|
||||
|
|
|
|||
|
|
@ -86,7 +86,9 @@ Review the frontmatter to understand:
|
|||
### 4. Handle Workflow Completion
|
||||
|
||||
**If `stepsCompleted` array contains `"step-11-complete.md"`:**
|
||||
"Great news! It looks like we've already completed the PRD workflow for {{project_name}}.
|
||||
|
||||
<display>
|
||||
Great news! It looks like we've already completed the PRD workflow for {{project_name}}.
|
||||
|
||||
The final document is ready at `{outputFile}` with all sections completed.
|
||||
|
||||
|
|
@ -96,12 +98,15 @@ Would you like me to:
|
|||
- Suggest next workflow steps (like architecture or epic creation)
|
||||
- Start a new PRD revision
|
||||
|
||||
What would be most helpful?"
|
||||
What would be most helpful?
|
||||
</display>
|
||||
|
||||
### 5. Present Current Progress
|
||||
|
||||
**If workflow not complete:**
|
||||
"Welcome back {{user_name}}! I'm resuming our PRD collaboration for {{project_name}}.
|
||||
|
||||
<display>
|
||||
Welcome back {{user_name}}! I'm resuming our PRD collaboration for {{project_name}}.
|
||||
|
||||
**Current Progress:**
|
||||
- Last completed: {last step filename from stepsCompleted array}
|
||||
|
|
@ -112,11 +117,14 @@ What would be most helpful?"
|
|||
- Current PRD document is ready with all completed sections
|
||||
- Ready to continue from where we left off
|
||||
|
||||
Does this look right, or do you want to make any adjustments before we proceed?"
|
||||
Does this look right, or do you want to make any adjustments before we proceed?
|
||||
</display>
|
||||
|
||||
### 6. Present MENU OPTIONS
|
||||
|
||||
Display: "**Select an Option:** [C] Continue to {next step name}"
|
||||
<display>
|
||||
**Select an Option:** [C] Continue to {next step name}
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
|
||||
|
|
|
|||
|
|
@ -83,20 +83,24 @@ Read the frontmatter from `{outputFile}` to get document counts:
|
|||
|
||||
**Announce your understanding:**
|
||||
|
||||
"From step 1, I have loaded:
|
||||
<display>
|
||||
From step 1, I have loaded:
|
||||
- Product briefs: {{briefCount}}
|
||||
- Research: {{researchCount}}
|
||||
- Brainstorming: {{brainstormingCount}}
|
||||
- Project docs: {{projectDocsCount}}
|
||||
|
||||
{{if projectDocsCount > 0}}This is a brownfield project - I'll focus on understanding what you want to add or change.{{else}}This is a greenfield project - I'll help you define the full product vision.{{/if}}"
|
||||
{{if projectDocsCount > 0}}This is a brownfield project - I'll focus on understanding what you want to add or change.{{else}}This is a greenfield project - I'll help you define the full product vision.{{/if}}
|
||||
</display>
|
||||
|
||||
### 2. Load Classification Data
|
||||
|
||||
**Attempt subprocess data lookup:**
|
||||
|
||||
**Project Type Lookup:**
|
||||
"Your task: Lookup data in {projectTypesCSV}
|
||||
|
||||
<display>
|
||||
Your task: Lookup data in {projectTypesCSV}
|
||||
|
||||
**Search criteria:**
|
||||
- Find row where project_type matches {{detectedProjectType}}
|
||||
|
|
@ -105,10 +109,13 @@ Read the frontmatter from `{outputFile}` to get document counts:
|
|||
Return ONLY the matching row as a YAML-formatted object with these fields:
|
||||
project_type, detection_signals
|
||||
|
||||
**Do NOT return the entire CSV - only the matching row.**"
|
||||
**Do NOT return the entire CSV - only the matching row.**
|
||||
</display>
|
||||
|
||||
**Domain Complexity Lookup:**
|
||||
"Your task: Lookup data in {domainComplexityCSV}
|
||||
|
||||
<display>
|
||||
Your task: Lookup data in {domainComplexityCSV}
|
||||
|
||||
**Search criteria:**
|
||||
- Find row where domain matches {{detectedDomain}}
|
||||
|
|
@ -117,7 +124,8 @@ project_type, detection_signals
|
|||
Return ONLY the matching row as a YAML-formatted object with these fields:
|
||||
domain, complexity, typical_concerns, compliance_requirements
|
||||
|
||||
**Do NOT return the entire CSV - only the matching row.**"
|
||||
**Do NOT return the entire CSV - only the matching row.**
|
||||
</display>
|
||||
|
||||
**Graceful degradation (if Task tool unavailable):**
|
||||
- Load the CSV files directly
|
||||
|
|
@ -147,12 +155,14 @@ As the user describes their product, match against:
|
|||
|
||||
Once you have enough understanding, share your classification:
|
||||
|
||||
"I'm hearing this as:
|
||||
<display>
|
||||
I'm hearing this as:
|
||||
- **Project Type:** {{detectedType}}
|
||||
- **Domain:** {{detectedDomain}}
|
||||
- **Complexity:** {{complexityLevel}}
|
||||
|
||||
Does this sound right to you?"
|
||||
Does this sound right to you?
|
||||
</display>
|
||||
|
||||
Let the user confirm or refine your classification.
|
||||
|
||||
|
|
@ -171,7 +181,8 @@ classification:
|
|||
|
||||
Present the project classification for review, then display menu:
|
||||
|
||||
"Based on our conversation, I've discovered and classified your project.
|
||||
<display>
|
||||
Based on our conversation, I've discovered and classified your project.
|
||||
|
||||
**Here's the classification:**
|
||||
|
||||
|
|
@ -180,9 +191,12 @@ Present the project classification for review, then display menu:
|
|||
**Complexity:** {{complexityLevel}}
|
||||
**Project Context:** {{greenfield|brownfield}}
|
||||
|
||||
**What would you like to do?**"
|
||||
**What would you like to do?**
|
||||
</display>
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Product Vision (Step 2b of 13)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Product Vision (Step 2b of 13)
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
- IF A: Read fully and follow: {advancedElicitationTask} with the current classification, process the enhanced insights that come back, ask user if they accept the improvements, if yes update classification then redisplay menu, if no keep original classification then redisplay menu
|
||||
|
|
|
|||
|
|
@ -172,7 +172,9 @@ Present the success criteria content for user review, then display menu:
|
|||
- Ask if they'd like to refine further, get other perspectives, or proceed
|
||||
- Present menu options naturally as part of the conversation
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to User Journey Mapping (Step 4 of 11)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to User Journey Mapping (Step 4 of 11)
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
- IF A: Read fully and follow: {advancedElicitationTask} with the current success criteria content, process the enhanced success metrics that come back, ask user "Accept these improvements to the success criteria? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
|
||||
|
|
|
|||
|
|
@ -152,7 +152,9 @@ Present the user journey content for review, then display menu:
|
|||
- Ask if they'd like to refine further, get other perspectives, or proceed
|
||||
- Present menu options naturally as part of conversation
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Domain Requirements (Step 5 of 11)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Domain Requirements (Step 5 of 11)
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
- IF A: Read fully and follow: {advancedElicitationTask} with the current journey content, process the enhanced journey insights that come back, ask user "Accept these improvements to the user journeys? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
|
||||
|
|
|
|||
|
|
@ -80,9 +80,12 @@ For complex domains, explore what makes this domain special:
|
|||
**If complexity is LOW:**
|
||||
|
||||
Offer to skip:
|
||||
"The domain complexity from our discovery is low. We may not need deep domain-specific requirements. Would you like to:
|
||||
|
||||
<display>
|
||||
The domain complexity from our discovery is low. We may not need deep domain-specific requirements. Would you like to:
|
||||
- [C] Skip this step and move to Innovation
|
||||
- [D] Do domain exploration anyway"
|
||||
- [D] Do domain exploration anyway
|
||||
</display>
|
||||
|
||||
**If complexity is MEDIUM or HIGH:**
|
||||
|
||||
|
|
@ -92,7 +95,8 @@ Proceed with domain exploration.
|
|||
|
||||
**Attempt subprocess data lookup:**
|
||||
|
||||
"Your task: Lookup data in {domainComplexityCSV}
|
||||
<display>
|
||||
Your task: Lookup data in {domainComplexityCSV}
|
||||
|
||||
**Search criteria:**
|
||||
- Find row where domain matches {{domainFromStep02}}
|
||||
|
|
@ -101,7 +105,8 @@ Proceed with domain exploration.
|
|||
Return ONLY the matching row as a YAML-formatted object with these fields:
|
||||
domain, complexity, typical_concerns, compliance_requirements
|
||||
|
||||
**Do NOT return the entire CSV - only the matching row.**"
|
||||
**Do NOT return the entire CSV - only the matching row.**
|
||||
</display>
|
||||
|
||||
**Graceful degradation (if Task tool unavailable):**
|
||||
- Load the CSV file directly
|
||||
|
|
@ -147,11 +152,15 @@ Acknowledge the domain and explore what makes it complex:
|
|||
|
||||
**Check with the user:**
|
||||
|
||||
"Are there other domain-specific concerns we should consider? For [this domain], what typically gets overlooked?"
|
||||
<display>
|
||||
Are there other domain-specific concerns we should consider? For [this domain], what typically gets overlooked?
|
||||
</display>
|
||||
|
||||
### N. Present MENU OPTIONS
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue - Save and Proceed to Innovation (Step 6 of 13)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue - Save and Proceed to Innovation (Step 6 of 13)
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
- IF A: Read fully and follow: {advancedElicitationTask}, and when finished redisplay the menu
|
||||
|
|
|
|||
|
|
@ -152,7 +152,9 @@ Present the innovation content for review, then display menu:
|
|||
- Ask if they'd like to refine further, get other perspectives, or proceed
|
||||
- Present menu options naturally as part of conversation
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Project Type Analysis (Step 7 of 11)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Project Type Analysis (Step 7 of 11)
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
- IF A: Read fully and follow: {advancedElicitationTask} with the current innovation content, process the enhanced innovation insights that come back, ask user "Accept these improvements to the innovation analysis? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
|
||||
|
|
@ -172,7 +174,9 @@ If no genuine innovation signals are found after exploration:
|
|||
- Note this is fine - many successful products are excellent executions of existing concepts
|
||||
- Ask if they'd like to try finding innovative angles or proceed
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation - Let's try to find innovative angles [C] Continue - Skip innovation section and move to Project Type Analysis (Step 7 of 11)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation - Let's try to find innovative angles [C] Continue - Skip innovation section and move to Project Type Analysis (Step 7 of 11)
|
||||
</display>
|
||||
|
||||
### Menu Handling Logic:
|
||||
- IF A: Proceed with content generation anyway, then return to menu
|
||||
|
|
|
|||
|
|
@ -55,7 +55,7 @@ Conduct project-type specific discovery using CSV-driven guidance to define tech
|
|||
|
||||
**Attempt subprocess data lookup:**
|
||||
|
||||
"Your task: Lookup data in {projectTypesCSV}
|
||||
Your task: Lookup data in {projectTypesCSV}
|
||||
|
||||
**Search criteria:**
|
||||
- Find row where project_type matches {{projectTypeFromStep02}}
|
||||
|
|
@ -64,7 +64,7 @@ Conduct project-type specific discovery using CSV-driven guidance to define tech
|
|||
Return ONLY the matching row as a YAML-formatted object with these fields:
|
||||
project_type, key_questions, required_sections, skip_sections, innovation_signals
|
||||
|
||||
**Do NOT return the entire CSV - only the matching row.**"
|
||||
**Do NOT return the entire CSV - only the matching row.**
|
||||
|
||||
**Graceful degradation (if Task tool unavailable):**
|
||||
- Load the CSV file directly
|
||||
|
|
@ -161,15 +161,19 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
|
||||
Present the project-type content for review, then display menu:
|
||||
|
||||
"Based on our conversation and best practices for this product type, I've documented the {project_type}-specific requirements for {{project_name}}.
|
||||
<display>
|
||||
Based on our conversation and best practices for this product type, I've documented the {project_type}-specific requirements for {{project_name}}.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
[Show the complete markdown content from section 5]
|
||||
|
||||
**What would you like to do?**"
|
||||
**What would you like to do?**
|
||||
</display>
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Scoping (Step 8 of 11)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Scoping (Step 8 of 11)
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
- IF A: Read fully and follow: {advancedElicitationTask} with the current project-type content, process the enhanced technical insights that come back, ask user "Accept these improvements to the technical requirements? (y/n)", if yes update content with improvements then redisplay menu, if no keep original content then redisplay menu
|
||||
|
|
|
|||
|
|
@ -117,11 +117,14 @@ Create phased development approach:
|
|||
Identify and mitigate scoping risks:
|
||||
|
||||
**Technical Risks:**
|
||||
"Looking at your innovation and domain requirements:
|
||||
|
||||
<display>
|
||||
Looking at your innovation and domain requirements:
|
||||
|
||||
- What's the most technically challenging aspect?
|
||||
- Could we simplify the initial implementation?
|
||||
- What's the riskiest assumption about technology feasibility?"
|
||||
- What's the riskiest assumption about technology feasibility?
|
||||
</display>
|
||||
|
||||
**Market Risks:**
|
||||
|
||||
|
|
@ -180,7 +183,9 @@ Present the scoping decisions for review, then display menu:
|
|||
- Ask if they'd like to refine further, get other perspectives, or proceed
|
||||
- Present menu options naturally as part of conversation
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Functional Requirements (Step 9 of 11)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Functional Requirements (Step 9 of 11)
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
- IF A: Read fully and follow: {advancedElicitationTask} with the current scoping analysis, process the enhanced insights that come back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu
|
||||
|
|
|
|||
|
|
@ -176,9 +176,11 @@ Present the functional requirements for review, then display menu:
|
|||
- Ask if they'd like to refine further, get other perspectives, or proceed
|
||||
- Present menu options naturally as part of conversation
|
||||
|
||||
**What would you like to do?**"
|
||||
**What would you like to do?**
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Non-Functional Requirements (Step 10 of 11)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Non-Functional Requirements (Step 10 of 11)
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
- IF A: Read fully and follow: {advancedElicitationTask} with the current FR list, process the enhanced capability coverage that comes back, ask user if they accept the additions, if yes update content then redisplay menu, if no keep original content then redisplay menu
|
||||
|
|
|
|||
|
|
@ -165,7 +165,9 @@ Present the non-functional requirements for review, then display menu:
|
|||
- Ask if they'd like to refine further, get other perspectives, or proceed
|
||||
- Present menu options naturally as part of conversation
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Polish Document (Step 11 of 12)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Polish Document (Step 11 of 12)
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
- IF A: Read fully and follow: {advancedElicitationTask} with the current NFR content, process the enhanced quality attribute insights that come back, ask user if they accept the improvements, if yes update content then redisplay menu, if no keep original content then redisplay menu
|
||||
|
|
|
|||
|
|
@ -166,7 +166,9 @@ Present the polished document for review, then display menu:
|
|||
- Ask if they'd like to refine further, get other perspectives, or proceed
|
||||
- Present menu options naturally as part of conversation
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Complete PRD (Step 12 of 12)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Complete PRD (Step 12 of 12)
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
- IF A: Read fully and follow: {advancedElicitationTask} with the polished document, process the enhanced refinements that come back, ask user "Accept these polish improvements? (y/n)", if yes update content with improvements then redisplay menu, if no keep original polish then redisplay menu
|
||||
|
|
|
|||
|
|
@ -70,11 +70,13 @@ This file defines what makes a great BMAD PRD. Internalize this understanding -
|
|||
|
||||
### 2. Discover PRD to Edit
|
||||
|
||||
"**PRD Edit Workflow**
|
||||
<display>
|
||||
**PRD Edit Workflow**
|
||||
|
||||
Which PRD would you like to edit?
|
||||
|
||||
Please provide the path to the PRD file you want to edit."
|
||||
Please provide the path to the PRD file you want to edit.
|
||||
</display>
|
||||
|
||||
**Wait for user to provide PRD path.**
|
||||
|
||||
|
|
@ -97,7 +99,8 @@ ls -t {prd_folder_path}/validation-report-*.md 2>/dev/null | head -1
|
|||
**If validation report found:**
|
||||
|
||||
Display:
|
||||
"**📋 Found Validation Report**
|
||||
<display>
|
||||
**📋 Found Validation Report**
|
||||
|
||||
I found a validation report from {validation_date} in the PRD folder.
|
||||
|
||||
|
|
@ -105,7 +108,8 @@ This report contains findings from previous validation checks and can help guide
|
|||
|
||||
**Would you like to:**
|
||||
- **[U] Use validation report** - Load it to guide and prioritize edits
|
||||
- **[S] Skip** - Proceed with manual edit discovery"
|
||||
- **[S] Skip** - Proceed with manual edit discovery
|
||||
</display>
|
||||
|
||||
**Wait for user input.**
|
||||
|
||||
|
|
@ -125,11 +129,13 @@ This report contains findings from previous validation checks and can help guide
|
|||
|
||||
### 5. Ask About Validation Report
|
||||
|
||||
"**Do you have a validation report to guide edits?**
|
||||
<display>
|
||||
**Do you have a validation report to guide edits?**
|
||||
|
||||
If you've run the validation workflow on this PRD, I can use that report to guide improvements and prioritize changes.
|
||||
|
||||
Validation report path (or type 'none'):"
|
||||
Validation report path (or type 'none'):
|
||||
</display>
|
||||
|
||||
**Wait for user input.**
|
||||
|
||||
|
|
@ -144,7 +150,8 @@ Validation report path (or type 'none'):"
|
|||
|
||||
### 6. Discover Edit Requirements
|
||||
|
||||
"**What would you like to edit in this PRD?**
|
||||
<display>
|
||||
**What would you like to edit in this PRD?**
|
||||
|
||||
Please describe the changes you want to make. For example:
|
||||
- Fix specific issues (information density, implementation leakage, etc.)
|
||||
|
|
@ -154,7 +161,8 @@ Please describe the changes you want to make. For example:
|
|||
- General improvements
|
||||
- Other changes
|
||||
|
||||
**Describe your edit goals:**"
|
||||
**Describe your edit goals:**
|
||||
</display>
|
||||
|
||||
**Wait for user to describe their requirements.**
|
||||
|
||||
|
|
@ -181,25 +189,31 @@ Analyze the loaded PRD:
|
|||
|
||||
**IF validation report provided OR PRD is BMAD Standard/Variant:**
|
||||
|
||||
Display: "**Edit Requirements Understood**
|
||||
Display:
|
||||
<display>
|
||||
**Edit Requirements Understood**
|
||||
|
||||
**PRD Format:** {classification}
|
||||
{If validation report: "**Validation Guide:** Yes - will use validation report findings"}
|
||||
**Edit Goals:** {summary of user's requirements}
|
||||
|
||||
**Proceeding to deep review and analysis...**"
|
||||
**Proceeding to deep review and analysis...**
|
||||
</display>
|
||||
|
||||
Read fully and follow: next step (step-e-02-review.md)
|
||||
|
||||
**IF PRD is Legacy (Non-Standard) AND no validation report:**
|
||||
|
||||
Display: "**Format Detected:** Legacy PRD
|
||||
Display:
|
||||
<display>
|
||||
**Format Detected:** Legacy PRD
|
||||
|
||||
This PRD does not follow BMAD standard structure (only {count}/6 core sections present).
|
||||
|
||||
**Your edit goals:** {user's requirements}
|
||||
|
||||
**How would you like to proceed?**"
|
||||
**How would you like to proceed?**
|
||||
</display>
|
||||
|
||||
Present MENU OPTIONS below for user selection
|
||||
|
||||
|
|
|
|||
|
|
@ -128,7 +128,8 @@ Return conversion assessment with gap analysis and effort estimate."
|
|||
|
||||
Display:
|
||||
|
||||
"**Legacy PRD Conversion Assessment**
|
||||
<display>
|
||||
**Legacy PRD Conversion Assessment**
|
||||
|
||||
**Current PRD Structure:**
|
||||
- Core sections present: {count}/6
|
||||
|
|
@ -146,7 +147,8 @@ Display:
|
|||
**Recommendation:**
|
||||
{Based on effort and user goals, recommend best approach}
|
||||
|
||||
**How would you like to proceed?**"
|
||||
**How would you like to proceed?**
|
||||
</display>
|
||||
|
||||
### 4. Present MENU OPTIONS
|
||||
|
||||
|
|
@ -175,12 +177,15 @@ Store conversion decision for next step:
|
|||
- **Edit requirements:** [user's requirements from step e-01]
|
||||
- **Gap analysis:** [summary of gaps identified]
|
||||
|
||||
Display: "**Conversion Strategy Documented**
|
||||
Display:
|
||||
<display>
|
||||
**Conversion Strategy Documented**
|
||||
|
||||
Mode: {conversion mode}
|
||||
Edit goals: {summary}
|
||||
|
||||
**Proceeding to deep review...**"
|
||||
**Proceeding to deep review...**
|
||||
</display>
|
||||
|
||||
Read fully and follow: {nextStepFile} (step-e-02-review.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -146,7 +146,8 @@ Return detailed change plan with section breakdown."
|
|||
|
||||
Display:
|
||||
|
||||
"**Deep Review Complete - Change Plan**
|
||||
<display>
|
||||
**Deep Review Complete - Change Plan**
|
||||
|
||||
**PRD Analysis:**
|
||||
{Brief summary of PRD current state}
|
||||
|
|
@ -175,7 +176,8 @@ Display:
|
|||
2. Any sections I should add/remove/reprioritize?
|
||||
3. Any concerns before I proceed with edits?
|
||||
|
||||
**Review the plan and let me know if you'd like any adjustments.**"
|
||||
**Review the plan and let me know if you'd like any adjustments.**
|
||||
</display>
|
||||
|
||||
### 5. Get User Confirmation
|
||||
|
||||
|
|
@ -198,11 +200,14 @@ Store approved change plan for next step:
|
|||
- **Priority order:** Sequence to apply changes
|
||||
- **User confirmed:** Yes
|
||||
|
||||
Display: "**Change Plan Approved**
|
||||
Display:
|
||||
<display>
|
||||
**Change Plan Approved**
|
||||
|
||||
{Brief summary of approved plan}
|
||||
|
||||
**Proceeding to edit step...**"
|
||||
**Proceeding to edit step...**
|
||||
</display>
|
||||
|
||||
Read fully and follow: {nextStepFile} (step-e-03-edit.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -64,13 +64,16 @@ From step e-02, retrieve:
|
|||
- **Priority order:** Sequence to apply changes
|
||||
- **User requirements:** Edit goals from step e-01
|
||||
|
||||
Display: "**Starting PRD Edits**
|
||||
Display:
|
||||
<display>
|
||||
**Starting PRD Edits**
|
||||
|
||||
**Change Plan:** {summary}
|
||||
**Total Changes:** {count}
|
||||
**Estimated Effort:** {effort level}
|
||||
|
||||
**Proceeding with edits section by section...**"
|
||||
**Proceeding with edits section by section...**
|
||||
</display>
|
||||
|
||||
### 2. Attempt Sub-Process Edits (For Complex Changes)
|
||||
|
||||
|
|
@ -120,9 +123,11 @@ Apply changes and return updated section."
|
|||
- Verify changes applied correctly
|
||||
|
||||
**Display progress after each section:**
|
||||
"**Section Updated:** {section_name}
|
||||
<display>
|
||||
**Section Updated:** {section_name}
|
||||
Changes: {brief summary}
|
||||
{More sections remaining...}"
|
||||
{More sections remaining...}
|
||||
</display>
|
||||
|
||||
### 4. Handle Restructuring (If Needed)
|
||||
|
||||
|
|
@ -145,9 +150,12 @@ Changes: {brief summary}
|
|||
8. Functional Requirements
|
||||
9. Non-Functional Requirements
|
||||
|
||||
Display: "**PRD Restructured**
|
||||
Display:
|
||||
<display>
|
||||
**PRD Restructured**
|
||||
BMAD standard structure applied.
|
||||
{Sections added/reordered}"
|
||||
{Sections added/reordered}
|
||||
</display>
|
||||
|
||||
### 5. Update PRD Frontmatter
|
||||
|
||||
|
|
@ -194,7 +202,8 @@ editHistory:
|
|||
|
||||
Display:
|
||||
|
||||
"**PRD Edits Complete**
|
||||
<display>
|
||||
**PRD Edits Complete**
|
||||
|
||||
**Changes Applied:** {count} sections modified
|
||||
**PRD Updated:** {prd_file_path}
|
||||
|
|
@ -206,7 +215,8 @@ Display:
|
|||
- Use in downstream workflows (UX, Architecture)
|
||||
- Validation (if not yet validated)
|
||||
|
||||
**What would you like to do next?**"
|
||||
**What would you like to do next?**
|
||||
</display>
|
||||
|
||||
### 8. Present MENU OPTIONS
|
||||
|
||||
|
|
|
|||
|
|
@ -80,7 +80,8 @@ From step e-03 change execution, compile:
|
|||
|
||||
Display:
|
||||
|
||||
"**✓ PRD Edit Complete**
|
||||
<display>
|
||||
**✓ PRD Edit Complete**
|
||||
|
||||
**Updated PRD:** {prd_file_path}
|
||||
|
||||
|
|
@ -97,7 +98,8 @@ Display:
|
|||
- Validation to ensure quality
|
||||
- Production use
|
||||
|
||||
**What would you like to do next?**"
|
||||
**What would you like to do next?**
|
||||
</display>
|
||||
|
||||
### 3. Present MENU OPTIONS
|
||||
|
||||
|
|
@ -116,15 +118,21 @@ Display:
|
|||
#### Menu Handling Logic:
|
||||
|
||||
- **IF V (Run Full Validation):**
|
||||
- Display: "**Starting Validation Workflow**"
|
||||
- Display: "This will run all 13 validation checks on the updated PRD."
|
||||
- Display: "Preparing to validate: {prd_file_path}"
|
||||
- Display: "**Proceeding to validation...**"
|
||||
- Display:
|
||||
<display>
|
||||
**Starting Validation Workflow**
|
||||
|
||||
This will run all 13 validation checks on the updated PRD.
|
||||
|
||||
Preparing to validate: {prd_file_path}
|
||||
|
||||
**Proceeding to validation...**
|
||||
</display>
|
||||
- Read fully and follow: {validationWorkflow} (steps-v/step-v-01-discovery.md)
|
||||
- Note: This hands off to the validation workflow which will run its complete 13-step process
|
||||
|
||||
- **IF E (Edit More):**
|
||||
- Display: "**Additional Edits**"
|
||||
- <display>**Additional Edits**</display>
|
||||
- Ask: "What additional edits would you like to make?"
|
||||
- Accept input, then display: "**Returning to edit step...**"
|
||||
- Read fully and follow: step-e-03-edit.md again
|
||||
|
|
@ -134,12 +142,12 @@ Display:
|
|||
- Complete list of all changes made
|
||||
- Before/after comparison (key improvements)
|
||||
- Recommendations for next steps
|
||||
- Display: "**Edit Workflow Complete**"
|
||||
- <display>**Edit Workflow Complete**</display>
|
||||
- Exit
|
||||
|
||||
- **IF X (Exit):**
|
||||
- Display summary
|
||||
- Display: "**Edit Workflow Complete**"
|
||||
- <display>**Edit Workflow Complete**</display>
|
||||
- Exit
|
||||
|
||||
- **IF Any other:** Help user, then redisplay menu
|
||||
|
|
|
|||
|
|
@ -71,11 +71,14 @@ This file contains the BMAD PRD philosophy, standards, and validation criteria t
|
|||
- Use provided path
|
||||
|
||||
**If no PRD path provided:**
|
||||
"**PRD Validation Workflow**
|
||||
|
||||
<display>
|
||||
**PRD Validation Workflow**
|
||||
|
||||
Which PRD would you like to validate?
|
||||
|
||||
Please provide the path to the PRD file you want to validate."
|
||||
Please provide the path to the PRD file you want to validate.
|
||||
</display>
|
||||
|
||||
**Wait for user to provide PRD path.**
|
||||
|
||||
|
|
@ -112,7 +115,8 @@ For each document listed in `inputDocuments`:
|
|||
|
||||
### 6. Ask About Additional Reference Documents
|
||||
|
||||
"**I've loaded the following documents from your PRD frontmatter:**
|
||||
<display>
|
||||
**I've loaded the following documents from your PRD frontmatter:**
|
||||
|
||||
{list loaded documents with file names}
|
||||
|
||||
|
|
@ -124,7 +128,8 @@ These could include:
|
|||
- Standards or compliance documents
|
||||
- Competitive analysis or benchmarks
|
||||
|
||||
Please provide paths to any additional documents, or type 'none' to proceed."
|
||||
Please provide paths to any additional documents, or type 'none' to proceed.
|
||||
</display>
|
||||
|
||||
**Load any additional documents provided by user.**
|
||||
|
||||
|
|
@ -161,7 +166,8 @@ validationStatus: IN_PROGRESS
|
|||
|
||||
### 8. Present Discovery Summary
|
||||
|
||||
"**Setup Complete!**
|
||||
<display>
|
||||
**Setup Complete!**
|
||||
|
||||
**PRD to Validate:** {prd_path}
|
||||
|
||||
|
|
@ -173,11 +179,16 @@ validationStatus: IN_PROGRESS
|
|||
|
||||
**Validation Report:** {validationReportPath}
|
||||
|
||||
**Ready to begin validation.**"
|
||||
**Ready to begin validation.**
|
||||
</display>
|
||||
|
||||
### 9. Present MENU OPTIONS
|
||||
|
||||
Display: **Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Format Detection
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Format Detection
|
||||
</display>
|
||||
|
||||
#### EXECUTION RULES:
|
||||
|
||||
|
|
|
|||
|
|
@ -132,19 +132,27 @@ Append to validation report:
|
|||
|
||||
**IF format is BMAD Standard or BMAD Variant:**
|
||||
|
||||
Display: "**Format Detected:** {classification}
|
||||
Display:
|
||||
|
||||
Proceeding to systematic validation checks..."
|
||||
<display>
|
||||
**Format Detected:** {classification}
|
||||
|
||||
Proceeding to systematic validation checks...
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile} (step-v-03-density-validation.md)
|
||||
|
||||
**IF format is Non-Standard (< 3 core sections):**
|
||||
|
||||
Display: "**Format Detected:** Non-Standard PRD
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**Format Detected:** Non-Standard PRD
|
||||
|
||||
This PRD does not follow BMAD standard structure (only {count}/6 core sections present).
|
||||
|
||||
You have options:"
|
||||
You have options:
|
||||
</display>
|
||||
|
||||
Present MENU OPTIONS below for user selection
|
||||
|
||||
|
|
|
|||
|
|
@ -155,7 +155,8 @@ Append to validation report:
|
|||
|
||||
Display:
|
||||
|
||||
"**Parity Analysis Complete**
|
||||
<display>
|
||||
**Parity Analysis Complete**
|
||||
|
||||
Your PRD is missing {count} of 6 core BMAD PRD sections. The overall effort to reach BMAD standard is: **{effort level}**
|
||||
|
||||
|
|
@ -165,7 +166,8 @@ Your PRD is missing {count} of 6 core BMAD PRD sections. The overall effort to r
|
|||
**Recommendation:**
|
||||
{recommendation from analysis}
|
||||
|
||||
**How would you like to proceed?**"
|
||||
**How would you like to proceed?**
|
||||
</display>
|
||||
|
||||
### 5. Present MENU OPTIONS
|
||||
|
||||
|
|
|
|||
|
|
@ -142,11 +142,15 @@ Append to validation report:
|
|||
|
||||
### 5. Display Progress and Auto-Proceed
|
||||
|
||||
Display: "**Information Density Validation Complete**
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**Information Density Validation Complete**
|
||||
|
||||
Severity: {Critical/Warning/Pass}
|
||||
|
||||
**Proceeding to next validation check...**"
|
||||
**Proceeding to next validation check...**
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile} (step-v-04-brief-coverage-validation.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -72,9 +72,13 @@ Append to validation report:
|
|||
**Status:** N/A - No Product Brief was provided as input
|
||||
```
|
||||
|
||||
Display: "**Product Brief Coverage: Skipped** (No Product Brief provided)
|
||||
Display:
|
||||
|
||||
**Proceeding to next validation check...**"
|
||||
<display>
|
||||
**Product Brief Coverage: Skipped** (No Product Brief provided)
|
||||
|
||||
**Proceeding to next validation check...**
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile}
|
||||
|
||||
|
|
@ -180,11 +184,15 @@ Append to validation report:
|
|||
|
||||
### 6. Display Progress and Auto-Proceed
|
||||
|
||||
Display: "**Product Brief Coverage Validation Complete**
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**Product Brief Coverage Validation Complete**
|
||||
|
||||
Overall Coverage: {assessment}
|
||||
|
||||
**Proceeding to next validation check...**"
|
||||
**Proceeding to next validation check...**
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile} (step-v-05-measurability-validation.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -195,11 +195,15 @@ Append to validation report:
|
|||
|
||||
### 5. Display Progress and Auto-Proceed
|
||||
|
||||
Display: "**Measurability Validation Complete**
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**Measurability Validation Complete**
|
||||
|
||||
Total Violations: {count} ({severity})
|
||||
|
||||
**Proceeding to next validation check...**"
|
||||
**Proceeding to next validation check...**
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile} (step-v-06-traceability-validation.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -183,11 +183,15 @@ Append to validation report:
|
|||
|
||||
### 5. Display Progress and Auto-Proceed
|
||||
|
||||
Display: "**Traceability Validation Complete**
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**Traceability Validation Complete**
|
||||
|
||||
Total Issues: {count} ({severity})
|
||||
|
||||
**Proceeding to next validation check...**"
|
||||
**Proceeding to next validation check...**
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile} (step-v-07-implementation-leakage-validation.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -172,11 +172,15 @@ Append to validation report:
|
|||
|
||||
### 5. Display Progress and Auto-Proceed
|
||||
|
||||
Display: "**Implementation Leakage Validation Complete**
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**Implementation Leakage Validation Complete**
|
||||
|
||||
Total Violations: {count} ({severity})
|
||||
|
||||
**Proceeding to next validation check...**"
|
||||
**Proceeding to next validation check...**
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile} (step-v-08-domain-compliance-validation.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -155,11 +155,15 @@ Append to validation report:
|
|||
**Note:** This PRD is for a standard domain without regulatory compliance requirements.
|
||||
```
|
||||
|
||||
Display: "**Domain Compliance Validation Skipped**
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**Domain Compliance Validation Skipped**
|
||||
|
||||
Domain: {domain} (low complexity)
|
||||
|
||||
**Proceeding to next validation check...**"
|
||||
**Proceeding to next validation check...**
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile}
|
||||
|
||||
|
|
@ -206,12 +210,16 @@ Append to validation report:
|
|||
|
||||
### 7. Display Progress and Auto-Proceed
|
||||
|
||||
Display: "**Domain Compliance Validation Complete**
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**Domain Compliance Validation Complete**
|
||||
|
||||
Domain: {domain} ({complexity})
|
||||
Compliance Status: {status}
|
||||
|
||||
**Proceeding to next validation check...**"
|
||||
**Proceeding to next validation check...**
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile} (step-v-09-project-type-validation.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -227,12 +227,16 @@ Append to validation report:
|
|||
|
||||
### 7. Display Progress and Auto-Proceed
|
||||
|
||||
Display: "**Project-Type Compliance Validation Complete**
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**Project-Type Compliance Validation Complete**
|
||||
|
||||
Project Type: {projectType}
|
||||
Compliance: {score}%
|
||||
|
||||
**Proceeding to next validation check...**"
|
||||
**Proceeding to next validation check...**
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile} (step-v-10-smart-validation.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -173,11 +173,15 @@ Append to validation report:
|
|||
|
||||
### 5. Display Progress and Auto-Proceed
|
||||
|
||||
Display: "**SMART Requirements Validation Complete**
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**SMART Requirements Validation Complete**
|
||||
|
||||
FR Quality: {percentage}% with acceptable scores ({severity})
|
||||
|
||||
**Proceeding to next validation check...**"
|
||||
**Proceeding to next validation check...**
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile} (step-v-11-holistic-quality-validation.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -226,11 +226,15 @@ Append to validation report:
|
|||
|
||||
### 4. Display Progress and Auto-Proceed
|
||||
|
||||
Display: "**Holistic Quality Assessment Complete**
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**Holistic Quality Assessment Complete**
|
||||
|
||||
Overall Rating: {rating}/5 - {label}
|
||||
|
||||
**Proceeding to final validation checks...**"
|
||||
**Proceeding to final validation checks...**
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile} (step-v-12-completeness-validation.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -206,11 +206,15 @@ Append to validation report:
|
|||
|
||||
### 4. Display Progress and Auto-Proceed
|
||||
|
||||
Display: "**Completeness Validation Complete**
|
||||
Display:
|
||||
|
||||
<display>
|
||||
**Completeness Validation Complete**
|
||||
|
||||
Overall Completeness: {percentage}% ({severity})
|
||||
|
||||
**Proceeding to final step...**"
|
||||
**Proceeding to final step...**
|
||||
</display>
|
||||
|
||||
Without delay, read fully and follow: {nextStepFile} (step-v-13-report-complete.md)
|
||||
|
||||
|
|
|
|||
|
|
@ -125,7 +125,8 @@ overallStatus: '{Pass/Warning/Critical based on all findings}'
|
|||
|
||||
Display:
|
||||
|
||||
"**✓ PRD Validation Complete**
|
||||
<display>
|
||||
**✓ PRD Validation Complete**
|
||||
|
||||
**Overall Status:** {Pass/Warning/Critical}
|
||||
|
||||
|
|
@ -154,7 +155,8 @@ Display:
|
|||
- Warning: "PRD is usable but has issues that should be addressed. Review warnings and improve where needed."
|
||||
- Critical: "PRD has significant issues that should be fixed before use. Focus on critical issues above."}
|
||||
|
||||
**What would you like to do next?**"
|
||||
**What would you like to do next?**
|
||||
</display>
|
||||
|
||||
### 5. Present MENU OPTIONS
|
||||
|
||||
|
|
@ -195,8 +197,12 @@ Display:
|
|||
- Return to menu
|
||||
|
||||
- **IF X (Exit):**
|
||||
- Display: "**Validation Report Saved:** {validationReportPath}"
|
||||
- Display: "**Summary:** {overall status} - {recommendation}"
|
||||
- Display:
|
||||
<display>
|
||||
**Validation Report Saved:** {validationReportPath}
|
||||
|
||||
**Summary:** {overall status} - {recommendation}
|
||||
</display>
|
||||
- PRD Validation complete. Read fully and follow: `_bmad/core/tasks/bmad-help.md` with argument `Validate PRD`.
|
||||
|
||||
- **IF Any other:** Help user, then redisplay menu
|
||||
|
|
|
|||
|
|
@ -40,30 +40,53 @@ Determine which mode to invoke based on:
|
|||
3. **Menu Selection (if unclear):**
|
||||
|
||||
If mode cannot be determined from invocation:
|
||||
"**PRD Workflow - Select Mode:**
|
||||
|
||||
<display>
|
||||
**PRD Workflow - Select Mode:**
|
||||
|
||||
**[C] Create** - Create a new PRD from scratch
|
||||
**[V] Validate** - Validate an existing PRD against BMAD standards
|
||||
**[E] Edit** - Improve an existing PRD
|
||||
|
||||
Which mode would you like?"
|
||||
Which mode would you like?
|
||||
</display>
|
||||
|
||||
Wait for user selection.
|
||||
|
||||
### Route to Appropriate Workflow
|
||||
|
||||
**IF Create Mode:**
|
||||
"**Create Mode: Creating a new PRD from scratch.**"
|
||||
|
||||
<display>
|
||||
**Create Mode: Creating a new PRD from scratch.**
|
||||
</display>
|
||||
|
||||
Read fully and follow: `{nextStep}` (steps-c/step-01-init.md)
|
||||
|
||||
**IF Validate Mode:**
|
||||
"**Validate Mode: Validating an existing PRD against BMAD standards.**"
|
||||
Prompt for PRD path: "Which PRD would you like to validate? Please provide the path to the PRD.md file."
|
||||
|
||||
<display>
|
||||
**Validate Mode: Validating an existing PRD against BMAD standards.**
|
||||
</display>
|
||||
|
||||
Prompt for PRD path:
|
||||
|
||||
<display>
|
||||
Which PRD would you like to validate? Please provide the path to the PRD.md file.
|
||||
</display>
|
||||
Then read fully and follow: `{validateWorkflow}` (steps-v/step-v-01-discovery.md)
|
||||
|
||||
**IF Edit Mode:**
|
||||
"**Edit Mode: Improving an existing PRD.**"
|
||||
Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file."
|
||||
|
||||
<display>
|
||||
**Edit Mode: Improving an existing PRD.**
|
||||
</display>
|
||||
|
||||
Prompt for PRD path:
|
||||
|
||||
<display>
|
||||
Which PRD would you like to edit? Please provide the path to the PRD.md file.
|
||||
</display>
|
||||
Then read fully and follow: `{editWorkflow}` (steps-e/step-e-01-discovery.md)
|
||||
|
||||
---
|
||||
|
|
@ -113,13 +136,15 @@ This uses **step-file architecture** for disciplined execution:
|
|||
|
||||
**If mode is still unclear, ask user:**
|
||||
|
||||
"**PRD Workflow - Select Mode:**
|
||||
<display>
|
||||
**PRD Workflow - Select Mode:**
|
||||
|
||||
**[C] Create** - Create a new PRD from scratch
|
||||
**[V] Validate** - Validate an existing PRD against BMAD standards
|
||||
**[E] Edit** - Improve an existing PRD
|
||||
|
||||
Which mode would you like?"
|
||||
Which mode would you like?
|
||||
</display>
|
||||
|
||||
Wait for user selection.
|
||||
|
||||
|
|
@ -136,15 +161,37 @@ Load and read full config from {main_config} and resolve:
|
|||
### 3. Route to Appropriate Workflow
|
||||
|
||||
**IF mode == create:**
|
||||
"**Create Mode: Creating a new PRD from scratch.**"
|
||||
|
||||
<display>
|
||||
**Create Mode: Creating a new PRD from scratch.**
|
||||
</display>
|
||||
|
||||
Read fully and follow: `{nextStep}` (steps-c/step-01-init.md)
|
||||
|
||||
**IF mode == validate:**
|
||||
"**Validate Mode: Validating an existing PRD against BMAD standards.**"
|
||||
Prompt for PRD path: "Which PRD would you like to validate? Please provide the path to the PRD.md file."
|
||||
|
||||
<display>
|
||||
**Validate Mode: Validating an existing PRD against BMAD standards.**
|
||||
</display>
|
||||
|
||||
Prompt for PRD path:
|
||||
|
||||
<display>
|
||||
Which PRD would you like to validate? Please provide the path to the PRD.md file.
|
||||
</display>
|
||||
|
||||
Then read fully and follow: `{validateWorkflow}` (steps-v/step-v-01-discovery.md)
|
||||
|
||||
**IF mode == edit:**
|
||||
"**Edit Mode: Improving an existing PRD.**"
|
||||
Prompt for PRD path: "Which PRD would you like to edit? Please provide the path to the PRD.md file."
|
||||
|
||||
<display>
|
||||
**Edit Mode: Improving an existing PRD.**
|
||||
</display>
|
||||
|
||||
Prompt for PRD path:
|
||||
|
||||
<display>
|
||||
Which PRD would you like to edit? Please provide the path to the PRD.md file.
|
||||
</display>
|
||||
|
||||
Then read fully and follow: `{editWorkflow}` (steps-e/step-e-01-discovery.md)
|
||||
|
|
|
|||
|
|
@ -94,7 +94,8 @@ Complete setup and report to user:
|
|||
|
||||
**Input Documents Discovered:**
|
||||
Report what was found:
|
||||
"Welcome {{user_name}}! I've set up your UX design workspace for {{project_name}}.
|
||||
<display>
|
||||
Welcome {{user_name}}! I've set up your UX design workspace for {{project_name}}.
|
||||
|
||||
**Documents Found:**
|
||||
|
||||
|
|
@ -106,7 +107,8 @@ Report what was found:
|
|||
|
||||
Do you have any other documents you'd like me to include, or shall we continue to the next step?
|
||||
|
||||
[C] Continue to UX discovery"
|
||||
[C] Continue to UX discovery
|
||||
</display>
|
||||
|
||||
## NEXT STEP:
|
||||
|
||||
|
|
|
|||
|
|
@ -52,7 +52,8 @@ Reload the context documents listed in `inputDocuments`:
|
|||
### 3. Summarize Current Progress
|
||||
|
||||
Welcome the user back and provide context:
|
||||
"Welcome back {{user_name}}! I'm resuming our UX design collaboration for {{project_name}}.
|
||||
<display>
|
||||
Welcome back {{user_name}}! I'm resuming our UX design collaboration for {{project_name}}.
|
||||
|
||||
**Current Progress:**
|
||||
|
||||
|
|
@ -66,7 +67,8 @@ Welcome the user back and provide context:
|
|||
- Current UX design document is ready with all completed sections
|
||||
- Ready to continue from where we left off
|
||||
|
||||
Does this look right, or do you want to make any adjustments before we proceed?"
|
||||
Does this look right, or do you want to make any adjustments before we proceed?
|
||||
</display>
|
||||
|
||||
### 4. Determine Next Step
|
||||
|
||||
|
|
@ -81,9 +83,11 @@ Based on `lastStep` value, determine which step to load next:
|
|||
### 5. Present Continuation Options
|
||||
|
||||
After presenting current progress, ask:
|
||||
"Ready to continue with Step {nextStepNumber}: {nextStepTitle}?
|
||||
<display>
|
||||
Ready to continue with Step {nextStepNumber}: {nextStepTitle}?
|
||||
|
||||
[C] Continue to Step {nextStepNumber}"
|
||||
[C] Continue to Step {nextStepNumber}
|
||||
</display>
|
||||
|
||||
## SUCCESS METRICS:
|
||||
|
||||
|
|
@ -106,7 +110,8 @@ After presenting current progress, ask:
|
|||
## WORKFLOW ALREADY COMPLETE?
|
||||
|
||||
If `lastStep` indicates the final step is completed:
|
||||
"Great news! It looks like we've already completed the UX design workflow for {{project_name}}.
|
||||
<display>
|
||||
Great news! It looks like we've already completed the UX design workflow for {{project_name}}.
|
||||
|
||||
The final UX design specification is ready at {output_folder}/ux-design-specification.md with all sections completed through step {finalStepNumber}.
|
||||
|
||||
|
|
@ -118,7 +123,8 @@ Would you like me to:
|
|||
- Suggest next workflow steps (like wireframe generation or architecture)
|
||||
- Start a new UX design revision
|
||||
|
||||
What would be most helpful?"
|
||||
What would be most helpful?
|
||||
</display>
|
||||
|
||||
## NEXT STEP:
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,8 @@ Understand the project context, target users, and what makes this product specia
|
|||
### 1. Review Loaded Context
|
||||
|
||||
Start by analyzing what we know from the loaded documents:
|
||||
"Based on the project documentation we have loaded, let me confirm what I'm understanding about {{project_name}}.
|
||||
<display>
|
||||
Based on the project documentation we have loaded, let me confirm what I'm understanding about {{project_name}}.
|
||||
|
||||
**From the documents:**
|
||||
{summary of key insights from loaded PRD, briefs, and other context documents}
|
||||
|
|
@ -62,12 +63,14 @@ Start by analyzing what we know from the loaded documents:
|
|||
**Key Features/Goals:**
|
||||
{summary of main features and goals from loaded documents}
|
||||
|
||||
Does this match your understanding? Are there any corrections or additions you'd like to make?"
|
||||
Does this match your understanding? Are there any corrections or additions you'd like to make?
|
||||
</display>
|
||||
|
||||
### 2. Fill Context Gaps (If no documents or gaps exist)
|
||||
|
||||
If no documents were loaded or key information is missing:
|
||||
"Since we don't have complete documentation, let's start with the essentials:
|
||||
<display>
|
||||
Since we don't have complete documentation, let's start with the essentials:
|
||||
|
||||
**What are you building?** (Describe your product in 1-2 sentences)
|
||||
|
||||
|
|
@ -75,12 +78,14 @@ If no documents were loaded or key information is missing:
|
|||
|
||||
**What makes this special or different?** (What's the unique value proposition?)
|
||||
|
||||
**What's the main thing users will do with this?** (Core user action or goal)"
|
||||
**What's the main thing users will do with this?** (Core user action or goal)
|
||||
</display>
|
||||
|
||||
### 3. Explore User Context Deeper
|
||||
|
||||
Dive into user understanding:
|
||||
"Let me understand your users better to inform the UX design:
|
||||
<display>
|
||||
Let me understand your users better to inform the UX design:
|
||||
|
||||
**User Context Questions:**
|
||||
|
||||
|
|
@ -89,12 +94,14 @@ Dive into user understanding:
|
|||
- What would make them say 'this is exactly what I needed'?
|
||||
- How tech-savvy are your target users?
|
||||
- What devices will they use most?
|
||||
- When/where will they use this product?"
|
||||
- When/where will they use this product?
|
||||
</display>
|
||||
|
||||
### 4. Identify UX Design Challenges
|
||||
|
||||
Surface the key UX challenges to address:
|
||||
"From what we've discussed, I'm seeing some key UX design considerations:
|
||||
<display>
|
||||
From what we've discussed, I'm seeing some key UX design considerations:
|
||||
|
||||
**Design Challenges:**
|
||||
|
||||
|
|
@ -107,7 +114,8 @@ Surface the key UX challenges to address:
|
|||
- [Identify 2-3 areas where great UX could create competitive advantage]
|
||||
- [Note any opportunities for innovative UX patterns]
|
||||
|
||||
Does this capture the key UX considerations we need to address?"
|
||||
Does this capture the key UX considerations we need to address?
|
||||
</display>
|
||||
|
||||
### 5. Generate Project Understanding Content
|
||||
|
||||
|
|
@ -140,14 +148,16 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
### 6. Present Content and Menu
|
||||
|
||||
Show the generated project understanding content and present choices:
|
||||
"I've documented our understanding of {{project_name}} from a UX perspective. This will guide all our design decisions moving forward.
|
||||
<display>
|
||||
I've documented our understanding of {{project_name}} from a UX perspective. This will guide all our design decisions moving forward.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
[Show the complete markdown content from step 5]
|
||||
|
||||
**What would you like to do?**
|
||||
[C] Continue - Save this to the document and move to core experience definition"
|
||||
[C] Continue - Save this to the document and move to core experience definition
|
||||
</display>
|
||||
|
||||
### 7. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,8 @@ Define the core user experience, platform requirements, and what makes the inter
|
|||
### 1. Define Core User Action
|
||||
|
||||
Start by identifying the most important user interaction:
|
||||
"Now let's dig into the heart of the user experience for {{project_name}}.
|
||||
<display>
|
||||
Now let's dig into the heart of the user experience for {{project_name}}.
|
||||
|
||||
**Core Experience Questions:**
|
||||
|
||||
|
|
@ -60,12 +61,14 @@ Start by identifying the most important user interaction:
|
|||
- What should be completely effortless for users?
|
||||
- If we nail one interaction, everything else follows - what is it?
|
||||
|
||||
Think about the core loop or primary action that defines your product's value."
|
||||
Think about the core loop or primary action that defines your product's value.
|
||||
</display>
|
||||
|
||||
### 2. Explore Platform Requirements
|
||||
|
||||
Determine where and how users will interact:
|
||||
"Let's define the platform context for {{project_name}}:
|
||||
<display>
|
||||
Let's define the platform context for {{project_name}}:
|
||||
|
||||
**Platform Questions:**
|
||||
|
||||
|
|
@ -73,34 +76,40 @@ Determine where and how users will interact:
|
|||
- Will this be primarily touch-based or mouse/keyboard?
|
||||
- Any specific platform requirements or constraints?
|
||||
- Do we need to consider offline functionality?
|
||||
- Any device-specific capabilities we should leverage?"
|
||||
- Any device-specific capabilities we should leverage?
|
||||
</display>
|
||||
|
||||
### 3. Identify Effortless Interactions
|
||||
|
||||
Surface what should feel magical or completely seamless:
|
||||
"**Effortless Experience Design:**
|
||||
<display>
|
||||
**Effortless Experience Design:**
|
||||
|
||||
- What user actions should feel completely natural and require zero thought?
|
||||
- Where do users currently struggle with similar products?
|
||||
- What interaction, if made effortless, would create delight?
|
||||
- What should happen automatically without user intervention?
|
||||
- Where can we eliminate steps that competitors require?"
|
||||
- Where can we eliminate steps that competitors require?
|
||||
</display>
|
||||
|
||||
### 4. Define Critical Success Moments
|
||||
|
||||
Identify the moments that determine success or failure:
|
||||
"**Critical Success Moments:**
|
||||
<display>
|
||||
**Critical Success Moments:**
|
||||
|
||||
- What's the moment where users realize 'this is better'?
|
||||
- When does the user feel successful or accomplished?
|
||||
- What interaction, if failed, would ruin the experience?
|
||||
- What are the make-or-break user flows?
|
||||
- Where does first-time user success happen?"
|
||||
- Where does first-time user success happen?
|
||||
</display>
|
||||
|
||||
### 5. Synthesize Experience Principles
|
||||
|
||||
Extract guiding principles from the conversation:
|
||||
"Based on our discussion, I'm hearing these core experience principles for {{project_name}}:
|
||||
<display>
|
||||
Based on our discussion, I'm hearing these core experience principles for {{project_name}}:
|
||||
|
||||
**Experience Principles:**
|
||||
|
||||
|
|
@ -109,7 +118,8 @@ Extract guiding principles from the conversation:
|
|||
- [Principle 3 based on platform considerations]
|
||||
- [Principle 4 based on critical success moments]
|
||||
|
||||
These principles will guide all our UX decisions. Do these capture what's most important?"
|
||||
These principles will guide all our UX decisions. Do these capture what's most important?
|
||||
</display>
|
||||
|
||||
### 6. Generate Core Experience Content
|
||||
|
||||
|
|
@ -146,7 +156,8 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
### 7. Present Content and Menu
|
||||
|
||||
Show the generated core experience content and present choices:
|
||||
"I've defined the core user experience for {{project_name}} based on our conversation. This establishes the foundation for all our UX design decisions.
|
||||
<display>
|
||||
I've defined the core user experience for {{project_name}} based on our conversation. This establishes the foundation for all our UX design decisions.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -155,7 +166,8 @@ Show the generated core experience content and present choices:
|
|||
**What would you like to do?**
|
||||
[A] Advanced Elicitation - Let's refine the core experience definition
|
||||
[P] Party Mode - Bring different perspectives on the user experience
|
||||
[C] Continue - Save this to the document and move to emotional response definition"
|
||||
[C] Continue - Save this to the document and move to emotional response definition
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,8 @@ Define the desired emotional responses users should feel when using the product.
|
|||
### 1. Explore Core Emotional Goals
|
||||
|
||||
Start by understanding the emotional objectives:
|
||||
"Now let's think about how {{project_name}} should make users feel.
|
||||
<display>
|
||||
Now let's think about how {{project_name}} should make users feel.
|
||||
|
||||
**Emotional Response Questions:**
|
||||
|
||||
|
|
@ -60,23 +61,27 @@ Start by understanding the emotional objectives:
|
|||
- How should users feel after accomplishing their primary goal?
|
||||
- What feeling differentiates this from competitors?
|
||||
|
||||
Common emotional goals: Empowered and in control? Delighted and surprised? Efficient and productive? Creative and inspired? Calm and focused? Connected and engaged?"
|
||||
Common emotional goals: Empowered and in control? Delighted and surprised? Efficient and productive? Creative and inspired? Calm and focused? Connected and engaged?
|
||||
</display>
|
||||
|
||||
### 2. Identify Emotional Journey Mapping
|
||||
|
||||
Explore feelings at different stages:
|
||||
"**Emotional Journey Considerations:**
|
||||
<display>
|
||||
**Emotional Journey Considerations:**
|
||||
|
||||
- How should users feel when they first discover the product?
|
||||
- What emotion during the core experience/action?
|
||||
- How should they feel after completing their task?
|
||||
- What if something goes wrong - what emotional response do we want?
|
||||
- How should they feel when returning to use it again?"
|
||||
- How should they feel when returning to use it again?
|
||||
</display>
|
||||
|
||||
### 3. Define Micro-Emotions
|
||||
|
||||
Surface subtle but important emotional states:
|
||||
"**Micro-Emotions to Consider:**
|
||||
<display>
|
||||
**Micro-Emotions to Consider:**
|
||||
|
||||
- Confidence vs. Confusion
|
||||
- Trust vs. Skepticism
|
||||
|
|
@ -85,12 +90,14 @@ Surface subtle but important emotional states:
|
|||
- Delight vs. Satisfaction
|
||||
- Belonging vs. Isolation
|
||||
|
||||
Which of these emotional states are most critical for your product's success?"
|
||||
Which of these emotional states are most critical for your product's success?
|
||||
</display>
|
||||
|
||||
### 4. Connect Emotions to UX Decisions
|
||||
|
||||
Link feelings to design implications:
|
||||
"**Design Implications:**
|
||||
<display>
|
||||
**Design Implications:**
|
||||
|
||||
- If we want users to feel [emotional state], what UX choices support this?
|
||||
- What interactions might create negative emotions we want to avoid?
|
||||
|
|
@ -101,18 +108,21 @@ Link feelings to design implications:
|
|||
|
||||
- [Emotion 1] → [UX design approach]
|
||||
- [Emotion 2] → [UX design approach]
|
||||
- [Emotion 3] → [UX design approach]"
|
||||
- [Emotion 3] → [UX design approach]
|
||||
</display>
|
||||
|
||||
### 5. Validate Emotional Goals
|
||||
|
||||
Check if emotional goals align with product vision:
|
||||
"Let me make sure I understand the emotional vision for {{project_name}}:
|
||||
<display>
|
||||
Let me make sure I understand the emotional vision for {{project_name}}:
|
||||
|
||||
**Primary Emotional Goal:** [Summarize main emotional response]
|
||||
**Secondary Feelings:** [List supporting emotional states]
|
||||
**Emotions to Avoid:** [List negative emotions to prevent]
|
||||
|
||||
Does this capture the emotional experience you want to create? Any adjustments needed?"
|
||||
Does this capture the emotional experience you want to create? Any adjustments needed?
|
||||
</display>
|
||||
|
||||
### 6. Generate Emotional Response Content
|
||||
|
||||
|
|
@ -149,7 +159,8 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
### 7. Present Content and Menu
|
||||
|
||||
Show the generated emotional response content and present choices:
|
||||
"I've defined the desired emotional responses for {{project_name}}. These emotional goals will guide our design decisions to create the right user experience.
|
||||
<display>
|
||||
I've defined the desired emotional responses for {{project_name}}. These emotional goals will guide our design decisions to create the right user experience.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -158,7 +169,8 @@ Show the generated emotional response content and present choices:
|
|||
**What would you like to do?**
|
||||
[A] Advanced Elicitation - Let's refine the emotional response definition
|
||||
[P] Party Mode - Bring different perspectives on user emotional needs
|
||||
[C] Continue - Save this to the document and move to inspiration analysis"
|
||||
[C] Continue - Save this to the document and move to inspiration analysis
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,8 @@ Analyze inspiring products and UX patterns to inform design decisions for the cu
|
|||
### 1. Identify User's Favorite Apps
|
||||
|
||||
Start by gathering inspiration sources:
|
||||
"Let's learn from products your users already love and use regularly.
|
||||
<display>
|
||||
Let's learn from products your users already love and use regularly.
|
||||
|
||||
**Inspiration Questions:**
|
||||
|
||||
|
|
@ -60,12 +61,14 @@ Start by gathering inspiration sources:
|
|||
- What makes the experience compelling or delightful?
|
||||
- What keeps users coming back to these apps?
|
||||
|
||||
Think about apps in your category or even unrelated products that have great UX."
|
||||
Think about apps in your category or even unrelated products that have great UX.
|
||||
</display>
|
||||
|
||||
### 2. Analyze UX Patterns and Principles
|
||||
|
||||
Break down what makes these apps successful:
|
||||
"For each inspiring app, let's analyze their UX success:
|
||||
<display>
|
||||
For each inspiring app, let's analyze their UX success:
|
||||
|
||||
**For [App Name]:**
|
||||
|
||||
|
|
@ -74,12 +77,14 @@ Break down what makes these apps successful:
|
|||
- How do they handle navigation and information hierarchy?
|
||||
- What are their most innovative or delightful interactions?
|
||||
- What visual design choices support the user experience?
|
||||
- How do they handle errors or edge cases?"
|
||||
- How do they handle errors or edge cases?
|
||||
</display>
|
||||
|
||||
### 3. Extract Transferable Patterns
|
||||
|
||||
Identify patterns that could apply to your project:
|
||||
"**Transferable UX Patterns:**
|
||||
<display>
|
||||
**Transferable UX Patterns:**
|
||||
Looking across these inspiring apps, I see patterns we could adapt:
|
||||
|
||||
**Navigation Patterns:**
|
||||
|
|
@ -97,24 +102,28 @@ Looking across these inspiring apps, I see patterns we could adapt:
|
|||
- [Pattern 1] - supports your [emotional goal]
|
||||
- [Pattern 2] - aligns with your [platform requirements]
|
||||
|
||||
Which of these patterns resonate most for your product?"
|
||||
Which of these patterns resonate most for your product?
|
||||
</display>
|
||||
|
||||
### 4. Identify Anti-Patterns to Avoid
|
||||
|
||||
Surface what not to do based on analysis:
|
||||
"**UX Anti-Patterns to Avoid:**
|
||||
<display>
|
||||
**UX Anti-Patterns to Avoid:**
|
||||
From analyzing both successes and failures in your space, here are patterns to avoid:
|
||||
|
||||
- [Anti-pattern 1] - users find this confusing/frustrating
|
||||
- [Anti-pattern 2] - this creates unnecessary friction
|
||||
- [Anti-pattern 3] - doesn't align with your [emotional goals]
|
||||
|
||||
Learning from others' mistakes is as important as learning from their successes."
|
||||
Learning from others' mistakes is as important as learning from their successes.
|
||||
</display>
|
||||
|
||||
### 5. Define Design Inspiration Strategy
|
||||
|
||||
Create a clear strategy for using this inspiration:
|
||||
"**Design Inspiration Strategy:**
|
||||
<display>
|
||||
**Design Inspiration Strategy:**
|
||||
|
||||
**What to Adopt:**
|
||||
|
||||
|
|
@ -131,7 +140,8 @@ Create a clear strategy for using this inspiration:
|
|||
- [Specific anti-pattern] - conflicts with [your goals]
|
||||
- [Specific anti-pattern] - doesn't fit [your platform]
|
||||
|
||||
This strategy will guide our design decisions while keeping {{project_name}} unique."
|
||||
This strategy will guide our design decisions while keeping {{project_name}} unique.
|
||||
</display>
|
||||
|
||||
### 6. Generate Inspiration Analysis Content
|
||||
|
||||
|
|
@ -164,7 +174,8 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
### 7. Present Content and Menu
|
||||
|
||||
Show the generated inspiration analysis content and present choices:
|
||||
"I've analyzed inspiring UX patterns and products to inform our design strategy for {{project_name}}. This gives us a solid foundation of proven patterns to build upon.
|
||||
<display>
|
||||
I've analyzed inspiring UX patterns and products to inform our design strategy for {{project_name}}. This gives us a solid foundation of proven patterns to build upon.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -173,7 +184,8 @@ Show the generated inspiration analysis content and present choices:
|
|||
**What would you like to do?**
|
||||
[A] Advanced Elicitation - Let's deepen our UX pattern analysis
|
||||
[P] Party Mode - Bring different perspectives on inspiration sources
|
||||
[C] Continue - Save this to the document and move to design system choice"
|
||||
[C] Continue - Save this to the document and move to design system choice
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,8 @@ Choose appropriate design system approach based on project requirements and cons
|
|||
### 1. Present Design System Options
|
||||
|
||||
Educate about design system approaches:
|
||||
"For {{project_name}}, we need to choose a design system foundation. Think of design systems like LEGO blocks for UI - they provide proven components and patterns, ensuring consistency and speeding development.
|
||||
<display>
|
||||
For {{project_name}}, we need to choose a design system foundation. Think of design systems like LEGO blocks for UI - they provide proven components and patterns, ensuring consistency and speeding development.
|
||||
|
||||
**Design System Approaches:**
|
||||
|
||||
|
|
@ -76,12 +77,14 @@ Educate about design system approaches:
|
|||
- Moderate learning curve
|
||||
- Good balance of speed and uniqueness
|
||||
|
||||
Which direction feels right for your project?"
|
||||
Which direction feels right for your project?
|
||||
</display>
|
||||
|
||||
### 2. Analyze Project Requirements
|
||||
|
||||
Guide decision based on project context:
|
||||
"**Let's consider your specific needs:**
|
||||
<display>
|
||||
**Let's consider your specific needs:**
|
||||
|
||||
**Based on our previous conversations:**
|
||||
|
||||
|
|
@ -97,12 +100,14 @@ Guide decision based on project context:
|
|||
- Brand guidelines or existing visual identity
|
||||
- Team's design expertise
|
||||
- Long-term maintenance considerations
|
||||
- Integration requirements with existing systems"
|
||||
- Integration requirements with existing systems
|
||||
</display>
|
||||
|
||||
### 3. Explore Specific Design System Options
|
||||
|
||||
Dive deeper into relevant options:
|
||||
"**Recommended Options Based on Your Needs:**
|
||||
<display>
|
||||
**Recommended Options Based on Your Needs:**
|
||||
|
||||
**For [Your Platform Type]:**
|
||||
|
||||
|
|
@ -117,12 +122,14 @@ Dive deeper into relevant options:
|
|||
- Customization capabilities
|
||||
- Accessibility compliance
|
||||
- Performance characteristics
|
||||
- Learning curve for your team"
|
||||
- Learning curve for your team
|
||||
</display>
|
||||
|
||||
### 4. Facilitate Decision Process
|
||||
|
||||
Help user make informed choice:
|
||||
"**Decision Framework:**
|
||||
<display>
|
||||
**Decision Framework:**
|
||||
|
||||
1. What's most important: Speed, uniqueness, or balance?
|
||||
2. How much design expertise does your team have?
|
||||
|
|
@ -130,12 +137,14 @@ Help user make informed choice:
|
|||
4. What's your timeline and budget?
|
||||
5. Long-term maintenance needs?
|
||||
|
||||
Let's evaluate options based on your answers to these questions."
|
||||
Let's evaluate options based on your answers to these questions.
|
||||
</display>
|
||||
|
||||
### 5. Finalize Design System Choice
|
||||
|
||||
Confirm and document the decision:
|
||||
"Based on our analysis, I recommend [Design System Choice] for {{project_name}}.
|
||||
<display>
|
||||
Based on our analysis, I recommend [Design System Choice] for {{project_name}}.
|
||||
|
||||
**Rationale:**
|
||||
|
||||
|
|
@ -149,7 +158,8 @@ Confirm and document the decision:
|
|||
- Define component strategy for custom components needed
|
||||
- Establish design tokens and patterns
|
||||
|
||||
Does this design system choice feel right to you?"
|
||||
Does this design system choice feel right to you?
|
||||
</display>
|
||||
|
||||
### 6. Generate Design System Content
|
||||
|
||||
|
|
@ -182,7 +192,8 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
### 7. Present Content and Menu
|
||||
|
||||
Show the generated design system content and present choices:
|
||||
"I've documented our design system choice for {{project_name}}. This foundation will ensure consistency and speed up development.
|
||||
<display>
|
||||
I've documented our design system choice for {{project_name}}. This foundation will ensure consistency and speed up development.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -192,6 +203,7 @@ Show the generated design system content and present choices:
|
|||
[A] Advanced Elicitation - Let's refine our design system decision
|
||||
[P] Party Mode - Bring technical perspectives on design systems
|
||||
[C] Continue - Save this to the document and move to defining experience
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,8 @@ Define the core interaction that, if nailed, makes everything else follow in the
|
|||
### 1. Identify the Defining Experience
|
||||
|
||||
Focus on the core interaction:
|
||||
"Every successful product has a defining experience - the core interaction that, if we nail it, everything else follows.
|
||||
<display>
|
||||
Every successful product has a defining experience - the core interaction that, if we nail it, everything else follows.
|
||||
|
||||
**Think about these famous examples:**
|
||||
|
||||
|
|
@ -63,12 +64,14 @@ Focus on the core interaction:
|
|||
**For {{project_name}}:**
|
||||
What's the core action that users will describe to their friends?
|
||||
What's the interaction that makes users feel successful?
|
||||
If we get ONE thing perfectly right, what should it be?"
|
||||
If we get ONE thing perfectly right, what should it be?
|
||||
</display>
|
||||
|
||||
### 2. Explore the User's Mental Model
|
||||
|
||||
Understand how users think about the core task:
|
||||
"**User Mental Model Questions:**
|
||||
<display>
|
||||
**User Mental Model Questions:**
|
||||
|
||||
- How do users currently solve this problem?
|
||||
- What mental model do they bring to this task?
|
||||
|
|
@ -79,12 +82,14 @@ Understand how users think about the core task:
|
|||
|
||||
- What do users love/hate about existing approaches?
|
||||
- What shortcuts or workarounds do they use?
|
||||
- What makes existing solutions feel magical or terrible?"
|
||||
- What makes existing solutions feel magical or terrible?
|
||||
</display>
|
||||
|
||||
### 3. Define Success Criteria for Core Experience
|
||||
|
||||
Establish what makes the core interaction successful:
|
||||
"**Core Experience Success Criteria:**
|
||||
<display>
|
||||
**Core Experience Success Criteria:**
|
||||
|
||||
- What makes users say 'this just works'?
|
||||
- When do they feel smart or accomplished?
|
||||
|
|
@ -96,12 +101,14 @@ Establish what makes the core interaction successful:
|
|||
|
||||
- [Success indicator 1]
|
||||
- [Success indicator 2]
|
||||
- [Success indicator 3]"
|
||||
- [Success indicator 3]
|
||||
</display>
|
||||
|
||||
### 4. Identify Novel vs. Established Patterns
|
||||
|
||||
Determine if we need to innovate or can use proven patterns:
|
||||
"**Pattern Analysis:**
|
||||
<display>
|
||||
**Pattern Analysis:**
|
||||
Looking at your core experience, does this:
|
||||
|
||||
- Use established UX patterns that users already understand?
|
||||
|
|
@ -118,12 +125,14 @@ Looking at your core experience, does this:
|
|||
|
||||
- Which proven patterns should we adopt?
|
||||
- How can we innovate within familiar patterns?
|
||||
- What's our unique twist on established interactions?"
|
||||
- What's our unique twist on established interactions?
|
||||
</display>
|
||||
|
||||
### 5. Define Experience Mechanics
|
||||
|
||||
Break down the core interaction into details:
|
||||
"**Core Experience Mechanics:**
|
||||
<display>
|
||||
**Core Experience Mechanics:**
|
||||
Let's design the step-by-step flow for [defining experience]:
|
||||
|
||||
**1. Initiation:**
|
||||
|
|
@ -147,7 +156,8 @@ Let's design the step-by-step flow for [defining experience]:
|
|||
|
||||
- How do users know they're done?
|
||||
- What's the successful outcome?
|
||||
- What's next?"
|
||||
- What's next?
|
||||
</display>
|
||||
|
||||
### 6. Generate Defining Experience Content
|
||||
|
||||
|
|
@ -184,7 +194,8 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
### 7. Present Content and Menu
|
||||
|
||||
Show the generated defining experience content and present choices:
|
||||
"I've defined the core experience for {{project_name}} - the interaction that will make users love this product.
|
||||
<display>
|
||||
I've defined the core experience for {{project_name}} - the interaction that will make users love this product.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -194,6 +205,7 @@ Show the generated defining experience content and present choices:
|
|||
[A] Advanced Elicitation - Let's refine the core experience definition
|
||||
[P] Party Mode - Bring different perspectives on the defining interaction
|
||||
[C] Continue - Save this to the document and move to visual foundation
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -51,24 +51,29 @@ Establish the visual design foundation including color themes, typography, and s
|
|||
### 1. Brand Guidelines Assessment
|
||||
|
||||
Check for existing brand requirements:
|
||||
"Do you have existing brand guidelines or a specific color palette I should follow? (y/n)
|
||||
<display>
|
||||
Do you have existing brand guidelines or a specific color palette I should follow? (y/n)
|
||||
|
||||
If yes, I'll extract and document your brand colors and create semantic color mappings.
|
||||
If no, I'll generate theme options based on your project's personality and emotional goals from our earlier discussion."
|
||||
If no, I'll generate theme options based on your project's personality and emotional goals from our earlier discussion.
|
||||
</display>
|
||||
|
||||
### 2. Generate Color Theme Options (If no brand guidelines)
|
||||
|
||||
Create visual exploration opportunities:
|
||||
"If no existing brand guidelines, I'll create a color theme visualizer to help you explore options.
|
||||
<display>
|
||||
If no existing brand guidelines, I'll create a color theme visualizer to help you explore options.
|
||||
|
||||
🎨 I can generate comprehensive HTML color theme visualizers with multiple theme options, complete UI examples, and the ability to see how colors work in real interface contexts.
|
||||
|
||||
This will help you make an informed decision about the visual direction for {{project_name}}."
|
||||
This will help you make an informed decision about the visual direction for {{project_name}}.
|
||||
</display>
|
||||
|
||||
### 3. Define Typography System
|
||||
|
||||
Establish the typographic foundation:
|
||||
"**Typography Questions:**
|
||||
<display>
|
||||
**Typography Questions:**
|
||||
|
||||
- What should the overall tone feel like? (Professional, friendly, modern, classic?)
|
||||
- How much text content will users read? (Headings only? Long-form content?)
|
||||
|
|
@ -80,12 +85,14 @@ Establish the typographic foundation:
|
|||
- Choose primary and secondary typefaces
|
||||
- Establish type scale (h1, h2, h3, body, etc.)
|
||||
- Define line heights and spacing relationships
|
||||
- Consider readability and accessibility"
|
||||
- Consider readability and accessibility
|
||||
</display>
|
||||
|
||||
### 4. Establish Spacing and Layout Foundation
|
||||
|
||||
Define the structural foundation:
|
||||
"**Spacing and Layout Foundation:**
|
||||
<display>
|
||||
**Spacing and Layout Foundation:**
|
||||
|
||||
- How should the overall layout feel? (Dense and efficient? Airy and spacious?)
|
||||
- What spacing unit should we use? (4px, 8px, 12px base?)
|
||||
|
|
@ -96,12 +103,14 @@ Define the structural foundation:
|
|||
|
||||
- [Layout principle 1 based on product type]
|
||||
- [Layout principle 2 based on user needs]
|
||||
- [Layout principle 3 based on platform requirements]"
|
||||
- [Layout principle 3 based on platform requirements]
|
||||
</display>
|
||||
|
||||
### 5. Create Visual Foundation Strategy
|
||||
|
||||
Synthesize all visual decisions:
|
||||
"**Visual Foundation Strategy:**
|
||||
<display>
|
||||
**Visual Foundation Strategy:**
|
||||
|
||||
**Color System:**
|
||||
|
||||
|
|
@ -121,7 +130,8 @@ Synthesize all visual decisions:
|
|||
- Grid system approach
|
||||
- Component spacing relationships
|
||||
|
||||
This foundation will ensure consistency across all our design decisions."
|
||||
This foundation will ensure consistency across all our design decisions.
|
||||
</display>
|
||||
|
||||
### 6. Generate Visual Foundation Content
|
||||
|
||||
|
|
@ -154,7 +164,8 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
### 7. Present Content and Menu
|
||||
|
||||
Show the generated visual foundation content and present choices:
|
||||
"I've established the visual design foundation for {{project_name}}. This provides the building blocks for consistent, beautiful design.
|
||||
<display>
|
||||
I've established the visual design foundation for {{project_name}}. This provides the building blocks for consistent, beautiful design.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -164,6 +175,7 @@ Show the generated visual foundation content and present choices:
|
|||
[A] Advanced Elicitation - Let's refine our visual foundation
|
||||
[P] Party Mode - Bring design perspectives on visual choices
|
||||
[C] Continue - Save this to the document and move to design directions
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,8 @@ Generate comprehensive design direction mockups showing different visual approac
|
|||
### 1. Generate Design Direction Variations
|
||||
|
||||
Create diverse visual explorations:
|
||||
"I'll generate 6-8 different design direction variations exploring:
|
||||
<display>
|
||||
I'll generate 6-8 different design direction variations exploring:
|
||||
|
||||
- Different layout approaches and information hierarchy
|
||||
- Various interaction patterns and visual weights
|
||||
|
|
@ -59,12 +60,14 @@ Create diverse visual explorations:
|
|||
- Different density and spacing approaches
|
||||
- Various navigation and component arrangements
|
||||
|
||||
Each mockup will show a complete vision for {{project_name}} with all our design decisions applied."
|
||||
Each mockup will show a complete vision for {{project_name}} with all our design decisions applied.
|
||||
</display>
|
||||
|
||||
### 2. Create HTML Design Direction Showcase
|
||||
|
||||
Generate interactive visual exploration:
|
||||
"🎨 Design Direction Mockups Generated!
|
||||
<display>
|
||||
🎨 Design Direction Mockups Generated!
|
||||
|
||||
I'm creating a comprehensive HTML design direction showcase at `{planning_artifacts}/ux-design-directions.html`
|
||||
|
||||
|
|
@ -76,12 +79,14 @@ I'm creating a comprehensive HTML design direction showcase at `{planning_artifa
|
|||
- Complete UI examples with real content
|
||||
- Responsive behavior demonstrations
|
||||
|
||||
Each mockup represents a complete visual direction for your app's look and feel."
|
||||
Each mockup represents a complete visual direction for your app's look and feel.
|
||||
</display>
|
||||
|
||||
### 3. Present Design Exploration Framework
|
||||
|
||||
Guide evaluation criteria:
|
||||
"As you explore the design directions, look for:
|
||||
<display>
|
||||
As you explore the design directions, look for:
|
||||
|
||||
✅ **Layout Intuitiveness** - Which information hierarchy matches your priorities?
|
||||
✅ **Interaction Style** - Which interaction style fits your core experience?
|
||||
|
|
@ -90,12 +95,14 @@ Guide evaluation criteria:
|
|||
✅ **Component Usage** - How well do the components support your user journeys?
|
||||
✅ **Brand Alignment** - Which direction best supports your emotional goals?
|
||||
|
||||
Take your time exploring - this is a crucial decision that will guide all our design work!"
|
||||
Take your time exploring - this is a crucial decision that will guide all our design work!
|
||||
</display>
|
||||
|
||||
### 4. Facilitate Design Direction Selection
|
||||
|
||||
Help user choose or combine elements:
|
||||
"After exploring all the design directions:
|
||||
<display>
|
||||
After exploring all the design directions:
|
||||
|
||||
**Which approach resonates most with you?**
|
||||
|
||||
|
|
@ -109,19 +116,22 @@ Help user choose or combine elements:
|
|||
- Which layout feels most intuitive for your users?
|
||||
- Which visual weight matches your brand personality?
|
||||
- Which interaction style supports your core experience?
|
||||
- Are there elements from different directions you'd like to combine?"
|
||||
- Are there elements from different directions you'd like to combine?
|
||||
</display>
|
||||
|
||||
### 5. Document Design Direction Decision
|
||||
|
||||
Capture the chosen approach:
|
||||
"Based on your exploration, I'm understanding your design direction preference:
|
||||
<display>
|
||||
Based on your exploration, I'm understanding your design direction preference:
|
||||
|
||||
**Chosen Direction:** [Direction number or combination]
|
||||
**Key Elements:** [Specific elements you liked]
|
||||
**Modifications Needed:** [Any changes requested]
|
||||
**Rationale:** [Why this direction works for your product]
|
||||
|
||||
This will become our design foundation moving forward. Are we ready to lock this in, or do you want to explore variations?"
|
||||
This will become our design foundation moving forward. Are we ready to lock this in, or do you want to explore variations?
|
||||
</display>
|
||||
|
||||
### 6. Generate Design Direction Content
|
||||
|
||||
|
|
@ -154,7 +164,8 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
### 7. Present Content and Menu
|
||||
|
||||
Show the generated design direction content and present choices:
|
||||
"I've documented our design direction decision for {{project_name}}. This visual approach will guide all our detailed design work.
|
||||
<display>
|
||||
I've documented our design direction decision for {{project_name}}. This visual approach will guide all our detailed design work.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -164,6 +175,7 @@ Show the generated design direction content and present choices:
|
|||
[A] Advanced Elicitation - Let's refine our design direction
|
||||
[P] Party Mode - Bring different perspectives on visual choices
|
||||
[C] Continue - Save this to the document and move to user journey flows
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,8 @@ Design detailed user journey flows for critical user interactions.
|
|||
### 1. Load PRD User Journeys as Foundation
|
||||
|
||||
Start with user journeys already defined in the PRD:
|
||||
"Great! Since we have the PRD available, let's build on the user journeys already documented there.
|
||||
<display>
|
||||
Great! Since we have the PRD available, let's build on the user journeys already documented there.
|
||||
|
||||
**Existing User Journeys from PRD:**
|
||||
I've already loaded these user journeys from your PRD:
|
||||
|
|
@ -66,14 +67,16 @@ Looking at the PRD journeys, I need to design detailed interaction flows for:
|
|||
- [Critical journey 2 identified from PRD narratives]
|
||||
- [Critical journey 3 identified from PRD narratives]
|
||||
|
||||
The PRD gave us the stories - now we design the mechanics!"
|
||||
The PRD gave us the stories - now we design the mechanics!
|
||||
</display>
|
||||
|
||||
### 2. Design Each Journey Flow
|
||||
|
||||
For each critical journey, design detailed flow:
|
||||
|
||||
**For [Journey Name]:**
|
||||
"Let's design the flow for users accomplishing [journey goal].
|
||||
<display>
|
||||
Let's design the flow for users accomplishing [journey goal].
|
||||
|
||||
**Flow Design Questions:**
|
||||
|
||||
|
|
@ -83,12 +86,14 @@ For each critical journey, design detailed flow:
|
|||
- How do they know they're progressing successfully?
|
||||
- What does success look like for this journey?
|
||||
- Where might they get confused or stuck?
|
||||
- How do they recover from errors?"
|
||||
- How do they recover from errors?
|
||||
</display>
|
||||
|
||||
### 3. Create Flow Diagrams
|
||||
|
||||
Visualize each journey with Mermaid diagrams:
|
||||
"I'll create detailed flow diagrams for each journey showing:
|
||||
<display>
|
||||
I'll create detailed flow diagrams for each journey showing:
|
||||
|
||||
**[Journey Name] Flow:**
|
||||
|
||||
|
|
@ -98,12 +103,14 @@ Visualize each journey with Mermaid diagrams:
|
|||
- Error recovery mechanisms
|
||||
- Progressive disclosure of information
|
||||
|
||||
Each diagram will map the complete user experience from start to finish."
|
||||
Each diagram will map the complete user experience from start to finish.
|
||||
</display>
|
||||
|
||||
### 4. Optimize for Efficiency and Delight
|
||||
|
||||
Refine flows for optimal user experience:
|
||||
"**Flow Optimization:**
|
||||
<display>
|
||||
**Flow Optimization:**
|
||||
For each journey, let's ensure we're:
|
||||
|
||||
- Minimizing steps to value (getting users to success quickly)
|
||||
|
|
@ -116,12 +123,14 @@ For each journey, let's ensure we're:
|
|||
|
||||
- [Optimization 1 for journey efficiency]
|
||||
- [Optimization 2 for user delight]
|
||||
- [Optimization 3 for error handling]"
|
||||
- [Optimization 3 for error handling]
|
||||
</display>
|
||||
|
||||
### 5. Document Journey Patterns
|
||||
|
||||
Extract reusable patterns across journeys:
|
||||
"**Journey Patterns:**
|
||||
<display>
|
||||
**Journey Patterns:**
|
||||
Across these flows, I'm seeing some common patterns we can standardize:
|
||||
|
||||
**Navigation Patterns:**
|
||||
|
|
@ -139,7 +148,8 @@ Across these flows, I'm seeing some common patterns we can standardize:
|
|||
- [Feedback pattern 1]
|
||||
- [Feedback pattern 2]
|
||||
|
||||
These patterns will ensure consistency across all user experiences."
|
||||
These patterns will ensure consistency across all user experiences.
|
||||
</display>
|
||||
|
||||
### 6. Generate User Journey Content
|
||||
|
||||
|
|
@ -172,7 +182,8 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
### 7. Present Content and Menu
|
||||
|
||||
Show the generated user journey content and present choices:
|
||||
"I've designed detailed user journey flows for {{project_name}}. These flows will guide the detailed design of each user interaction.
|
||||
<display>
|
||||
I've designed detailed user journey flows for {{project_name}}. These flows will guide the detailed design of each user interaction.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -182,6 +193,7 @@ Show the generated user journey content and present choices:
|
|||
[A] Advanced Elicitation - Let's refine our user journey designs
|
||||
[P] Party Mode - Bring different perspectives on user flows
|
||||
[C] Continue - Save this to the document and move to component strategy
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,8 @@ Define component library strategy and design custom components not covered by th
|
|||
### 1. Analyze Design System Coverage
|
||||
|
||||
Review what components are available vs. needed:
|
||||
"Based on our chosen design system [design system from step 6], let's identify what components are already available and what we need to create custom.
|
||||
<display>
|
||||
Based on our chosen design system [design system from step 6], let's identify what components are already available and what we need to create custom.
|
||||
|
||||
**Available from Design System:**
|
||||
[List of components available in chosen design system]
|
||||
|
|
@ -66,14 +67,16 @@ Looking at our user journeys and design direction, we need:
|
|||
**Gap Analysis:**
|
||||
|
||||
- [Gap 1 - needed but not available]
|
||||
- [Gap 2 - needed but not available]"
|
||||
- [Gap 2 - needed but not available]
|
||||
</display>
|
||||
|
||||
### 2. Design Custom Components
|
||||
|
||||
For each custom component needed, design thoroughly:
|
||||
|
||||
**For each custom component:**
|
||||
"**[Component Name] Design:**
|
||||
<display>
|
||||
**[Component Name] Design:**
|
||||
|
||||
**Purpose:** What does this component do for users?
|
||||
**Content:** What information or data does it display?
|
||||
|
|
@ -82,7 +85,8 @@ For each custom component needed, design thoroughly:
|
|||
**Variants:** Are there different sizes or styles needed?
|
||||
**Accessibility:** What ARIA labels and keyboard support needed?
|
||||
|
||||
Let's walk through each custom component systematically."
|
||||
Let's walk through each custom component systematically.
|
||||
</display>
|
||||
|
||||
### 3. Document Component Specifications
|
||||
|
||||
|
|
@ -106,7 +110,8 @@ Create detailed specifications for each component:
|
|||
### 4. Define Component Strategy
|
||||
|
||||
Establish overall component library approach:
|
||||
"**Component Strategy:**
|
||||
<display>
|
||||
**Component Strategy:**
|
||||
|
||||
**Foundation Components:** (from design system)
|
||||
|
||||
|
|
@ -123,12 +128,14 @@ Establish overall component library approach:
|
|||
- Build custom components using design system tokens
|
||||
- Ensure consistency with established patterns
|
||||
- Follow accessibility best practices
|
||||
- Create reusable patterns for common use cases"
|
||||
- Create reusable patterns for common use cases
|
||||
</display>
|
||||
|
||||
### 5. Plan Implementation Roadmap
|
||||
|
||||
Define how and when to build components:
|
||||
"**Implementation Roadmap:**
|
||||
<display>
|
||||
**Implementation Roadmap:**
|
||||
|
||||
**Phase 1 - Core Components:**
|
||||
|
||||
|
|
@ -145,7 +152,8 @@ Define how and when to build components:
|
|||
- [Component 5] - optimizes [user journey]
|
||||
- [Component 6] - adds [special feature]
|
||||
|
||||
This roadmap helps prioritize development based on user journey criticality."
|
||||
This roadmap helps prioritize development based on user journey criticality.
|
||||
</display>
|
||||
|
||||
### 6. Generate Component Strategy Content
|
||||
|
||||
|
|
@ -178,7 +186,8 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
### 7. Present Content and Menu
|
||||
|
||||
Show the generated component strategy content and present choices:
|
||||
"I've defined the component strategy for {{project_name}}. This balances using proven design system components with custom components for your unique needs.
|
||||
<display>
|
||||
I've defined the component strategy for {{project_name}}. This balances using proven design system components with custom components for your unique needs.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -188,6 +197,7 @@ Show the generated component strategy content and present choices:
|
|||
[A] Advanced Elicitation - Let's refine our component strategy
|
||||
[P] Party Mode - Bring technical perspectives on component design
|
||||
[C] Continue - Save this to the document and move to UX patterns
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,8 @@ Establish UX consistency patterns for common situations like buttons, forms, nav
|
|||
### 1. Identify Pattern Categories
|
||||
|
||||
Determine which patterns need definition for your product:
|
||||
"Let's establish consistency patterns for how {{project_name}} behaves in common situations.
|
||||
<display>
|
||||
Let's establish consistency patterns for how {{project_name}} behaves in common situations.
|
||||
|
||||
**Pattern Categories to Define:**
|
||||
|
||||
|
|
@ -63,14 +64,16 @@ Determine which patterns need definition for your product:
|
|||
- Empty states and loading states
|
||||
- Search and filtering patterns
|
||||
|
||||
Which categories are most critical for your product? We can go through each thoroughly or focus on the most important ones."
|
||||
Which categories are most critical for your product? We can go through each thoroughly or focus on the most important ones.
|
||||
</display>
|
||||
|
||||
### 2. Define Critical Patterns First
|
||||
|
||||
Focus on patterns most relevant to your product:
|
||||
|
||||
**For [Critical Pattern Category]:**
|
||||
"**[Pattern Type] Patterns:**
|
||||
<display>
|
||||
**[Pattern Type] Patterns:**
|
||||
What should users see/do when they need to [pattern action]?
|
||||
|
||||
**Considerations:**
|
||||
|
|
@ -86,7 +89,8 @@ What should users see/do when they need to [pattern action]?
|
|||
- [Example 1 for this pattern type]
|
||||
- [Example 2 for this pattern type]
|
||||
|
||||
How should {{project_name}} handle [pattern type] interactions?"
|
||||
How should {{project_name}} handle [pattern type] interactions?
|
||||
</display>
|
||||
|
||||
### 3. Establish Pattern Guidelines
|
||||
|
||||
|
|
@ -108,7 +112,8 @@ Document specific design decisions:
|
|||
### 4. Design System Integration
|
||||
|
||||
Ensure patterns work with chosen design system:
|
||||
"**Integration with [Design System]:**
|
||||
<display>
|
||||
**Integration with [Design System]:**
|
||||
|
||||
- How do these patterns complement our design system components?
|
||||
- What customizations are needed?
|
||||
|
|
@ -118,7 +123,8 @@ Ensure patterns work with chosen design system:
|
|||
|
||||
- [Custom rule 1]
|
||||
- [Custom rule 2]
|
||||
- [Custom rule 3]"
|
||||
- [Custom rule 3]
|
||||
</display>
|
||||
|
||||
### 5. Create Pattern Documentation
|
||||
|
||||
|
|
@ -167,7 +173,8 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
### 7. Present Content and Menu
|
||||
|
||||
Show the generated UX patterns content and present choices:
|
||||
"I've established UX consistency patterns for {{project_name}}. These patterns ensure users have a consistent, predictable experience across all interactions.
|
||||
<display>
|
||||
I've established UX consistency patterns for {{project_name}}. These patterns ensure users have a consistent, predictable experience across all interactions.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -177,6 +184,7 @@ Show the generated UX patterns content and present choices:
|
|||
[A] Advanced Elicitation - Let's refine our UX patterns
|
||||
[P] Party Mode - Bring different perspectives on consistency patterns
|
||||
[C] Continue - Save this to the document and move to responsive design
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,8 @@ Define responsive design strategy and accessibility requirements for the product
|
|||
### 1. Define Responsive Strategy
|
||||
|
||||
Establish how the design adapts across devices:
|
||||
"Let's define how {{project_name}} adapts across different screen sizes and devices.
|
||||
<display>
|
||||
Let's define how {{project_name}} adapts across different screen sizes and devices.
|
||||
|
||||
**Responsive Design Questions:**
|
||||
|
||||
|
|
@ -71,12 +72,14 @@ Establish how the design adapts across devices:
|
|||
|
||||
- Bottom navigation or hamburger menu?
|
||||
- How do layouts collapse on small screens?
|
||||
- What's the most critical information to show mobile-first?"
|
||||
- What's the most critical information to show mobile-first?
|
||||
</display>
|
||||
|
||||
### 2. Establish Breakpoint Strategy
|
||||
|
||||
Define when and how layouts change:
|
||||
"**Breakpoint Strategy:**
|
||||
<display>
|
||||
**Breakpoint Strategy:**
|
||||
We need to define screen size breakpoints where layouts adapt.
|
||||
|
||||
**Common Breakpoints:**
|
||||
|
|
@ -89,12 +92,14 @@ We need to define screen size breakpoints where layouts adapt.
|
|||
|
||||
- Use standard breakpoints or custom ones?
|
||||
- Focus on mobile-first or desktop-first design?
|
||||
- Have specific breakpoints for your key use cases?"
|
||||
- Have specific breakpoints for your key use cases?
|
||||
</display>
|
||||
|
||||
### 3. Design Accessibility Strategy
|
||||
|
||||
Define accessibility requirements and compliance level:
|
||||
"**Accessibility Strategy:**
|
||||
<display>
|
||||
**Accessibility Strategy:**
|
||||
What level of WCAG compliance does {{project_name}} need?
|
||||
|
||||
**WCAG Levels:**
|
||||
|
|
@ -113,12 +118,14 @@ What level of WCAG compliance does {{project_name}} need?
|
|||
- Keyboard navigation support
|
||||
- Screen reader compatibility
|
||||
- Touch target sizes (minimum 44x44px)
|
||||
- Focus indicators and skip links"
|
||||
- Focus indicators and skip links
|
||||
</display>
|
||||
|
||||
### 4. Define Testing Strategy
|
||||
|
||||
Plan how to ensure responsive design and accessibility:
|
||||
"**Testing Strategy:**
|
||||
<display>
|
||||
**Testing Strategy:**
|
||||
|
||||
**Responsive Testing:**
|
||||
|
||||
|
|
@ -137,12 +144,14 @@ Plan how to ensure responsive design and accessibility:
|
|||
|
||||
- Include users with disabilities in testing
|
||||
- Test with diverse assistive technologies
|
||||
- Validate with actual target devices"
|
||||
- Validate with actual target devices
|
||||
</display>
|
||||
|
||||
### 5. Document Implementation Guidelines
|
||||
|
||||
Create specific guidelines for developers:
|
||||
"**Implementation Guidelines:**
|
||||
<display>
|
||||
**Implementation Guidelines:**
|
||||
|
||||
**Responsive Development:**
|
||||
|
||||
|
|
@ -157,7 +166,8 @@ Create specific guidelines for developers:
|
|||
- ARIA labels and roles
|
||||
- Keyboard navigation implementation
|
||||
- Focus management and skip links
|
||||
- High contrast mode support"
|
||||
- High contrast mode support
|
||||
</display>
|
||||
|
||||
### 6. Generate Responsive & Accessibility Content
|
||||
|
||||
|
|
@ -194,7 +204,8 @@ When saving to document, append these Level 2 and Level 3 sections:
|
|||
### 7. Present Content and Menu
|
||||
|
||||
Show the generated responsive and accessibility content and present choices:
|
||||
"I've defined the responsive design and accessibility strategy for {{project_name}}. This ensures your product works beautifully across all devices and is accessible to all users.
|
||||
<display>
|
||||
I've defined the responsive design and accessibility strategy for {{project_name}}. This ensures your product works beautifully across all devices and is accessible to all users.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -204,6 +215,7 @@ Show the generated responsive and accessibility content and present choices:
|
|||
[A] Advanced Elicitation - Let's refine our responsive/accessibility strategy
|
||||
[P] Party Mode - Bring different perspectives on inclusive design
|
||||
[C] Continue - Save this to the document and complete the workflow
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -44,7 +44,8 @@ Complete the UX design workflow, update status files, and suggest next steps for
|
|||
### 1. Announce Workflow Completion
|
||||
|
||||
Inform user that the UX design is complete:
|
||||
"🎉 **UX Design Complete, {{user_name}}!**
|
||||
<display>
|
||||
🎉 **UX Design Complete, {{user_name}}!**
|
||||
|
||||
I've successfully collaborated with you to create a comprehensive UX design specification for {{project_name}}.
|
||||
|
||||
|
|
@ -69,7 +70,8 @@ I've successfully collaborated with you to create a comprehensive UX design spec
|
|||
- Color themes visualizer: `{planning_artifacts}/ux-color-themes.html`
|
||||
- Design directions mockups: `{planning_artifacts}/ux-design-directions.html`
|
||||
|
||||
This specification is now ready to guide visual design, implementation, and development."
|
||||
This specification is now ready to guide visual design, implementation, and development.
|
||||
</display>
|
||||
|
||||
### 2. Workflow Status Update
|
||||
|
||||
|
|
|
|||
|
|
@ -54,14 +54,16 @@ To discover, inventory, and organize all project documents, identifying duplicat
|
|||
|
||||
### 1. Initialize Document Discovery
|
||||
|
||||
"Beginning **Document Discovery** to inventory all project files.
|
||||
<display>
|
||||
Beginning **Document Discovery** to inventory all project files.
|
||||
|
||||
I will:
|
||||
|
||||
1. Search for all required documents (PRD, Architecture, Epics, UX)
|
||||
2. Group sharded documents together
|
||||
3. Identify any duplicates (whole + sharded versions)
|
||||
4. Present findings for your confirmation"
|
||||
4. Present findings for your confirmation
|
||||
</display>
|
||||
|
||||
### 2. Document Search Patterns
|
||||
|
||||
|
|
@ -133,7 +135,8 @@ Initialize {outputFile} with {templateFile}.
|
|||
### 6. Present Findings and Get Confirmation
|
||||
|
||||
Display findings and ask:
|
||||
"**Document Discovery Complete**
|
||||
<display>
|
||||
**Document Discovery Complete**
|
||||
|
||||
[Show organized file list]
|
||||
|
||||
|
|
@ -147,11 +150,14 @@ Display findings and ask:
|
|||
- If duplicates exist: Please remove/rename one version
|
||||
- Confirm which documents to use for assessment
|
||||
|
||||
**Ready to proceed?** [C] Continue after resolving issues"
|
||||
**Ready to proceed?** [C] Continue after resolving issues
|
||||
</display>
|
||||
|
||||
### 7. Present MENU OPTIONS
|
||||
|
||||
Display: **Select an Option:** [C] Continue to File Validation
|
||||
<display>
|
||||
**Select an Option:** [C] Continue to File Validation
|
||||
</display>
|
||||
|
||||
#### EXECUTION RULES:
|
||||
|
||||
|
|
|
|||
|
|
@ -54,7 +54,8 @@ To fully read and analyze the PRD document (whole or sharded) to extract all Fun
|
|||
|
||||
### 1. Initialize PRD Analysis
|
||||
|
||||
"Beginning **PRD Analysis** to extract all requirements.
|
||||
<display>
|
||||
Beginning **PRD Analysis** to extract all requirements.
|
||||
|
||||
I will:
|
||||
|
||||
|
|
@ -62,7 +63,8 @@ I will:
|
|||
2. Read it completely and thoroughly
|
||||
3. Extract ALL Functional Requirements (FRs)
|
||||
4. Extract ALL Non-Functional Requirements (NFRs)
|
||||
5. Document findings for coverage validation"
|
||||
5. Document findings for coverage validation
|
||||
</display>
|
||||
|
||||
### 2. Load and Read PRD
|
||||
|
||||
|
|
|
|||
|
|
@ -53,14 +53,16 @@ To validate that all Functional Requirements from the PRD are captured in the ep
|
|||
|
||||
### 1. Initialize Coverage Validation
|
||||
|
||||
"Beginning **Epic Coverage Validation**.
|
||||
<display>
|
||||
Beginning **Epic Coverage Validation**.
|
||||
|
||||
I will:
|
||||
|
||||
1. Load the epics and stories document
|
||||
2. Extract FR coverage information
|
||||
3. Compare against PRD FRs from previous step
|
||||
4. Identify any FRs not covered in epics"
|
||||
4. Identify any FRs not covered in epics
|
||||
</display>
|
||||
|
||||
### 2. Load Epics Document
|
||||
|
||||
|
|
|
|||
|
|
@ -53,13 +53,15 @@ To check if UX documentation exists and validate that it aligns with PRD require
|
|||
|
||||
### 1. Initialize UX Validation
|
||||
|
||||
"Beginning **UX Alignment** validation.
|
||||
<display>
|
||||
Beginning **UX Alignment** validation.
|
||||
|
||||
I will:
|
||||
|
||||
1. Check if UX documentation exists
|
||||
2. If UX exists: validate alignment with PRD and Architecture
|
||||
3. If no UX: determine if UX is implied and document warning"
|
||||
3. If no UX: determine if UX is implied and document warning
|
||||
</display>
|
||||
|
||||
### 2. Search for UX Documentation
|
||||
|
||||
|
|
|
|||
|
|
@ -55,7 +55,8 @@ To validate epics and stories against the best practices defined in create-epics
|
|||
|
||||
### 1. Initialize Best Practices Validation
|
||||
|
||||
"Beginning **Epic Quality Review** against create-epics-and-stories standards.
|
||||
<display>
|
||||
Beginning **Epic Quality Review** against create-epics-and-stories standards.
|
||||
|
||||
I will rigorously validate:
|
||||
|
||||
|
|
@ -64,7 +65,8 @@ I will rigorously validate:
|
|||
- Story dependencies (no forward references)
|
||||
- Proper story sizing and completeness
|
||||
|
||||
Any deviation from best practices will be flagged as a defect."
|
||||
Any deviation from best practices will be flagged as a defect.
|
||||
</display>
|
||||
|
||||
### 2. Epic Structure Validation
|
||||
|
||||
|
|
|
|||
|
|
@ -52,14 +52,16 @@ To provide a comprehensive summary of all findings and give the report a final p
|
|||
|
||||
### 1. Initialize Final Assessment
|
||||
|
||||
"Completing **Final Assessment**.
|
||||
<display>
|
||||
Completing **Final Assessment**.
|
||||
|
||||
I will now:
|
||||
|
||||
1. Review all findings from previous steps
|
||||
2. Provide a comprehensive summary
|
||||
3. Add specific recommendations
|
||||
4. Determine overall readiness status"
|
||||
4. Determine overall readiness status
|
||||
</display>
|
||||
|
||||
### 2. Review Previous Findings
|
||||
|
||||
|
|
@ -105,11 +107,13 @@ This assessment identified [X] issues across [Y] categories. Address the critica
|
|||
### 5. Present Completion
|
||||
|
||||
Display:
|
||||
"**Implementation Readiness Assessment Complete**
|
||||
<display>
|
||||
**Implementation Readiness Assessment Complete**
|
||||
|
||||
Report generated: {outputFile}
|
||||
|
||||
The assessment found [number] issues requiring attention. Review the detailed report for specific findings and recommendations."
|
||||
The assessment found [number] issues requiring attention. Review the detailed report for specific findings and recommendations.
|
||||
</display>
|
||||
|
||||
## WORKFLOW COMPLETE
|
||||
|
||||
|
|
|
|||
|
|
@ -108,7 +108,8 @@ Complete setup and report to user:
|
|||
|
||||
**Input Documents Discovered:**
|
||||
Report what was found:
|
||||
"Welcome {{user_name}}! I've set up your Architecture workspace for {{project_name}}.
|
||||
<display>
|
||||
Welcome {{user_name}}! I've set up your Architecture workspace for {{project_name}}.
|
||||
|
||||
**Documents Found:**
|
||||
|
||||
|
|
@ -123,6 +124,7 @@ Report what was found:
|
|||
Ready to begin architectural decision making. Do you have any other documents you'd like me to include?
|
||||
|
||||
[C] Continue to project context analysis
|
||||
</display>
|
||||
|
||||
## SUCCESS METRICS:
|
||||
|
||||
|
|
|
|||
|
|
@ -55,7 +55,8 @@ Read the existing architecture document completely and analyze:
|
|||
|
||||
Show the user their current progress:
|
||||
|
||||
"Welcome back {{user_name}}! I found your Architecture work for {{project_name}}.
|
||||
<display>
|
||||
Welcome back {{user_name}}! I found your Architecture work for {{project_name}}.
|
||||
|
||||
**Current Progress:**
|
||||
|
||||
|
|
@ -77,7 +78,7 @@ Show the user their current progress:
|
|||
[C] Continue to next logical step
|
||||
[O] Overview of all remaining steps
|
||||
[X] Start over (will overwrite existing work)
|
||||
"
|
||||
</display>
|
||||
|
||||
### 3. Handle User Choice
|
||||
|
||||
|
|
|
|||
|
|
@ -94,7 +94,8 @@ Calculate and present project complexity:
|
|||
|
||||
Present your analysis back to user for validation:
|
||||
|
||||
"I'm reviewing your project documentation for {{project_name}}.
|
||||
<display>
|
||||
I'm reviewing your project documentation for {{project_name}}.
|
||||
|
||||
{if_epics_loaded}I see {{epic_count}} epics with {{story_count}} total stories.{/if_epics_loaded}
|
||||
{if_no_epics}I found {{fr_count}} functional requirements organized into {{fr_category_list}}.{/if_no_epics}
|
||||
|
|
@ -116,7 +117,8 @@ Present your analysis back to user for validation:
|
|||
|
||||
This analysis will help me guide you through the architectural decisions needed to ensure AI agents implement this consistently.
|
||||
|
||||
Does this match your understanding of the project scope and requirements?"
|
||||
Does this match your understanding of the project scope and requirements?
|
||||
</display>
|
||||
|
||||
### 4. Generate Project Context Content
|
||||
|
||||
|
|
@ -155,7 +157,8 @@ Prepare the content to append to the document:
|
|||
|
||||
Show the generated content and present choices:
|
||||
|
||||
"I've drafted the Project Context Analysis based on your requirements. This sets the foundation for our architectural decisions.
|
||||
<display>
|
||||
I've drafted the Project Context Analysis based on your requirements. This sets the foundation for our architectural decisions.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -164,7 +167,8 @@ Show the generated content and present choices:
|
|||
**What would you like to do?**
|
||||
[A] Advanced Elicitation - Let's dive deeper into architectural implications
|
||||
[P] Party Mode - Bring different perspectives to analyze requirements
|
||||
[C] Continue - Save this analysis and begin architectural decisions"
|
||||
[C] Continue - Save this analysis and begin architectural decisions
|
||||
</display>
|
||||
|
||||
### 6. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -53,7 +53,8 @@ Discover technical preferences and evaluate starter template options, leveraging
|
|||
### 0. Check Technical Preferences & Context
|
||||
|
||||
**Check Project Context for Existing Technical Preferences:**
|
||||
"Before we dive into starter templates, let me check if you have any technical preferences already documented.
|
||||
<display>
|
||||
Before we dive into starter templates, let me check if you have any technical preferences already documented.
|
||||
|
||||
{{if_project_context_exists}}
|
||||
I found some technical rules in your project context file:
|
||||
|
|
@ -68,10 +69,12 @@ I found some technical rules in your project context file:
|
|||
|
||||
{{else}}
|
||||
No existing technical preferences found in project context file. We'll establish your technical preferences now.
|
||||
{{/if_project_context}}"
|
||||
{{/if_project_context}}
|
||||
</display>
|
||||
|
||||
**Discover User Technical Preferences:**
|
||||
"Based on your project context, let's discuss your technical preferences:
|
||||
<display>
|
||||
Based on your project context, let's discuss your technical preferences:
|
||||
|
||||
{{primary_technology_category}} Preferences:
|
||||
|
||||
|
|
@ -94,7 +97,8 @@ No existing technical preferences found in project context file. We'll establish
|
|||
- Any existing systems or APIs you need to integrate with?
|
||||
- Third-party services you plan to use (payment, authentication, analytics, etc.)?
|
||||
|
||||
These preferences will help me recommend the most suitable starter templates and guide our architectural decisions."
|
||||
These preferences will help me recommend the most suitable starter templates and guide our architectural decisions.
|
||||
</display>
|
||||
|
||||
### 1. Identify Primary Technology Domain
|
||||
|
||||
|
|
@ -173,28 +177,34 @@ For each viable starter option, document:
|
|||
Based on user skill level and project needs:
|
||||
|
||||
**For Expert Users:**
|
||||
"Found {{starter_name}} which provides:
|
||||
<display>
|
||||
Found {{starter_name}} which provides:
|
||||
{{quick_decision_list_of_key_decisions}}
|
||||
|
||||
This would establish our base architecture with these technical decisions already made. Use it?"
|
||||
This would establish our base architecture with these technical decisions already made. Use it?
|
||||
</display>
|
||||
|
||||
**For Intermediate Users:**
|
||||
"I found {{starter_name}}, which is a well-maintained starter for {{project_type}} projects.
|
||||
<display>
|
||||
I found {{starter_name}}, which is a well-maintained starter for {{project_type}} projects.
|
||||
|
||||
It makes these architectural decisions for us:
|
||||
{{decision_list_with_explanations}}
|
||||
|
||||
This gives us a solid foundation following current best practices. Should we use it?"
|
||||
This gives us a solid foundation following current best practices. Should we use it?
|
||||
</display>
|
||||
|
||||
**For Beginner Users:**
|
||||
"I found {{starter_name}}, which is like a pre-built foundation for your project.
|
||||
<display>
|
||||
I found {{starter_name}}, which is like a pre-built foundation for your project.
|
||||
|
||||
Think of it like buying a prefab house frame instead of cutting each board yourself.
|
||||
|
||||
It makes these decisions for us:
|
||||
{{friendly_explanation_of_decisions}}
|
||||
|
||||
This is a great starting point that follows best practices and saves us from making dozens of small technical choices. Should we use it?"
|
||||
This is a great starting point that follows best practices and saves us from making dozens of small technical choices. Should we use it?
|
||||
</display>
|
||||
|
||||
### 7. Get Current CLI Commands
|
||||
|
||||
|
|
@ -262,7 +272,8 @@ Prepare the content to append to the document:
|
|||
|
||||
Show the generated content and present choices:
|
||||
|
||||
"I've analyzed starter template options for {{project_type}} projects.
|
||||
<display>
|
||||
I've analyzed starter template options for {{project_type}} projects.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -271,7 +282,8 @@ Show the generated content and present choices:
|
|||
**What would you like to do?**
|
||||
[A] Advanced Elicitation - Explore custom approaches or unconventional starters
|
||||
[P] Party Mode - Evaluate trade-offs from different perspectives
|
||||
[C] Continue - Save this decision and move to architectural decisions"
|
||||
[C] Continue - Save this decision and move to architectural decisions
|
||||
</display>
|
||||
|
||||
### 10. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -55,7 +55,8 @@ Facilitate collaborative architectural decision making, leveraging existing tech
|
|||
### 1. Load Decision Framework & Check Existing Preferences
|
||||
|
||||
**Review Technical Preferences from Step 3:**
|
||||
"Based on our technical preferences discussion in step 3, let's build on those foundations:
|
||||
<display>
|
||||
Based on our technical preferences discussion in step 3, let's build on those foundations:
|
||||
|
||||
**Your Technical Preferences:**
|
||||
{{user_technical_preferences_from_step_3}}
|
||||
|
|
@ -64,7 +65,8 @@ Facilitate collaborative architectural decision making, leveraging existing tech
|
|||
{{starter_template_decisions}}
|
||||
|
||||
**Project Context Technical Rules:**
|
||||
{{project_context_technical_rules}}"
|
||||
{{project_context_technical_rules}}
|
||||
</display>
|
||||
|
||||
**Identify Remaining Decisions:**
|
||||
Based on technical preferences, starter template choice, and project context, identify remaining critical decisions:
|
||||
|
|
@ -129,24 +131,29 @@ For each category, facilitate collaborative decision making:
|
|||
Based on user skill level and project context:
|
||||
|
||||
**Expert Mode:**
|
||||
"{{Decision_Category}}: {{Specific_Decision}}
|
||||
<display>
|
||||
{{Decision_Category}}: {{Specific_Decision}}
|
||||
|
||||
Options: {{concise_option_list_with_tradeoffs}}
|
||||
|
||||
What's your preference for this decision?"
|
||||
What's your preference for this decision?
|
||||
</display>
|
||||
|
||||
**Intermediate Mode:**
|
||||
"Next decision: {{Human_Friendly_Category}}
|
||||
<display>
|
||||
Next decision: {{Human_Friendly_Category}}
|
||||
|
||||
We need to choose {{Specific_Decision}}.
|
||||
|
||||
Common options:
|
||||
{{option_list_with_brief_explanations}}
|
||||
|
||||
For your project, I'd lean toward {{recommendation}} because {{reason}}. What are your thoughts?"
|
||||
For your project, I'd lean toward {{recommendation}} because {{reason}}. What are your thoughts?
|
||||
</display>
|
||||
|
||||
**Beginner Mode:**
|
||||
"Let's talk about {{Human_Friendly_Category}}.
|
||||
<display>
|
||||
Let's talk about {{Human_Friendly_Category}}.
|
||||
|
||||
{{Educational_Context_About_Why_This_Matters}}
|
||||
|
||||
|
|
@ -158,7 +165,8 @@ Your main options:
|
|||
My suggestion: {{recommendation}}
|
||||
This is good for you because {{beginner_friendly_reason}}.
|
||||
|
||||
What feels right to you?"
|
||||
What feels right to you?
|
||||
</display>
|
||||
|
||||
**Verify Technology Versions:**
|
||||
If decision involves specific technology:
|
||||
|
|
@ -170,7 +178,9 @@ Search the web: "{{technology}} production readiness"
|
|||
```
|
||||
|
||||
**Get User Input:**
|
||||
"What's your preference? (or 'explain more' for details)"
|
||||
<display>
|
||||
What's your preference? (or 'explain more' for details)
|
||||
</display>
|
||||
|
||||
**Handle User Response:**
|
||||
|
||||
|
|
@ -191,10 +201,12 @@ Search the web: "{{technology}} production readiness"
|
|||
|
||||
After each major decision, identify related decisions:
|
||||
|
||||
"This choice means we'll also need to decide:
|
||||
<display>
|
||||
This choice means we'll also need to decide:
|
||||
|
||||
- {{related_decision_1}}
|
||||
- {{related_decision_2}}"
|
||||
- {{related_decision_2}}
|
||||
</display>
|
||||
|
||||
### 5. Generate Decisions Content
|
||||
|
||||
|
|
@ -249,7 +261,8 @@ After facilitating all decision categories, prepare the content to append:
|
|||
|
||||
Show the generated decisions content and present choices:
|
||||
|
||||
"I've documented all the core architectural decisions we've made together.
|
||||
<display>
|
||||
I've documented all the core architectural decisions we've made together.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -258,7 +271,8 @@ Show the generated decisions content and present choices:
|
|||
**What would you like to do?**
|
||||
[A] Advanced Elicitation - Explore innovative approaches to any specific decisions
|
||||
[P] Party Mode - Review decisions from multiple perspectives
|
||||
[C] Continue - Save these decisions and move to implementation patterns"
|
||||
[C] Continue - Save these decisions and move to implementation patterns
|
||||
</display>
|
||||
|
||||
### 7. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -99,23 +99,29 @@ Based on the chosen technology stack and decisions, identify where AI agents cou
|
|||
For each conflict category, facilitate collaborative pattern definition:
|
||||
|
||||
**Present the Conflict Point:**
|
||||
"Given that we're using {{tech_stack}}, different AI agents might handle {{conflict_area}} differently.
|
||||
<display>
|
||||
Given that we're using {{tech_stack}}, different AI agents might handle {{conflict_area}} differently.
|
||||
|
||||
For example, one agent might name database tables 'users' while another uses 'Users' - this would cause conflicts.
|
||||
|
||||
We need to establish consistent patterns that all agents follow."
|
||||
We need to establish consistent patterns that all agents follow.
|
||||
</display>
|
||||
|
||||
**Show Options and Trade-offs:**
|
||||
"Common approaches for {{pattern_category}}:
|
||||
<display>
|
||||
Common approaches for {{pattern_category}}:
|
||||
|
||||
1. {{option_1}} - {{pros_and_cons}}
|
||||
2. {{option_2}} - {{pros_and_cons}}
|
||||
3. {{option_3}} - {{pros_and_cons}}
|
||||
|
||||
Which approach makes the most sense for our project?"
|
||||
Which approach makes the most sense for our project?
|
||||
</display>
|
||||
|
||||
**Get User Decision:**
|
||||
"What's your preference for this pattern? (or discuss the trade-offs more)"
|
||||
<display>
|
||||
What's your preference for this pattern? (or discuss the trade-offs more)
|
||||
</display>
|
||||
|
||||
### 3. Define Pattern Categories
|
||||
|
||||
|
|
@ -290,7 +296,8 @@ Prepare the content to append to the document:
|
|||
|
||||
Show the generated patterns content and present choices:
|
||||
|
||||
"I've documented implementation patterns that will prevent conflicts between AI agents working on this project.
|
||||
<display>
|
||||
I've documented implementation patterns that will prevent conflicts between AI agents working on this project.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -299,7 +306,8 @@ Show the generated patterns content and present choices:
|
|||
**What would you like to do?**
|
||||
[A] Advanced Elicitation - Explore additional consistency patterns
|
||||
[P] Party Mode - Review patterns from different implementation perspectives
|
||||
[C] Continue - Save these patterns and move to project structure"
|
||||
[C] Continue - Save these patterns and move to project structure
|
||||
</display>
|
||||
|
||||
### 6. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -55,14 +55,18 @@ Define the complete project structure and architectural boundaries based on all
|
|||
Map project requirements to architectural components:
|
||||
|
||||
**From Epics (if available):**
|
||||
"Epic: {{epic_name}} → Lives in {{module/directory/service}}"
|
||||
<display>
|
||||
Epic: {{epic_name}} → Lives in {{module/directory/service}}
|
||||
</display>
|
||||
|
||||
- User stories within the epic
|
||||
- Cross-epic dependencies
|
||||
- Shared components needed
|
||||
|
||||
**From FR Categories (if no epics):**
|
||||
"FR Category: {{fr_category_name}} → Lives in {{module/directory/service}}"
|
||||
<display>
|
||||
FR Category: {{fr_category_name}} → Lives in {{module/directory/service}}
|
||||
</display>
|
||||
|
||||
- Related functional requirements
|
||||
- Shared functionality across categories
|
||||
|
|
@ -214,22 +218,26 @@ project-name/
|
|||
Create explicit mapping from project requirements to specific files/directories:
|
||||
|
||||
**Epic/Feature Mapping:**
|
||||
"Epic: User Management
|
||||
<display>
|
||||
Epic: User Management
|
||||
|
||||
- Components: src/components/features/users/
|
||||
- Services: src/services/users/
|
||||
- API Routes: src/app/api/users/
|
||||
- Database: prisma/migrations/_*users*_
|
||||
- Tests: tests/features/users/"
|
||||
- Tests: tests/features/users/
|
||||
</display>
|
||||
|
||||
**Cross-Cutting Concerns:**
|
||||
"Authentication System
|
||||
<display>
|
||||
Authentication System
|
||||
|
||||
- Components: src/components/auth/
|
||||
- Services: src/services/auth/
|
||||
- Middleware: src/middleware/auth.ts
|
||||
- Guards: src/guards/auth.guard.ts
|
||||
- Tests: tests/auth/"
|
||||
- Tests: tests/auth/
|
||||
</display>
|
||||
|
||||
### 6. Generate Structure Content
|
||||
|
||||
|
|
@ -310,7 +318,8 @@ Prepare the content to append to the document:
|
|||
|
||||
Show the generated project structure content and present choices:
|
||||
|
||||
"I've created a complete project structure based on all our architectural decisions.
|
||||
<display>
|
||||
I've created a complete project structure based on all our architectural decisions.
|
||||
|
||||
**Here's what I'll add to the document:**
|
||||
|
||||
|
|
@ -319,7 +328,8 @@ Show the generated project structure content and present choices:
|
|||
**What would you like to do?**
|
||||
[A] Advanced Elicitation - Explore innovative project organization approaches
|
||||
[P] Party Mode - Review structure from different development perspectives
|
||||
[C] Continue - Save this structure and move to architecture validation"
|
||||
[C] Continue - Save this structure and move to architecture validation
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -155,25 +155,31 @@ Identify and document any missing elements:
|
|||
For any issues found, facilitate resolution:
|
||||
|
||||
**Critical Issues:**
|
||||
"I found some issues that need to be addressed before implementation:
|
||||
<display>
|
||||
I found some issues that need to be addressed before implementation:
|
||||
|
||||
{{critical_issue_description}}
|
||||
|
||||
These could cause implementation problems. How would you like to resolve this?"
|
||||
These could cause implementation problems. How would you like to resolve this?
|
||||
</display>
|
||||
|
||||
**Important Issues:**
|
||||
"I noticed a few areas that could be improved:
|
||||
<display>
|
||||
I noticed a few areas that could be improved:
|
||||
|
||||
{{important_issue_description}}
|
||||
|
||||
These aren't blocking, but addressing them would make implementation smoother. Should we work on these?"
|
||||
These aren't blocking, but addressing them would make implementation smoother. Should we work on these?
|
||||
</display>
|
||||
|
||||
**Minor Issues:**
|
||||
"Here are some minor suggestions for improvement:
|
||||
<display>
|
||||
Here are some minor suggestions for improvement:
|
||||
|
||||
{{minor_issue_description}}
|
||||
|
||||
These are optional refinements. Would you like to address any of these?"
|
||||
These are optional refinements. Would you like to address any of these?
|
||||
</display>
|
||||
|
||||
### 6. Generate Validation Content
|
||||
|
||||
|
|
@ -284,7 +290,8 @@ Prepare the content to append to the document:
|
|||
|
||||
Show the validation results and present choices:
|
||||
|
||||
"I've completed a comprehensive validation of your architecture.
|
||||
<display>
|
||||
I've completed a comprehensive validation of your architecture.
|
||||
|
||||
**Validation Summary:**
|
||||
|
||||
|
|
@ -300,6 +307,7 @@ Show the validation results and present choices:
|
|||
[A] Advanced Elicitation - Address any complex architectural concerns
|
||||
[P] Party Mode - Review validation from different implementation perspectives
|
||||
[C] Continue - Complete the architecture and finish workflow
|
||||
</display>
|
||||
|
||||
### 8. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -219,7 +219,9 @@ After extraction and confirmation, update {outputFile} with:
|
|||
|
||||
### 10. Present MENU OPTIONS
|
||||
|
||||
Display: `**Confirm the Requirements are complete and correct to [C] continue:**`
|
||||
<display>
|
||||
**Confirm the Requirements are complete and correct to [C] continue:**
|
||||
</display>
|
||||
|
||||
#### EXECUTION RULES:
|
||||
|
||||
|
|
|
|||
|
|
@ -190,7 +190,9 @@ After approval, update {outputFile}:
|
|||
|
||||
### 8. Present MENU OPTIONS
|
||||
|
||||
Display: "**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue"
|
||||
<display>
|
||||
**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
|
||||
|
|
|
|||
|
|
@ -227,7 +227,9 @@ The final {outputFile} must follow this structure exactly:
|
|||
|
||||
After all epics and stories are complete:
|
||||
|
||||
Display: "**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue"
|
||||
<display>
|
||||
**Select an Option:** [A] Advanced Elicitation [P] Party Mode [C] Continue
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
|
||||
|
|
|
|||
|
|
@ -88,7 +88,9 @@ Use holistic judgment, not mechanical keyword matching.
|
|||
|
||||
### No Escalation (simple request)
|
||||
|
||||
Display: "**Select:** [P] Plan first (tech-spec) [E] Execute directly"
|
||||
<display>
|
||||
**Select:** [P] Plan first (tech-spec) [E] Execute directly
|
||||
</display>
|
||||
|
||||
#### Menu Handling Logic:
|
||||
|
||||
|
|
|
|||
|
|
@ -67,7 +67,9 @@ a) **Menu Handling:**
|
|||
|
||||
a) **Greet the user briefly:**
|
||||
|
||||
"Hey {user_name}! What are we building today?"
|
||||
<display>
|
||||
Hey {user_name}! What are we building today?
|
||||
</display>
|
||||
|
||||
b) **Get their initial description.** Don't ask detailed questions yet - just understand enough to know where to look.
|
||||
|
||||
|
|
@ -150,19 +152,23 @@ a) **Create the tech-spec WIP file:**
|
|||
|
||||
b) **Report to user:**
|
||||
|
||||
"Created: `{wipFile}`
|
||||
<display>
|
||||
Created: `{wipFile}`
|
||||
|
||||
**Captured:**
|
||||
|
||||
- Title: {title}
|
||||
- Problem: {problem_statement_summary}
|
||||
- Scope: {scope_summary}"
|
||||
- Scope: {scope_summary}
|
||||
</display>
|
||||
|
||||
### 6. Present Checkpoint Menu
|
||||
|
||||
a) **Display menu:**
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Deep Investigation (Step 2 of 4)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Deep Investigation (Step 2 of 4)
|
||||
</display>
|
||||
|
||||
b) **HALT and wait for user selection.**
|
||||
|
||||
|
|
|
|||
|
|
@ -45,7 +45,9 @@ a) **Build on Step 1's Quick Scan**
|
|||
|
||||
Review what was found in Step 1's orient scan. Then ask:
|
||||
|
||||
"Based on my quick look, I see [files/patterns found]. Are there other files or directories I should investigate deeply?"
|
||||
<display>
|
||||
Based on my quick look, I see [files/patterns found]. Are there other files or directories I should investigate deeply?
|
||||
</display>
|
||||
|
||||
b) **Read and Analyze Code**
|
||||
|
||||
|
|
@ -106,16 +108,20 @@ Fill in:
|
|||
|
||||
**Report to user:**
|
||||
|
||||
"**Context Gathered:**
|
||||
<display>
|
||||
**Context Gathered:**
|
||||
|
||||
- Tech Stack: {tech_stack_summary}
|
||||
- Files to Modify: {files_count} files identified
|
||||
- Patterns: {patterns_summary}
|
||||
- Tests: {test_patterns_summary}"
|
||||
- Tests: {test_patterns_summary}
|
||||
</display>
|
||||
|
||||
### 4. Present Checkpoint Menu
|
||||
|
||||
Display: "**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Generate Spec (Step 3 of 4)"
|
||||
<display>
|
||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Generate Spec (Step 3 of 4)
|
||||
</display>
|
||||
|
||||
**HALT and wait for user selection.**
|
||||
|
||||
|
|
|
|||
|
|
@ -31,19 +31,25 @@ wipFile: '{implementation_artifacts}/tech-spec-wip.md'
|
|||
|
||||
**Present to user:**
|
||||
|
||||
"Here's your complete tech-spec. Please review:"
|
||||
<display>
|
||||
Here's your complete tech-spec. Please review:
|
||||
</display>
|
||||
|
||||
[Display the complete spec content - all sections]
|
||||
|
||||
"**Quick Summary:**
|
||||
<display>
|
||||
**Quick Summary:**
|
||||
|
||||
- {task_count} tasks to implement
|
||||
- {ac_count} acceptance criteria to verify
|
||||
- {files_count} files to modify"
|
||||
- {files_count} files to modify
|
||||
</display>
|
||||
|
||||
**Present review menu:**
|
||||
|
||||
Display: "**Select:** [C] Continue [E] Edit [Q] Questions [A] Advanced Elicitation [P] Party Mode"
|
||||
<display>
|
||||
**Select:** [C] Continue [E] Edit [Q] Questions [A] Advanced Elicitation [P] Party Mode
|
||||
</display>
|
||||
|
||||
**HALT and wait for user selection.**
|
||||
|
||||
|
|
@ -106,7 +112,7 @@ b) **Rename WIP file to final filename:**
|
|||
|
||||
a) **Display completion message and menu:**
|
||||
|
||||
```
|
||||
<display>
|
||||
**Tech-Spec Complete!**
|
||||
|
||||
Saved to: {finalFile}
|
||||
|
|
@ -127,12 +133,12 @@ Once you are fully satisfied with the spec (ideally after **Adversarial Review**
|
|||
|
||||
Copy this prompt to start dev:
|
||||
|
||||
\`\`\`
|
||||
```
|
||||
quick-dev {finalFile}
|
||||
\`\`\`
|
||||
```
|
||||
|
||||
This ensures the dev agent has clean context focused solely on implementation.
|
||||
```
|
||||
</display>
|
||||
|
||||
b) **HALT and wait for user selection.**
|
||||
|
||||
|
|
@ -173,7 +179,8 @@ b) **HALT and wait for user selection.**
|
|||
|
||||
**When user selects [D]:**
|
||||
|
||||
"**All done!** Your tech-spec is ready at:
|
||||
<display>
|
||||
**All done!** Your tech-spec is ready at:
|
||||
|
||||
`{finalFile}`
|
||||
|
||||
|
|
@ -183,7 +190,8 @@ When you're ready to implement, run:
|
|||
quick-dev {finalFile}
|
||||
```
|
||||
|
||||
Ship it!"
|
||||
Ship it!
|
||||
</display>
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -94,7 +94,7 @@ Your choice [1/2/3]:
|
|||
<action>Skip loading project-types.csv and architecture_registry.csv (not needed on resume)</action>
|
||||
<action>Store loaded doc requirements for use in remaining steps</action>
|
||||
|
||||
<action>Display: "Resuming {{workflow_mode}} from {{current_step}} with cached project type(s): {{cached_project_types}}"</action>
|
||||
<display>Resuming {{workflow_mode}} from {{current_step}} with cached project type(s): {{cached_project_types}}</display>
|
||||
|
||||
<check if="workflow_mode == deep_dive">
|
||||
<action>Read fully and follow: {installed_path}/workflows/deep-dive-instructions.md with resume context</action>
|
||||
|
|
@ -114,12 +114,12 @@ Your choice [1/2/3]:
|
|||
</check>
|
||||
|
||||
<check if="user selects 3">
|
||||
<action>Display: "Exiting workflow without changes."</action>
|
||||
<display>Exiting workflow without changes.</display>
|
||||
<action>Exit workflow</action>
|
||||
</check>
|
||||
|
||||
<check if="state file age >= 24 hours">
|
||||
<action>Display: "Found old state file (>24 hours). Starting fresh scan."</action>
|
||||
<display>Found old state file (>24 hours). Starting fresh scan.</display>
|
||||
<action>Archive old state file to: {output_folder}/.archive/project-scan-report-{{timestamp}}.json</action>
|
||||
<action>Set resume_mode = false</action>
|
||||
<action>Continue to Step 0.5</action>
|
||||
|
|
@ -147,7 +147,7 @@ Your choice [1/2/3]:
|
|||
|
||||
<check if="user selects 1">
|
||||
<action>Set workflow_mode = "full_rescan"</action>
|
||||
<action>Display: "Starting full project rescan..."</action>
|
||||
<display>Starting full project rescan...</display>
|
||||
<action>Read fully and follow: {installed_path}/workflows/full-scan-instructions.md</action>
|
||||
<action>After sub-workflow completes, continue to Step 4</action>
|
||||
</check>
|
||||
|
|
@ -155,7 +155,7 @@ Your choice [1/2/3]:
|
|||
<check if="user selects 2">
|
||||
<action>Set workflow_mode = "deep_dive"</action>
|
||||
<action>Set scan_level = "exhaustive"</action>
|
||||
<action>Display: "Starting deep-dive documentation mode..."</action>
|
||||
<display>Starting deep-dive documentation mode...</display>
|
||||
<action>Read fully and follow: {installed_path}/workflows/deep-dive-instructions.md</action>
|
||||
<action>After sub-workflow completes, continue to Step 4</action>
|
||||
</check>
|
||||
|
|
@ -168,7 +168,7 @@ Your choice [1/2/3]:
|
|||
|
||||
<check if="index.md does not exist">
|
||||
<action>Set workflow_mode = "initial_scan"</action>
|
||||
<action>Display: "No existing documentation found. Starting initial project scan..."</action>
|
||||
<display>No existing documentation found. Starting initial project scan...</display>
|
||||
<action>Read fully and follow: {installed_path}/workflows/full-scan-instructions.md</action>
|
||||
<action>After sub-workflow completes, continue to Step 4</action>
|
||||
</check>
|
||||
|
|
|
|||
|
|
@ -37,9 +37,9 @@ This workflow uses a single comprehensive CSV file to intelligently document you
|
|||
|
||||
<action>Load documentation-requirements.csv from: {documentation_requirements_csv}</action>
|
||||
<action>Store all 12 rows indexed by project_type_id for project detection and requirements lookup</action>
|
||||
<action>Display: "Loaded documentation requirements for 12 project types (web, mobile, backend, cli, library, desktop, game, data, extension, infra, embedded)"</action>
|
||||
<display>Loaded documentation requirements for 12 project types (web, mobile, backend, cli, library, desktop, game, data, extension, infra, embedded)</display>
|
||||
|
||||
<action>Display: "✓ Documentation requirements loaded successfully. Ready to begin project analysis."</action>
|
||||
<display>✓ Documentation requirements loaded successfully. Ready to begin project analysis.</display>
|
||||
</step>
|
||||
|
||||
<step n="0.6" goal="Check for existing documentation and determine workflow mode">
|
||||
|
|
@ -114,17 +114,17 @@ Your choice [1/2/3] (default: 1):
|
|||
|
||||
<action if="user selects 1 OR user presses enter">
|
||||
<action>Set scan_level = "quick"</action>
|
||||
<action>Display: "Using Quick Scan (pattern-based, no source file reading)"</action>
|
||||
<display>Using Quick Scan (pattern-based, no source file reading)</display>
|
||||
</action>
|
||||
|
||||
<action if="user selects 2">
|
||||
<action>Set scan_level = "deep"</action>
|
||||
<action>Display: "Using Deep Scan (reading critical files per project type)"</action>
|
||||
<display>Using Deep Scan (reading critical files per project type)</display>
|
||||
</action>
|
||||
|
||||
<action if="user selects 3">
|
||||
<action>Set scan_level = "exhaustive"</action>
|
||||
<action>Display: "Using Exhaustive Scan (reading all source files)"</action>
|
||||
<display>Using Exhaustive Scan (reading all source files)</display>
|
||||
</action>
|
||||
|
||||
<action>Initialize state file: {output_folder}/project-scan-report.json</action>
|
||||
|
|
@ -915,7 +915,7 @@ Enter number(s) separated by commas (e.g., "1,3,5"), or type 'all':
|
|||
- Store result in {{selected_items}} array
|
||||
</action>
|
||||
|
||||
<action>Display: "Generating {{selected_items.length}} document(s)..."</action>
|
||||
<display>Generating {{selected_items.length}} document(s)...</display>
|
||||
|
||||
<action>For each item in {{selected_items}}:
|
||||
|
||||
|
|
@ -927,7 +927,7 @@ Enter number(s) separated by commas (e.g., "1,3,5"), or type 'all':
|
|||
2. **Route to appropriate generation substep based on doc_type:**
|
||||
|
||||
**If doc_type == "architecture":**
|
||||
- Display: "Generating architecture documentation for {{part_id}}..."
|
||||
- <display>Generating architecture documentation for {{part_id}}...</display>
|
||||
- Load architecture_match for this part from state file (Step 3 cache)
|
||||
- Re-run Step 8 architecture generation logic ONLY for this specific part
|
||||
- Use matched template and fill with cached data from state file
|
||||
|
|
@ -935,7 +935,7 @@ Enter number(s) separated by commas (e.g., "1,3,5"), or type 'all':
|
|||
- Validate completeness
|
||||
|
||||
**If doc_type == "api-contracts":**
|
||||
- Display: "Generating API contracts for {{part_id}}..."
|
||||
- <display>Generating API contracts for {{part_id}}...</display>
|
||||
- Load part data and documentation_requirements
|
||||
- Re-run Step 4 API scan substep targeting ONLY this part
|
||||
- Use scan_level from state file (quick/deep/exhaustive)
|
||||
|
|
@ -943,35 +943,35 @@ Enter number(s) separated by commas (e.g., "1,3,5"), or type 'all':
|
|||
- Validate document structure
|
||||
|
||||
**If doc_type == "data-models":**
|
||||
- Display: "Generating data models documentation for {{part_id}}..."
|
||||
- <display>Generating data models documentation for {{part_id}}...</display>
|
||||
- Re-run Step 4 data models scan substep targeting ONLY this part
|
||||
- Use schema_migration_patterns from documentation_requirements
|
||||
- Generate data-models-{{part_id}}.md
|
||||
- Validate completeness
|
||||
|
||||
**If doc_type == "component-inventory":**
|
||||
- Display: "Generating component inventory for {{part_id}}..."
|
||||
- <display>Generating component inventory for {{part_id}}...</display>
|
||||
- Re-run Step 9 component inventory generation for this specific part
|
||||
- Scan components/, ui/, widgets/ folders
|
||||
- Generate component-inventory-{{part_id}}.md
|
||||
- Validate structure
|
||||
|
||||
**If doc_type == "development-guide":**
|
||||
- Display: "Generating development guide for {{part_id}}..."
|
||||
- <display>Generating development guide for {{part_id}}...</display>
|
||||
- Re-run Step 9 development guide generation for this specific part
|
||||
- Use key_file_patterns and test_file_patterns from documentation_requirements
|
||||
- Generate development-guide-{{part_id}}.md
|
||||
- Validate completeness
|
||||
|
||||
**If doc_type == "deployment-guide":**
|
||||
- Display: "Generating deployment guide..."
|
||||
- <display>Generating deployment guide...</display>
|
||||
- Re-run Step 6 deployment configuration scan
|
||||
- Re-run Step 9 deployment guide generation
|
||||
- Generate deployment-guide.md
|
||||
- Validate structure
|
||||
|
||||
**If doc_type == "integration-architecture":**
|
||||
- Display: "Generating integration architecture..."
|
||||
- <display>Generating integration architecture...</display>
|
||||
- Re-run Step 7 integration analysis for all parts
|
||||
- Generate integration-architecture.md
|
||||
- Validate completeness
|
||||
|
|
@ -980,7 +980,7 @@ Enter number(s) separated by commas (e.g., "1,3,5"), or type 'all':
|
|||
- Confirm file was written successfully
|
||||
- Update state file with newly generated output
|
||||
- Add to {{newly_generated_docs}} tracking list
|
||||
- Display: "✓ Generated: {{file_path}}"
|
||||
- <display>✓ Generated: {{file_path}}</display>
|
||||
|
||||
4. **Handle errors:**
|
||||
- If generation fails, log error and continue with next item
|
||||
|
|
@ -1101,6 +1101,6 @@ When ready to plan new features, run the PRD workflow and provide this index as
|
|||
- Write final state file
|
||||
</action>
|
||||
|
||||
<action>Display: "State file saved: {{output_folder}}/project-scan-report.json"</action>
|
||||
<display>State file saved: {{output_folder}}/project-scan-report.json</display>
|
||||
|
||||
</workflow>
|
||||
|
|
|
|||
|
|
@ -135,7 +135,8 @@ Set frontmatter `sections_completed` to track what will be updated
|
|||
|
||||
Report findings to user:
|
||||
|
||||
"Welcome {{user_name}}! I've analyzed your project for {{project_name}} to discover the context that AI agents need.
|
||||
<display>
|
||||
Welcome {{user_name}}! I've analyzed your project for {{project_name}} to discover the context that AI agents need.
|
||||
|
||||
**Technology Stack Discovered:**
|
||||
{{list_of_technologies_with_versions}}
|
||||
|
|
@ -158,7 +159,8 @@ Report findings to user:
|
|||
|
||||
Ready to create/update your project context. This will help AI agents implement code consistently with your project's standards.
|
||||
|
||||
[C] Continue to context generation"
|
||||
[C] Continue to context generation
|
||||
</display>
|
||||
|
||||
## SUCCESS METRICS:
|
||||
|
||||
|
|
|
|||
|
|
@ -55,13 +55,16 @@ Document the exact technology stack from discovery:
|
|||
Based on user skill level, present findings:
|
||||
|
||||
**Expert Mode:**
|
||||
"Technology stack from your architecture and package files:
|
||||
<display>
|
||||
Technology stack from your architecture and package files:
|
||||
{{exact_technologies_with_versions}}
|
||||
|
||||
Any critical version constraints I should document for agents?"
|
||||
Any critical version constraints I should document for agents?
|
||||
</display>
|
||||
|
||||
**Intermediate Mode:**
|
||||
"I found your technology stack:
|
||||
<display>
|
||||
I found your technology stack:
|
||||
|
||||
**Core Technologies:**
|
||||
{{main_technologies_with_versions}}
|
||||
|
|
@ -69,10 +72,12 @@ Any critical version constraints I should document for agents?"
|
|||
**Key Dependencies:**
|
||||
{{important_dependencies_with_versions}}
|
||||
|
||||
Are there any version constraints or compatibility notes agents should know about?"
|
||||
Are there any version constraints or compatibility notes agents should know about?
|
||||
</display>
|
||||
|
||||
**Beginner Mode:**
|
||||
"Here are the technologies you're using:
|
||||
<display>
|
||||
Here are the technologies you're using:
|
||||
|
||||
**Main Technologies:**
|
||||
{{friendly_description_of_tech_stack}}
|
||||
|
|
@ -80,14 +85,16 @@ Are there any version constraints or compatibility notes agents should know abou
|
|||
**Important Notes:**
|
||||
{{key_things_agents_need_to_know_about_versions}}
|
||||
|
||||
Should I document any special version rules or compatibility requirements?"
|
||||
Should I document any special version rules or compatibility requirements?
|
||||
</display>
|
||||
|
||||
### 2. Language-Specific Rules
|
||||
|
||||
Focus on unobvious language patterns agents might miss:
|
||||
|
||||
**TypeScript/JavaScript Rules:**
|
||||
"Based on your codebase, I notice some specific patterns:
|
||||
<display>
|
||||
Based on your codebase, I notice some specific patterns:
|
||||
|
||||
**Configuration Requirements:**
|
||||
{{typescript_config_rules}}
|
||||
|
|
@ -98,7 +105,8 @@ Focus on unobvious language patterns agents might miss:
|
|||
**Error Handling Patterns:**
|
||||
{{error_handling_requirements}}
|
||||
|
||||
Are these patterns correct? Any other language-specific rules agents should follow?"
|
||||
Are these patterns correct? Any other language-specific rules agents should follow?
|
||||
</display>
|
||||
|
||||
**Python/Ruby/Other Language Rules:**
|
||||
Adapt to the actual language in use with similar focused questions.
|
||||
|
|
@ -108,7 +116,8 @@ Adapt to the actual language in use with similar focused questions.
|
|||
Document framework-specific patterns:
|
||||
|
||||
**React Rules (if applicable):**
|
||||
"For React development, I see these patterns:
|
||||
<display>
|
||||
For React development, I see these patterns:
|
||||
|
||||
**Hooks Usage:**
|
||||
{{hooks_usage_patterns}}
|
||||
|
|
@ -122,7 +131,8 @@ Document framework-specific patterns:
|
|||
**Performance Rules:**
|
||||
{{performance_optimization_requirements}}
|
||||
|
||||
Should I add any other React-specific rules?"
|
||||
Should I add any other React-specific rules?
|
||||
</display>
|
||||
|
||||
**Other Framework Rules:**
|
||||
Adapt for Vue, Angular, Next.js, Express, etc.
|
||||
|
|
@ -132,7 +142,8 @@ Adapt for Vue, Angular, Next.js, Express, etc.
|
|||
Focus on testing patterns that ensure consistency:
|
||||
|
||||
**Test Structure Rules:**
|
||||
"Your testing setup shows these patterns:
|
||||
<display>
|
||||
Your testing setup shows these patterns:
|
||||
|
||||
**Test Organization:**
|
||||
{{test_file_organization}}
|
||||
|
|
@ -146,14 +157,16 @@ Focus on testing patterns that ensure consistency:
|
|||
**Integration vs Unit Test Rules:**
|
||||
{{test_boundary_patterns}}
|
||||
|
||||
Are there testing rules agents should always follow?"
|
||||
Are there testing rules agents should always follow?
|
||||
</display>
|
||||
|
||||
### 5. Code Quality & Style Rules
|
||||
|
||||
Document critical style and quality rules:
|
||||
|
||||
**Linting/Formatting:**
|
||||
"Your code style configuration requires:
|
||||
<display>
|
||||
Your code style configuration requires:
|
||||
|
||||
**ESLint/Prettier Rules:**
|
||||
{{specific_linting_rules}}
|
||||
|
|
@ -167,14 +180,16 @@ Document critical style and quality rules:
|
|||
**Documentation Requirements:**
|
||||
{{comment_and_documentation_patterns}}
|
||||
|
||||
Any additional code quality rules?"
|
||||
Any additional code quality rules?
|
||||
</display>
|
||||
|
||||
### 6. Development Workflow Rules
|
||||
|
||||
Document workflow patterns that affect implementation:
|
||||
|
||||
**Git/Repository Rules:**
|
||||
"Your project uses these patterns:
|
||||
<display>
|
||||
Your project uses these patterns:
|
||||
|
||||
**Branch Naming:**
|
||||
{{branch_naming_conventions}}
|
||||
|
|
@ -188,14 +203,16 @@ Document workflow patterns that affect implementation:
|
|||
**Deployment Patterns:**
|
||||
{{deployment_considerations}}
|
||||
|
||||
Should I document any other workflow rules?"
|
||||
Should I document any other workflow rules?
|
||||
</display>
|
||||
|
||||
### 7. Critical Don't-Miss Rules
|
||||
|
||||
Identify rules that prevent common mistakes:
|
||||
|
||||
**Anti-Patterns to Avoid:**
|
||||
"Based on your codebase, here are critical things agents must NOT do:
|
||||
<display>
|
||||
Based on your codebase, here are critical things agents must NOT do:
|
||||
|
||||
{{critical_anti_patterns_with_examples}}
|
||||
|
||||
|
|
@ -208,7 +225,8 @@ Identify rules that prevent common mistakes:
|
|||
**Performance Gotchas:**
|
||||
{{performance_patterns_to_avoid}}
|
||||
|
||||
Are there other 'gotchas' agents should know about?"
|
||||
Are there other 'gotchas' agents should know about?
|
||||
</display>
|
||||
|
||||
### 8. Generate Context Content
|
||||
|
||||
|
|
@ -252,7 +270,8 @@ For each category, prepare lean content for the project context file:
|
|||
|
||||
After each category, show the generated rules and present choices:
|
||||
|
||||
"I've drafted the {{category_name}} rules for your project context.
|
||||
<display>
|
||||
I've drafted the {{category_name}} rules for your project context.
|
||||
|
||||
**Here's what I'll add:**
|
||||
|
||||
|
|
@ -261,7 +280,8 @@ After each category, show the generated rules and present choices:
|
|||
**What would you like to do?**
|
||||
[A] Advanced Elicitation - Explore nuanced rules for this category
|
||||
[P] Party Mode - Review from different implementation perspectives
|
||||
[C] Continue - Save these rules and move to next category"
|
||||
[C] Continue - Save these rules and move to next category
|
||||
</display>
|
||||
|
||||
### 10. Handle Menu Selection
|
||||
|
||||
|
|
|
|||
|
|
@ -133,14 +133,17 @@ Last Updated: {{date}}
|
|||
Based on user skill level, present the completion:
|
||||
|
||||
**Expert Mode:**
|
||||
"Project context complete. Optimized for LLM consumption with {{rule_count}} critical rules across {{section_count}} sections.
|
||||
<display>
|
||||
Project context complete. Optimized for LLM consumption with {{rule_count}} critical rules across {{section_count}} sections.
|
||||
|
||||
File saved to: `{output_folder}/project-context.md`
|
||||
|
||||
Ready for AI agent integration."
|
||||
Ready for AI agent integration.
|
||||
</display>
|
||||
|
||||
**Intermediate Mode:**
|
||||
"Your project context is complete and optimized for AI agents!
|
||||
<display>
|
||||
Your project context is complete and optimized for AI agents!
|
||||
|
||||
**What we created:**
|
||||
|
||||
|
|
@ -160,10 +163,12 @@ Ready for AI agent integration."
|
|||
|
||||
- AI agents should read this file before implementing
|
||||
- Update as your project evolves
|
||||
- Review periodically for optimization"
|
||||
- Review periodically for optimization
|
||||
</display>
|
||||
|
||||
**Beginner Mode:**
|
||||
"Excellent! Your project context guide is ready! 🎉
|
||||
<display>
|
||||
Excellent! Your project context guide is ready!
|
||||
|
||||
**What this does:**
|
||||
Think of this as a 'rules of the road' guide for AI agents working on your project. It ensures they all follow the same patterns and avoid common mistakes.
|
||||
|
|
@ -178,7 +183,8 @@ Think of this as a 'rules of the road' guide for AI agents working on your proje
|
|||
**How AI agents use it:**
|
||||
They read this file before writing any code, ensuring everything they create follows your project's standards perfectly.
|
||||
|
||||
Your project context is saved and ready to help agents implement consistently!"
|
||||
Your project context is saved and ready to help agents implement consistently!
|
||||
</display>
|
||||
|
||||
### 5. Final File Updates
|
||||
|
||||
|
|
@ -225,32 +231,34 @@ Final checks before completion:
|
|||
|
||||
Present final completion to user:
|
||||
|
||||
"✅ **Project Context Generation Complete!**
|
||||
<display>
|
||||
**Project Context Generation Complete!**
|
||||
|
||||
Your optimized project context file is ready at:
|
||||
`{output_folder}/project-context.md`
|
||||
|
||||
**📊 Context Summary:**
|
||||
**Context Summary:**
|
||||
|
||||
- {{rule_count}} critical rules for AI agents
|
||||
- {{section_count}} comprehensive sections
|
||||
- Optimized for LLM context efficiency
|
||||
- Ready for immediate agent integration
|
||||
|
||||
**🎯 Key Benefits:**
|
||||
**Key Benefits:**
|
||||
|
||||
- Consistent implementation across all AI agents
|
||||
- Reduced common mistakes and edge cases
|
||||
- Clear guidance for project-specific patterns
|
||||
- Minimal LLM context usage
|
||||
|
||||
**📋 Next Steps:**
|
||||
**Next Steps:**
|
||||
|
||||
1. AI agents will automatically read this file when implementing
|
||||
2. Update this file when your technology stack or patterns evolve
|
||||
3. Review quarterly to optimize and remove outdated rules
|
||||
|
||||
Your project context will help ensure high-quality, consistent implementation across all development work. Great work capturing your project's critical implementation requirements!"
|
||||
Your project context will help ensure high-quality, consistent implementation across all development work. Great work capturing your project's critical implementation requirements!
|
||||
</display>
|
||||
|
||||
## SUCCESS METRICS:
|
||||
|
||||
|
|
|
|||
|
|
@ -131,6 +131,7 @@
|
|||
<tag>template-output - Save content checkpoint</tag>
|
||||
<tag>critical - Cannot be skipped</tag>
|
||||
<tag>example - Show example output</tag>
|
||||
<tag>display - Present enclosed content to user verbatim (no file save, no pause)</tag>
|
||||
</output>
|
||||
</supported-tags>
|
||||
|
||||
|
|
|
|||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue