# yasir2000/archipilot architecture

> Architecture diagram of the GitHub repository yasir2000/archipilot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yasir2000/archipilot
- Repository: https://github.com/yasir2000/archipilot

## Overview

archipilot is a VS Code Copilot Chat extension for managing TOGAF-aligned architecture work in Obsidian vaults. The main workflow is an architect command routed through the chat participant, which builds a prompt using vault context, receives a Copilot response, and may validate and apply structured updates; read-only analysis and exports are other outcomes. The graph preserves documented scanning, governance, diagramming, and export capabilities. Some subsystem links come from the README workflow because the participant implementation is only partially excerpted.

Main entry points: [`src/core/index.ts`](https://github.com/yasir2000/archipilot/blob/main/src/core/index.ts) (Core engine), [`src/participant.ts`](https://github.com/yasir2000/archipilot/blob/main/src/participant.ts) (Chat participant), [`src/updater.ts`](https://github.com/yasir2000/archipilot/blob/main/src/updater.ts) (File updater), [`src/sidebar.ts`](https://github.com/yasir2000/archipilot/blob/main/src/sidebar.ts) (Vault sidebar)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interaction"]
  node_chat["Chat participant<br/>[participant.ts]"]
  node_sidebar["Vault sidebar<br/>[sidebar.ts]"]
  node_command_router["Extension commands<br/>[extension.ts]"]
end

subgraph group_orchestration["Chat orchestration"]
  node_prompts["Prompt builder<br/>[prompts.ts]"]
  node_context["Context windowing<br/>[context.ts]"]
end

subgraph group_vault["Vault management"]
  node_vault_manager["Vault manager<br/>[vault.ts]"]
  node_vault_files[("Obsidian vault")]
  node_templates["TOGAF templates<br/>[vault-template.ts]"]
end

subgraph group_architecture["Architecture capabilities"]
  node_source_scan["Workspace scanner<br/>[source-scanner.ts]"]
  node_core_engine["Core engine<br/>[index.ts]"]
  node_parser["Command parser<br/>[parser.ts]"]
  node_validator["Vault validator<br/>[validator.ts]"]
  node_todo["TOGAF action items<br/>[todo-extractor.ts]"]
  node_archimate["ArchiMate export"]
  node_viewpoints["ArchiMate viewpoints"]
  node_drawio["Draw.io export<br/>[drawio-exporter.ts]"]
  node_c4["C4 scaffolding<br/>[c4-scaffold.ts]"]
  node_sizing_timeline["Sizing and timeline<br/>[sizing-scaffold.ts]"]
end

subgraph group_changes["Governed changes"]
  node_updater["File updater<br/>[updater.ts]"]
  node_mutations["Vault mutations<br/>[mutations.ts]"]
end

node_architect(("Enterprise architect"))
node_copilot(("Copilot LLM"))

node_architect -->|"sends commands"| node_chat
node_architect -->|"opens explorer"| node_sidebar
node_architect -->|"runs commands"| node_command_router
node_sidebar -->|"routes actions"| node_command_router
node_chat -->|"builds prompts"| node_prompts
node_chat -->|"loads vault"| node_vault_manager
node_chat -->|"uses core"| node_core_engine
node_chat -->|"scans workspace"| node_source_scan
node_chat -->|"creates vault"| node_templates
node_prompts -->|"sends prompt"| node_copilot
node_vault_manager -->|"reads vault"| node_vault_files
node_context -->|"filters context"| node_vault_files
node_core_engine -->|"scans read-only"| node_vault_files
node_core_engine -->|"hands off changes"| node_updater
node_updater -->|"writes updates"| node_vault_files
node_updater -->|"parses commands"| node_parser
node_updater -->|"validates updates"| node_validator
node_updater -->|"applies edits"| node_mutations
node_core_engine -.->|"provides actions"| node_todo
node_core_engine -.->|"exports models"| node_archimate
node_core_engine -.->|"builds viewpoints"| node_viewpoints
node_core_engine -.->|"exports diagrams"| node_drawio
node_core_engine -.->|"scaffolds C4"| node_c4
node_core_engine -.->|"scaffolds plans"| node_sizing_timeline

click node_chat "https://github.com/yasir2000/archipilot/blob/main/src/participant.ts"
click node_sidebar "https://github.com/yasir2000/archipilot/blob/main/src/sidebar.ts"
click node_command_router "https://github.com/yasir2000/archipilot/blob/main/src/extension.ts"
click node_prompts "https://github.com/yasir2000/archipilot/blob/main/src/prompts.ts"
click node_vault_manager "https://github.com/yasir2000/archipilot/blob/main/src/vault.ts"
click node_context "https://github.com/yasir2000/archipilot/blob/main/src/core/context.ts"
click node_source_scan "https://github.com/yasir2000/archipilot/blob/main/src/source-scanner.ts"
click node_templates "https://github.com/yasir2000/archipilot/blob/main/src/vault-template.ts"
click node_core_engine "https://github.com/yasir2000/archipilot/blob/main/src/core/index.ts"
click node_parser "https://github.com/yasir2000/archipilot/blob/main/src/core/parser.ts"
click node_validator "https://github.com/yasir2000/archipilot/blob/main/src/core/validator.ts"
click node_todo "https://github.com/yasir2000/archipilot/blob/main/src/core/todo-extractor.ts"
click node_archimate "https://github.com/yasir2000/archipilot/blob/main/src/core/archimate-exporter.ts"
click node_viewpoints "https://github.com/yasir2000/archipilot/blob/main/src/core/archimate-templates.ts"
click node_drawio "https://github.com/yasir2000/archipilot/blob/main/src/core/drawio-exporter.ts"
click node_c4 "https://github.com/yasir2000/archipilot/blob/main/src/core/c4-scaffold.ts"
click node_sizing_timeline "https://github.com/yasir2000/archipilot/blob/main/src/core/sizing-scaffold.ts"
click node_updater "https://github.com/yasir2000/archipilot/blob/main/src/updater.ts"
click node_mutations "https://github.com/yasir2000/archipilot/blob/main/src/core/mutations.ts"

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_chat,node_sidebar,node_command_router toneBlue
class node_prompts,node_context toneAmber
class node_vault_manager,node_vault_files,node_templates toneMint
class node_source_scan,node_core_engine,node_parser,node_validator,node_todo,node_archimate,node_viewpoints,node_drawio,node_c4,node_sizing_timeline toneRose
class node_updater,node_mutations,node_architect,node_copilot toneIndigo
```

## Components

### User interaction

- [Chat participant](https://github.com/yasir2000/archipilot/blob/main/src/participant.ts): `src/participant.ts`
- [Vault sidebar](https://github.com/yasir2000/archipilot/blob/main/src/sidebar.ts): `src/sidebar.ts`
- [Extension commands](https://github.com/yasir2000/archipilot/blob/main/src/extension.ts): `src/extension.ts`

### Chat orchestration

- [Prompt builder](https://github.com/yasir2000/archipilot/blob/main/src/prompts.ts): `src/prompts.ts`
- [Context windowing](https://github.com/yasir2000/archipilot/blob/main/src/core/context.ts): `src/core/context.ts`

### Vault management

- [Vault manager](https://github.com/yasir2000/archipilot/blob/main/src/vault.ts): `src/vault.ts`
- **Obsidian vault**
- [TOGAF templates](https://github.com/yasir2000/archipilot/blob/main/src/vault-template.ts): `src/vault-template.ts`

### Architecture capabilities

- [Workspace scanner](https://github.com/yasir2000/archipilot/blob/main/src/source-scanner.ts): `src/source-scanner.ts`
- [Core engine](https://github.com/yasir2000/archipilot/blob/main/src/core/index.ts): `src/core/index.ts`
- [Command parser](https://github.com/yasir2000/archipilot/blob/main/src/core/parser.ts): `src/core/parser.ts`
- [Vault validator](https://github.com/yasir2000/archipilot/blob/main/src/core/validator.ts): `src/core/validator.ts`
- [TOGAF action items](https://github.com/yasir2000/archipilot/blob/main/src/core/todo-extractor.ts): `src/core/todo-extractor.ts`
- [ArchiMate export](https://github.com/yasir2000/archipilot/blob/main/src/core/archimate-exporter.ts): `src/core/archimate-exporter.ts`
- [ArchiMate viewpoints](https://github.com/yasir2000/archipilot/blob/main/src/core/archimate-templates.ts): `src/core/archimate-templates.ts`
- [Draw.io export](https://github.com/yasir2000/archipilot/blob/main/src/core/drawio-exporter.ts): `src/core/drawio-exporter.ts`
- [C4 scaffolding](https://github.com/yasir2000/archipilot/blob/main/src/core/c4-scaffold.ts): `src/core/c4-scaffold.ts`
- [Sizing and timeline](https://github.com/yasir2000/archipilot/blob/main/src/core/sizing-scaffold.ts): `src/core/sizing-scaffold.ts`

### Governed changes

- [File updater](https://github.com/yasir2000/archipilot/blob/main/src/updater.ts): `src/updater.ts`
- [Vault mutations](https://github.com/yasir2000/archipilot/blob/main/src/core/mutations.ts): `src/core/mutations.ts`

### Other components

- **Enterprise architect**
- **Copilot LLM**

## Connections

- Enterprise architect → Chat participant: sends commands (evidence: `README.md`)
- Enterprise architect → Vault sidebar: opens explorer (evidence: `README.md`)
- Enterprise architect → Extension commands: runs commands (evidence: `README.md`)
- Vault sidebar → Extension commands: routes actions (evidence: `README.md`)
- Chat participant → Prompt builder: builds prompts (evidence: `src/participant.ts`)
- Chat participant → Vault manager: loads vault (evidence: `src/participant.ts`)
- Chat participant → Core engine: uses core (evidence: `src/participant.ts`)
- Chat participant → Workspace scanner: scans workspace (evidence: `src/participant.ts`)
- Chat participant → TOGAF templates: creates vault (evidence: `src/participant.ts`)
- Prompt builder → Copilot LLM: sends prompt (evidence: `README.md`)
- Vault manager → Obsidian vault: reads vault (evidence: `README.md`)
- Context windowing → Obsidian vault: filters context (evidence: `README.md`)
- Core engine → Obsidian vault: scans read-only (evidence: `README.md`)
- Core engine → File updater: hands off changes (evidence: `README.md`)
- File updater → Obsidian vault: writes updates (evidence: `README.md`)
- File updater → Command parser: parses commands (evidence: `src/updater.ts`)
- File updater → Vault validator: validates updates (evidence: `src/updater.ts`)
- File updater → Vault mutations: applies edits (evidence: `src/updater.ts`)
- Core engine → TOGAF action items: provides actions (evidence: `src/core/index.ts`)
- Core engine → ArchiMate export: exports models (evidence: `src/core/index.ts`)
- Core engine → ArchiMate viewpoints: builds viewpoints (evidence: `src/core/index.ts`)
- Core engine → Draw.io export: exports diagrams (evidence: `src/core/index.ts`)
- Core engine → C4 scaffolding: scaffolds C4 (evidence: `src/core/index.ts`)
- Core engine → Sizing and timeline: scaffolds plans (evidence: `src/core/index.ts`)
