# agents-digital-enterprise/agency-agents-enterprise architecture

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

- Interactive diagram: https://gitdiagram.com/agents-digital-enterprise/agency-agents-enterprise
- Repository: https://github.com/agents-digital-enterprise/agency-agents-enterprise

## Overview

Digital Enterprise OS is a GitHub-Issue-centered agent operating system and project factory. A user submits an order as an Issue; the CEO researches and structures the project, the architect decomposes work, the team lead implements it, and QA validates the result, with Issue comments carrying context and handoffs. The local MCP server resolves roles and serves the filesystem-based persona library. The CEO also scaffolds projects from the template and registers them. README documents additional MCP integrations; sampled source verifies persona lookup, token generation, and comment posting, but not all orchestration wiring.

Main entry points: [`.claude/agents/ceo.md`](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/.claude/agents/ceo.md) (CEO overlay), [`scripts/agents-mcp-server.js`](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/scripts/agents-mcp-server.js) (Persona MCP server), [`scripts/github-logger.js`](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/scripts/github-logger.js) (Issue comment logger), [`.claude/agents/library/engineering/engineering-software-architect.md`](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/.claude/agents/library/engineering/engineering-software-architect.md) (Architect role)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_coordination["Agent Coordination"]
  node_ceo["CEO overlay<br/>[ceo.md]"]
  node_architect["Architect role"]
  node_lead["Team Lead role"]
  node_qa["QA role"]
  node_protocol["Agent protocols<br/>[AGENT_PROTOCOLS.md]"]
end

subgraph group_personas["Persona System"]
  node_mcp["Persona MCP server"]
  node_library["Agent library<br/>[library]"]
  node_overlays["Role overlays<br/>[agents]"]
end

subgraph group_factory["Project Factory"]
  node_registry[("Project registry")]
  node_template["Project template"]
  node_project["New project repository"]
end

subgraph group_github["GitHub Collaboration"]
  node_issue["GitHub Issues"]
  node_token["GitHub App token"]
  node_githubapi["GitHub API"]
  node_logger["Issue comment logger<br/>[github-logger.js]"]
end

node_user(("Project requester"))

node_user -->|"creates order"| node_issue
node_issue -->|"provides context"| node_ceo
node_ceo -->|"structures work"| node_issue
node_issue -->|"hands off plan"| node_architect
node_architect -->|"defines tasks"| node_issue
node_issue -->|"hands off tasks"| node_lead
node_lead -->|"posts implementation"| node_issue
node_issue -->|"provides change"| node_qa
node_qa -->|"posts review"| node_issue
node_ceo -->|"creates repository"| node_project
node_ceo -->|"copies scaffold"| node_template
node_ceo -->|"registers project"| node_registry
node_mcp -->|"scans and loads"| node_library
node_mcp -->|"loads overlay"| node_overlays
node_token -->|"requests token"| node_githubapi
node_logger -->|"posts comments"| node_issue
node_logger -->|"calls API"| node_githubapi

click node_ceo "https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/.claude/agents/ceo.md"
click node_architect "https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/.claude/agents/library/engineering/engineering-software-architect.md"
click node_lead "https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/.claude/agents/library/engineering/engineering-senior-developer.md"
click node_qa "https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/.claude/agents/library/engineering/engineering-code-reviewer.md"
click node_protocol "https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/AGENT_PROTOCOLS.md"
click node_mcp "https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/scripts/agents-mcp-server.js"
click node_library "https://github.com/agents-digital-enterprise/agency-agents-enterprise/tree/main/.claude/agents/library"
click node_overlays "https://github.com/agents-digital-enterprise/agency-agents-enterprise/tree/main/.claude/agents"
click node_registry "https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/projects-registry.json"
click node_template "https://github.com/agents-digital-enterprise/agency-agents-enterprise/tree/main/projects/template"
click node_token "https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/scripts/github-app-token.js"
click node_logger "https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/scripts/github-logger.js"

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_ceo,node_architect,node_lead,node_qa,node_protocol toneBlue
class node_mcp,node_library,node_overlays toneAmber
class node_registry,node_template,node_project,node_user toneMint
class node_issue,node_token,node_githubapi,node_logger toneRose
```

## Components

### Agent Coordination

- [CEO overlay](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/.claude/agents/ceo.md): `.claude/agents/ceo.md`
- [Architect role](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/.claude/agents/library/engineering/engineering-software-architect.md): `.claude/agents/library/engineering/engineering-software-architect.md`
- [Team Lead role](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/.claude/agents/library/engineering/engineering-senior-developer.md): `.claude/agents/library/engineering/engineering-senior-developer.md`
- [QA role](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/.claude/agents/library/engineering/engineering-code-reviewer.md): `.claude/agents/library/engineering/engineering-code-reviewer.md`
- [Agent protocols](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/AGENT_PROTOCOLS.md): `AGENT_PROTOCOLS.md`

### Persona System

- [Persona MCP server](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/scripts/agents-mcp-server.js): `scripts/agents-mcp-server.js`
- [Agent library](https://github.com/agents-digital-enterprise/agency-agents-enterprise/tree/main/.claude/agents/library): `.claude/agents/library`
- [Role overlays](https://github.com/agents-digital-enterprise/agency-agents-enterprise/tree/main/.claude/agents): `.claude/agents`

### Project Factory

- [Project registry](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/projects-registry.json): `projects-registry.json`
- [Project template](https://github.com/agents-digital-enterprise/agency-agents-enterprise/tree/main/projects/template): `projects/template`
- **New project repository**

### GitHub Collaboration

- **GitHub Issues**
- [GitHub App token](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/scripts/github-app-token.js): `scripts/github-app-token.js`
- **GitHub API**
- [Issue comment logger](https://github.com/agents-digital-enterprise/agency-agents-enterprise/blob/main/scripts/github-logger.js): `scripts/github-logger.js`

### Other components

- **Project requester**

## Connections

- Project requester → GitHub Issues: creates order
- GitHub Issues → CEO overlay: provides context
- CEO overlay → GitHub Issues: structures work
- GitHub Issues → Architect role: hands off plan
- Architect role → GitHub Issues: defines tasks
- GitHub Issues → Team Lead role: hands off tasks
- Team Lead role → GitHub Issues: posts implementation
- GitHub Issues → QA role: provides change
- QA role → GitHub Issues: posts review
- CEO overlay → New project repository: creates repository
- CEO overlay → Project template: copies scaffold
- CEO overlay → Project registry: registers project
- Persona MCP server → Agent library: scans and loads
- Persona MCP server → Role overlays: loads overlay
- GitHub App token → GitHub API: requests token
- Issue comment logger → GitHub Issues: posts comments
- Issue comment logger → GitHub API: calls API