# mhrnqaruni/ai-agent-skill-architectural-concept-design architecture

> Architecture diagram of the GitHub repository mhrnqaruni/ai-agent-skill-architectural-concept-design, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mhrnqaruni/ai-agent-skill-architectural-concept-design
- Repository: https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design

## Overview

This is an agent skill plus a deterministic architectural concept-design engine. The principal workflow runs from a brief and design decisions through a JSON model, rule-check/fix iterations, then drawings, a furnished 3D model, renders and area schedule. The graph preserves those stages and the engine’s geometry, checking and presentation layers. Relationships are based on README statements and the supplied source index; unsampled implementation details are not inferred.

Main entry points: [`skills/architectural-concept-design/scripts/conceptdesign/cli.py`](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/cli.py) (Engine CLI), [`skills/architectural-concept-design/scripts/conceptdesign/sheets.py`](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/sheets.py) (Drawing set), [`skills/architectural-concept-design/scripts/conceptdesign/rules.py`](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/rules.py) (Design rules), [`skills/architectural-concept-design/scripts/conceptdesign/plans.py`](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/plans.py) (Floor plans)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_design["Design workflow"]
  node_brief["Brief and requirements<br/>[briefing.md]"]
  node_questions["Decision questions<br/>[SKILL.md]"]
  node_spec["Design specification<br/>[specification.md]"]
  node_designjson["Design model<br/>[design.json]"]
end

subgraph group_engine["Design engine"]
  node_cli["Engine CLI<br/>[cli.py]"]
  node_model["Model loader<br/>[model.py]"]
  node_geometry["Plan geometry<br/>[geometry.py]"]
end

subgraph group_checks["Checks and areas"]
  node_rules["Design rules<br/>[rules.py]"]
  node_areas["Area schedule<br/>[areas.py]"]
end

subgraph group_drawings["Drawing outputs"]
  node_plans["Floor plans<br/>[plans.py]"]
  node_elevations["Elevations and section<br/>[elevations.py]"]
  node_cad["CAD primitives<br/>[cad.py]"]
  node_sheets["Drawing set<br/>[sheets.py]"]
end

subgraph group_model3d["3D outputs"]
  node_scene["3D scene<br/>[scene.py]"]
  node_web["HTML model and renders<br/>[web.py]"]
  node_viewer["Offline 3D viewer<br/>[viewer.js]"]
end

node_agent(("Design agent"))

node_agent -->|"captures"| node_brief
node_brief -->|"informs"| node_questions
node_questions -->|"guides"| node_spec
node_spec -->|"produces"| node_designjson
node_agent -->|"writes"| node_designjson
node_agent -->|"runs"| node_cli
node_cli -->|"loads"| node_model
node_model -->|"uses"| node_geometry
node_cli -->|"checks"| node_rules
node_rules -->|"measures"| node_areas
node_rules -->|"uses"| node_geometry
node_cli -->|"builds"| node_sheets
node_cli -->|"builds"| node_web
node_sheets -->|"uses"| node_areas
node_sheets -->|"uses"| node_plans
node_sheets -->|"uses"| node_elevations
node_sheets -->|"writes with"| node_cad
node_plans -->|"labels with"| node_areas
node_plans -->|"draws with"| node_cad
node_plans -->|"uses"| node_geometry
node_web -->|"builds from"| node_scene
node_web -->|"uses slug"| node_sheets
node_scene -->|"uses"| node_elevations
node_scene -->|"uses"| node_plans
node_scene -->|"uses"| node_geometry
node_web -->|"embeds"| node_viewer
node_cli -->|"prints schedule"| node_areas
node_rules -->|"reports findings for"| node_designjson
node_agent -->|"fixes and repeats"| node_rules

