# timosalomaki/github-copilot-toolkit architecture

> Architecture diagram of the GitHub repository timosalomaki/github-copilot-toolkit, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/timosalomaki/github-copilot-toolkit
- Repository: https://github.com/timosalomaki/github-copilot-toolkit

## Overview

GitHub Copilot Toolkit is a curated collection of reusable prompt and agent instruction files, not a runtime application. Users copy selected resources into a VS Code workspace or profile, then invoke prompts in chat or select an agent. Its documented capabilities span code analysis, architecture and dependency mapping, AI feature ideation, and multi-model deliberation. The graph reflects README-described usage; source excerpts were unavailable, so it does not infer internal prompt behavior or undocumented interactions.

Main entry points: [`.github/agents/dead-code-detective.agent.md`](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/agents/dead-code-detective.agent.md) (Dead Code Detective), [`.github/agents/monolith-splitter.agent.md`](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/agents/monolith-splitter.agent.md) (Monolith Splitter), [`.github/prompts/why-this-way.prompt.md`](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/why-this-way.prompt.md) (Why This Way), [`.github/prompts/legacy-architecture-map.prompt.md`](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/legacy-architecture-map.prompt.md) (Legacy Architecture Map)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agents["Custom agents"]
  node_deadcode["Dead Code Detective"]
  node_monolith["Monolith Splitter"]
end

subgraph group_prompts["Prompt tools"]
  node_why["Why This Way"]
  node_architecture["Legacy Architecture Map"]
  node_dependency["Dependency Chain Analyzer"]
  node_ideation["AI Feature Ideation"]
end

subgraph group_council["AI Council"]
  node_councilguide["Council Guide<br/>[ai-council.md]"]
  node_claude["Claude Prompt"]
  node_gpt["GPT Prompt"]
  node_gemini["Gemini Prompt"]
end

node_user(("Developer"))
node_vscode["VS Code Copilot"]

node_user -->|"selects agent"| node_deadcode
node_user -->|"selects agent"| node_monolith
node_user -->|"runs prompt"| node_why
node_user -->|"runs prompt"| node_architecture
node_user -->|"runs prompt"| node_dependency
node_user -->|"runs prompt"| node_ideation
node_user -->|"follows guidance"| node_councilguide
node_user -->|"rotates manually"| node_claude
node_user -->|"rotates manually"| node_gpt
node_user -->|"rotates manually"| node_gemini
node_deadcode -->|"activates in chat"| node_vscode
node_monolith -->|"activates in chat"| node_vscode
node_why -->|"runs in chat"| node_vscode
node_architecture -->|"runs in chat"| node_vscode
node_dependency -->|"runs in chat"| node_vscode
node_ideation -->|"runs in chat"| node_vscode
node_claude -->|"runs in chat"| node_vscode
node_gpt -->|"runs in chat"| node_vscode
node_gemini -->|"runs in chat"| node_vscode

click node_deadcode "https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/agents/dead-code-detective.agent.md"
click node_monolith "https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/agents/monolith-splitter.agent.md"
click node_why "https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/why-this-way.prompt.md"
click node_architecture "https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/legacy-architecture-map.prompt.md"
click node_dependency "https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/dependency-chain-analyzer.prompt.md"
click node_ideation "https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/ai-feature-ideation.prompt.md"
click node_councilguide "https://github.com/timosalomaki/github-copilot-toolkit/blob/main/docs/ai-council.md"
click node_claude "https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/council-claude.prompt.md"
click node_gpt "https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/council-gpt.prompt.md"
click node_gemini "https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/council-gemini.prompt.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_deadcode,node_monolith toneBlue
class node_why,node_architecture,node_dependency,node_ideation toneAmber
class node_councilguide,node_claude,node_gpt,node_gemini toneMint
class node_user,node_vscode toneIndigo
```

## Components

### Custom agents

- [Dead Code Detective](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/agents/dead-code-detective.agent.md): `.github/agents/dead-code-detective.agent.md`
- [Monolith Splitter](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/agents/monolith-splitter.agent.md): `.github/agents/monolith-splitter.agent.md`

### Prompt tools

- [Why This Way](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/why-this-way.prompt.md): `.github/prompts/why-this-way.prompt.md`
- [Legacy Architecture Map](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/legacy-architecture-map.prompt.md): `.github/prompts/legacy-architecture-map.prompt.md`
- [Dependency Chain Analyzer](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/dependency-chain-analyzer.prompt.md): `.github/prompts/dependency-chain-analyzer.prompt.md`
- [AI Feature Ideation](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/ai-feature-ideation.prompt.md): `.github/prompts/ai-feature-ideation.prompt.md`

### AI Council

- [Council Guide](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/docs/ai-council.md): `docs/ai-council.md`
- [Claude Prompt](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/council-claude.prompt.md): `.github/prompts/council-claude.prompt.md`
- [GPT Prompt](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/council-gpt.prompt.md): `.github/prompts/council-gpt.prompt.md`
- [Gemini Prompt](https://github.com/timosalomaki/github-copilot-toolkit/blob/main/.github/prompts/council-gemini.prompt.md): `.github/prompts/council-gemini.prompt.md`

### Other components

- **Developer**
- **VS Code Copilot**

## Connections

- Developer → Dead Code Detective: selects agent (evidence: `README.md`)
- Developer → Monolith Splitter: selects agent (evidence: `README.md`)
- Developer → Why This Way: runs prompt (evidence: `README.md`)
- Developer → Legacy Architecture Map: runs prompt (evidence: `README.md`)
- Developer → Dependency Chain Analyzer: runs prompt (evidence: `README.md`)
- Developer → AI Feature Ideation: runs prompt (evidence: `README.md`)
- Developer → Council Guide: follows guidance (evidence: `README.md`)
- Developer → Claude Prompt: rotates manually (evidence: `README.md`)
- Developer → GPT Prompt: rotates manually (evidence: `README.md`)
- Developer → Gemini Prompt: rotates manually (evidence: `README.md`)
- Dead Code Detective → VS Code Copilot: activates in chat (evidence: `README.md`)
- Monolith Splitter → VS Code Copilot: activates in chat (evidence: `README.md`)
- Why This Way → VS Code Copilot: runs in chat (evidence: `README.md`)
- Legacy Architecture Map → VS Code Copilot: runs in chat (evidence: `README.md`)
- Dependency Chain Analyzer → VS Code Copilot: runs in chat (evidence: `README.md`)
- AI Feature Ideation → VS Code Copilot: runs in chat (evidence: `README.md`)
- Claude Prompt → VS Code Copilot: runs in chat (evidence: `README.md`)
- GPT Prompt → VS Code Copilot: runs in chat (evidence: `README.md`)
- Gemini Prompt → VS Code Copilot: runs in chat (evidence: `README.md`)
