# carlosnavarrovalldecabres-vlc/agents architecture

> Architecture diagram of the GitHub repository carlosnavarrovalldecabres-vlc/agents, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/carlosnavarrovalldecabres-vlc/agents
- Repository: https://github.com/carlosnavarrovalldecabres-vlc/agents

## Overview

##### Project Type and Purpose
- This is an open-source “plugin” or agent-definition library for Claude Code. Each Markdown file describes an AI agent (name, description, tools, system prompt). The repository’s purpose is to organize, document, and distribute these agents so that Claude Code can load and invoke them automatically or on demand.

##### File Structure Analysis
- Top-level:
- `.gitignore`, `README.md` – repo metadata
- `design/`, `engineering/`, `marketing/`, `product/`, `project-management/`, `studio-operations/`, `testing/`, `bonus/` – department folders
- Each folder contains `.md` files with YAML frontmatter.
- Installation involves a simple copy/clone operation; there is no build script or compiled code.
- The “engine” that consumes these files resides in Claude Code; this repo is purely content.

##### Key Insights from README
- Agents are categorized by department for discovery.
- Installation: clone & copy into `~/.claude/agents/`; restart Claude Code.
- Agents auto-register and trigger proactively based on context.

##### Essential Architectural Elements to Capture
- Separation of concerns: content repo vs. runtime vs. installation vs. UI.
- Plugin loading process (file → parse → register).
- Agent dispatch logic (intent matching, proactive triggers).
- Extensibility workflow (adding/modifying `.md` files).
- Performance metrics pipeline (runtime → logging → analytics).

## Diagram (Mermaid)

```mermaid
flowchart TD
    subgraph "Content Repository"
        GitRepo["GitHub Repo"]:::filestore
    end
    subgraph "Local Clone File System"
        LocalCloneFS["Agents Root (Local Clone)"]:::filestore
        Design["Design Agents"]:::filestore
        Engineering["Engineering Agents"]:::filestore
        Marketing["Marketing Agents"]:::filestore
        Product["Product Agents"]:::filestore
        PM["Project Management Agents"]:::filestore
        StudioOps["Studio Ops Agents"]:::filestore
        Testing["Testing Agents"]:::filestore
        Bonus["Bonus Agents"]:::filestore
        LocalCloneFS -->|contains| Design
        LocalCloneFS -->|contains| Engineering
        LocalCloneFS -->|contains| Marketing
        LocalCloneFS -->|contains| Product
        LocalCloneFS -->|contains| PM
        LocalCloneFS -->|contains| StudioOps
        LocalCloneFS -->|contains| Testing
        LocalCloneFS -->|contains| Bonus
    end
    GitRepo -->|git clone| LocalCloneFS

    subgraph "Installation"
        Install["Install (.md files copy)"]:::service
    end
    LocalCloneFS -->|copy *.md| Install
    Install -->|to ~/.claude/agents/| AgentDir

    subgraph "Claude Code Environment"
        AgentDir["Claude Agent Directory"]:::filestore
        Parser["Markdown Parser"]:::runtime
        Registry["Agent Registry"]:::runtime
        Orchestrator["Agent Orchestrator"]:::runtime
        AgentDir --> Parser --> Registry --> Orchestrator
    end

    subgraph "User Interaction"
        UI["IDE / CLI"]:::ui
    end
    UI -->|prompt| Orchestrator
    Orchestrator -->|response| UI

    AnalyticsDB["Analytics Service"]:::external
    Orchestrator -->|logs usage| AnalyticsDB

    click GitRepo "https://github.com/carlosnavarrovalldecabres-vlc/agents/blob/main//README.md"
    click LocalCloneFS "https://github.com/carlosnavarrovalldecabres-vlc/agents/tree/main//"
    click Design "https://github.com/carlosnavarrovalldecabres-vlc/agents/tree/main//design/"
    click Engineering "https://github.com/carlosnavarrovalldecabres-vlc/agents/tree/main//engineering/"
    click Marketing "https://github.com/carlosnavarrovalldecabres-vlc/agents/tree/main//marketing/"
    click Product "https://github.com/carlosnavarrovalldecabres-vlc/agents/tree/main//product/"
    click PM "https://github.com/carlosnavarrovalldecabres-vlc/agents/tree/main//project-management/"
    click StudioOps "https://github.com/carlosnavarrovalldecabres-vlc/agents/tree/main//studio-operations/"
    click Testing "https://github.com/carlosnavarrovalldecabres-vlc/agents/tree/main//testing/"
    click Bonus "https://github.com/carlosnavarrovalldecabres-vlc/agents/tree/main//bonus/"
    click Install "https://github.com/carlosnavarrovalldecabres-vlc/agents/blob/main//README.md"

    classDef filestore fill:#ADD8E6,stroke:#000,stroke-width:1px
    classDef runtime fill:#90EE90,stroke:#000,stroke-width:1px
    classDef external fill:#FFA500,stroke:#000,stroke-width:1px
    classDef service fill:#98FB98,stroke:#000,stroke-width:1px
    classDef ui fill:#D3D3D3,stroke:#000,stroke-width:1px
```
