Workflow: Discovery & Context (00)

graph TB
    subgraph Context [🔍 Phase 1: Understand]
        direction TB
        A[New to project] --> B[load-context]
        B --> C{Understood?}
        C -- No --> B
    end

    subgraph Setup [⚙️ Phase 2: Setup]
        direction TB
        C -- Yes --> D[setup-environment]
        D --> E{Ready?}
        E -- No --> D
    end

    E -- Yes --> F((Start Development))

    %% Styling
    style Context fill:#f5f5f5,stroke:#333,stroke-dasharray: 5 5
    style Setup fill:#e1f5fe,stroke:#01579b
    style C fill:#ffd54f
    style E fill:#ffd54f
    style F fill:#e8f5e9,stroke:#1b5e20,stroke-width:3px

app/
├── controllers/      # HTTP layer, thin
├── models/          # Domain logic + persistence
├── services/        # Business operations
├── jobs/            # Background processing
├── views/           # ERB/HAML + Hotwire
└── helpers/         # View utilities

config/
├── routes.rb        # Routing table
└── initializers/    # Gem configs

spec/ or test/
├── models/          # Unit tests
├── requests/        # Integration tests
├── services/        # Service tests
└── system/          # E2E tests

docs/
├── architecture.md  # System design
├── api/             # API documentation
└── workflows/       # This directory

# Standard setup
bin/rails db:create
bin/rails db:migrate
bin/rails db:seed

# Test environment
RAILS_ENV=test bin/rails db:create db:migrate

# With Docker
docker-compose up -d db
docker-compose run web bin/rails db:create db:migrate db:seed

DO NOT write implementation code before running load-context.
ALWAYS post the Context Summary and resolve any ambiguities first.