# vinnividivicci/hvac-loads-skill architecture

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

- Interactive diagram: https://gitdiagram.com/vinnividivicci/hvac-loads-skill
- Repository: https://github.com/vinnividivicci/hvac-loads-skill

## Overview

This repository is a Claude Code skill and Python toolkit for turning house plans into auditable room-by-room heating and cooling loads. The user supplies plans and site context; plan takeoff produces a building model, which is validated before design conditions and two load methods are run. Results are compared and delivered as a report, takeoff CSV, JSON, and interactive 3D model. The graph preserves documented capability branches, but some internals are unsampled; uncertain connections are omitted rather than inferred.

Main entry points: [`skills/hvac-load-calc/scripts/hvacload/pipeline.py`](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/pipeline.py) (Project pipeline), [`skills/hvac-load-calc/scripts/hvacload/geometry.py`](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/geometry.py) (Typed surfaces), [`skills/hvac-load-calc/scripts/hvacload/results.py`](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/results.py) (Load comparison), [`skills/hvac-load-calc/scripts/hvacload/design.py`](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/design.py) (Design conditions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workflow["Project workflow"]
  node_skill["HVAC load skill<br/>[SKILL.md]"]
  node_cli["Command tools<br/>[hvacload.py]"]
  node_pipeline["Project pipeline<br/>[pipeline.py]"]
end

subgraph group_takeoff["Plans and model"]
  node_pdf["PDF plan tools<br/>[pdfkit.py]"]
  node_building["Building model<br/>[model.py]"]
  node_geometry["Typed surfaces<br/>[geometry.py]"]
  node_qa["Geometry QA<br/>[qa.py]"]
  node_assembly["Assembly properties<br/>[assembly.py]"]
end

subgraph group_loads["Design loads"]
  node_design["Design conditions<br/>[design.py]"]
  node_weather["Weather and codes<br/>[weather.py]"]
  node_codes["NBC conditions<br/>[codes.py]"]
  node_manualj["Manual J engine<br/>[hpxml.py]"]
  node_energyplus["EnergyPlus check<br/>[eplus.py]"]
end

subgraph group_deliverables["Review and deliverables"]
  node_results["Load comparison<br/>[results.py]"]
  node_report["EN/FR report<br/>[report.py]"]
  node_viewer["3D viewer<br/>[viewer.py]"]
end

subgraph group_runtime["Runtime integrations"]
  node_tools["Engine setup<br/>[tools.py]"]
end

node_professional(("Professional"))
node_claude(("Claude Code user"))
node_external_engines["OpenStudio / EnergyPlus"]
node_external_weather["Weather and NBC data"]

node_professional -->|"provides plans"| node_claude
node_claude -->|"runs workflow"| node_skill
node_skill -->|"invokes tools"| node_cli
node_cli -->|"dispatches commands"| node_pipeline
node_pipeline -->|"uses plan tools"| node_pdf
node_pipeline -->|"loads model"| node_building
node_pipeline -->|"builds surfaces"| node_geometry
node_pipeline -->|"checks model"| node_qa
node_pipeline -->|"prepares loads"| node_design
node_pipeline -->|"runs primary method"| node_manualj
node_pipeline -->|"runs cross-check"| node_energyplus
node_pipeline -->|"combines results"| node_results
node_pipeline -->|"builds report"| node_report
node_pipeline -->|"creates viewer"| node_viewer
node_pdf -.->|"informs takeoff"| node_building
node_professional -->|"confirms geometry"| node_qa
node_geometry -->|"writes surfaces"| node_manualj
node_geometry -->|"models surfaces"| node_energyplus
node_geometry -->|"renders same surfaces"| node_viewer
node_geometry -->|"supplies takeoff basis"| node_results
node_design -->|"uses weather data"| node_weather
node_design -.->|"uses code values"| node_codes
node_building -.->|"defines assemblies"| node_assembly
node_tools -->|"downloads engines"| node_external_engines
node_weather -.->|"fetches data"| node_external_weather
node_results -->|"feeds comparison"| node_report
node_results -->|"delivers outputs"| node_professional

click node_skill "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/SKILL.md"
click node_cli "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload.py"
click node_pipeline "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/pipeline.py"
click node_pdf "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/pdfkit.py"
click node_building "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/model.py"
click node_geometry "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/geometry.py"
click node_qa "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/qa.py"
click node_assembly "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/assembly.py"
click node_design "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/design.py"
click node_weather "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/weather.py"
click node_codes "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/codes.py"
click node_manualj "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/hpxml.py"
click node_energyplus "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/eplus.py"
click node_results "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/results.py"
click node_report "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/report.py"
click node_viewer "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/viewer.py"
click node_tools "https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/tools.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_skill,node_cli,node_pipeline,node_claude toneBlue
class node_pdf,node_building,node_geometry,node_qa,node_assembly toneAmber
class node_design,node_weather,node_codes,node_manualj,node_energyplus toneMint
class node_results,node_report,node_viewer toneRose
class node_tools,node_professional,node_external_engines,node_external_weather toneIndigo
```

## Components

### Project workflow

- [HVAC load skill](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/SKILL.md): `skills/hvac-load-calc/SKILL.md`
- [Command tools](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload.py): `skills/hvac-load-calc/scripts/hvacload.py`
- [Project pipeline](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/pipeline.py): `skills/hvac-load-calc/scripts/hvacload/pipeline.py`

### Plans and model

- [PDF plan tools](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/pdfkit.py): `skills/hvac-load-calc/scripts/hvacload/pdfkit.py`
- [Building model](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/model.py): `skills/hvac-load-calc/scripts/hvacload/model.py`
- [Typed surfaces](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/geometry.py): `skills/hvac-load-calc/scripts/hvacload/geometry.py`
- [Geometry QA](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/qa.py): `skills/hvac-load-calc/scripts/hvacload/qa.py`
- [Assembly properties](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/assembly.py): `skills/hvac-load-calc/scripts/hvacload/assembly.py`

### Design loads

- [Design conditions](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/design.py): `skills/hvac-load-calc/scripts/hvacload/design.py`
- [Weather and codes](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/weather.py): `skills/hvac-load-calc/scripts/hvacload/weather.py`
- [NBC conditions](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/codes.py): `skills/hvac-load-calc/scripts/hvacload/codes.py`
- [Manual J engine](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/hpxml.py): `skills/hvac-load-calc/scripts/hvacload/hpxml.py`
- [EnergyPlus check](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/eplus.py): `skills/hvac-load-calc/scripts/hvacload/eplus.py`

### Review and deliverables

- [Load comparison](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/results.py): `skills/hvac-load-calc/scripts/hvacload/results.py`
- [EN/FR report](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/report.py): `skills/hvac-load-calc/scripts/hvacload/report.py`
- [3D viewer](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/viewer.py): `skills/hvac-load-calc/scripts/hvacload/viewer.py`

### Runtime integrations

- [Engine setup](https://github.com/vinnividivicci/hvac-loads-skill/blob/main/skills/hvac-load-calc/scripts/hvacload/tools.py): `skills/hvac-load-calc/scripts/hvacload/tools.py`

### Other components

- **Professional**
- **Claude Code user**
- **OpenStudio / EnergyPlus**
- **Weather and NBC data**

## Connections

- Professional → Claude Code user: provides plans (evidence: `README.md`)
- Claude Code user → HVAC load skill: runs workflow (evidence: `README.md`)
- HVAC load skill → Command tools: invokes tools (evidence: `README.md`)
- Command tools → Project pipeline: dispatches commands (evidence: `skills/hvac-load-calc/scripts/hvacload.py`)
- Project pipeline → PDF plan tools: uses plan tools (evidence: `skills/hvac-load-calc/scripts/hvacload/pipeline.py`)
- Project pipeline → Building model: loads model (evidence: `skills/hvac-load-calc/scripts/hvacload/pipeline.py`)
- Project pipeline → Typed surfaces: builds surfaces (evidence: `skills/hvac-load-calc/scripts/hvacload/pipeline.py`)
- Project pipeline → Geometry QA: checks model (evidence: `skills/hvac-load-calc/scripts/hvacload/pipeline.py`)
- Project pipeline → Design conditions: prepares loads (evidence: `skills/hvac-load-calc/scripts/hvacload/pipeline.py`)
- Project pipeline → Manual J engine: runs primary method (evidence: `skills/hvac-load-calc/scripts/hvacload/pipeline.py`)
- Project pipeline → EnergyPlus check: runs cross-check (evidence: `skills/hvac-load-calc/scripts/hvacload/pipeline.py`)
- Project pipeline → Load comparison: combines results (evidence: `skills/hvac-load-calc/scripts/hvacload/pipeline.py`)
- Project pipeline → EN/FR report: builds report (evidence: `skills/hvac-load-calc/scripts/hvacload/pipeline.py`)
- Project pipeline → 3D viewer: creates viewer (evidence: `skills/hvac-load-calc/scripts/hvacload/pipeline.py`)
- PDF plan tools → Building model: informs takeoff (evidence: `README.md`)
- Professional → Geometry QA: confirms geometry (evidence: `README.md`)
- Typed surfaces → Manual J engine: writes surfaces (evidence: `skills/hvac-load-calc/scripts/hvacload/hpxml.py`)
- Typed surfaces → EnergyPlus check: models surfaces (evidence: `skills/hvac-load-calc/scripts/hvacload/eplus.py`)
- Typed surfaces → 3D viewer: renders same surfaces (evidence: `README.md`)
- Typed surfaces → Load comparison: supplies takeoff basis (evidence: `README.md`)
- Design conditions → Weather and codes: uses weather data (evidence: `skills/hvac-load-calc/scripts/hvacload/design.py`)
- Design conditions → NBC conditions: uses code values (evidence: `README.md`)
- Building model → Assembly properties: defines assemblies (evidence: `README.md`)
- Engine setup → OpenStudio / EnergyPlus: downloads engines (evidence: `skills/hvac-load-calc/scripts/hvacload/tools.py`)
- Weather and codes → Weather and NBC data: fetches data (evidence: `README.md`)
- Load comparison → EN/FR report: feeds comparison (evidence: `skills/hvac-load-calc/scripts/hvacload/report.py`)
- Load comparison → Professional: delivers outputs (evidence: `README.md`)
