FESADev/.codex/skills/fesa-io-contract/SKILL.md

name, description

name	description
fesa-io-contract	Use when defining FESA solver I/O contracts, Abaqus .inp keyword subsets, internal model mapping, validation rules, HDF5 result schemas, and deterministic CSV view schemas for reference comparison.

FESA I/O Contract

Use this skill to define exactly what input and output data the solver feature accepts and produces.

Inputs

Read these first:

• AGENTS.md
• docs/SOLVER_AGENT_DESIGN.md
• docs/io-definitions/README.md
• docs/requirements/<feature-id>.md
• docs/formulations/<feature-id>-formulation.md
• Numerical review and reference model documents when present

Workflow

1. Define Abaqus Input Scope for the feature-specific .inp subset.
2. Define Syntax Policy for keyword lines, data lines, comments, unsupported keywords, and diagnostics.
3. Separate Model Data Mapping from History Data Mapping.
4. Define supported keywords such as *NODE, *ELEMENT, *MATERIAL, *ELASTIC, *BOUNDARY, *CLOAD, *STEP, *OUTPUT, *NODE OUTPUT, and *ELEMENT OUTPUT only when required.
5. Define Internal Model Contract at a semantic level without C++ APIs.
6. Define Output HDF5 Schema for authoritative solver output results.h5.
7. Define Deterministic CSV View Schemas for csv/displacements.csv, csv/reactions.csv, csv/element_forces.csv, csv/stresses.csv, and optional view files.
8. Define units, coordinate system, component naming, output location, step/frame identity, and ID matching rules.
9. Define validation rules and open issues.

Output Contract

Produce or revise docs/io-definitions/<feature-id>-io.md with:

• Abaqus Input Scope
• Syntax Policy
• Model Data Mapping
• History Data Mapping
• Internal Model Contract
• Output HDF5 Schema
• Deterministic CSV View Schemas
• Validation Rules
• Downstream Handoff

Boundaries

• Do not implement parsers.
• Do not design C++ APIs.
• Do not claim full Abaqus compatibility.
• Do not run Abaqus, Nastran, or any reference solver.
• Do not generate reference HDF5 files or deterministic CSV views.
• Do not approve release readiness.

Quality Gate

• Every supported keyword has a documented purpose, required data, and unsupported-case behavior.
• HDF5 schema is the authoritative solver output contract and must carry schema version, step/frame identity, units, coordinate system, output location, and component naming.
• Deterministic CSV view schemas are comparison views derived from HDF5 datasets and must define stable row ordering, ID fields, and component ordering.
• Unsupported Abaqus input is explicit: unsupported, ignored-with-warning, or requires user decision.
• The I/O contract is compatible with requirements, formulation, and reference comparison needs.

Handoff

Send keyword and schema contracts to Reference Model Agent and Implementation Planning Agent. Send HDF5 dataset paths, deterministic CSV view schemas, ID matching, and tolerance-source constraints to Reference Verification Agent.