# bronz3beard/ai.tech-lead-stack architecture

> Architecture diagram of the GitHub repository bronz3beard/ai.tech-lead-stack, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bronz3beard/ai.tech-lead-stack
- Repository: https://github.com/bronz3beard/ai.tech-lead-stack
- Video tour (about a minute): https://gitdiagram.com/bronz3beard/ai.tech-lead-stack/video

## Overview

The Lead Stack combines an agent-agnostic workflow/tooling product with a web dashboard for repository work, AI assistance, design review, and workflow analytics. A principal web workflow is a developer submitting a brief to the Reflexion endpoint, which configures a model runner, executes iterative planning, persists run state, and returns a handoff or interview result. The README also describes intent-to-release skills and review/testing workflows. The tree and sampled files support several dashboard and MCP paths; skill catalogue internals and some integrations were not sampled, so uncertain wiring is omitted.

Main entry points: [`apps/dashboard/src/app/api/orchestrator/reflexion/route.ts`](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/orchestrator/reflexion/route.ts) (Reflexion endpoint), [`packages/core/src/lib/prisma.ts`](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/lib/prisma.ts) (Application database), [`packages/core/src/lib/ai/reflexion/engine.ts`](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/lib/ai/reflexion/engine.ts) (Reflexion engine), [`packages/core/src/mcp-server/handlers/pipeline.ts`](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/mcp-server/handlers/pipeline.ts) (Pipeline planning)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_dashboard["Dashboard workflows"]
  node_web["Dashboard UI<br/>[layout.tsx]"]
  node_chatui["Chat interface<br/>[ChatBody.tsx]"]
  node_chatapi["AI chat API<br/>[route.ts]"]
  node_discovery["Feature discovery<br/>[route.ts]"]
  node_sandbox["Sandbox boot<br/>[route.ts]"]
  node_design["Design review<br/>[route.ts]"]
  node_projects["Project management<br/>[route.ts]"]
  node_analytics["Workflow analytics<br/>[agentic-metrics.ts]"]
end

subgraph group_ai["AI orchestration"]
  node_reflexionapi["Reflexion endpoint<br/>[route.ts]"]
  node_engine["Reflexion engine<br/>[engine.ts]"]
  node_runner["User model runner<br/>[providers-user.ts]"]
end

subgraph group_mcp["MCP and skills"]
  node_pipeline["Pipeline planning<br/>[pipeline.ts]"]
  node_mcpserver["MCP server<br/>[index.ts]"]
  node_skills["Skill services<br/>[fs-service.ts]"]
end

subgraph group_state["State and integrations"]
  node_db[("Application database<br/>[prisma.ts]")]
  node_github["GitHub"]
  node_e2b["E2B sandbox"]
  node_model["AI model provider"]
  node_telemetry["Telemetry"]
end

node_developer(("Developer"))

node_developer -->|"uses"| node_web
node_web -->|"opens chat"| node_chatui
node_chatui -->|"sends messages"| node_chatapi
node_chatapi -->|"streams responses"| node_model
node_developer -->|"submits brief"| node_reflexionapi
node_reflexionapi -.->|"reads project files"| node_github
node_reflexionapi -->|"configures runner"| node_runner
node_reflexionapi -->|"creates run state"| node_db
node_reflexionapi -->|"runs loop"| node_engine
node_engine -->|"generates and critiques"| node_runner
node_engine -->|"persists loop state"| node_db
node_developer -->|"starts discovery"| node_discovery
node_discovery -->|"streams assistance"| node_model
node_developer -->|"boots sandbox"| node_sandbox
node_sandbox -->|"runs project"| node_e2b
node_developer -->|"manages review"| node_design
node_design -->|"reads and updates sessions"| node_db
node_developer -->|"manages projects"| node_projects
node_projects -->|"reads and writes projects"| node_db
node_developer -->|"requests tools"| node_mcpserver
node_mcpserver -->|"dispatches pipeline"| node_pipeline
node_pipeline -->|"loads skill graph"| node_skills
node_pipeline -->|"tracks planning"| node_telemetry
node_developer -->|"views metrics"| node_analytics

