Copilot Expert Hub Architecture

Overview

The Copilot Expert Hub consists of three building blocks that work together:

graph TB
    subgraph "GitHub Copilot in VS Code"
        A[Copilot Chat]
    end

    subgraph "Copilot Expert Hub"
        subgraph "Agents (15)"
            B[Engineering Agents]
            C[Review Agents]
            D[Productivity Agents]
            E[Communication Agents]
        end

        subgraph "Skills (25+)"
            F[Language Patterns]
            G[Software Engineering]
            H[Architecture]
            I[Project & Team]
        end

        subgraph "Templates & References"
            J[Marp Templates]
            K[Reference Repos]
        end
    end

    A --> B & C & D & E
    B & C --> F & G & H
    E --> J
    B --> K

    style A fill:#e3f2fd,stroke:#1565c0

---

Agents

Agents are specialized AI personalities with a defined role, responsibilities, and workflow. Each agent has:

• Identity — Who am I? What is my expertise?
• Core Responsibilities — What are my main tasks?
• Instructions — How do I proceed? What rules do I follow?
• Templates — What output formats do I use?

Agents are defined as .agent.md files in the agents/ directory and are automatically recognized by GitHub Copilot.

Agent Lifecycle

graph LR
    subgraph "Phase 1: Planning"
        A[Task Orchestrator]
        B[Lead Architect]
        C[GCP Architect]
    end

    subgraph "Phase 2: Implementation"
        D[Python Expert]
        E[Golang Expert]
        F["Flutter & iOS Expert"]
        G[Frontend Expert]
    end

    subgraph "Phase 3: Quality"
        H[Test Strategist]
        I[Architecture Reviewer]
        J[Code Reviewer]
    end

    subgraph "Phase 4: Deployment"
        K[DevOps Agent]
    end

    subgraph "Phase 5: Communication"
        L[Context Manager]
        M[Presentation Agent]
        N[Stakeholder Agent]
        O["Proposal/Pitch Agent"]
    end

    A --> B --> D & E & F & G
    D & E & F & G --> H --> I --> J --> K --> L --> M & N & O

---

Skills

Skills are technical knowledge bases that agents use to provide well-founded recommendations. They contain:

• Best Practices with code examples
• Patterns for recurring problems
• Anti-Patterns — what to avoid
• Decision guides for technical choices

Skills are organized as Markdown files in the skills/ directory — either as SKILL.md in a dedicated folder or as individual .md files in category folders.

Skill Categories

Category	Skills	Primary Users
Language Patterns	Python, Go, Flutter, Frontend	Implementation Agents
Software Engineering	Clean Code, SOLID, Design Patterns	All Agents
Architecture	Microservices, DDD, Cloud-Native	Lead Architect, GCP Architect
Project & Team	Agile, PR Crafting, Progress Sync	Task Orchestrator, Context Manager

---

Templates & References

Marp Templates

Pre-built presentation templates for the Presentation Agent:

Template	Audience	Purpose
Client Pitch	Business Stakeholders	Selling solutions
Technical Deep-Dive	Engineers	Explaining architecture
Project Review	Stakeholders	Sprint/project status

Reference Repos

Golden-path examples for production architectures:

Repo	Description
Python Golden	Production-grade Python project structure
Event-Driven Python	Event-Driven Architecture on GCP

---

Directory Structure

ai-agents/
├── agents/                     # 15 specialized AI Agents
│   ├── lead-architect.agent.md
│   ├── python-expert.agent.md
│   └── ...
├── skills/                     # 25+ technical knowledge bases
│   ├── python-patterns/
│   ├── software-engineering/
│   ├── architecture/
│   └── ...
├── marp-templates/             # 3 Marp Slide Templates
│   ├── client-pitch.md
│   ├── technical-deepdive.md
│   └── project-review.md
├── reference-repos/            # 2 Golden-Path References
│   ├── python-golden/
│   └── event-driven-python/
├── templates/                  # Templates for new Skills
│   └── skill-template.md
├── assets/
│   ├── mkdocs/                 # MkDocs Source (Markdown)
│   └── mkdocs.yml              # MkDocs Configuration
├── docs/                       # Built Documentation (GitHub Pages)
├── copilot-instructions.md     # Global Copilot Configuration
├── justfile                    # Development Commands
└── mkdocs.yml                  # MkDocs Configuration

---

Extensibility

The Hub is modular by design. New agents and skills can be added easily:

1. New Agent: Create an .agent.md file in agents/ → Guide
2. New Skill: Create a folder in skills/ with SKILL.md → Guide
3. New Template: Add a Marp file in marp-templates/ → Guidelines

# Using the Justfile:
just new-agent rust-expert
just new-skill rust-patterns