# maheeth07/codecrafter architecture

> Architecture diagram of the GitHub repository maheeth07/codecrafter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/maheeth07/codecrafter
- Repository: https://github.com/maheeth07/codecrafter

## Overview

CodeCrafter is an agent workflow that turns a user request into a structured project plan, breaks that plan into file-level implementation tasks, and uses a coding agent with project-file tools to generate files. Its checked-in generated project is a Tic Tac Toe web game with board, score, theme, and mode controls. The workflow and tool wiring are visible in `agent/graph.py`; the README provides no additional capability detail, and generated HTML/CSS behavior was not sampled.

Main entry points: [`agent/graph.py`](https://github.com/maheeth07/codecrafter/blob/dev/agent/graph.py) (Project Planner), [`agent/prompts.py`](https://github.com/maheeth07/codecrafter/blob/dev/agent/prompts.py) (Prompt Templates), [`agent/tools.py`](https://github.com/maheeth07/codecrafter/blob/dev/agent/tools.py) (Project File Tools), [`agent/generated_project`](https://github.com/maheeth07/codecrafter/tree/dev/agent/generated_project) (Generated Project Files)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Generation Workflow"]
  node_planner["Project Planner<br/>[graph.py]"]
  node_architect["Task Architect<br/>[graph.py]"]
  node_coder["Implementation Coder<br/>[graph.py]"]
end

subgraph group_agent_support["Agent Support"]
  node_schemas["Plan Schemas<br/>[states.py]"]
  node_prompt_templates["Prompt Templates<br/>[prompts.py]"]
  node_project_tools["Project File Tools<br/>[tools.py]"]
end

subgraph group_generated_app["Generated Game"]
  node_project_files["Generated Project Files"]
  node_game_logic["Game Logic<br/>[script.js]"]
end

node_user(("User Request"))
node_gemini{{"Gemini Model"}}

node_user -->|"submits request"| node_planner
node_planner -->|"formats request"| node_prompt_templates
node_planner -->|"requests plan"| node_gemini
node_planner -->|"structures as Plan"| node_schemas
node_planner -->|"passes plan"| node_architect
node_architect -->|"formats plan"| node_prompt_templates
node_architect -->|"requests tasks"| node_gemini
node_architect -->|"structures TaskPlan"| node_schemas
node_architect -->|"passes task plan"| node_coder
node_coder -->|"builds coder prompt"| node_prompt_templates
node_coder -->|"reads and writes files"| node_project_tools
node_coder -->|"runs coding agent"| node_gemini
node_project_tools -->|"manages files"| node_project_files
node_project_files -.->|"includes game script"| node_game_logic

click node_planner "https://github.com/maheeth07/codecrafter/blob/dev/agent/graph.py"
click node_architect "https://github.com/maheeth07/codecrafter/blob/dev/agent/graph.py"
click node_coder "https://github.com/maheeth07/codecrafter/blob/dev/agent/graph.py"
click node_schemas "https://github.com/maheeth07/codecrafter/blob/dev/agent/states.py"
click node_prompt_templates "https://github.com/maheeth07/codecrafter/blob/dev/agent/prompts.py"
click node_project_tools "https://github.com/maheeth07/codecrafter/blob/dev/agent/tools.py"
click node_project_files "https://github.com/maheeth07/codecrafter/tree/dev/agent/generated_project"
click node_game_logic "https://github.com/maheeth07/codecrafter/blob/dev/agent/generated_project/script.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_planner,node_architect,node_coder,node_user toneBlue
class node_schemas,node_prompt_templates,node_project_tools toneAmber
class node_project_files,node_game_logic toneMint
class node_gemini toneIndigo
```

## Components

### Generation Workflow

- [Project Planner](https://github.com/maheeth07/codecrafter/blob/dev/agent/graph.py): `agent/graph.py`
- [Task Architect](https://github.com/maheeth07/codecrafter/blob/dev/agent/graph.py): `agent/graph.py`
- [Implementation Coder](https://github.com/maheeth07/codecrafter/blob/dev/agent/graph.py): `agent/graph.py`

### Agent Support

- [Plan Schemas](https://github.com/maheeth07/codecrafter/blob/dev/agent/states.py): `agent/states.py`
- [Prompt Templates](https://github.com/maheeth07/codecrafter/blob/dev/agent/prompts.py): `agent/prompts.py`
- [Project File Tools](https://github.com/maheeth07/codecrafter/blob/dev/agent/tools.py): `agent/tools.py`

### Generated Game

- [Generated Project Files](https://github.com/maheeth07/codecrafter/tree/dev/agent/generated_project): `agent/generated_project`
- [Game Logic](https://github.com/maheeth07/codecrafter/blob/dev/agent/generated_project/script.js): `agent/generated_project/script.js`

### Other components

- **User Request**
- **Gemini Model**

## Connections

- User Request → Project Planner: submits request (evidence: `agent/graph.py`)
- Project Planner → Prompt Templates: formats request (evidence: `agent/graph.py`)
- Project Planner → Gemini Model: requests plan (evidence: `agent/graph.py`)
- Project Planner → Plan Schemas: structures as Plan (evidence: `agent/graph.py`)
- Project Planner → Task Architect: passes plan (evidence: `agent/graph.py`)
- Task Architect → Prompt Templates: formats plan (evidence: `agent/graph.py`)
- Task Architect → Gemini Model: requests tasks (evidence: `agent/graph.py`)
- Task Architect → Plan Schemas: structures TaskPlan (evidence: `agent/graph.py`)
- Task Architect → Implementation Coder: passes task plan (evidence: `agent/graph.py`)
- Implementation Coder → Prompt Templates: builds coder prompt (evidence: `agent/graph.py`)
- Implementation Coder → Project File Tools: reads and writes files (evidence: `agent/graph.py`)
- Implementation Coder → Gemini Model: runs coding agent (evidence: `agent/graph.py`)
- Project File Tools → Generated Project Files: manages files (evidence: `agent/tools.py`)
- Generated Project Files → Game Logic: includes game script
