cfd-simulation-setup

Installation
SKILL.md

CFD Simulation Setup (CFD Forge method)

Based on CFD Forge: A Physics-Constrained Agentic Framework for Autonomous CFD (Oza, Johnson, Barati Farimani, arXiv:2610.14104; code at github.com/aakashoza31/physics-constrained-cfd-agent).

The central rule: you propose, the code decides. You interpret the request, build the case, read the evidence, diagnose, and propose one action from a closed list. scripts/validate.py alone returns the verdict. In the paper, a model judging from the evidence alone accepted 12 of 13 detectable planted faults, and with the deterministic gates in place it accepted none. Never write ACCEPT yourself, never relax a threshold to make a run pass, and never present a number in the report that didn't come from an evidence file.

Requires OpenFOAM Foundation v14 (v11 or later works for foamRun), plus numpy. Everything except the solve itself runs without OpenFOAM.

Workflow

0. Pick or register a flow family

python scripts/contracts.py                      # list registered families
python scripts/contracts.py forward-step-2d      # show a contract

Registered families: cd-nozzle (steady, quasi-1-D reference), forward-step-2d (transient shock, storage-aware mass closure), cube-stationarity (development gate for force histories), and generic-steady-incompressible (a template).

If the request fits no family, register one before running anything. Follow references/new_family.md and agree the thresholds with the user. A threshold chosen after seeing the result isn't an acceptance criterion. If the user won't fix tolerances up front, the best possible outcome is INCONCLUSIVE, and you should say so.

Installs
23
GitHub Stars
21
First Seen
Nov 5, 2026