# apply.sh — use cases

```mermaid
flowchart TD
    A([Developer]) -- "curl | bash" --> B[Bootstrap: clone or pull ai-superpower]
    B -- "exec apply.sh --bootstrapped" --> C[Copy .ai/ into DEV_ROOT]

    A -- "bash apply.sh" --> ERR[✗ Error: must run via curl]

    C --> D[Scan dev root for .git projects]

    D --> E{Projects found?}
    E -- "No" --> NP[Print: no projects found]
    E -- "Yes" --> G[Per-project setup]

    G --> H{.ai symlink → DEV_ROOT/.ai ok?}
    H -- "Missing or broken" --> I[Create symlink]
    H -- "Ok" --> J[Skip]

    I --> K
    J --> K

    K{.ai in .gitignore?}
    K -- "No" --> L[Add .ai to .gitignore]
    K -- "Yes" --> M[Skip]

    L --> N
    M --> N

    N{docs/ exists?}
    N -- "No" --> O[⚠ Warning: no docs/ folder]
    N -- "Yes" --> P{ai-context.md exists?}

    O --> S
    P -- "No" --> Q[Create from template]
    P -- "Yes, marker present" --> QR[Refresh from template]
    P -- "Yes, no marker" --> R[Skip — developer owns file]

    Q --> S
    QR --> S
    R --> S

    S{architecture.md exists?}
    S -- "No" --> T[Create from template]
    S -- "Yes, marker present" --> TR[Refresh from template]
    S -- "Yes, no marker" --> U[Skip — developer owns file]

    T --> V
    TR --> V
    U --> V

    V{More projects?}
    V -- "Yes" --> G
    V -- "No" --> W[Write .ai-superpower.version]
    W --> X([✅ Done])