# dfinke/awesome-copilot-chatmodes architecture

> Architecture diagram of the GitHub repository dfinke/awesome-copilot-chatmodes, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dfinke/awesome-copilot-chatmodes
- Repository: https://github.com/dfinke/awesome-copilot-chatmodes

## Overview

##### Project type and purpose
- This is an open-source repository that curates and distributes custom chat mode definition files (`.chatmode.md`) for GitHub Copilot Chat in VS Code.
- It provides a collection of persona/config files, instructions, and assets (an illustration) so that end users can paste these files into their workspace and unlock specialized AI behaviors.

##### File structure
- Top-level:
– LICENSE – open-source license
– README.md – project overview and usage instructions
– assets/ – contains static images for documentation
– chatmodes/ – contains individual `.chatmode.md` definition files (each defines a persona or behavior)
- No source code beyond Markdown files; this is a static content repository.
- No build scripts or complex deployment; distribution is via GitHub.

##### README for additional insights
- Explains how to install: copy a `.chatmode.md` into your workspace’s `.github/chatmodes` directory, restart VS Code, then select the mode in the Copilot Chat panel.
- Links to official VS Code documentation on chat modes.
- Emphasizes contribution of new chat modes via pull requests.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Repository Layer
    subgraph "GitHub Remote Repository"
        GitHubRepo["GitHub Remote Repository"]:::repo
        README["README.md"]:::repo
        LICENSE["LICENSE"]:::repo
        Assets["assets/"]:::repo
        ChatmodesDir["chatmodes/"]:::repo
        subgraph "Chat Mode Definition Files"
            BulletPoints["bullet-points.chatmode.md"]:::repo
            CleanCode["clean-code.chatmode.md"]:::repo
            PromptDesigner["prompt-designer.chatmode.md"]:::repo
            SecurityScout["security-scout.chatmode.md"]:::repo
        end
    end

    %% Local Workspace Layer
    subgraph "Local Workspace"
        WorkspaceRepo["Local Clone of Repository"]:::workspace
        WorkspaceChatmodes[".github/chatmodes/"]:::workspace
    end

    %% Editor / Extension Layer
    subgraph "VS Code Editor"
        VSCode["VS Code + Copilot Chat"]:::extension
    end

    %% Cloud Service
    CloudAPI["Copilot Chat Cloud API"]:::service

    %% Relationships
    GitHubRepo -->|"git clone / pull"| WorkspaceRepo
    WorkspaceRepo -->|"copy .chatmode.md"| WorkspaceChatmodes
    WorkspaceChatmodes -->|"scan on restart"| VSCode
    VSCode -->|"select mode & send prompt"| CloudAPI
    CloudAPI -->|"response payload"| VSCode

    %% Click Events
    click GitHubRepo "https://github.com/dfinke/awesome-copilot-chatmodes/tree/main//"
    click README "https://github.com/dfinke/awesome-copilot-chatmodes/blob/main//README.md"
    click LICENSE "https://github.com/dfinke/awesome-copilot-chatmodes/tree/main//LICENSE"
    click Assets "https://github.com/dfinke/awesome-copilot-chatmodes/tree/main//assets/"
    click ChatmodesDir "https://github.com/dfinke/awesome-copilot-chatmodes/tree/main//chatmodes/"
    click BulletPoints "https://github.com/dfinke/awesome-copilot-chatmodes/blob/main//chatmodes/bullet-points.chatmode.md"
    click CleanCode "https://github.com/dfinke/awesome-copilot-chatmodes/blob/main//chatmodes/clean-code.chatmode.md"
    click PromptDesigner "https://github.com/dfinke/awesome-copilot-chatmodes/blob/main//chatmodes/prompt-designer.chatmode.md"
    click SecurityScout "https://github.com/dfinke/awesome-copilot-chatmodes/blob/main//chatmodes/security-scout.chatmode.md"

    %% Styles
    classDef repo fill:#E3F2FD,stroke:#90CAF9,color:#0D47A1;
    classDef workspace fill:#E8F5E9,stroke:#66BB6A,color:#1B5E20;
    classDef extension fill:#FFF3E0,stroke:#FFB74D,color:#E65100;
    classDef service fill:#FFEBEE,stroke:#EF5350,color:#B71C1C;
```
