Knowledge, Skills & Local Resources

The repo includes local context roots for OpenFOAM, SU2, CalculiX, Gmsh, CadQuery, FreeCAD, and PyVista under agent_resources/. These are first-class references for solver setup, command syntax, examples, tutorials, V&V, and API details. Knowledge packs index them with metadata filters and authority tiers.

packages/knowledge exposes ranked retrieval with metadata filters, authority capabilities, and ingest auditing. Citation records carry source path, heading path, excerpt, score, authority, and retrieval time — so a claim that depends on a citation is reviewable.

Skills are workflow guidance — sequencing, gating, review criteria — not hidden templates. Current platform skill highlights:

• CadQuery 2.7.0 — Use when the workflow needs programmatic CAD generation, geometry edits, or format handoff through the local CadQuery corpus.
• CalculiX / CCX 2.23 — Use when the workflow is building, adapting, debugging, or validating a CalculiX CCX 2.23 analysis or a CGX-assisted preprocessing flow.
• FreeCAD 1.1.0 — Use when the workflow needs FreeCAD scripting, GUI or headless automation, FeaturePython objects, FEM preprocessing, or FreeCAD-driven handoff into other simulation phases.
• Geometry & Meshing — Use when the geometry, export, or mesh contract is unresolved before or across software-specific phases, or when the workflow needs mesh-quality and convergence-study reasoning rather than one tool’s exact syntax.
• Gmsh 4.15.2 — Use when the active workflow phase is Gmsh geometry handling, meshing, physical-group definition, export, or mesh-debugging.
• OpenFOAM v2512 — Use when the active workflow is setting up, adapting, debugging, validating, or post-checking an OpenFOAM v2512 case.
• Optimization — Use for single- or multi-objective design optimization, method selection, surrogate strategy, convergence criteria, and Pareto decision framing after loading the study skill.
• Physics Setup — Use only when the main gap is CFD physics-model choice, BC reasoning, or numerics strategy before or across exact OpenFOAM or SU2 syntax. Do not use this skill for structural or thermal FEA deck semantics.
• Python Analysis — Use when a custom Python script is the clearest way to extract, compare, smooth, aggregate, or plot results after checking whether PyVista or createVisualization already covers the need.
• PyVista 0.47.3 — Use when results already exist and the active phase is reading, sampling, visualizing, exporting, or reporting with PyVista.

1. Workspace inspection for the active case.
2. Local resources and knowledge packs for solver-specific context.
3. Loaded skills for methodology.
4. Docs / web search when local context does not settle the question.

Persist citations for every evidence-bearing claim.

The base prompt does not carry every solver rule. If the agent lacks information, improve retrieval, resource coverage, skill routing, or tool error messages — never bloat the system prompt.