click node_brief "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/references/briefing.md"
click node_questions "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/SKILL.md"
click node_spec "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/assets/templates/specification.md"
click node_designjson "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/assets/templates/design.json"
click node_cli "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/cli.py"
click node_model "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/model.py"
click node_geometry "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/geometry.py"
click node_rules "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/rules.py"
click node_areas "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/areas.py"
click node_plans "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/plans.py"
click node_elevations "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/elevations.py"
click node_cad "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/cad.py"
click node_sheets "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/sheets.py"
click node_scene "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/scene.py"
click node_web "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/web.py"
click node_viewer "https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/assets/viewer/viewer.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_brief,node_questions,node_spec,node_designjson toneBlue
class node_cli,node_model,node_geometry toneAmber
class node_rules,node_areas toneMint
class node_plans,node_elevations,node_cad,node_sheets toneRose
class node_scene,node_web,node_viewer,node_agent toneIndigo
```

## Components

### Design workflow

- [Brief and requirements](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/references/briefing.md): `skills/architectural-concept-design/references/briefing.md`
- [Decision questions](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/SKILL.md): `skills/architectural-concept-design/SKILL.md`
- [Design specification](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/assets/templates/specification.md): `skills/architectural-concept-design/assets/templates/specification.md`
- [Design model](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/assets/templates/design.json): `skills/architectural-concept-design/assets/templates/design.json`

### Design engine

- [Engine CLI](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/cli.py): `skills/architectural-concept-design/scripts/conceptdesign/cli.py`
- [Model loader](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/model.py): `skills/architectural-concept-design/scripts/conceptdesign/model.py`
- [Plan geometry](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/geometry.py): `skills/architectural-concept-design/scripts/conceptdesign/geometry.py`

### Checks and areas

- [Design rules](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/rules.py): `skills/architectural-concept-design/scripts/conceptdesign/rules.py`
- [Area schedule](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/areas.py): `skills/architectural-concept-design/scripts/conceptdesign/areas.py`

### Drawing outputs

- [Floor plans](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/plans.py): `skills/architectural-concept-design/scripts/conceptdesign/plans.py`
- [Elevations and section](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/elevations.py): `skills/architectural-concept-design/scripts/conceptdesign/elevations.py`
- [CAD primitives](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/cad.py): `skills/architectural-concept-design/scripts/conceptdesign/cad.py`
- [Drawing set](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/sheets.py): `skills/architectural-concept-design/scripts/conceptdesign/sheets.py`

### 3D outputs

- [3D scene](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/scene.py): `skills/architectural-concept-design/scripts/conceptdesign/scene.py`
- [HTML model and renders](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/scripts/conceptdesign/web.py): `skills/architectural-concept-design/scripts/conceptdesign/web.py`
- [Offline 3D viewer](https://github.com/mhrnqaruni/ai-agent-skill-architectural-concept-design/blob/main/skills/architectural-concept-design/assets/viewer/viewer.js): `skills/architectural-concept-design/assets/viewer/viewer.js`

### Other components

- **Design agent**

## Connections

- Design agent → Brief and requirements: captures (evidence: `README.md`)
- Brief and requirements → Decision questions: informs (evidence: `README.md`)
- Decision questions → Design specification: guides (evidence: `README.md`)
- Design specification → Design model: produces (evidence: `README.md`)
- Design agent → Design model: writes (evidence: `README.md`)
- Design agent → Engine CLI: runs (evidence: `README.md`)
- Engine CLI → Model loader: loads (evidence: `skills/architectural-concept-design/scripts/conceptdesign/cli.py`)
- Model loader → Plan geometry: uses (evidence: `skills/architectural-concept-design/scripts/conceptdesign/model.py`)
- Engine CLI → Design rules: checks (evidence: `skills/architectural-concept-design/scripts/conceptdesign/cli.py`)
- Design rules → Area schedule: measures (evidence: `skills/architectural-concept-design/scripts/conceptdesign/rules.py`)
- Design rules → Plan geometry: uses (evidence: `skills/architectural-concept-design/scripts/conceptdesign/rules.py`)
- Engine CLI → Drawing set: builds (evidence: `skills/architectural-concept-design/scripts/conceptdesign/cli.py`)
- Engine CLI → HTML model and renders: builds (evidence: `skills/architectural-concept-design/scripts/conceptdesign/cli.py`)
- Drawing set → Area schedule: uses (evidence: `skills/architectural-concept-design/scripts/conceptdesign/sheets.py`)
- Drawing set → Floor plans: uses (evidence: `skills/architectural-concept-design/scripts/conceptdesign/sheets.py`)
- Drawing set → Elevations and section: uses (evidence: `skills/architectural-concept-design/scripts/conceptdesign/sheets.py`)
- Drawing set → CAD primitives: writes with (evidence: `skills/architectural-concept-design/scripts/conceptdesign/sheets.py`)
- Floor plans → Area schedule: labels with (evidence: `skills/architectural-concept-design/scripts/conceptdesign/plans.py`)
- Floor plans → CAD primitives: draws with (evidence: `skills/architectural-concept-design/scripts/conceptdesign/plans.py`)
- Floor plans → Plan geometry: uses (evidence: `skills/architectural-concept-design/scripts/conceptdesign/plans.py`)
- HTML model and renders → 3D scene: builds from (evidence: `skills/architectural-concept-design/scripts/conceptdesign/web.py`)
- HTML model and renders → Drawing set: uses slug (evidence: `skills/architectural-concept-design/scripts/conceptdesign/web.py`)
- 3D scene → Elevations and section: uses (evidence: `skills/architectural-concept-design/scripts/conceptdesign/scene.py`)
- 3D scene → Floor plans: uses (evidence: `skills/architectural-concept-design/scripts/conceptdesign/scene.py`)
- 3D scene → Plan geometry: uses (evidence: `skills/architectural-concept-design/scripts/conceptdesign/scene.py`)
- HTML model and renders → Offline 3D viewer: embeds (evidence: `skills/architectural-concept-design/scripts/conceptdesign/web.py`)
- Engine CLI → Area schedule: prints schedule (evidence: `skills/architectural-concept-design/scripts/conceptdesign/cli.py`)
- Design rules → Design model: reports findings for (evidence: `README.md`)
- Design agent → Design rules: fixes and repeats (evidence: `README.md`)