# Brownfield Level 4 - Enterprise Scale Changes to Existing System
# 40+ stories, major expansion of existing enterprise system

project_type: "software"
level: 4
field_type: "brownfield"
description: "Enterprise scale expansion of existing system"

phases:
  - phase: 0
    name: "Documentation"
    conditional: "if_undocumented"
    workflows:
      - id: "document-project"
        required: true
        agent: "analyst"
        command: "document-project"
        output: "Comprehensive codebase documentation"
        note: "Critical for enterprise-scale changes"

  - phase: 1
    name: "Analysis"
    required: true
    workflows:
      - id: "brainstorm-project"
        recommended: true
        agent: "analyst"
        command: "brainstorm-project"
      - id: "research"
        required: true
        agent: "analyst"
        command: "research"
        note: "Research existing system architecture deeply"
      - id: "product-brief"
        required: true
        agent: "analyst"
        command: "product-brief"
        note: "Strategic brief for major expansion"

  - phase: 2
    name: "Planning"
    required: true
    workflows:
      - id: "prd"
        required: true
        agent: "pm"
        command: "prd"
        output: "Comprehensive PRD considering existing system"
      - id: "validate-prd"
        optional: true
        agent: "pm"
        command: "validate-prd"
      - id: "create-design"
        required: true
        agent: "ux-designer"
        command: "create-design"
        note: "Multiple UI/UX specifications"

  - phase: 3
    name: "Solutioning"
    required: true
    workflows:
      - id: "create-architecture"
        required: true
        agent: "architect"
        command: "create-architecture"
        output: "Architecture for system expansion"
        note: "Must maintain backward compatibility"
      - id: "validate-architecture"
        optional: true
        agent: "architect"
        command: "validate-architecture"
      - id: "solutioning-gate-check"
        required: true
        agent: "architect"
        command: "solutioning-gate-check"
        note: "Critical validation before major changes"

  - phase: 4
    name: "Implementation"
    required: true
    phase_initialization:
      - id: "sprint-planning"
        required: true
        agent: "sm"
        command: "sprint-planning"
        note: "Initialize sprint tracking - run once when entering Phase 4"
    epic_loop: "for_each_epic"
    epic_iteration:
      setup_workflows:
        - id: "tech-spec"
          required: true
          agent: "sm"
          command: "tech-spec"
          note: "JIT per epic - creates stories considering existing code"

      story_loop: "for_each_story_in_epic"
      story_workflows:
        - id: "create-story"
          required: true
          agent: "sm"
          command: "create-story"
        - id: "story-context"
          required: true
          agent: "sm"
          command: "story-context"
          note: "Extensive existing code context required"
        - id: "validate-story-context"
          optional: true
          agent: "sm"
          command: "validate-story-context"
        - id: "story-ready"
          optional: true
          agent: "sm"
          command: "story-ready"
        - id: "dev-story"
          required: true
          agent: "dev"
          command: "dev-story"
        - id: "review-story"
          optional: true
          agent: "dev"
          command: "review-story"
          note: "Rigorous review for enterprise changes"
        - id: "integration-test"
          optional: true
          agent: "dev"
          command: "integration-test"
          note: "Test integration with existing systems"
        - id: "story-done"
          required: true
          agent: "dev"
          command: "story-done"

      completion_workflows:
        - id: "retrospective"
          required: true
          agent: "sm"
          command: "retrospective"
          note: "Critical for enterprise-scale learning"

story_naming: "story-<epic>.<story>.md"
story_example: "story-1.1.md, story-2.3.md"
epic_structure: "JIT tech-specs per epic create stories"
enterprise_note: "Maintain system stability while implementing major changes"
brownfield_note: "Extensive regression testing and backward compatibility required"