flowchart TB
    subgraph bootstrap ["Bootstrap (dotfiles bootstrap)"]
        B1["1. Xcode CLI"]
        B2["2. Homebrew"]
        B3["3. Brew Bundle"]
        B4["4. Sheldon"]
        B5["5. Stow core/"]
        B6["6. Theme apply"]
        B1 --> B2 --> B3 --> B4 --> B5 --> B6
    end

    subgraph layers ["Three-Layer Structure"]
        direction LR
        CORE["core/<br/>git · zsh · sheldon · nvim · tmux · starship"]
        MODS["modules/<br/>aerospace · ghostty · karabiner<br/>sketchybar · borders · gitmux"]
        SYS["system/<br/>themes · lib · bin · packages"]
    end

    subgraph stow ["Stow Manager"]
        SM["dotfiles stow"]
        SM -->|"--target $HOME"| CORE
        SM -->|"--target $HOME/.config/..."| MODS
    end

    subgraph theme ["Theme Engine"]
        direction TB
        TL["themes/list/*.sh<br/>Semantic color definitions"]
        TR["themes/renderers/<br/>starship · sketchybar · tmux · borders"]
        TG["themes/generated/<br/>Tool-specific configs (gitignored)"]
        CLI["dotfiles theme<br/>CLI: list · apply · select · current"]
        TL --> CLI --> TR --> TG
    end

    bootstrap --> layers
    layers --> stow
    SYS --> theme
    TG -.->|"source / include"| CORE
    TG -.->|"source / include"| MODS

flowchart LR
    subgraph source ["Source"]
        T1["catppuccin-mocha.sh"]
        T2["dracula.sh"]
        T3["tokyo-night.sh"]
        T4["... 9 more"]
    end

    subgraph apply ["theme apply <name>"]
        S["Source theme file<br/>(loads THEME_* vars)"]
        R["Run all renderers"]
        P["Persist to .current-theme"]
    end

    subgraph generated ["Generated (gitignored)"]
        G1["starship.toml"]
        G2["sketchybar-colors.sh"]
        G3["tmux-colors.conf"]
        G4["borders-colors.sh"]
    end

    subgraph tools ["Tool Integration"]
        ST["Starship<br/>STARSHIP_CONFIG env var"]
        SB["SketchyBar<br/>source colors.sh"]
        TM["Tmux<br/>source-file tmux-colors.conf"]
        BD["Borders<br/>CLI args from colors"]
    end

    source --> S --> R --> P
    R --> generated
    G1 --> ST
    G2 --> SB
    G3 --> TM
    G4 --> BD

flowchart TB
    ZSHRC[".zshrc"]
    SHELDON["Sheldon (plugin manager)"]
    PLUGINS["Plugins<br/>zsh-vi-mode (sync)<br/>zsh-defer (sync)<br/>zsh-syntax-highlighting (deferred)<br/>zsh-autosuggestions (deferred)<br/>zsh-autopair (deferred)<br/>zsh-completions (fpath)"]

    subgraph modules ["System Modules"]
        ALIAS["alias.sh"]
        HIST["history.sh"]
        CLR["colors.sh (palette defaults)"]
        TOOL["tools.sh (starship, fzf, eza, bat, zoxide)"]
    end

    LOCAL["~/.zshrc.local (optional)"]

    ZSHRC --> SHELDON
    SHELDON --> PLUGINS
    PLUGINS --> ALIAS
    ALIAS --> HIST --> CLR --> TOOL
    TOOL --> LOCAL

flowchart LR
    subgraph core_pkgs ["core/"]
        direction TB
        CG["git/.gitconfig"]
        CZ["zsh/.zshrc"]
        CSD["sheldon/plugins.toml"]
        CN["nvim/init.lua lua/..."]
        CT["tmux/tmux.conf"]
        CS["starship/starship.toml"]
    end

    subgraph module_pkgs ["modules/"]
        direction TB
        MA["aerospace/aerospace.toml"]
        MG["ghostty/config"]
        MK["karabiner/karabiner.json assets/"]
        MS["sketchybar/sketchybarrc items/ plugins/"]
        MB["borders/bordersrc"]
        MX["gitmux/.gitmux.conf"]
    end

    subgraph system_pkgs ["system/"]
        direction TB
        CB["bin/ (dotfiles CLI)"]
    end

    subgraph targets ["~ (Home)"]
        direction TB
        T1["$HOME/.gitconfig"]
        T2["$HOME/.zshrc"]
        T3["$HOME/.config/nvim/"]
        T4["$HOME/.config/tmux/"]
        T5["$HOME/.config/aerospace/"]
        T6["$HOME/.config/ghostty/"]
        T7["$HOME/.config/sketchybar/"]
        T8["$HOME/.local/bin/ (CLI)"]
    end

    CG -->|"stow --target=$HOME"| T1
    CZ -->|"stow --target=$HOME"| T2
    CN -->|"stow --target=$HOME/.config/nvim"| T3
    CT -->|"stow --target=$HOME/.config/tmux"| T4
    MA -->|"stow --target=$HOME/.config/aerospace"| T5
    MG -->|"stow --target=$HOME/.config/ghostty"| T6
    MS -->|"stow --target=$HOME/.config/sketchybar"| T7
    CB -->|"stow --target=$HOME/.local/bin"| T8