refactor: complete display tag migration across all workflows
Convert remaining bare quote output blocks and Display: patterns to <display> tags in 48 files across product-brief, ux-design, architecture, check-implementation-readiness, quick-spec, research, brainstorming, party-mode, generate-project-context, and document-project workflows. Fix orphaned quote artifact in step-09-functional.md.
This commit is contained in:
parent
7746b8f066
commit
35c7ec55d1
|
|
@ -117,7 +117,8 @@ Try to discover the following:
|
||||||
#### C. Present Initialization Results
|
#### C. Present Initialization Results
|
||||||
|
|
||||||
**Setup Report to User:**
|
**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:**
|
**Document Setup:**
|
||||||
|
|
||||||
|
|
@ -133,7 +134,8 @@ Try to discover the following:
|
||||||
|
|
||||||
**Files loaded:** {list of specific file names or "No additional documents found"}
|
**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
|
### 4. Present MENU OPTIONS
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -75,7 +75,8 @@ Review the frontmatter to understand:
|
||||||
### 3. Present Current Progress
|
### 3. Present Current Progress
|
||||||
|
|
||||||
**Progress Report to User:**
|
**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:**
|
**Current Progress:**
|
||||||
|
|
||||||
|
|
@ -88,7 +89,8 @@ Review the frontmatter to understand:
|
||||||
- Current product brief is ready with all completed sections
|
- Current product brief is ready with all completed sections
|
||||||
- Ready to continue from where we left off
|
- 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
|
### 4. Determine Continuation Path
|
||||||
|
|
||||||
|
|
@ -104,7 +106,8 @@ Based on `lastStep` value, determine which step to load next:
|
||||||
### 5. Handle Workflow Completion
|
### 5. Handle Workflow Completion
|
||||||
|
|
||||||
**If workflow already complete (`lastStep = 6`):**
|
**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.
|
The final document is ready at `{outputFile}` with all sections completed through step 6.
|
||||||
|
|
||||||
|
|
@ -114,7 +117,8 @@ Would you like me to:
|
||||||
- Suggest next workflow steps (like PRD creation)
|
- Suggest next workflow steps (like PRD creation)
|
||||||
- Start a new product brief revision
|
- Start a new product brief revision
|
||||||
|
|
||||||
What would be most helpful?"
|
What would be most helpful?
|
||||||
|
</display>
|
||||||
|
|
||||||
### 6. Present MENU OPTIONS
|
### 6. Present MENU OPTIONS
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -61,7 +61,8 @@ Conduct comprehensive product vision discovery to define the core problem, solut
|
||||||
### 1. Begin Vision Discovery
|
### 1. Begin Vision Discovery
|
||||||
|
|
||||||
**Opening Conversation:**
|
**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:**
|
**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 would success look like for the people you're helping?
|
||||||
- What excites you most about this solution?
|
- 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
|
### 2. Deep Problem Understanding
|
||||||
|
|
||||||
|
|
@ -147,12 +149,14 @@ Prepare the following structure for document append:
|
||||||
### 7. Present MENU OPTIONS
|
### 7. Present MENU OPTIONS
|
||||||
|
|
||||||
**Content Presentation:**
|
**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:**
|
**Here's what I'll add to the document:**
|
||||||
[Show the complete markdown content from step 6]
|
[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:
|
#### 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
|
### 1. Begin User Discovery
|
||||||
|
|
||||||
**Opening Exploration:**
|
**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:**
|
**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?
|
- Who gets the most value from this solution?
|
||||||
- Are there primary users and secondary users we should consider?
|
- 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
|
### 2. Primary User Segment Development
|
||||||
|
|
||||||
|
|
@ -150,12 +152,14 @@ Prepare the following structure for document append:
|
||||||
### 6. Present MENU OPTIONS
|
### 6. Present MENU OPTIONS
|
||||||
|
|
||||||
**Content Presentation:**
|
**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:**
|
**Here's what I'll add to the document:**
|
||||||
[Show the complete markdown content from step 5]
|
[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:
|
#### Menu Handling Logic:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -61,7 +61,8 @@ Define comprehensive success metrics that include user success, business objecti
|
||||||
### 1. Begin Success Metrics Discovery
|
### 1. Begin Success Metrics Discovery
|
||||||
|
|
||||||
**Opening Exploration:**
|
**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:**
|
**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 would make users say 'this was worth it'?
|
||||||
- What metrics show we're creating real value?
|
- 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
|
### 2. User Success Metrics
|
||||||
|
|
||||||
|
|
@ -153,12 +155,14 @@ Prepare the following structure for document append:
|
||||||
### 7. Present MENU OPTIONS
|
### 7. Present MENU OPTIONS
|
||||||
|
|
||||||
**Content Presentation:**
|
**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:**
|
**Here's what I'll add to the document:**
|
||||||
[Show the complete markdown content from step 6]
|
[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:
|
#### Menu Handling Logic:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -61,7 +61,8 @@ Define MVP scope with clear boundaries and outline future vision through collabo
|
||||||
### 1. Begin Scope Definition
|
### 1. Begin Scope Definition
|
||||||
|
|
||||||
**Opening Exploration:**
|
**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:**
|
**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'?
|
- What features would make users say 'this solves my problem'?
|
||||||
- How do we balance ambition with getting something valuable to users quickly?
|
- 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
|
### 2. MVP Core Features Definition
|
||||||
|
|
||||||
|
|
@ -167,12 +169,14 @@ Prepare the following structure for document append:
|
||||||
### 7. Present MENU OPTIONS
|
### 7. Present MENU OPTIONS
|
||||||
|
|
||||||
**Content Presentation:**
|
**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:**
|
**Here's what I'll add to the document:**
|
||||||
[Show the complete markdown content from step 6]
|
[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:
|
#### Menu Handling Logic:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -56,22 +56,24 @@ Complete the product brief workflow, update status files, and provide guidance o
|
||||||
### 1. Announce Workflow Completion
|
### 1. Announce Workflow Completion
|
||||||
|
|
||||||
**Completion Announcement:**
|
**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}}.
|
I've successfully collaborated with you to create a comprehensive Product Brief for {{project_name}}.
|
||||||
|
|
||||||
**What we've accomplished:**
|
**What we've accomplished:**
|
||||||
|
|
||||||
- ✅ Executive Summary with clear vision and problem statement
|
- Executive Summary with clear vision and problem statement
|
||||||
- ✅ Core Vision with solution definition and unique differentiators
|
- Core Vision with solution definition and unique differentiators
|
||||||
- ✅ Target Users with rich personas and user journeys
|
- Target Users with rich personas and user journeys
|
||||||
- ✅ Success Metrics with measurable outcomes and business objectives
|
- Success Metrics with measurable outcomes and business objectives
|
||||||
- ✅ MVP Scope with focused feature set and clear boundaries
|
- MVP Scope with focused feature set and clear boundaries
|
||||||
- ✅ Future Vision that inspires while maintaining current focus
|
- Future Vision that inspires while maintaining current focus
|
||||||
|
|
||||||
**The complete Product Brief is now available at:** `{outputFile}`
|
**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
|
### 2. Document Quality Check
|
||||||
|
|
||||||
|
|
@ -116,7 +118,9 @@ Provide guidance on logical next workflows:
|
||||||
|
|
||||||
### 4. Congrats to the user
|
### 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:
|
Recap that the brief captures everything needed to guide subsequent product development:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -91,7 +91,8 @@ Execute research type discovery and routing:
|
||||||
|
|
||||||
### Collaborative Research Discovery
|
### 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.**
|
**Let me help you clarify what you'd like to research.**
|
||||||
|
|
||||||
|
|
@ -104,6 +105,7 @@ For example:
|
||||||
- 'AI implementation in financial services'
|
- 'AI implementation in financial services'
|
||||||
- 'Sustainable packaging regulations'
|
- 'Sustainable packaging regulations'
|
||||||
- 'Or anything else you have in mind...'
|
- 'Or anything else you have in mind...'
|
||||||
|
</display>
|
||||||
|
|
||||||
### Topic Exploration and Clarification
|
### Topic Exploration and Clarification
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -176,7 +176,7 @@ Present the functional requirements for review, then display menu:
|
||||||
- Ask if they'd like to refine further, get other perspectives, or proceed
|
- Ask if they'd like to refine further, get other perspectives, or proceed
|
||||||
- Present menu options naturally as part of conversation
|
- Present menu options naturally as part of conversation
|
||||||
|
|
||||||
**What would you like to do?**"
|
**What would you like to do?**
|
||||||
|
|
||||||
<display>
|
<display>
|
||||||
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Non-Functional Requirements (Step 10 of 11)
|
**Select:** [A] Advanced Elicitation [P] Party Mode [C] Continue to Non-Functional Requirements (Step 10 of 11)
|
||||||
|
|
|
||||||
|
|
@ -132,7 +132,7 @@ Display:
|
||||||
- Note: This hands off to the validation workflow which will run its complete 13-step process
|
- Note: This hands off to the validation workflow which will run its complete 13-step process
|
||||||
|
|
||||||
- **IF E (Edit More):**
|
- **IF E (Edit More):**
|
||||||
- Display: "**Additional Edits**"
|
- <display>**Additional Edits**</display>
|
||||||
- Ask: "What additional edits would you like to make?"
|
- Ask: "What additional edits would you like to make?"
|
||||||
- Accept input, then display: "**Returning to edit step...**"
|
- Accept input, then display: "**Returning to edit step...**"
|
||||||
- Read fully and follow: step-e-03-edit.md again
|
- Read fully and follow: step-e-03-edit.md again
|
||||||
|
|
@ -142,12 +142,12 @@ Display:
|
||||||
- Complete list of all changes made
|
- Complete list of all changes made
|
||||||
- Before/after comparison (key improvements)
|
- Before/after comparison (key improvements)
|
||||||
- Recommendations for next steps
|
- Recommendations for next steps
|
||||||
- Display: "**Edit Workflow Complete**"
|
- <display>**Edit Workflow Complete**</display>
|
||||||
- Exit
|
- Exit
|
||||||
|
|
||||||
- **IF X (Exit):**
|
- **IF X (Exit):**
|
||||||
- Display summary
|
- Display summary
|
||||||
- Display: "**Edit Workflow Complete**"
|
- <display>**Edit Workflow Complete**</display>
|
||||||
- Exit
|
- Exit
|
||||||
|
|
||||||
- **IF Any other:** Help user, then redisplay menu
|
- **IF Any other:** Help user, then redisplay menu
|
||||||
|
|
|
||||||
|
|
@ -94,7 +94,8 @@ Complete setup and report to user:
|
||||||
|
|
||||||
**Input Documents Discovered:**
|
**Input Documents Discovered:**
|
||||||
Report what was found:
|
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:**
|
**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?
|
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:
|
## NEXT STEP:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -52,7 +52,8 @@ Reload the context documents listed in `inputDocuments`:
|
||||||
### 3. Summarize Current Progress
|
### 3. Summarize Current Progress
|
||||||
|
|
||||||
Welcome the user back and provide context:
|
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:**
|
**Current Progress:**
|
||||||
|
|
||||||
|
|
@ -66,7 +67,8 @@ Welcome the user back and provide context:
|
||||||
- Current UX design document is ready with all completed sections
|
- Current UX design document is ready with all completed sections
|
||||||
- Ready to continue from where we left off
|
- 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
|
### 4. Determine Next Step
|
||||||
|
|
||||||
|
|
@ -81,9 +83,11 @@ Based on `lastStep` value, determine which step to load next:
|
||||||
### 5. Present Continuation Options
|
### 5. Present Continuation Options
|
||||||
|
|
||||||
After presenting current progress, ask:
|
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:
|
## SUCCESS METRICS:
|
||||||
|
|
||||||
|
|
@ -106,7 +110,8 @@ After presenting current progress, ask:
|
||||||
## WORKFLOW ALREADY COMPLETE?
|
## WORKFLOW ALREADY COMPLETE?
|
||||||
|
|
||||||
If `lastStep` indicates the final step is completed:
|
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}.
|
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)
|
- Suggest next workflow steps (like wireframe generation or architecture)
|
||||||
- Start a new UX design revision
|
- Start a new UX design revision
|
||||||
|
|
||||||
What would be most helpful?"
|
What would be most helpful?
|
||||||
|
</display>
|
||||||
|
|
||||||
## NEXT STEP:
|
## NEXT STEP:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -51,7 +51,8 @@ Understand the project context, target users, and what makes this product specia
|
||||||
### 1. Review Loaded Context
|
### 1. Review Loaded Context
|
||||||
|
|
||||||
Start by analyzing what we know from the loaded documents:
|
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:**
|
**From the documents:**
|
||||||
{summary of key insights from loaded PRD, briefs, and other context 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:**
|
**Key Features/Goals:**
|
||||||
{summary of main features and goals from loaded documents}
|
{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)
|
### 2. Fill Context Gaps (If no documents or gaps exist)
|
||||||
|
|
||||||
If no documents were loaded or key information is missing:
|
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)
|
**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 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
|
### 3. Explore User Context Deeper
|
||||||
|
|
||||||
Dive into user understanding:
|
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:**
|
**User Context Questions:**
|
||||||
|
|
||||||
|
|
@ -89,12 +94,14 @@ Dive into user understanding:
|
||||||
- What would make them say 'this is exactly what I needed'?
|
- What would make them say 'this is exactly what I needed'?
|
||||||
- How tech-savvy are your target users?
|
- How tech-savvy are your target users?
|
||||||
- What devices will they use most?
|
- 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
|
### 4. Identify UX Design Challenges
|
||||||
|
|
||||||
Surface the key UX challenges to address:
|
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:**
|
**Design Challenges:**
|
||||||
|
|
||||||
|
|
@ -107,7 +114,8 @@ Surface the key UX challenges to address:
|
||||||
- [Identify 2-3 areas where great UX could create competitive advantage]
|
- [Identify 2-3 areas where great UX could create competitive advantage]
|
||||||
- [Note any opportunities for innovative UX patterns]
|
- [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
|
### 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
|
### 6. Present Content and Menu
|
||||||
|
|
||||||
Show the generated project understanding content and present choices:
|
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:**
|
**Here's what I'll add to the document:**
|
||||||
|
|
||||||
[Show the complete markdown content from step 5]
|
[Show the complete markdown content from step 5]
|
||||||
|
|
||||||
**What would you like to do?**
|
**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
|
### 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
|
### 1. Define Core User Action
|
||||||
|
|
||||||
Start by identifying the most important user interaction:
|
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:**
|
**Core Experience Questions:**
|
||||||
|
|
||||||
|
|
@ -60,12 +61,14 @@ Start by identifying the most important user interaction:
|
||||||
- What should be completely effortless for users?
|
- What should be completely effortless for users?
|
||||||
- If we nail one interaction, everything else follows - what is it?
|
- 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
|
### 2. Explore Platform Requirements
|
||||||
|
|
||||||
Determine where and how users will interact:
|
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:**
|
**Platform Questions:**
|
||||||
|
|
||||||
|
|
@ -73,34 +76,40 @@ Determine where and how users will interact:
|
||||||
- Will this be primarily touch-based or mouse/keyboard?
|
- Will this be primarily touch-based or mouse/keyboard?
|
||||||
- Any specific platform requirements or constraints?
|
- Any specific platform requirements or constraints?
|
||||||
- Do we need to consider offline functionality?
|
- 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
|
### 3. Identify Effortless Interactions
|
||||||
|
|
||||||
Surface what should feel magical or completely seamless:
|
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?
|
- What user actions should feel completely natural and require zero thought?
|
||||||
- Where do users currently struggle with similar products?
|
- Where do users currently struggle with similar products?
|
||||||
- What interaction, if made effortless, would create delight?
|
- What interaction, if made effortless, would create delight?
|
||||||
- What should happen automatically without user intervention?
|
- 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
|
### 4. Define Critical Success Moments
|
||||||
|
|
||||||
Identify the moments that determine success or failure:
|
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'?
|
- What's the moment where users realize 'this is better'?
|
||||||
- When does the user feel successful or accomplished?
|
- When does the user feel successful or accomplished?
|
||||||
- What interaction, if failed, would ruin the experience?
|
- What interaction, if failed, would ruin the experience?
|
||||||
- What are the make-or-break user flows?
|
- 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
|
### 5. Synthesize Experience Principles
|
||||||
|
|
||||||
Extract guiding principles from the conversation:
|
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:**
|
**Experience Principles:**
|
||||||
|
|
||||||
|
|
@ -109,7 +118,8 @@ Extract guiding principles from the conversation:
|
||||||
- [Principle 3 based on platform considerations]
|
- [Principle 3 based on platform considerations]
|
||||||
- [Principle 4 based on critical success moments]
|
- [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
|
### 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
|
### 7. Present Content and Menu
|
||||||
|
|
||||||
Show the generated core experience content and present choices:
|
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:**
|
**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?**
|
**What would you like to do?**
|
||||||
[A] Advanced Elicitation - Let's refine the core experience definition
|
[A] Advanced Elicitation - Let's refine the core experience definition
|
||||||
[P] Party Mode - Bring different perspectives on the user experience
|
[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
|
### 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
|
### 1. Explore Core Emotional Goals
|
||||||
|
|
||||||
Start by understanding the emotional objectives:
|
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:**
|
**Emotional Response Questions:**
|
||||||
|
|
||||||
|
|
@ -60,23 +61,27 @@ Start by understanding the emotional objectives:
|
||||||
- How should users feel after accomplishing their primary goal?
|
- How should users feel after accomplishing their primary goal?
|
||||||
- What feeling differentiates this from competitors?
|
- 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
|
### 2. Identify Emotional Journey Mapping
|
||||||
|
|
||||||
Explore feelings at different stages:
|
Explore feelings at different stages:
|
||||||
"**Emotional Journey Considerations:**
|
<display>
|
||||||
|
**Emotional Journey Considerations:**
|
||||||
|
|
||||||
- How should users feel when they first discover the product?
|
- How should users feel when they first discover the product?
|
||||||
- What emotion during the core experience/action?
|
- What emotion during the core experience/action?
|
||||||
- How should they feel after completing their task?
|
- How should they feel after completing their task?
|
||||||
- What if something goes wrong - what emotional response do we want?
|
- 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
|
### 3. Define Micro-Emotions
|
||||||
|
|
||||||
Surface subtle but important emotional states:
|
Surface subtle but important emotional states:
|
||||||
"**Micro-Emotions to Consider:**
|
<display>
|
||||||
|
**Micro-Emotions to Consider:**
|
||||||
|
|
||||||
- Confidence vs. Confusion
|
- Confidence vs. Confusion
|
||||||
- Trust vs. Skepticism
|
- Trust vs. Skepticism
|
||||||
|
|
@ -85,12 +90,14 @@ Surface subtle but important emotional states:
|
||||||
- Delight vs. Satisfaction
|
- Delight vs. Satisfaction
|
||||||
- Belonging vs. Isolation
|
- 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
|
### 4. Connect Emotions to UX Decisions
|
||||||
|
|
||||||
Link feelings to design implications:
|
Link feelings to design implications:
|
||||||
"**Design Implications:**
|
<display>
|
||||||
|
**Design Implications:**
|
||||||
|
|
||||||
- If we want users to feel [emotional state], what UX choices support this?
|
- If we want users to feel [emotional state], what UX choices support this?
|
||||||
- What interactions might create negative emotions we want to avoid?
|
- 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 1] → [UX design approach]
|
||||||
- [Emotion 2] → [UX design approach]
|
- [Emotion 2] → [UX design approach]
|
||||||
- [Emotion 3] → [UX design approach]"
|
- [Emotion 3] → [UX design approach]
|
||||||
|
</display>
|
||||||
|
|
||||||
### 5. Validate Emotional Goals
|
### 5. Validate Emotional Goals
|
||||||
|
|
||||||
Check if emotional goals align with product vision:
|
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]
|
**Primary Emotional Goal:** [Summarize main emotional response]
|
||||||
**Secondary Feelings:** [List supporting emotional states]
|
**Secondary Feelings:** [List supporting emotional states]
|
||||||
**Emotions to Avoid:** [List negative emotions to prevent]
|
**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
|
### 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
|
### 7. Present Content and Menu
|
||||||
|
|
||||||
Show the generated emotional response content and present choices:
|
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:**
|
**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?**
|
**What would you like to do?**
|
||||||
[A] Advanced Elicitation - Let's refine the emotional response definition
|
[A] Advanced Elicitation - Let's refine the emotional response definition
|
||||||
[P] Party Mode - Bring different perspectives on user emotional needs
|
[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
|
### 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
|
### 1. Identify User's Favorite Apps
|
||||||
|
|
||||||
Start by gathering inspiration sources:
|
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:**
|
**Inspiration Questions:**
|
||||||
|
|
||||||
|
|
@ -60,12 +61,14 @@ Start by gathering inspiration sources:
|
||||||
- What makes the experience compelling or delightful?
|
- What makes the experience compelling or delightful?
|
||||||
- What keeps users coming back to these apps?
|
- 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
|
### 2. Analyze UX Patterns and Principles
|
||||||
|
|
||||||
Break down what makes these apps successful:
|
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]:**
|
**For [App Name]:**
|
||||||
|
|
||||||
|
|
@ -74,12 +77,14 @@ Break down what makes these apps successful:
|
||||||
- How do they handle navigation and information hierarchy?
|
- How do they handle navigation and information hierarchy?
|
||||||
- What are their most innovative or delightful interactions?
|
- What are their most innovative or delightful interactions?
|
||||||
- What visual design choices support the user experience?
|
- 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
|
### 3. Extract Transferable Patterns
|
||||||
|
|
||||||
Identify patterns that could apply to your project:
|
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:
|
Looking across these inspiring apps, I see patterns we could adapt:
|
||||||
|
|
||||||
**Navigation Patterns:**
|
**Navigation Patterns:**
|
||||||
|
|
@ -97,24 +102,28 @@ Looking across these inspiring apps, I see patterns we could adapt:
|
||||||
- [Pattern 1] - supports your [emotional goal]
|
- [Pattern 1] - supports your [emotional goal]
|
||||||
- [Pattern 2] - aligns with your [platform requirements]
|
- [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
|
### 4. Identify Anti-Patterns to Avoid
|
||||||
|
|
||||||
Surface what not to do based on analysis:
|
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:
|
From analyzing both successes and failures in your space, here are patterns to avoid:
|
||||||
|
|
||||||
- [Anti-pattern 1] - users find this confusing/frustrating
|
- [Anti-pattern 1] - users find this confusing/frustrating
|
||||||
- [Anti-pattern 2] - this creates unnecessary friction
|
- [Anti-pattern 2] - this creates unnecessary friction
|
||||||
- [Anti-pattern 3] - doesn't align with your [emotional goals]
|
- [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
|
### 5. Define Design Inspiration Strategy
|
||||||
|
|
||||||
Create a clear strategy for using this inspiration:
|
Create a clear strategy for using this inspiration:
|
||||||
"**Design Inspiration Strategy:**
|
<display>
|
||||||
|
**Design Inspiration Strategy:**
|
||||||
|
|
||||||
**What to Adopt:**
|
**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] - conflicts with [your goals]
|
||||||
- [Specific anti-pattern] - doesn't fit [your platform]
|
- [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
|
### 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
|
### 7. Present Content and Menu
|
||||||
|
|
||||||
Show the generated inspiration analysis content and present choices:
|
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:**
|
**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?**
|
**What would you like to do?**
|
||||||
[A] Advanced Elicitation - Let's deepen our UX pattern analysis
|
[A] Advanced Elicitation - Let's deepen our UX pattern analysis
|
||||||
[P] Party Mode - Bring different perspectives on inspiration sources
|
[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
|
### 8. Handle Menu Selection
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -51,7 +51,8 @@ Choose appropriate design system approach based on project requirements and cons
|
||||||
### 1. Present Design System Options
|
### 1. Present Design System Options
|
||||||
|
|
||||||
Educate about design system approaches:
|
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:**
|
**Design System Approaches:**
|
||||||
|
|
||||||
|
|
@ -76,12 +77,14 @@ Educate about design system approaches:
|
||||||
- Moderate learning curve
|
- Moderate learning curve
|
||||||
- Good balance of speed and uniqueness
|
- 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
|
### 2. Analyze Project Requirements
|
||||||
|
|
||||||
Guide decision based on project context:
|
Guide decision based on project context:
|
||||||
"**Let's consider your specific needs:**
|
<display>
|
||||||
|
**Let's consider your specific needs:**
|
||||||
|
|
||||||
**Based on our previous conversations:**
|
**Based on our previous conversations:**
|
||||||
|
|
||||||
|
|
@ -97,12 +100,14 @@ Guide decision based on project context:
|
||||||
- Brand guidelines or existing visual identity
|
- Brand guidelines or existing visual identity
|
||||||
- Team's design expertise
|
- Team's design expertise
|
||||||
- Long-term maintenance considerations
|
- Long-term maintenance considerations
|
||||||
- Integration requirements with existing systems"
|
- Integration requirements with existing systems
|
||||||
|
</display>
|
||||||
|
|
||||||
### 3. Explore Specific Design System Options
|
### 3. Explore Specific Design System Options
|
||||||
|
|
||||||
Dive deeper into relevant options:
|
Dive deeper into relevant options:
|
||||||
"**Recommended Options Based on Your Needs:**
|
<display>
|
||||||
|
**Recommended Options Based on Your Needs:**
|
||||||
|
|
||||||
**For [Your Platform Type]:**
|
**For [Your Platform Type]:**
|
||||||
|
|
||||||
|
|
@ -117,12 +122,14 @@ Dive deeper into relevant options:
|
||||||
- Customization capabilities
|
- Customization capabilities
|
||||||
- Accessibility compliance
|
- Accessibility compliance
|
||||||
- Performance characteristics
|
- Performance characteristics
|
||||||
- Learning curve for your team"
|
- Learning curve for your team
|
||||||
|
</display>
|
||||||
|
|
||||||
### 4. Facilitate Decision Process
|
### 4. Facilitate Decision Process
|
||||||
|
|
||||||
Help user make informed choice:
|
Help user make informed choice:
|
||||||
"**Decision Framework:**
|
<display>
|
||||||
|
**Decision Framework:**
|
||||||
|
|
||||||
1. What's most important: Speed, uniqueness, or balance?
|
1. What's most important: Speed, uniqueness, or balance?
|
||||||
2. How much design expertise does your team have?
|
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?
|
4. What's your timeline and budget?
|
||||||
5. Long-term maintenance needs?
|
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
|
### 5. Finalize Design System Choice
|
||||||
|
|
||||||
Confirm and document the decision:
|
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:**
|
**Rationale:**
|
||||||
|
|
||||||
|
|
@ -149,7 +158,8 @@ Confirm and document the decision:
|
||||||
- Define component strategy for custom components needed
|
- Define component strategy for custom components needed
|
||||||
- Establish design tokens and patterns
|
- 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
|
### 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
|
### 7. Present Content and Menu
|
||||||
|
|
||||||
Show the generated design system content and present choices:
|
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:**
|
**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
|
[A] Advanced Elicitation - Let's refine our design system decision
|
||||||
[P] Party Mode - Bring technical perspectives on design systems
|
[P] Party Mode - Bring technical perspectives on design systems
|
||||||
[C] Continue - Save this to the document and move to defining experience
|
[C] Continue - Save this to the document and move to defining experience
|
||||||
|
</display>
|
||||||
|
|
||||||
### 8. Handle Menu Selection
|
### 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
|
### 1. Identify the Defining Experience
|
||||||
|
|
||||||
Focus on the core interaction:
|
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:**
|
**Think about these famous examples:**
|
||||||
|
|
||||||
|
|
@ -63,12 +64,14 @@ Focus on the core interaction:
|
||||||
**For {{project_name}}:**
|
**For {{project_name}}:**
|
||||||
What's the core action that users will describe to their friends?
|
What's the core action that users will describe to their friends?
|
||||||
What's the interaction that makes users feel successful?
|
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
|
### 2. Explore the User's Mental Model
|
||||||
|
|
||||||
Understand how users think about the core task:
|
Understand how users think about the core task:
|
||||||
"**User Mental Model Questions:**
|
<display>
|
||||||
|
**User Mental Model Questions:**
|
||||||
|
|
||||||
- How do users currently solve this problem?
|
- How do users currently solve this problem?
|
||||||
- What mental model do they bring to this task?
|
- 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 do users love/hate about existing approaches?
|
||||||
- What shortcuts or workarounds do they use?
|
- 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
|
### 3. Define Success Criteria for Core Experience
|
||||||
|
|
||||||
Establish what makes the core interaction successful:
|
Establish what makes the core interaction successful:
|
||||||
"**Core Experience Success Criteria:**
|
<display>
|
||||||
|
**Core Experience Success Criteria:**
|
||||||
|
|
||||||
- What makes users say 'this just works'?
|
- What makes users say 'this just works'?
|
||||||
- When do they feel smart or accomplished?
|
- When do they feel smart or accomplished?
|
||||||
|
|
@ -96,12 +101,14 @@ Establish what makes the core interaction successful:
|
||||||
|
|
||||||
- [Success indicator 1]
|
- [Success indicator 1]
|
||||||
- [Success indicator 2]
|
- [Success indicator 2]
|
||||||
- [Success indicator 3]"
|
- [Success indicator 3]
|
||||||
|
</display>
|
||||||
|
|
||||||
### 4. Identify Novel vs. Established Patterns
|
### 4. Identify Novel vs. Established Patterns
|
||||||
|
|
||||||
Determine if we need to innovate or can use proven patterns:
|
Determine if we need to innovate or can use proven patterns:
|
||||||
"**Pattern Analysis:**
|
<display>
|
||||||
|
**Pattern Analysis:**
|
||||||
Looking at your core experience, does this:
|
Looking at your core experience, does this:
|
||||||
|
|
||||||
- Use established UX patterns that users already understand?
|
- 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?
|
- Which proven patterns should we adopt?
|
||||||
- How can we innovate within familiar patterns?
|
- 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
|
### 5. Define Experience Mechanics
|
||||||
|
|
||||||
Break down the core interaction into details:
|
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]:
|
Let's design the step-by-step flow for [defining experience]:
|
||||||
|
|
||||||
**1. Initiation:**
|
**1. Initiation:**
|
||||||
|
|
@ -147,7 +156,8 @@ Let's design the step-by-step flow for [defining experience]:
|
||||||
|
|
||||||
- How do users know they're done?
|
- How do users know they're done?
|
||||||
- What's the successful outcome?
|
- What's the successful outcome?
|
||||||
- What's next?"
|
- What's next?
|
||||||
|
</display>
|
||||||
|
|
||||||
### 6. Generate Defining Experience Content
|
### 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
|
### 7. Present Content and Menu
|
||||||
|
|
||||||
Show the generated defining experience content and present choices:
|
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:**
|
**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
|
[A] Advanced Elicitation - Let's refine the core experience definition
|
||||||
[P] Party Mode - Bring different perspectives on the defining interaction
|
[P] Party Mode - Bring different perspectives on the defining interaction
|
||||||
[C] Continue - Save this to the document and move to visual foundation
|
[C] Continue - Save this to the document and move to visual foundation
|
||||||
|
</display>
|
||||||
|
|
||||||
### 8. Handle Menu Selection
|
### 8. Handle Menu Selection
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -51,24 +51,29 @@ Establish the visual design foundation including color themes, typography, and s
|
||||||
### 1. Brand Guidelines Assessment
|
### 1. Brand Guidelines Assessment
|
||||||
|
|
||||||
Check for existing brand requirements:
|
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 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)
|
### 2. Generate Color Theme Options (If no brand guidelines)
|
||||||
|
|
||||||
Create visual exploration opportunities:
|
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.
|
🎨 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
|
### 3. Define Typography System
|
||||||
|
|
||||||
Establish the typographic foundation:
|
Establish the typographic foundation:
|
||||||
"**Typography Questions:**
|
<display>
|
||||||
|
**Typography Questions:**
|
||||||
|
|
||||||
- What should the overall tone feel like? (Professional, friendly, modern, classic?)
|
- What should the overall tone feel like? (Professional, friendly, modern, classic?)
|
||||||
- How much text content will users read? (Headings only? Long-form content?)
|
- 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
|
- Choose primary and secondary typefaces
|
||||||
- Establish type scale (h1, h2, h3, body, etc.)
|
- Establish type scale (h1, h2, h3, body, etc.)
|
||||||
- Define line heights and spacing relationships
|
- Define line heights and spacing relationships
|
||||||
- Consider readability and accessibility"
|
- Consider readability and accessibility
|
||||||
|
</display>
|
||||||
|
|
||||||
### 4. Establish Spacing and Layout Foundation
|
### 4. Establish Spacing and Layout Foundation
|
||||||
|
|
||||||
Define the structural 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?)
|
- How should the overall layout feel? (Dense and efficient? Airy and spacious?)
|
||||||
- What spacing unit should we use? (4px, 8px, 12px base?)
|
- 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 1 based on product type]
|
||||||
- [Layout principle 2 based on user needs]
|
- [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
|
### 5. Create Visual Foundation Strategy
|
||||||
|
|
||||||
Synthesize all visual decisions:
|
Synthesize all visual decisions:
|
||||||
"**Visual Foundation Strategy:**
|
<display>
|
||||||
|
**Visual Foundation Strategy:**
|
||||||
|
|
||||||
**Color System:**
|
**Color System:**
|
||||||
|
|
||||||
|
|
@ -121,7 +130,8 @@ Synthesize all visual decisions:
|
||||||
- Grid system approach
|
- Grid system approach
|
||||||
- Component spacing relationships
|
- 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
|
### 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
|
### 7. Present Content and Menu
|
||||||
|
|
||||||
Show the generated visual foundation content and present choices:
|
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:**
|
**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
|
[A] Advanced Elicitation - Let's refine our visual foundation
|
||||||
[P] Party Mode - Bring design perspectives on visual choices
|
[P] Party Mode - Bring design perspectives on visual choices
|
||||||
[C] Continue - Save this to the document and move to design directions
|
[C] Continue - Save this to the document and move to design directions
|
||||||
|
</display>
|
||||||
|
|
||||||
### 8. Handle Menu Selection
|
### 8. Handle Menu Selection
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -51,7 +51,8 @@ Generate comprehensive design direction mockups showing different visual approac
|
||||||
### 1. Generate Design Direction Variations
|
### 1. Generate Design Direction Variations
|
||||||
|
|
||||||
Create diverse visual explorations:
|
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
|
- Different layout approaches and information hierarchy
|
||||||
- Various interaction patterns and visual weights
|
- Various interaction patterns and visual weights
|
||||||
|
|
@ -59,12 +60,14 @@ Create diverse visual explorations:
|
||||||
- Different density and spacing approaches
|
- Different density and spacing approaches
|
||||||
- Various navigation and component arrangements
|
- 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
|
### 2. Create HTML Design Direction Showcase
|
||||||
|
|
||||||
Generate interactive visual exploration:
|
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`
|
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
|
- Complete UI examples with real content
|
||||||
- Responsive behavior demonstrations
|
- 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
|
### 3. Present Design Exploration Framework
|
||||||
|
|
||||||
Guide evaluation criteria:
|
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?
|
✅ **Layout Intuitiveness** - Which information hierarchy matches your priorities?
|
||||||
✅ **Interaction Style** - Which interaction style fits your core experience?
|
✅ **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?
|
✅ **Component Usage** - How well do the components support your user journeys?
|
||||||
✅ **Brand Alignment** - Which direction best supports your emotional goals?
|
✅ **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
|
### 4. Facilitate Design Direction Selection
|
||||||
|
|
||||||
Help user choose or combine elements:
|
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?**
|
**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 layout feels most intuitive for your users?
|
||||||
- Which visual weight matches your brand personality?
|
- Which visual weight matches your brand personality?
|
||||||
- Which interaction style supports your core experience?
|
- 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
|
### 5. Document Design Direction Decision
|
||||||
|
|
||||||
Capture the chosen approach:
|
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]
|
**Chosen Direction:** [Direction number or combination]
|
||||||
**Key Elements:** [Specific elements you liked]
|
**Key Elements:** [Specific elements you liked]
|
||||||
**Modifications Needed:** [Any changes requested]
|
**Modifications Needed:** [Any changes requested]
|
||||||
**Rationale:** [Why this direction works for your product]
|
**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
|
### 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
|
### 7. Present Content and Menu
|
||||||
|
|
||||||
Show the generated design direction content and present choices:
|
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:**
|
**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
|
[A] Advanced Elicitation - Let's refine our design direction
|
||||||
[P] Party Mode - Bring different perspectives on visual choices
|
[P] Party Mode - Bring different perspectives on visual choices
|
||||||
[C] Continue - Save this to the document and move to user journey flows
|
[C] Continue - Save this to the document and move to user journey flows
|
||||||
|
</display>
|
||||||
|
|
||||||
### 8. Handle Menu Selection
|
### 8. Handle Menu Selection
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -51,7 +51,8 @@ Design detailed user journey flows for critical user interactions.
|
||||||
### 1. Load PRD User Journeys as Foundation
|
### 1. Load PRD User Journeys as Foundation
|
||||||
|
|
||||||
Start with user journeys already defined in the PRD:
|
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:**
|
**Existing User Journeys from PRD:**
|
||||||
I've already loaded these user journeys from your 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 2 identified from PRD narratives]
|
||||||
- [Critical journey 3 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
|
### 2. Design Each Journey Flow
|
||||||
|
|
||||||
For each critical journey, design detailed flow:
|
For each critical journey, design detailed flow:
|
||||||
|
|
||||||
**For [Journey Name]:**
|
**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:**
|
**Flow Design Questions:**
|
||||||
|
|
||||||
|
|
@ -83,12 +86,14 @@ For each critical journey, design detailed flow:
|
||||||
- How do they know they're progressing successfully?
|
- How do they know they're progressing successfully?
|
||||||
- What does success look like for this journey?
|
- What does success look like for this journey?
|
||||||
- Where might they get confused or stuck?
|
- Where might they get confused or stuck?
|
||||||
- How do they recover from errors?"
|
- How do they recover from errors?
|
||||||
|
</display>
|
||||||
|
|
||||||
### 3. Create Flow Diagrams
|
### 3. Create Flow Diagrams
|
||||||
|
|
||||||
Visualize each journey with Mermaid 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:**
|
**[Journey Name] Flow:**
|
||||||
|
|
||||||
|
|
@ -98,12 +103,14 @@ Visualize each journey with Mermaid diagrams:
|
||||||
- Error recovery mechanisms
|
- Error recovery mechanisms
|
||||||
- Progressive disclosure of information
|
- 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
|
### 4. Optimize for Efficiency and Delight
|
||||||
|
|
||||||
Refine flows for optimal user experience:
|
Refine flows for optimal user experience:
|
||||||
"**Flow Optimization:**
|
<display>
|
||||||
|
**Flow Optimization:**
|
||||||
For each journey, let's ensure we're:
|
For each journey, let's ensure we're:
|
||||||
|
|
||||||
- Minimizing steps to value (getting users to success quickly)
|
- 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 1 for journey efficiency]
|
||||||
- [Optimization 2 for user delight]
|
- [Optimization 2 for user delight]
|
||||||
- [Optimization 3 for error handling]"
|
- [Optimization 3 for error handling]
|
||||||
|
</display>
|
||||||
|
|
||||||
### 5. Document Journey Patterns
|
### 5. Document Journey Patterns
|
||||||
|
|
||||||
Extract reusable patterns across journeys:
|
Extract reusable patterns across journeys:
|
||||||
"**Journey Patterns:**
|
<display>
|
||||||
|
**Journey Patterns:**
|
||||||
Across these flows, I'm seeing some common patterns we can standardize:
|
Across these flows, I'm seeing some common patterns we can standardize:
|
||||||
|
|
||||||
**Navigation Patterns:**
|
**Navigation Patterns:**
|
||||||
|
|
@ -139,7 +148,8 @@ Across these flows, I'm seeing some common patterns we can standardize:
|
||||||
- [Feedback pattern 1]
|
- [Feedback pattern 1]
|
||||||
- [Feedback pattern 2]
|
- [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
|
### 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
|
### 7. Present Content and Menu
|
||||||
|
|
||||||
Show the generated user journey content and present choices:
|
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:**
|
**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
|
[A] Advanced Elicitation - Let's refine our user journey designs
|
||||||
[P] Party Mode - Bring different perspectives on user flows
|
[P] Party Mode - Bring different perspectives on user flows
|
||||||
[C] Continue - Save this to the document and move to component strategy
|
[C] Continue - Save this to the document and move to component strategy
|
||||||
|
</display>
|
||||||
|
|
||||||
### 8. Handle Menu Selection
|
### 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
|
### 1. Analyze Design System Coverage
|
||||||
|
|
||||||
Review what components are available vs. needed:
|
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:**
|
**Available from Design System:**
|
||||||
[List of components available in chosen 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 Analysis:**
|
||||||
|
|
||||||
- [Gap 1 - needed but not available]
|
- [Gap 1 - needed but not available]
|
||||||
- [Gap 2 - needed but not available]"
|
- [Gap 2 - needed but not available]
|
||||||
|
</display>
|
||||||
|
|
||||||
### 2. Design Custom Components
|
### 2. Design Custom Components
|
||||||
|
|
||||||
For each custom component needed, design thoroughly:
|
For each custom component needed, design thoroughly:
|
||||||
|
|
||||||
**For each custom component:**
|
**For each custom component:**
|
||||||
"**[Component Name] Design:**
|
<display>
|
||||||
|
**[Component Name] Design:**
|
||||||
|
|
||||||
**Purpose:** What does this component do for users?
|
**Purpose:** What does this component do for users?
|
||||||
**Content:** What information or data does it display?
|
**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?
|
**Variants:** Are there different sizes or styles needed?
|
||||||
**Accessibility:** What ARIA labels and keyboard support 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
|
### 3. Document Component Specifications
|
||||||
|
|
||||||
|
|
@ -106,7 +110,8 @@ Create detailed specifications for each component:
|
||||||
### 4. Define Component Strategy
|
### 4. Define Component Strategy
|
||||||
|
|
||||||
Establish overall component library approach:
|
Establish overall component library approach:
|
||||||
"**Component Strategy:**
|
<display>
|
||||||
|
**Component Strategy:**
|
||||||
|
|
||||||
**Foundation Components:** (from design system)
|
**Foundation Components:** (from design system)
|
||||||
|
|
||||||
|
|
@ -123,12 +128,14 @@ Establish overall component library approach:
|
||||||
- Build custom components using design system tokens
|
- Build custom components using design system tokens
|
||||||
- Ensure consistency with established patterns
|
- Ensure consistency with established patterns
|
||||||
- Follow accessibility best practices
|
- Follow accessibility best practices
|
||||||
- Create reusable patterns for common use cases"
|
- Create reusable patterns for common use cases
|
||||||
|
</display>
|
||||||
|
|
||||||
### 5. Plan Implementation Roadmap
|
### 5. Plan Implementation Roadmap
|
||||||
|
|
||||||
Define how and when to build components:
|
Define how and when to build components:
|
||||||
"**Implementation Roadmap:**
|
<display>
|
||||||
|
**Implementation Roadmap:**
|
||||||
|
|
||||||
**Phase 1 - Core Components:**
|
**Phase 1 - Core Components:**
|
||||||
|
|
||||||
|
|
@ -145,7 +152,8 @@ Define how and when to build components:
|
||||||
- [Component 5] - optimizes [user journey]
|
- [Component 5] - optimizes [user journey]
|
||||||
- [Component 6] - adds [special feature]
|
- [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
|
### 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
|
### 7. Present Content and Menu
|
||||||
|
|
||||||
Show the generated component strategy content and present choices:
|
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:**
|
**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
|
[A] Advanced Elicitation - Let's refine our component strategy
|
||||||
[P] Party Mode - Bring technical perspectives on component design
|
[P] Party Mode - Bring technical perspectives on component design
|
||||||
[C] Continue - Save this to the document and move to UX patterns
|
[C] Continue - Save this to the document and move to UX patterns
|
||||||
|
</display>
|
||||||
|
|
||||||
### 8. Handle Menu Selection
|
### 8. Handle Menu Selection
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -51,7 +51,8 @@ Establish UX consistency patterns for common situations like buttons, forms, nav
|
||||||
### 1. Identify Pattern Categories
|
### 1. Identify Pattern Categories
|
||||||
|
|
||||||
Determine which patterns need definition for your product:
|
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:**
|
**Pattern Categories to Define:**
|
||||||
|
|
||||||
|
|
@ -63,14 +64,16 @@ Determine which patterns need definition for your product:
|
||||||
- Empty states and loading states
|
- Empty states and loading states
|
||||||
- Search and filtering patterns
|
- 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
|
### 2. Define Critical Patterns First
|
||||||
|
|
||||||
Focus on patterns most relevant to your product:
|
Focus on patterns most relevant to your product:
|
||||||
|
|
||||||
**For [Critical Pattern Category]:**
|
**For [Critical Pattern Category]:**
|
||||||
"**[Pattern Type] Patterns:**
|
<display>
|
||||||
|
**[Pattern Type] Patterns:**
|
||||||
What should users see/do when they need to [pattern action]?
|
What should users see/do when they need to [pattern action]?
|
||||||
|
|
||||||
**Considerations:**
|
**Considerations:**
|
||||||
|
|
@ -86,7 +89,8 @@ What should users see/do when they need to [pattern action]?
|
||||||
- [Example 1 for this pattern type]
|
- [Example 1 for this pattern type]
|
||||||
- [Example 2 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
|
### 3. Establish Pattern Guidelines
|
||||||
|
|
||||||
|
|
@ -108,7 +112,8 @@ Document specific design decisions:
|
||||||
### 4. Design System Integration
|
### 4. Design System Integration
|
||||||
|
|
||||||
Ensure patterns work with chosen design system:
|
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?
|
- How do these patterns complement our design system components?
|
||||||
- What customizations are needed?
|
- What customizations are needed?
|
||||||
|
|
@ -118,7 +123,8 @@ Ensure patterns work with chosen design system:
|
||||||
|
|
||||||
- [Custom rule 1]
|
- [Custom rule 1]
|
||||||
- [Custom rule 2]
|
- [Custom rule 2]
|
||||||
- [Custom rule 3]"
|
- [Custom rule 3]
|
||||||
|
</display>
|
||||||
|
|
||||||
### 5. Create Pattern Documentation
|
### 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
|
### 7. Present Content and Menu
|
||||||
|
|
||||||
Show the generated UX patterns content and present choices:
|
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:**
|
**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
|
[A] Advanced Elicitation - Let's refine our UX patterns
|
||||||
[P] Party Mode - Bring different perspectives on consistency patterns
|
[P] Party Mode - Bring different perspectives on consistency patterns
|
||||||
[C] Continue - Save this to the document and move to responsive design
|
[C] Continue - Save this to the document and move to responsive design
|
||||||
|
</display>
|
||||||
|
|
||||||
### 8. Handle Menu Selection
|
### 8. Handle Menu Selection
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -51,7 +51,8 @@ Define responsive design strategy and accessibility requirements for the product
|
||||||
### 1. Define Responsive Strategy
|
### 1. Define Responsive Strategy
|
||||||
|
|
||||||
Establish how the design adapts across devices:
|
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:**
|
**Responsive Design Questions:**
|
||||||
|
|
||||||
|
|
@ -71,12 +72,14 @@ Establish how the design adapts across devices:
|
||||||
|
|
||||||
- Bottom navigation or hamburger menu?
|
- Bottom navigation or hamburger menu?
|
||||||
- How do layouts collapse on small screens?
|
- 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
|
### 2. Establish Breakpoint Strategy
|
||||||
|
|
||||||
Define when and how layouts change:
|
Define when and how layouts change:
|
||||||
"**Breakpoint Strategy:**
|
<display>
|
||||||
|
**Breakpoint Strategy:**
|
||||||
We need to define screen size breakpoints where layouts adapt.
|
We need to define screen size breakpoints where layouts adapt.
|
||||||
|
|
||||||
**Common Breakpoints:**
|
**Common Breakpoints:**
|
||||||
|
|
@ -89,12 +92,14 @@ We need to define screen size breakpoints where layouts adapt.
|
||||||
|
|
||||||
- Use standard breakpoints or custom ones?
|
- Use standard breakpoints or custom ones?
|
||||||
- Focus on mobile-first or desktop-first design?
|
- 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
|
### 3. Design Accessibility Strategy
|
||||||
|
|
||||||
Define accessibility requirements and compliance level:
|
Define accessibility requirements and compliance level:
|
||||||
"**Accessibility Strategy:**
|
<display>
|
||||||
|
**Accessibility Strategy:**
|
||||||
What level of WCAG compliance does {{project_name}} need?
|
What level of WCAG compliance does {{project_name}} need?
|
||||||
|
|
||||||
**WCAG Levels:**
|
**WCAG Levels:**
|
||||||
|
|
@ -113,12 +118,14 @@ What level of WCAG compliance does {{project_name}} need?
|
||||||
- Keyboard navigation support
|
- Keyboard navigation support
|
||||||
- Screen reader compatibility
|
- Screen reader compatibility
|
||||||
- Touch target sizes (minimum 44x44px)
|
- Touch target sizes (minimum 44x44px)
|
||||||
- Focus indicators and skip links"
|
- Focus indicators and skip links
|
||||||
|
</display>
|
||||||
|
|
||||||
### 4. Define Testing Strategy
|
### 4. Define Testing Strategy
|
||||||
|
|
||||||
Plan how to ensure responsive design and accessibility:
|
Plan how to ensure responsive design and accessibility:
|
||||||
"**Testing Strategy:**
|
<display>
|
||||||
|
**Testing Strategy:**
|
||||||
|
|
||||||
**Responsive Testing:**
|
**Responsive Testing:**
|
||||||
|
|
||||||
|
|
@ -137,12 +144,14 @@ Plan how to ensure responsive design and accessibility:
|
||||||
|
|
||||||
- Include users with disabilities in testing
|
- Include users with disabilities in testing
|
||||||
- Test with diverse assistive technologies
|
- Test with diverse assistive technologies
|
||||||
- Validate with actual target devices"
|
- Validate with actual target devices
|
||||||
|
</display>
|
||||||
|
|
||||||
### 5. Document Implementation Guidelines
|
### 5. Document Implementation Guidelines
|
||||||
|
|
||||||
Create specific guidelines for developers:
|
Create specific guidelines for developers:
|
||||||
"**Implementation Guidelines:**
|
<display>
|
||||||
|
**Implementation Guidelines:**
|
||||||
|
|
||||||
**Responsive Development:**
|
**Responsive Development:**
|
||||||
|
|
||||||
|
|
@ -157,7 +166,8 @@ Create specific guidelines for developers:
|
||||||
- ARIA labels and roles
|
- ARIA labels and roles
|
||||||
- Keyboard navigation implementation
|
- Keyboard navigation implementation
|
||||||
- Focus management and skip links
|
- Focus management and skip links
|
||||||
- High contrast mode support"
|
- High contrast mode support
|
||||||
|
</display>
|
||||||
|
|
||||||
### 6. Generate Responsive & Accessibility Content
|
### 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
|
### 7. Present Content and Menu
|
||||||
|
|
||||||
Show the generated responsive and accessibility content and present choices:
|
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:**
|
**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
|
[A] Advanced Elicitation - Let's refine our responsive/accessibility strategy
|
||||||
[P] Party Mode - Bring different perspectives on inclusive design
|
[P] Party Mode - Bring different perspectives on inclusive design
|
||||||
[C] Continue - Save this to the document and complete the workflow
|
[C] Continue - Save this to the document and complete the workflow
|
||||||
|
</display>
|
||||||
|
|
||||||
### 8. Handle Menu Selection
|
### 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
|
### 1. Announce Workflow Completion
|
||||||
|
|
||||||
Inform user that the UX design is complete:
|
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}}.
|
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`
|
- Color themes visualizer: `{planning_artifacts}/ux-color-themes.html`
|
||||||
- Design directions mockups: `{planning_artifacts}/ux-design-directions.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
|
### 2. Workflow Status Update
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -54,14 +54,16 @@ To discover, inventory, and organize all project documents, identifying duplicat
|
||||||
|
|
||||||
### 1. Initialize Document Discovery
|
### 1. Initialize Document Discovery
|
||||||
|
|
||||||
"Beginning **Document Discovery** to inventory all project files.
|
<display>
|
||||||
|
Beginning **Document Discovery** to inventory all project files.
|
||||||
|
|
||||||
I will:
|
I will:
|
||||||
|
|
||||||
1. Search for all required documents (PRD, Architecture, Epics, UX)
|
1. Search for all required documents (PRD, Architecture, Epics, UX)
|
||||||
2. Group sharded documents together
|
2. Group sharded documents together
|
||||||
3. Identify any duplicates (whole + sharded versions)
|
3. Identify any duplicates (whole + sharded versions)
|
||||||
4. Present findings for your confirmation"
|
4. Present findings for your confirmation
|
||||||
|
</display>
|
||||||
|
|
||||||
### 2. Document Search Patterns
|
### 2. Document Search Patterns
|
||||||
|
|
||||||
|
|
@ -133,7 +135,8 @@ Initialize {outputFile} with {templateFile}.
|
||||||
### 6. Present Findings and Get Confirmation
|
### 6. Present Findings and Get Confirmation
|
||||||
|
|
||||||
Display findings and ask:
|
Display findings and ask:
|
||||||
"**Document Discovery Complete**
|
<display>
|
||||||
|
**Document Discovery Complete**
|
||||||
|
|
||||||
[Show organized file list]
|
[Show organized file list]
|
||||||
|
|
||||||
|
|
@ -147,7 +150,8 @@ Display findings and ask:
|
||||||
- If duplicates exist: Please remove/rename one version
|
- If duplicates exist: Please remove/rename one version
|
||||||
- Confirm which documents to use for assessment
|
- 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
|
### 7. Present MENU OPTIONS
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -54,7 +54,8 @@ To fully read and analyze the PRD document (whole or sharded) to extract all Fun
|
||||||
|
|
||||||
### 1. Initialize PRD Analysis
|
### 1. Initialize PRD Analysis
|
||||||
|
|
||||||
"Beginning **PRD Analysis** to extract all requirements.
|
<display>
|
||||||
|
Beginning **PRD Analysis** to extract all requirements.
|
||||||
|
|
||||||
I will:
|
I will:
|
||||||
|
|
||||||
|
|
@ -62,7 +63,8 @@ I will:
|
||||||
2. Read it completely and thoroughly
|
2. Read it completely and thoroughly
|
||||||
3. Extract ALL Functional Requirements (FRs)
|
3. Extract ALL Functional Requirements (FRs)
|
||||||
4. Extract ALL Non-Functional Requirements (NFRs)
|
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
|
### 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
|
### 1. Initialize Coverage Validation
|
||||||
|
|
||||||
"Beginning **Epic Coverage Validation**.
|
<display>
|
||||||
|
Beginning **Epic Coverage Validation**.
|
||||||
|
|
||||||
I will:
|
I will:
|
||||||
|
|
||||||
1. Load the epics and stories document
|
1. Load the epics and stories document
|
||||||
2. Extract FR coverage information
|
2. Extract FR coverage information
|
||||||
3. Compare against PRD FRs from previous step
|
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
|
### 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
|
### 1. Initialize UX Validation
|
||||||
|
|
||||||
"Beginning **UX Alignment** validation.
|
<display>
|
||||||
|
Beginning **UX Alignment** validation.
|
||||||
|
|
||||||
I will:
|
I will:
|
||||||
|
|
||||||
1. Check if UX documentation exists
|
1. Check if UX documentation exists
|
||||||
2. If UX exists: validate alignment with PRD and Architecture
|
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
|
### 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
|
### 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:
|
I will rigorously validate:
|
||||||
|
|
||||||
|
|
@ -64,7 +65,8 @@ I will rigorously validate:
|
||||||
- Story dependencies (no forward references)
|
- Story dependencies (no forward references)
|
||||||
- Proper story sizing and completeness
|
- 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
|
### 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
|
### 1. Initialize Final Assessment
|
||||||
|
|
||||||
"Completing **Final Assessment**.
|
<display>
|
||||||
|
Completing **Final Assessment**.
|
||||||
|
|
||||||
I will now:
|
I will now:
|
||||||
|
|
||||||
1. Review all findings from previous steps
|
1. Review all findings from previous steps
|
||||||
2. Provide a comprehensive summary
|
2. Provide a comprehensive summary
|
||||||
3. Add specific recommendations
|
3. Add specific recommendations
|
||||||
4. Determine overall readiness status"
|
4. Determine overall readiness status
|
||||||
|
</display>
|
||||||
|
|
||||||
### 2. Review Previous Findings
|
### 2. Review Previous Findings
|
||||||
|
|
||||||
|
|
@ -105,11 +107,13 @@ This assessment identified [X] issues across [Y] categories. Address the critica
|
||||||
### 5. Present Completion
|
### 5. Present Completion
|
||||||
|
|
||||||
Display:
|
Display:
|
||||||
"**Implementation Readiness Assessment Complete**
|
<display>
|
||||||
|
**Implementation Readiness Assessment Complete**
|
||||||
|
|
||||||
Report generated: {outputFile}
|
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
|
## WORKFLOW COMPLETE
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -108,7 +108,8 @@ Complete setup and report to user:
|
||||||
|
|
||||||
**Input Documents Discovered:**
|
**Input Documents Discovered:**
|
||||||
Report what was found:
|
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:**
|
**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?
|
Ready to begin architectural decision making. Do you have any other documents you'd like me to include?
|
||||||
|
|
||||||
[C] Continue to project context analysis
|
[C] Continue to project context analysis
|
||||||
|
</display>
|
||||||
|
|
||||||
## SUCCESS METRICS:
|
## SUCCESS METRICS:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -55,7 +55,8 @@ Read the existing architecture document completely and analyze:
|
||||||
|
|
||||||
Show the user their current progress:
|
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:**
|
**Current Progress:**
|
||||||
|
|
||||||
|
|
@ -77,7 +78,7 @@ Show the user their current progress:
|
||||||
[C] Continue to next logical step
|
[C] Continue to next logical step
|
||||||
[O] Overview of all remaining steps
|
[O] Overview of all remaining steps
|
||||||
[X] Start over (will overwrite existing work)
|
[X] Start over (will overwrite existing work)
|
||||||
"
|
</display>
|
||||||
|
|
||||||
### 3. Handle User Choice
|
### 3. Handle User Choice
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -94,7 +94,8 @@ Calculate and present project complexity:
|
||||||
|
|
||||||
Present your analysis back to user for validation:
|
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_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}
|
{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.
|
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
|
### 4. Generate Project Context Content
|
||||||
|
|
||||||
|
|
@ -155,7 +157,8 @@ Prepare the content to append to the document:
|
||||||
|
|
||||||
Show the generated content and present choices:
|
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:**
|
**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?**
|
**What would you like to do?**
|
||||||
[A] Advanced Elicitation - Let's dive deeper into architectural implications
|
[A] Advanced Elicitation - Let's dive deeper into architectural implications
|
||||||
[P] Party Mode - Bring different perspectives to analyze requirements
|
[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
|
### 6. Handle Menu Selection
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -53,7 +53,8 @@ Discover technical preferences and evaluate starter template options, leveraging
|
||||||
### 0. Check Technical Preferences & Context
|
### 0. Check Technical Preferences & Context
|
||||||
|
|
||||||
**Check Project Context for Existing Technical Preferences:**
|
**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}}
|
{{if_project_context_exists}}
|
||||||
I found some technical rules in your project context file:
|
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}}
|
{{else}}
|
||||||
No existing technical preferences found in project context file. We'll establish your technical preferences now.
|
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:**
|
**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:
|
{{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?
|
- Any existing systems or APIs you need to integrate with?
|
||||||
- Third-party services you plan to use (payment, authentication, analytics, etc.)?
|
- 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
|
### 1. Identify Primary Technology Domain
|
||||||
|
|
||||||
|
|
@ -173,28 +177,34 @@ For each viable starter option, document:
|
||||||
Based on user skill level and project needs:
|
Based on user skill level and project needs:
|
||||||
|
|
||||||
**For Expert Users:**
|
**For Expert Users:**
|
||||||
"Found {{starter_name}} which provides:
|
<display>
|
||||||
|
Found {{starter_name}} which provides:
|
||||||
{{quick_decision_list_of_key_decisions}}
|
{{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:**
|
**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:
|
It makes these architectural decisions for us:
|
||||||
{{decision_list_with_explanations}}
|
{{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:**
|
**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.
|
Think of it like buying a prefab house frame instead of cutting each board yourself.
|
||||||
|
|
||||||
It makes these decisions for us:
|
It makes these decisions for us:
|
||||||
{{friendly_explanation_of_decisions}}
|
{{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
|
### 7. Get Current CLI Commands
|
||||||
|
|
||||||
|
|
@ -262,7 +272,8 @@ Prepare the content to append to the document:
|
||||||
|
|
||||||
Show the generated content and present choices:
|
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:**
|
**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?**
|
**What would you like to do?**
|
||||||
[A] Advanced Elicitation - Explore custom approaches or unconventional starters
|
[A] Advanced Elicitation - Explore custom approaches or unconventional starters
|
||||||
[P] Party Mode - Evaluate trade-offs from different perspectives
|
[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
|
### 10. Handle Menu Selection
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -55,7 +55,8 @@ Facilitate collaborative architectural decision making, leveraging existing tech
|
||||||
### 1. Load Decision Framework & Check Existing Preferences
|
### 1. Load Decision Framework & Check Existing Preferences
|
||||||
|
|
||||||
**Review Technical Preferences from Step 3:**
|
**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:**
|
**Your Technical Preferences:**
|
||||||
{{user_technical_preferences_from_step_3}}
|
{{user_technical_preferences_from_step_3}}
|
||||||
|
|
@ -64,7 +65,8 @@ Facilitate collaborative architectural decision making, leveraging existing tech
|
||||||
{{starter_template_decisions}}
|
{{starter_template_decisions}}
|
||||||
|
|
||||||
**Project Context Technical Rules:**
|
**Project Context Technical Rules:**
|
||||||
{{project_context_technical_rules}}"
|
{{project_context_technical_rules}}
|
||||||
|
</display>
|
||||||
|
|
||||||
**Identify Remaining Decisions:**
|
**Identify Remaining Decisions:**
|
||||||
Based on technical preferences, starter template choice, and project context, identify remaining critical 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:
|
Based on user skill level and project context:
|
||||||
|
|
||||||
**Expert Mode:**
|
**Expert Mode:**
|
||||||
"{{Decision_Category}}: {{Specific_Decision}}
|
<display>
|
||||||
|
{{Decision_Category}}: {{Specific_Decision}}
|
||||||
|
|
||||||
Options: {{concise_option_list_with_tradeoffs}}
|
Options: {{concise_option_list_with_tradeoffs}}
|
||||||
|
|
||||||
What's your preference for this decision?"
|
What's your preference for this decision?
|
||||||
|
</display>
|
||||||
|
|
||||||
**Intermediate Mode:**
|
**Intermediate Mode:**
|
||||||
"Next decision: {{Human_Friendly_Category}}
|
<display>
|
||||||
|
Next decision: {{Human_Friendly_Category}}
|
||||||
|
|
||||||
We need to choose {{Specific_Decision}}.
|
We need to choose {{Specific_Decision}}.
|
||||||
|
|
||||||
Common options:
|
Common options:
|
||||||
{{option_list_with_brief_explanations}}
|
{{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:**
|
**Beginner Mode:**
|
||||||
"Let's talk about {{Human_Friendly_Category}}.
|
<display>
|
||||||
|
Let's talk about {{Human_Friendly_Category}}.
|
||||||
|
|
||||||
{{Educational_Context_About_Why_This_Matters}}
|
{{Educational_Context_About_Why_This_Matters}}
|
||||||
|
|
||||||
|
|
@ -158,7 +165,8 @@ Your main options:
|
||||||
My suggestion: {{recommendation}}
|
My suggestion: {{recommendation}}
|
||||||
This is good for you because {{beginner_friendly_reason}}.
|
This is good for you because {{beginner_friendly_reason}}.
|
||||||
|
|
||||||
What feels right to you?"
|
What feels right to you?
|
||||||
|
</display>
|
||||||
|
|
||||||
**Verify Technology Versions:**
|
**Verify Technology Versions:**
|
||||||
If decision involves specific technology:
|
If decision involves specific technology:
|
||||||
|
|
@ -170,7 +178,9 @@ Search the web: "{{technology}} production readiness"
|
||||||
```
|
```
|
||||||
|
|
||||||
**Get User Input:**
|
**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:**
|
**Handle User Response:**
|
||||||
|
|
||||||
|
|
@ -191,10 +201,12 @@ Search the web: "{{technology}} production readiness"
|
||||||
|
|
||||||
After each major decision, identify related decisions:
|
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_1}}
|
||||||
- {{related_decision_2}}"
|
- {{related_decision_2}}
|
||||||
|
</display>
|
||||||
|
|
||||||
### 5. Generate Decisions Content
|
### 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:
|
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:**
|
**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?**
|
**What would you like to do?**
|
||||||
[A] Advanced Elicitation - Explore innovative approaches to any specific decisions
|
[A] Advanced Elicitation - Explore innovative approaches to any specific decisions
|
||||||
[P] Party Mode - Review decisions from multiple perspectives
|
[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
|
### 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:
|
For each conflict category, facilitate collaborative pattern definition:
|
||||||
|
|
||||||
**Present the Conflict Point:**
|
**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.
|
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:**
|
**Show Options and Trade-offs:**
|
||||||
"Common approaches for {{pattern_category}}:
|
<display>
|
||||||
|
Common approaches for {{pattern_category}}:
|
||||||
|
|
||||||
1. {{option_1}} - {{pros_and_cons}}
|
1. {{option_1}} - {{pros_and_cons}}
|
||||||
2. {{option_2}} - {{pros_and_cons}}
|
2. {{option_2}} - {{pros_and_cons}}
|
||||||
3. {{option_3}} - {{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:**
|
**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
|
### 3. Define Pattern Categories
|
||||||
|
|
||||||
|
|
@ -290,7 +296,8 @@ Prepare the content to append to the document:
|
||||||
|
|
||||||
Show the generated patterns content and present choices:
|
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:**
|
**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?**
|
**What would you like to do?**
|
||||||
[A] Advanced Elicitation - Explore additional consistency patterns
|
[A] Advanced Elicitation - Explore additional consistency patterns
|
||||||
[P] Party Mode - Review patterns from different implementation perspectives
|
[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
|
### 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:
|
Map project requirements to architectural components:
|
||||||
|
|
||||||
**From Epics (if available):**
|
**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
|
- User stories within the epic
|
||||||
- Cross-epic dependencies
|
- Cross-epic dependencies
|
||||||
- Shared components needed
|
- Shared components needed
|
||||||
|
|
||||||
**From FR Categories (if no epics):**
|
**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
|
- Related functional requirements
|
||||||
- Shared functionality across categories
|
- Shared functionality across categories
|
||||||
|
|
@ -214,22 +218,26 @@ project-name/
|
||||||
Create explicit mapping from project requirements to specific files/directories:
|
Create explicit mapping from project requirements to specific files/directories:
|
||||||
|
|
||||||
**Epic/Feature Mapping:**
|
**Epic/Feature Mapping:**
|
||||||
"Epic: User Management
|
<display>
|
||||||
|
Epic: User Management
|
||||||
|
|
||||||
- Components: src/components/features/users/
|
- Components: src/components/features/users/
|
||||||
- Services: src/services/users/
|
- Services: src/services/users/
|
||||||
- API Routes: src/app/api/users/
|
- API Routes: src/app/api/users/
|
||||||
- Database: prisma/migrations/_*users*_
|
- Database: prisma/migrations/_*users*_
|
||||||
- Tests: tests/features/users/"
|
- Tests: tests/features/users/
|
||||||
|
</display>
|
||||||
|
|
||||||
**Cross-Cutting Concerns:**
|
**Cross-Cutting Concerns:**
|
||||||
"Authentication System
|
<display>
|
||||||
|
Authentication System
|
||||||
|
|
||||||
- Components: src/components/auth/
|
- Components: src/components/auth/
|
||||||
- Services: src/services/auth/
|
- Services: src/services/auth/
|
||||||
- Middleware: src/middleware/auth.ts
|
- Middleware: src/middleware/auth.ts
|
||||||
- Guards: src/guards/auth.guard.ts
|
- Guards: src/guards/auth.guard.ts
|
||||||
- Tests: tests/auth/"
|
- Tests: tests/auth/
|
||||||
|
</display>
|
||||||
|
|
||||||
### 6. Generate Structure Content
|
### 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:
|
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:**
|
**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?**
|
**What would you like to do?**
|
||||||
[A] Advanced Elicitation - Explore innovative project organization approaches
|
[A] Advanced Elicitation - Explore innovative project organization approaches
|
||||||
[P] Party Mode - Review structure from different development perspectives
|
[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
|
### 8. Handle Menu Selection
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -155,25 +155,31 @@ Identify and document any missing elements:
|
||||||
For any issues found, facilitate resolution:
|
For any issues found, facilitate resolution:
|
||||||
|
|
||||||
**Critical Issues:**
|
**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}}
|
{{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:**
|
**Important Issues:**
|
||||||
"I noticed a few areas that could be improved:
|
<display>
|
||||||
|
I noticed a few areas that could be improved:
|
||||||
|
|
||||||
{{important_issue_description}}
|
{{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:**
|
**Minor Issues:**
|
||||||
"Here are some minor suggestions for improvement:
|
<display>
|
||||||
|
Here are some minor suggestions for improvement:
|
||||||
|
|
||||||
{{minor_issue_description}}
|
{{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
|
### 6. Generate Validation Content
|
||||||
|
|
||||||
|
|
@ -284,7 +290,8 @@ Prepare the content to append to the document:
|
||||||
|
|
||||||
Show the validation results and present choices:
|
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:**
|
**Validation Summary:**
|
||||||
|
|
||||||
|
|
@ -300,6 +307,7 @@ Show the validation results and present choices:
|
||||||
[A] Advanced Elicitation - Address any complex architectural concerns
|
[A] Advanced Elicitation - Address any complex architectural concerns
|
||||||
[P] Party Mode - Review validation from different implementation perspectives
|
[P] Party Mode - Review validation from different implementation perspectives
|
||||||
[C] Continue - Complete the architecture and finish workflow
|
[C] Continue - Complete the architecture and finish workflow
|
||||||
|
</display>
|
||||||
|
|
||||||
### 8. Handle Menu Selection
|
### 8. Handle Menu Selection
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -67,7 +67,9 @@ a) **Menu Handling:**
|
||||||
|
|
||||||
a) **Greet the user briefly:**
|
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.
|
b) **Get their initial description.** Don't ask detailed questions yet - just understand enough to know where to look.
|
||||||
|
|
||||||
|
|
@ -150,13 +152,15 @@ a) **Create the tech-spec WIP file:**
|
||||||
|
|
||||||
b) **Report to user:**
|
b) **Report to user:**
|
||||||
|
|
||||||
"Created: `{wipFile}`
|
<display>
|
||||||
|
Created: `{wipFile}`
|
||||||
|
|
||||||
**Captured:**
|
**Captured:**
|
||||||
|
|
||||||
- Title: {title}
|
- Title: {title}
|
||||||
- Problem: {problem_statement_summary}
|
- Problem: {problem_statement_summary}
|
||||||
- Scope: {scope_summary}"
|
- Scope: {scope_summary}
|
||||||
|
</display>
|
||||||
|
|
||||||
### 6. Present Checkpoint Menu
|
### 6. Present Checkpoint Menu
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -45,7 +45,9 @@ a) **Build on Step 1's Quick Scan**
|
||||||
|
|
||||||
Review what was found in Step 1's orient scan. Then ask:
|
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**
|
b) **Read and Analyze Code**
|
||||||
|
|
||||||
|
|
@ -106,12 +108,14 @@ Fill in:
|
||||||
|
|
||||||
**Report to user:**
|
**Report to user:**
|
||||||
|
|
||||||
"**Context Gathered:**
|
<display>
|
||||||
|
**Context Gathered:**
|
||||||
|
|
||||||
- Tech Stack: {tech_stack_summary}
|
- Tech Stack: {tech_stack_summary}
|
||||||
- Files to Modify: {files_count} files identified
|
- Files to Modify: {files_count} files identified
|
||||||
- Patterns: {patterns_summary}
|
- Patterns: {patterns_summary}
|
||||||
- Tests: {test_patterns_summary}"
|
- Tests: {test_patterns_summary}
|
||||||
|
</display>
|
||||||
|
|
||||||
### 4. Present Checkpoint Menu
|
### 4. Present Checkpoint Menu
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -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>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>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">
|
<check if="workflow_mode == deep_dive">
|
||||||
<action>Read fully and follow: {installed_path}/workflows/deep-dive-instructions.md with resume context</action>
|
<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>
|
||||||
|
|
||||||
<check if="user selects 3">
|
<check if="user selects 3">
|
||||||
<action>Display: "Exiting workflow without changes."</action>
|
<display>Exiting workflow without changes.</display>
|
||||||
<action>Exit workflow</action>
|
<action>Exit workflow</action>
|
||||||
</check>
|
</check>
|
||||||
|
|
||||||
<check if="state file age >= 24 hours">
|
<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>Archive old state file to: {output_folder}/.archive/project-scan-report-{{timestamp}}.json</action>
|
||||||
<action>Set resume_mode = false</action>
|
<action>Set resume_mode = false</action>
|
||||||
<action>Continue to Step 0.5</action>
|
<action>Continue to Step 0.5</action>
|
||||||
|
|
@ -147,7 +147,7 @@ Your choice [1/2/3]:
|
||||||
|
|
||||||
<check if="user selects 1">
|
<check if="user selects 1">
|
||||||
<action>Set workflow_mode = "full_rescan"</action>
|
<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>Read fully and follow: {installed_path}/workflows/full-scan-instructions.md</action>
|
||||||
<action>After sub-workflow completes, continue to Step 4</action>
|
<action>After sub-workflow completes, continue to Step 4</action>
|
||||||
</check>
|
</check>
|
||||||
|
|
@ -155,7 +155,7 @@ Your choice [1/2/3]:
|
||||||
<check if="user selects 2">
|
<check if="user selects 2">
|
||||||
<action>Set workflow_mode = "deep_dive"</action>
|
<action>Set workflow_mode = "deep_dive"</action>
|
||||||
<action>Set scan_level = "exhaustive"</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>Read fully and follow: {installed_path}/workflows/deep-dive-instructions.md</action>
|
||||||
<action>After sub-workflow completes, continue to Step 4</action>
|
<action>After sub-workflow completes, continue to Step 4</action>
|
||||||
</check>
|
</check>
|
||||||
|
|
@ -168,7 +168,7 @@ Your choice [1/2/3]:
|
||||||
|
|
||||||
<check if="index.md does not exist">
|
<check if="index.md does not exist">
|
||||||
<action>Set workflow_mode = "initial_scan"</action>
|
<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>Read fully and follow: {installed_path}/workflows/full-scan-instructions.md</action>
|
||||||
<action>After sub-workflow completes, continue to Step 4</action>
|
<action>After sub-workflow completes, continue to Step 4</action>
|
||||||
</check>
|
</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>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>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>
|
||||||
|
|
||||||
<step n="0.6" goal="Check for existing documentation and determine workflow mode">
|
<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 if="user selects 1 OR user presses enter">
|
||||||
<action>Set scan_level = "quick"</action>
|
<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>
|
||||||
|
|
||||||
<action if="user selects 2">
|
<action if="user selects 2">
|
||||||
<action>Set scan_level = "deep"</action>
|
<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>
|
||||||
|
|
||||||
<action if="user selects 3">
|
<action if="user selects 3">
|
||||||
<action>Set scan_level = "exhaustive"</action>
|
<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>
|
||||||
|
|
||||||
<action>Initialize state file: {output_folder}/project-scan-report.json</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
|
- Store result in {{selected_items}} array
|
||||||
</action>
|
</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}}:
|
<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:**
|
2. **Route to appropriate generation substep based on doc_type:**
|
||||||
|
|
||||||
**If doc_type == "architecture":**
|
**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)
|
- Load architecture_match for this part from state file (Step 3 cache)
|
||||||
- Re-run Step 8 architecture generation logic ONLY for this specific part
|
- Re-run Step 8 architecture generation logic ONLY for this specific part
|
||||||
- Use matched template and fill with cached data from state file
|
- 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
|
- Validate completeness
|
||||||
|
|
||||||
**If doc_type == "api-contracts":**
|
**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
|
- Load part data and documentation_requirements
|
||||||
- Re-run Step 4 API scan substep targeting ONLY this part
|
- Re-run Step 4 API scan substep targeting ONLY this part
|
||||||
- Use scan_level from state file (quick/deep/exhaustive)
|
- 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
|
- Validate document structure
|
||||||
|
|
||||||
**If doc_type == "data-models":**
|
**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
|
- Re-run Step 4 data models scan substep targeting ONLY this part
|
||||||
- Use schema_migration_patterns from documentation_requirements
|
- Use schema_migration_patterns from documentation_requirements
|
||||||
- Generate data-models-{{part_id}}.md
|
- Generate data-models-{{part_id}}.md
|
||||||
- Validate completeness
|
- Validate completeness
|
||||||
|
|
||||||
**If doc_type == "component-inventory":**
|
**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
|
- Re-run Step 9 component inventory generation for this specific part
|
||||||
- Scan components/, ui/, widgets/ folders
|
- Scan components/, ui/, widgets/ folders
|
||||||
- Generate component-inventory-{{part_id}}.md
|
- Generate component-inventory-{{part_id}}.md
|
||||||
- Validate structure
|
- Validate structure
|
||||||
|
|
||||||
**If doc_type == "development-guide":**
|
**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
|
- Re-run Step 9 development guide generation for this specific part
|
||||||
- Use key_file_patterns and test_file_patterns from documentation_requirements
|
- Use key_file_patterns and test_file_patterns from documentation_requirements
|
||||||
- Generate development-guide-{{part_id}}.md
|
- Generate development-guide-{{part_id}}.md
|
||||||
- Validate completeness
|
- Validate completeness
|
||||||
|
|
||||||
**If doc_type == "deployment-guide":**
|
**If doc_type == "deployment-guide":**
|
||||||
- Display: "Generating deployment guide..."
|
- <display>Generating deployment guide...</display>
|
||||||
- Re-run Step 6 deployment configuration scan
|
- Re-run Step 6 deployment configuration scan
|
||||||
- Re-run Step 9 deployment guide generation
|
- Re-run Step 9 deployment guide generation
|
||||||
- Generate deployment-guide.md
|
- Generate deployment-guide.md
|
||||||
- Validate structure
|
- Validate structure
|
||||||
|
|
||||||
**If doc_type == "integration-architecture":**
|
**If doc_type == "integration-architecture":**
|
||||||
- Display: "Generating integration architecture..."
|
- <display>Generating integration architecture...</display>
|
||||||
- Re-run Step 7 integration analysis for all parts
|
- Re-run Step 7 integration analysis for all parts
|
||||||
- Generate integration-architecture.md
|
- Generate integration-architecture.md
|
||||||
- Validate completeness
|
- 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
|
- Confirm file was written successfully
|
||||||
- Update state file with newly generated output
|
- Update state file with newly generated output
|
||||||
- Add to {{newly_generated_docs}} tracking list
|
- Add to {{newly_generated_docs}} tracking list
|
||||||
- Display: "✓ Generated: {{file_path}}"
|
- <display>✓ Generated: {{file_path}}</display>
|
||||||
|
|
||||||
4. **Handle errors:**
|
4. **Handle errors:**
|
||||||
- If generation fails, log error and continue with next item
|
- 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
|
- Write final state file
|
||||||
</action>
|
</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>
|
</workflow>
|
||||||
|
|
|
||||||
|
|
@ -135,7 +135,8 @@ Set frontmatter `sections_completed` to track what will be updated
|
||||||
|
|
||||||
Report findings to user:
|
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:**
|
**Technology Stack Discovered:**
|
||||||
{{list_of_technologies_with_versions}}
|
{{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.
|
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:
|
## SUCCESS METRICS:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -55,13 +55,16 @@ Document the exact technology stack from discovery:
|
||||||
Based on user skill level, present findings:
|
Based on user skill level, present findings:
|
||||||
|
|
||||||
**Expert Mode:**
|
**Expert Mode:**
|
||||||
"Technology stack from your architecture and package files:
|
<display>
|
||||||
|
Technology stack from your architecture and package files:
|
||||||
{{exact_technologies_with_versions}}
|
{{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:**
|
**Intermediate Mode:**
|
||||||
"I found your technology stack:
|
<display>
|
||||||
|
I found your technology stack:
|
||||||
|
|
||||||
**Core Technologies:**
|
**Core Technologies:**
|
||||||
{{main_technologies_with_versions}}
|
{{main_technologies_with_versions}}
|
||||||
|
|
@ -69,10 +72,12 @@ Any critical version constraints I should document for agents?"
|
||||||
**Key Dependencies:**
|
**Key Dependencies:**
|
||||||
{{important_dependencies_with_versions}}
|
{{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:**
|
**Beginner Mode:**
|
||||||
"Here are the technologies you're using:
|
<display>
|
||||||
|
Here are the technologies you're using:
|
||||||
|
|
||||||
**Main Technologies:**
|
**Main Technologies:**
|
||||||
{{friendly_description_of_tech_stack}}
|
{{friendly_description_of_tech_stack}}
|
||||||
|
|
@ -80,14 +85,16 @@ Are there any version constraints or compatibility notes agents should know abou
|
||||||
**Important Notes:**
|
**Important Notes:**
|
||||||
{{key_things_agents_need_to_know_about_versions}}
|
{{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
|
### 2. Language-Specific Rules
|
||||||
|
|
||||||
Focus on unobvious language patterns agents might miss:
|
Focus on unobvious language patterns agents might miss:
|
||||||
|
|
||||||
**TypeScript/JavaScript Rules:**
|
**TypeScript/JavaScript Rules:**
|
||||||
"Based on your codebase, I notice some specific patterns:
|
<display>
|
||||||
|
Based on your codebase, I notice some specific patterns:
|
||||||
|
|
||||||
**Configuration Requirements:**
|
**Configuration Requirements:**
|
||||||
{{typescript_config_rules}}
|
{{typescript_config_rules}}
|
||||||
|
|
@ -98,7 +105,8 @@ Focus on unobvious language patterns agents might miss:
|
||||||
**Error Handling Patterns:**
|
**Error Handling Patterns:**
|
||||||
{{error_handling_requirements}}
|
{{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:**
|
**Python/Ruby/Other Language Rules:**
|
||||||
Adapt to the actual language in use with similar focused questions.
|
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:
|
Document framework-specific patterns:
|
||||||
|
|
||||||
**React Rules (if applicable):**
|
**React Rules (if applicable):**
|
||||||
"For React development, I see these patterns:
|
<display>
|
||||||
|
For React development, I see these patterns:
|
||||||
|
|
||||||
**Hooks Usage:**
|
**Hooks Usage:**
|
||||||
{{hooks_usage_patterns}}
|
{{hooks_usage_patterns}}
|
||||||
|
|
@ -122,7 +131,8 @@ Document framework-specific patterns:
|
||||||
**Performance Rules:**
|
**Performance Rules:**
|
||||||
{{performance_optimization_requirements}}
|
{{performance_optimization_requirements}}
|
||||||
|
|
||||||
Should I add any other React-specific rules?"
|
Should I add any other React-specific rules?
|
||||||
|
</display>
|
||||||
|
|
||||||
**Other Framework Rules:**
|
**Other Framework Rules:**
|
||||||
Adapt for Vue, Angular, Next.js, Express, etc.
|
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:
|
Focus on testing patterns that ensure consistency:
|
||||||
|
|
||||||
**Test Structure Rules:**
|
**Test Structure Rules:**
|
||||||
"Your testing setup shows these patterns:
|
<display>
|
||||||
|
Your testing setup shows these patterns:
|
||||||
|
|
||||||
**Test Organization:**
|
**Test Organization:**
|
||||||
{{test_file_organization}}
|
{{test_file_organization}}
|
||||||
|
|
@ -146,14 +157,16 @@ Focus on testing patterns that ensure consistency:
|
||||||
**Integration vs Unit Test Rules:**
|
**Integration vs Unit Test Rules:**
|
||||||
{{test_boundary_patterns}}
|
{{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
|
### 5. Code Quality & Style Rules
|
||||||
|
|
||||||
Document critical style and quality rules:
|
Document critical style and quality rules:
|
||||||
|
|
||||||
**Linting/Formatting:**
|
**Linting/Formatting:**
|
||||||
"Your code style configuration requires:
|
<display>
|
||||||
|
Your code style configuration requires:
|
||||||
|
|
||||||
**ESLint/Prettier Rules:**
|
**ESLint/Prettier Rules:**
|
||||||
{{specific_linting_rules}}
|
{{specific_linting_rules}}
|
||||||
|
|
@ -167,14 +180,16 @@ Document critical style and quality rules:
|
||||||
**Documentation Requirements:**
|
**Documentation Requirements:**
|
||||||
{{comment_and_documentation_patterns}}
|
{{comment_and_documentation_patterns}}
|
||||||
|
|
||||||
Any additional code quality rules?"
|
Any additional code quality rules?
|
||||||
|
</display>
|
||||||
|
|
||||||
### 6. Development Workflow Rules
|
### 6. Development Workflow Rules
|
||||||
|
|
||||||
Document workflow patterns that affect implementation:
|
Document workflow patterns that affect implementation:
|
||||||
|
|
||||||
**Git/Repository Rules:**
|
**Git/Repository Rules:**
|
||||||
"Your project uses these patterns:
|
<display>
|
||||||
|
Your project uses these patterns:
|
||||||
|
|
||||||
**Branch Naming:**
|
**Branch Naming:**
|
||||||
{{branch_naming_conventions}}
|
{{branch_naming_conventions}}
|
||||||
|
|
@ -188,14 +203,16 @@ Document workflow patterns that affect implementation:
|
||||||
**Deployment Patterns:**
|
**Deployment Patterns:**
|
||||||
{{deployment_considerations}}
|
{{deployment_considerations}}
|
||||||
|
|
||||||
Should I document any other workflow rules?"
|
Should I document any other workflow rules?
|
||||||
|
</display>
|
||||||
|
|
||||||
### 7. Critical Don't-Miss Rules
|
### 7. Critical Don't-Miss Rules
|
||||||
|
|
||||||
Identify rules that prevent common mistakes:
|
Identify rules that prevent common mistakes:
|
||||||
|
|
||||||
**Anti-Patterns to Avoid:**
|
**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}}
|
{{critical_anti_patterns_with_examples}}
|
||||||
|
|
||||||
|
|
@ -208,7 +225,8 @@ Identify rules that prevent common mistakes:
|
||||||
**Performance Gotchas:**
|
**Performance Gotchas:**
|
||||||
{{performance_patterns_to_avoid}}
|
{{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
|
### 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:
|
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:**
|
**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?**
|
**What would you like to do?**
|
||||||
[A] Advanced Elicitation - Explore nuanced rules for this category
|
[A] Advanced Elicitation - Explore nuanced rules for this category
|
||||||
[P] Party Mode - Review from different implementation perspectives
|
[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
|
### 10. Handle Menu Selection
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -133,14 +133,17 @@ Last Updated: {{date}}
|
||||||
Based on user skill level, present the completion:
|
Based on user skill level, present the completion:
|
||||||
|
|
||||||
**Expert Mode:**
|
**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`
|
File saved to: `{output_folder}/project-context.md`
|
||||||
|
|
||||||
Ready for AI agent integration."
|
Ready for AI agent integration.
|
||||||
|
</display>
|
||||||
|
|
||||||
**Intermediate Mode:**
|
**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:**
|
**What we created:**
|
||||||
|
|
||||||
|
|
@ -160,10 +163,12 @@ Ready for AI agent integration."
|
||||||
|
|
||||||
- AI agents should read this file before implementing
|
- AI agents should read this file before implementing
|
||||||
- Update as your project evolves
|
- Update as your project evolves
|
||||||
- Review periodically for optimization"
|
- Review periodically for optimization
|
||||||
|
</display>
|
||||||
|
|
||||||
**Beginner Mode:**
|
**Beginner Mode:**
|
||||||
"Excellent! Your project context guide is ready! 🎉
|
<display>
|
||||||
|
Excellent! Your project context guide is ready!
|
||||||
|
|
||||||
**What this does:**
|
**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.
|
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:**
|
**How AI agents use it:**
|
||||||
They read this file before writing any code, ensuring everything they create follows your project's standards perfectly.
|
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
|
### 5. Final File Updates
|
||||||
|
|
||||||
|
|
@ -225,32 +231,34 @@ Final checks before completion:
|
||||||
|
|
||||||
Present final completion to user:
|
Present final completion to user:
|
||||||
|
|
||||||
"✅ **Project Context Generation Complete!**
|
<display>
|
||||||
|
**Project Context Generation Complete!**
|
||||||
|
|
||||||
Your optimized project context file is ready at:
|
Your optimized project context file is ready at:
|
||||||
`{output_folder}/project-context.md`
|
`{output_folder}/project-context.md`
|
||||||
|
|
||||||
**📊 Context Summary:**
|
**Context Summary:**
|
||||||
|
|
||||||
- {{rule_count}} critical rules for AI agents
|
- {{rule_count}} critical rules for AI agents
|
||||||
- {{section_count}} comprehensive sections
|
- {{section_count}} comprehensive sections
|
||||||
- Optimized for LLM context efficiency
|
- Optimized for LLM context efficiency
|
||||||
- Ready for immediate agent integration
|
- Ready for immediate agent integration
|
||||||
|
|
||||||
**🎯 Key Benefits:**
|
**Key Benefits:**
|
||||||
|
|
||||||
- Consistent implementation across all AI agents
|
- Consistent implementation across all AI agents
|
||||||
- Reduced common mistakes and edge cases
|
- Reduced common mistakes and edge cases
|
||||||
- Clear guidance for project-specific patterns
|
- Clear guidance for project-specific patterns
|
||||||
- Minimal LLM context usage
|
- Minimal LLM context usage
|
||||||
|
|
||||||
**📋 Next Steps:**
|
**Next Steps:**
|
||||||
|
|
||||||
1. AI agents will automatically read this file when implementing
|
1. AI agents will automatically read this file when implementing
|
||||||
2. Update this file when your technology stack or patterns evolve
|
2. Update this file when your technology stack or patterns evolve
|
||||||
3. Review quarterly to optimize and remove outdated rules
|
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:
|
## SUCCESS METRICS:
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -140,11 +140,13 @@ Great starting point! Sometimes the most powerful ideas need space to develop. L
|
||||||
</display>
|
</display>
|
||||||
|
|
||||||
**When user gives detailed response:**
|
**When user gives detailed response:**
|
||||||
"Wow, there's so much rich material here! I want to make sure we capture the full potential. Let me focus on what I'm hearing:
|
<display>
|
||||||
|
Wow, there's so much rich material here! I want to make sure we capture the full potential. Let me focus on what I'm hearing:
|
||||||
|
|
||||||
**Key Insight:** [Extract and highlight their best point]
|
**Key Insight:** [Extract and highlight their best point]
|
||||||
**Building on That:** [Develop their idea further]
|
**Building on That:** [Develop their idea further]
|
||||||
**Additional Direction:** [Suggest new angles based on their thinking]"
|
**Additional Direction:** [Suggest new angles based on their thinking]
|
||||||
|
</display>
|
||||||
|
|
||||||
### 4. Check Technique Continuation
|
### 4. Check Technique Continuation
|
||||||
|
|
||||||
|
|
@ -177,7 +179,8 @@ This has been incredibly productive! We've generated some fantastic ideas around
|
||||||
|
|
||||||
**Periodic Check-In (DO NOT skip this):**
|
**Periodic Check-In (DO NOT skip this):**
|
||||||
|
|
||||||
"We've generated [X] ideas so far - great momentum!
|
<display>
|
||||||
|
We've generated [X] ideas so far - great momentum!
|
||||||
|
|
||||||
**Quick energy check:**
|
**Quick energy check:**
|
||||||
|
|
||||||
|
|
@ -185,7 +188,8 @@ This has been incredibly productive! We've generated some fantastic ideas around
|
||||||
- **Switch techniques** for a fresh perspective?
|
- **Switch techniques** for a fresh perspective?
|
||||||
- Or are you feeling like we've **thoroughly explored** this space?
|
- Or are you feeling like we've **thoroughly explored** this space?
|
||||||
|
|
||||||
Remember: The goal is quantity first - we can organize later. What feels right?"
|
Remember: The goal is quantity first - we can organize later. What feels right?
|
||||||
|
</display>
|
||||||
|
|
||||||
**IMPORTANT:** Default to continuing exploration. Only suggest organization if:
|
**IMPORTANT:** Default to continuing exploration. Only suggest organization if:
|
||||||
|
|
||||||
|
|
@ -256,11 +260,13 @@ Capture insights as they emerge during interactive facilitation:
|
||||||
|
|
||||||
**During Facilitation:**
|
**During Facilitation:**
|
||||||
|
|
||||||
"That's a powerful insight - let me capture that: _[Key idea with context]_
|
<display>
|
||||||
|
That's a powerful insight - let me capture that: _[Key idea with context]_
|
||||||
|
|
||||||
I'm noticing a theme emerging here: _[Pattern recognition]_
|
I'm noticing a theme emerging here: _[Pattern recognition]_
|
||||||
|
|
||||||
This connects beautifully with what we discovered earlier about _[previous connection]_"
|
This connects beautifully with what we discovered earlier about _[previous connection]_
|
||||||
|
</display>
|
||||||
|
|
||||||
**After Deep Exploration:**
|
**After Deep Exploration:**
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -70,7 +70,9 @@ For each selected agent:
|
||||||
Briefly acknowledge key discussion outcomes:
|
Briefly acknowledge key discussion outcomes:
|
||||||
|
|
||||||
**Session Recognition:**
|
**Session Recognition:**
|
||||||
"**Session Highlights:** Today we explored [main topic] through [number] different perspectives, generating valuable insights on [key outcomes]. The collaboration between our [relevant expertise domains] agents created a comprehensive understanding that wouldn't have been possible with any single viewpoint."
|
<display>
|
||||||
|
**Session Highlights:** Today we explored [main topic] through [number] different perspectives, generating valuable insights on [key outcomes]. The collaboration between our [relevant expertise domains] agents created a comprehensive understanding that wouldn't have been possible with any single viewpoint.
|
||||||
|
</display>
|
||||||
|
|
||||||
### 4. Final Party Mode Conclusion
|
### 4. Final Party Mode Conclusion
|
||||||
|
|
||||||
|
|
@ -116,9 +118,11 @@ workflow_completed: true
|
||||||
|
|
||||||
Execute final workflow termination:
|
Execute final workflow termination:
|
||||||
|
|
||||||
"[PARTY MODE WORKFLOW COMPLETE]
|
<display>
|
||||||
|
[PARTY MODE WORKFLOW COMPLETE]
|
||||||
|
|
||||||
Thank you for using BMAD Party Mode for collaborative multi-agent discussions!"
|
Thank you for using BMAD Party Mode for collaborative multi-agent discussions!
|
||||||
|
</display>
|
||||||
|
|
||||||
## SUCCESS METRICS:
|
## SUCCESS METRICS:
|
||||||
|
|
||||||
|
|
|
||||||
Loading…
Reference in New Issue