# mounidar/autonomous-software-engineering-team architecture

> Architecture diagram of the GitHub repository mounidar/autonomous-software-engineering-team, 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/mounidar/autonomous-software-engineering-team
- Repository: https://github.com/mounidar/autonomous-software-engineering-team
- Video tour (about a minute): https://gitdiagram.com/mounidar/autonomous-software-engineering-team/video

## Overview

This repository is a small autonomous software-engineering agent prototype. Its implemented workflow starts in `main.py`: an Architect asks OpenAI for a structured architecture, then a Developer reports selected architecture details and inspects and reads repository files. The Developer also exposes a file-writing method, though the main workflow does not call it. The README describes broader planning, implementation, testing, review, and improvement capabilities; the sampled code does not show those stages implemented, so they are not represented as runtime components.

Main entry points: [`agents/architect.py`](https://github.com/mounidar/autonomous-software-engineering-team/blob/main/agents/architect.py) (Architect agent), [`main.py`](https://github.com/mounidar/autonomous-software-engineering-team/blob/main/main.py) (Task runner), [`agents/developer.py`](https://github.com/mounidar/autonomous-software-engineering-team/blob/main/agents/developer.py) (Developer agent), [`tools/filesystem.py`](https://github.com/mounidar/autonomous-software-engineering-team/blob/main/tools/filesystem.py) (Filesystem tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orchestration["Workflow"]
  node_runner["Task runner<br/>[main.py]"]
end

subgraph group_agents["Agents"]
  node_architect["Architect agent<br/>[architect.py]"]
  node_developer["Developer agent<br/>[developer.py]"]
end

subgraph group_workspace["Workspace tools"]
  node_filesystem["Filesystem tools<br/>[filesystem.py]"]
end

node_openai{{"OpenAI API"}}

node_runner -->|"requests analysis"| node_architect
node_architect -->|"submits prompt"| node_openai
node_openai -->|"returns parsed plan"| node_architect
node_architect -->|"returns architecture"| node_runner
node_runner -->|"passes architecture"| node_developer
node_developer -->|"lists and reads"| node_filesystem
node_developer -->|"writes on request"| node_filesystem

click node_runner "https://github.com/mounidar/autonomous-software-engineering-team/blob/main/main.py"
click node_architect "https://github.com/mounidar/autonomous-software-engineering-team/blob/main/agents/architect.py"
click node_developer "https://github.com/mounidar/autonomous-software-engineering-team/blob/main/agents/developer.py"
click node_filesystem "https://github.com/mounidar/autonomous-software-engineering-team/blob/main/tools/filesystem.py"

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_runner toneBlue
class node_architect,node_developer toneAmber
class node_filesystem,node_openai toneMint
```

## Components

### Workflow

- [Task runner](https://github.com/mounidar/autonomous-software-engineering-team/blob/main/main.py): `main.py`

### Agents

- [Architect agent](https://github.com/mounidar/autonomous-software-engineering-team/blob/main/agents/architect.py): `agents/architect.py`
- [Developer agent](https://github.com/mounidar/autonomous-software-engineering-team/blob/main/agents/developer.py): `agents/developer.py`

### Workspace tools

- [Filesystem tools](https://github.com/mounidar/autonomous-software-engineering-team/blob/main/tools/filesystem.py): `tools/filesystem.py`

### Other components

- **OpenAI API**

## Connections

- Task runner → Architect agent: requests analysis
- Architect agent → OpenAI API: submits prompt
- OpenAI API → Architect agent: returns parsed plan
- Architect agent → Task runner: returns architecture
- Task runner → Developer agent: passes architecture
- Developer agent → Filesystem tools: lists and reads
- Developer agent → Filesystem tools: writes on request