checklist standardization and improvement with llm eliciatation

2025-12-29 16:14:59 +00:00 · 2025-06-08 20:34:07 -05:00
parent 460c47f5c8
commit 8788c1d20f
24 changed files with 2419 additions and 884 deletions
--- a/agent-team-workflows/greenfield-fullstack.yml
+++ b/agent-team-workflows/greenfield-fullstack.yml
@@ -2,15 +2,18 @@ workflow:
  id: greenfield-fullstack
  name: Greenfield Full-Stack Application Development
  description: >-
-    Agent workflow for building production-ready full-stack applications
-    from concept to development-ready artifacts.
+    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

-    sequence:
+  # For Complex Projects (Production-Ready, Multiple Features)
+  complex_project_sequence:
    - agent: analyst
      creates: project-brief.md
      optional_steps:
@@ -18,7 +21,7 @@ workflow:
        - 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  
+    - 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."
@@ -38,7 +41,7 @@ workflow:

    - agent: fullstack-architect
      creates: fullstack-architecture.md
-      requires: 
+      requires:
        - prd.md
        - front-end-spec.md
      optional_steps:
@@ -75,47 +78,91 @@ workflow:
      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] --> B[analyst: project-brief.md]
-        B --> C[pm: prd.md]
-        C --> D[ux-expert: front-end-spec.md]
-        D --> D2{Generate v0 prompt?}
-        D2 -->|Yes| D3[ux-expert: create v0 prompt]
-        D2 -->|No| E[fullstack-architect: fullstack-architecture.md]
-        D3 --> D4[User: generate UI in v0/Lovable]
-        D4 --> E
-        E --> F{Architecture suggests PRD changes?}
-        F -->|Yes| G[pm: update prd.md]
-        F -->|No| H[po: validate all artifacts]
-        G --> H
-        H --> I{PO finds issues?}
-        I -->|Yes| J[Return to relevant agent for fixes]
-        I -->|No| K{Generated UI?}
-        K -->|Yes| L[Guide project structure setup]
-        K -->|No| M[Guide development order]
-        L --> M
-        M --> N[Move to IDE Environment]
-        J --> H
+        A[Start: Greenfield Project] --> B{Project Complexity?}
+        B -->|Complex/Production| C[analyst: project-brief.md]
+        B -->|Simple/Prototype| D[analyst: focused project-brief.md]
        
-        B -.-> B1[Optional: brainstorming]
-        B -.-> B2[Optional: market research]
-        D -.-> D1[Optional: user research]
-        E -.-> E1[Optional: technical research]
+        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[fullstack-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
        
-        style N fill:#90EE90
-        style D3 fill:#E6E6FA
-        style D4 fill:#E6E6FA
-        style L fill:#E6E6FA
-        style M fill:#E6E6FA
-        style B fill:#FFE4B5
+        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 D 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."
@@ -123,4 +170,8 @@ workflow:
    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."
-    workflow_complete: "All planning artifacts validated and saved in docs/ folder. Move to IDE environment to begin development."
+    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."