click node_web "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/layout.tsx"
click node_chatui "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/components/chat/ChatBody.tsx"
click node_chatapi "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/chat/route.ts"
click node_discovery "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/orchestrator/discovery/route.ts"
click node_sandbox "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/orchestrator/sandbox/boot/route.ts"
click node_design "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/design-review/route.ts"
click node_projects "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/projects/route.ts"
click node_analytics "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/lib/agentic-metrics.ts"
click node_reflexionapi "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/orchestrator/reflexion/route.ts"
click node_engine "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/lib/ai/reflexion/engine.ts"
click node_runner "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/lib/ai/reflexion/providers-user.ts"
click node_pipeline "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/mcp-server/handlers/pipeline.ts"
click node_mcpserver "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/mcp-server/index.ts"
click node_skills "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/lib/skills/fs-service.ts"
click node_db "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/lib/prisma.ts"
click node_telemetry "https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/lib/telemetry-service.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_web,node_chatui,node_chatapi,node_discovery,node_sandbox,node_design,node_projects,node_analytics toneBlue
class node_reflexionapi,node_engine,node_runner toneAmber
class node_pipeline,node_mcpserver,node_skills toneMint
class node_db,node_github,node_e2b,node_model,node_telemetry toneRose
class node_developer toneIndigo
```

## Components

### Dashboard workflows

- [Dashboard UI](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/layout.tsx): `apps/dashboard/src/app/layout.tsx`
- [Chat interface](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/components/chat/ChatBody.tsx): `apps/dashboard/src/components/chat/ChatBody.tsx`
- [AI chat API](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/chat/route.ts): `apps/dashboard/src/app/api/chat/route.ts`
- [Feature discovery](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/orchestrator/discovery/route.ts): `apps/dashboard/src/app/api/orchestrator/discovery/route.ts`
- [Sandbox boot](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/orchestrator/sandbox/boot/route.ts): `apps/dashboard/src/app/api/orchestrator/sandbox/boot/route.ts`
- [Design review](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/design-review/route.ts): `apps/dashboard/src/app/api/design-review/route.ts`
- [Project management](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/projects/route.ts): `apps/dashboard/src/app/api/projects/route.ts`
- [Workflow analytics](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/lib/agentic-metrics.ts): `apps/dashboard/src/lib/agentic-metrics.ts`

### AI orchestration

- [Reflexion endpoint](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/apps/dashboard/src/app/api/orchestrator/reflexion/route.ts): `apps/dashboard/src/app/api/orchestrator/reflexion/route.ts`
- [Reflexion engine](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/lib/ai/reflexion/engine.ts): `packages/core/src/lib/ai/reflexion/engine.ts`
- [User model runner](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/lib/ai/reflexion/providers-user.ts): `packages/core/src/lib/ai/reflexion/providers-user.ts`

### MCP and skills

- [Pipeline planning](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/mcp-server/handlers/pipeline.ts): `packages/core/src/mcp-server/handlers/pipeline.ts`
- [MCP server](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/mcp-server/index.ts): `packages/core/src/mcp-server/index.ts`
- [Skill services](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/lib/skills/fs-service.ts): `packages/core/src/lib/skills/fs-service.ts`

### State and integrations

- [Application database](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/lib/prisma.ts): `packages/core/src/lib/prisma.ts`
- **GitHub**
- **E2B sandbox**
- **AI model provider**
- [Telemetry](https://github.com/bronz3beard/ai.tech-lead-stack/blob/main/packages/core/src/lib/telemetry-service.ts): `packages/core/src/lib/telemetry-service.ts`

### Other components

- **Developer**

## Connections

- Developer → Dashboard UI: uses
- Dashboard UI → Chat interface: opens chat
- Chat interface → AI chat API: sends messages
- AI chat API → AI model provider: streams responses
- Developer → Reflexion endpoint: submits brief
- Reflexion endpoint → GitHub: reads project files
- Reflexion endpoint → User model runner: configures runner
- Reflexion endpoint → Application database: creates run state
- Reflexion endpoint → Reflexion engine: runs loop
- Reflexion engine → User model runner: generates and critiques
- Reflexion engine → Application database: persists loop state
- Developer → Feature discovery: starts discovery
- Feature discovery → AI model provider: streams assistance
- Developer → Sandbox boot: boots sandbox
- Sandbox boot → E2B sandbox: runs project
- Developer → Design review: manages review
- Design review → Application database: reads and updates sessions
- Developer → Project management: manages projects
- Project management → Application database: reads and writes projects
- Developer → MCP server: requests tools
- MCP server → Pipeline planning: dispatches pipeline
- Pipeline planning → Skill services: loads skill graph
- Pipeline planning → Telemetry: tracks planning
- Developer → Workflow analytics: views metrics