009c77f0f5
### CHANGES - Add newlines and spacing for improved readability - Standardize instructional text for consistency - Renumber lists within tasks for better clarity - Add language identifiers to various code blocks - Update placeholder text for improved consistency - Adjust descriptions and wording in multiple files - Update VS Code settings and dictionary words
178 lines
8.0 KiB
YAML
178 lines
8.0 KiB
YAML
workflow:
|
|
id: greenfield-fullstack
|
|
name: Greenfield Full-Stack Application Development
|
|
description: >-
|
|
Agent workflow for building full-stack applications from concept to development.
|
|
Supports both comprehensive planning for complex projects and rapid prototyping for simple ones.
|
|
type: greenfield
|
|
project_types:
|
|
- web-app
|
|
- saas
|
|
- enterprise-app
|
|
- prototype
|
|
- mvp
|
|
|
|
# For Complex Projects (Production-Ready, Multiple Features)
|
|
complex_project_sequence:
|
|
- agent: analyst
|
|
creates: project-brief.md
|
|
optional_steps:
|
|
- brainstorming_session
|
|
- market_research_prompt
|
|
notes: "Can do brainstorming first, then optional deep research before creating project brief. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
|
|
|
|
- agent: pm
|
|
creates: prd.md
|
|
requires: project-brief.md
|
|
notes: "Creates PRD from project brief using prd-tmpl. SAVE OUTPUT: Copy final prd.md to your project's docs/ folder."
|
|
|
|
- agent: ux-expert
|
|
creates: front-end-spec.md
|
|
requires: prd.md
|
|
optional_steps:
|
|
- user_research_prompt
|
|
notes: "Creates UI/UX specification using front-end-spec-tmpl. SAVE OUTPUT: Copy final front-end-spec.md to your project's docs/ folder."
|
|
|
|
- agent: ux-expert
|
|
creates: v0_prompt (optional)
|
|
requires: front-end-spec.md
|
|
condition: user_wants_ai_generation
|
|
notes: "OPTIONAL BUT RECOMMENDED: Generate AI UI prompt for tools like v0, Lovable, etc. Use the generate-ai-frontend-prompt task. User can then generate UI in external tool and download project structure."
|
|
|
|
- agent: architect
|
|
creates: fullstack-architecture.md
|
|
requires:
|
|
- prd.md
|
|
- front-end-spec.md
|
|
optional_steps:
|
|
- technical_research_prompt
|
|
- review_generated_ui_structure
|
|
notes: "Creates comprehensive architecture using fullstack-architecture-tmpl. If user generated UI with v0/Lovable, can incorporate the project structure into architecture. May suggest changes to PRD stories or new stories. SAVE OUTPUT: Copy final fullstack-architecture.md to your project's docs/ folder."
|
|
|
|
- agent: pm
|
|
updates: prd.md (if needed)
|
|
requires: fullstack-architecture.md
|
|
condition: architecture_suggests_prd_changes
|
|
notes: "If architect suggests story changes, update PRD and re-export the complete unredacted prd.md to docs/ folder."
|
|
|
|
- agent: po
|
|
validates: all_artifacts
|
|
uses: po-master-checklist
|
|
notes: "Validates all documents for consistency and completeness. May require updates to any document."
|
|
|
|
- agent: various
|
|
updates: any_flagged_documents
|
|
condition: po_checklist_issues
|
|
notes: "If PO finds issues, return to relevant agent to fix and re-export updated documents to docs/ folder."
|
|
|
|
- project_setup_guidance:
|
|
action: guide_project_structure
|
|
condition: user_has_generated_ui
|
|
notes: "If user generated UI with v0/Lovable: For polyrepo setup, place downloaded project in separate frontend repo alongside backend repo. For monorepo, place in apps/web or packages/frontend directory. Review architecture document for specific guidance."
|
|
|
|
- development_order_guidance:
|
|
action: guide_development_sequence
|
|
notes: "Based on PRD stories: If stories are frontend-heavy, start with frontend project/directory first. If backend-heavy or API-first, start with backend. For tightly coupled features, follow story sequence in monorepo setup. Reference sharded PRD epics for development order."
|
|
|
|
- workflow_end:
|
|
action: move_to_ide
|
|
notes: "All planning artifacts complete. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
|
|
|
|
# For Simple Projects (Prototypes, MVPs, Quick Experiments)
|
|
simple_project_sequence:
|
|
- step: project_scope
|
|
action: assess complexity
|
|
notes: "First, assess if this needs full planning (use complex_project_sequence) or can be a simple prototype/MVP."
|
|
|
|
- agent: analyst
|
|
creates: project-brief.md
|
|
optional_steps:
|
|
- brainstorming_session
|
|
notes: "Creates focused project brief for simple project. SAVE OUTPUT: Copy final project-brief.md to your project's docs/ folder."
|
|
|
|
- agent: pm
|
|
creates: simple_epic OR single_story
|
|
uses: create-epic OR create-story
|
|
requires: project-brief.md
|
|
notes: "Create simple epic or story instead of full PRD for rapid development. Choose based on scope."
|
|
|
|
- workflow_end:
|
|
action: move_to_ide
|
|
notes: "Simple project defined. Move to IDE environment to begin development. Explain to the user the IDE Development Workflow next steps: data#bmad-kb:IDE Development Workflow"
|
|
|
|
flow_diagram: |
|
|
```mermaid
|
|
graph TD
|
|
A[Start: Greenfield Project] --> B{Project Complexity?}
|
|
B -->|Complex/Production| C[analyst: project-brief.md]
|
|
B -->|Simple/Prototype| D[analyst: focused project-brief.md]
|
|
|
|
C --> E[pm: prd.md]
|
|
E --> F[ux-expert: front-end-spec.md]
|
|
F --> F2{Generate v0 prompt?}
|
|
F2 -->|Yes| F3[ux-expert: create v0 prompt]
|
|
F2 -->|No| G[architect: fullstack-architecture.md]
|
|
F3 --> F4[User: generate UI in v0/Lovable]
|
|
F4 --> G
|
|
G --> H{Architecture suggests PRD changes?}
|
|
H -->|Yes| I[pm: update prd.md]
|
|
H -->|No| J[po: validate all artifacts]
|
|
I --> J
|
|
J --> K{PO finds issues?}
|
|
K -->|Yes| L[Return to relevant agent for fixes]
|
|
K -->|No| M[Move to IDE Environment]
|
|
L --> J
|
|
|
|
D --> N[pm: simple epic or story]
|
|
N --> O[Move to IDE Environment]
|
|
|
|
C -.-> C1[Optional: brainstorming]
|
|
C -.-> C2[Optional: market research]
|
|
F -.-> F1[Optional: user research]
|
|
G -.-> G1[Optional: technical research]
|
|
D -.-> D1[Optional: brainstorming]
|
|
|
|
style M fill:#90EE90
|
|
style O fill:#90EE90
|
|
style F3 fill:#E6E6FA
|
|
style F4 fill:#E6E6FA
|
|
style C fill:#FFE4B5
|
|
style E fill:#FFE4B5
|
|
style F fill:#FFE4B5
|
|
style G fill:#FFE4B5
|
|
style D fill:#FFB6C1
|
|
style N fill:#FFB6C1
|
|
```
|
|
|
|
decision_guidance:
|
|
use_complex_sequence_when:
|
|
- Building production-ready applications
|
|
- Multiple team members will be involved
|
|
- Complex feature requirements (4+ stories)
|
|
- Need comprehensive documentation
|
|
- Long-term maintenance expected
|
|
- Enterprise or customer-facing applications
|
|
|
|
use_simple_sequence_when:
|
|
- Building prototypes or MVPs
|
|
- Solo developer or small team
|
|
- Simple requirements (1-3 stories)
|
|
- Quick experiments or proof-of-concepts
|
|
- Short-term or throwaway projects
|
|
- Learning or educational projects
|
|
|
|
handoff_prompts:
|
|
# Complex sequence prompts
|
|
analyst_to_pm: "Project brief is complete. Save it as docs/project-brief.md in your project, then create the PRD."
|
|
pm_to_ux: "PRD is ready. Save it as docs/prd.md in your project, then create the UI/UX specification."
|
|
ux_to_architect: "UI/UX spec complete. Save it as docs/front-end-spec.md in your project, then create the fullstack architecture."
|
|
architect_review: "Architecture complete. Save it as docs/fullstack-architecture.md. Do you suggest any changes to the PRD stories or need new stories added?"
|
|
architect_to_pm: "Please update the PRD with the suggested story changes, then re-export the complete prd.md to docs/."
|
|
updated_to_po: "All documents ready in docs/ folder. Please validate all artifacts for consistency."
|
|
po_issues: "PO found issues with [document]. Please return to [agent] to fix and re-save the updated document."
|
|
complex_complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
|
|
|
|
# Simple sequence prompts
|
|
simple_analyst_to_pm: "Focused project brief complete. Save it as docs/project-brief.md, then create simple epic or story for rapid development."
|
|
simple_complete: "Simple project defined. Move to IDE environment to begin development."
|