modify documents

docs/ADR.md

@@ -47,7 +47,7 @@
 
 **Reason**: Shell results contain structured mesh, step/frame, nodal, element, Gauss point, resultant, stress, metadata, and tolerance data. HDF5 is better suited than flat CSV for this result hierarchy.
 
-**Tradeoff**: HDF5 becomes a required dependency. FESA will provide an internal RAII wrapper over the HDF5 C API, but the actual HDF5 C library must be supplied by `HDF5_ROOT` or `HDF5_DIR`.
+**Tradeoff**: HDF5 becomes a required dependency. FESA will provide an internal RAII wrapper over the HDF5 C API, but the actual HDF5 C library must be supplied by `HDF5_ROOT` or `HDF5_DIR`. The current local Windows install is `C:\Program Files\HDF_Group\HDF5\2.1.1`; use `HDF5_ROOT` for that root or `HDF5_DIR` for `C:\Program Files\HDF_Group\HDF5\2.1.1\cmake`.
 
 ## ADR-008: Single Tolerance Policy
 **Decision**: Reference comparison uses a single tolerance value `1e-5`. A compared scalar passes when absolute error or relative error is within `1e-5`.

docs/AGENT_RULES.md

@@ -88,7 +88,7 @@ Repeated failures must be routed back to the owning upstream stage instead of co
 - Each Agent writes the artifact for its stage and records downstream handoff items.
 - Every must requirement needs a verification method and acceptance criteria.
 - Every formulation needs clear DOF, coordinate, unit, sign, Jacobian, integration, and recovery rules.
-- Every I/O contract needs supported syntax, unsupported behavior, internal mapping, schema, units, component names, and matching rules.
+- Every I/O contract needs supported syntax, unsupported behavior, internal mapping, HDF5 result schema or explicitly approved CSV export schema, units, component names, and matching rules.
 - Every reference model contract needs model purpose, compared quantities, artifacts, provenance, and limitations.
 - Every implementation plan needs test-first tasks, target commands, candidate files, and traceability to upstream requirements.
 - Every verification report needs compared rows, missing/extra rows, max absolute error, max relative error, worst id/component, pass/fail, and failure classification.
@@ -96,6 +96,7 @@ Repeated failures must be routed back to the owning upstream stage instead of co
 ## Current Project Defaults
 - Initial feature id: `mitc4-linear-static-shell`.
 - Initial result/reference format: HDF5.
+- Local HDF5 default install: `C:\Program Files\HDF_Group\HDF5\2.1.1`; use `HDF5_ROOT` for this root or `HDF5_DIR` for `C:\Program Files\HDF_Group\HDF5\2.1.1\cmake`.
 - Reference policy: stored Abaqus S4R is primary for pass/fail; Abaqus S4 is diagnostic.
 - Required compared quantities: nodal displacement, reaction, element internal force/resultant, and stress.
 - Agents must preserve OpenSees-inspired architecture while using modern C++17 RAII and FESA ownership boundaries.

docs/ARCHITECTURE.md

@@ -217,6 +217,22 @@ Adapter targets:
 
 This allows test doubles and future dependency replacement without changing solver physics code.
 
+### HDF5 Dependency Discovery
+The current local Windows/MSVC HDF5 installation is:
+
+```text
+C:\Program Files\HDF_Group\HDF5\2.1.1
+```
+
+Implementation planning should use the HDF5 C API through the adapter layer, not the HDF5 C++ API. CMake discovery should prefer one of these explicit environment variables before falling back to default package search:
+
+```powershell
+$env:HDF5_ROOT = "C:\Program Files\HDF_Group\HDF5\2.1.1"
+$env:HDF5_DIR = "C:\Program Files\HDF_Group\HDF5\2.1.1\cmake"
+```
+
+The expected local artifacts are `include\hdf5.h`, `lib\hdf5.lib`, `bin\hdf5.dll`, and `cmake\hdf5-config.cmake`. `h5dump.exe -V` should report HDF5 `2.1.1` on this machine.
+
 ### Runtime Polymorphism
 Elements, materials, loads, and boundary conditions are handled through base interfaces. Phase 1 prioritizes clarity and testability. If large-model performance requires it later, assembly internals may add type-specific batch kernels.
 
@@ -247,6 +263,8 @@ element_id, gauss_id, section_point, S11, S22, S12, S13, S23
   feature_id
   solver_version
   model_id
+  hdf5_version
+  schema_version
   units
   tolerance
   reference_solver

docs/PLAN.md

@@ -43,5 +43,7 @@ Build the FESA structural solver foundation around the initial feature `mitc4-li
 
 ## Known Blockers
 - No CMake project exists yet, so `python scripts/validate_workspace.py` currently takes the no-op path.
-- HDF5 is not detected in standard local environment paths; implementation will need `HDF5_ROOT` or `HDF5_DIR`.
 - Abaqus reference artifacts are not generated by Agents and must be supplied by a human-approved process.
+
+## Known Environment Facts
+- HDF5 is installed locally at `C:\Program Files\HDF_Group\HDF5\2.1.1`; CMake should use `HDF5_ROOT` for this root or `HDF5_DIR` for `C:\Program Files\HDF_Group\HDF5\2.1.1\cmake`.

docs/PRD.md

@@ -89,7 +89,7 @@ MITC4 선형정적 기능이 reference 검증을 통과한 뒤 다음 기능을
 - MSVC and CMake must be available for C++ build validation.
 - Intel oneAPI MKL must be available through `MKLROOT` or known oneAPI installation paths.
 - Intel oneAPI TBB must be available through `TBBROOT` or known oneAPI installation paths.
-- HDF5 C library must be supplied through `HDF5_ROOT` or `HDF5_DIR`.
+- HDF5 C library must be supplied through `HDF5_ROOT` or `HDF5_DIR`; the current local default is `C:\Program Files\HDF_Group\HDF5\2.1.1`, with CMake package files under `C:\Program Files\HDF_Group\HDF5\2.1.1\cmake`.
 - Python 3 must be available for harness validation and phase execution.
 
 ## Release Requirements

docs/PROGRESS.md

@@ -21,6 +21,7 @@
 - Renamed the first solver development workflow stage to "새로운 솔버 기능 요구조건 분석" across `AGENTS.md`, `docs/`, `.codex/agents/requirement-agent.toml`, and `.codex/skills/fesa-requirements-baseline`.
 - Refined `requirement-agent` and `fesa-requirements-baseline` internals to describe a new solver feature requirements analysis document instead of a requirements drafting/specification task.
 - Documented the canonical git remote `https://teagit.mimi1011.synology.me/baram2584/FESADev.git`, default remote `origin`, shared baseline branch `dev`, and `codex/<short-task-name>` work branch convention in `AGENTS.md`, `docs/AGENT_RULES.md`, and `docs/PLAN.md`.
+- Confirmed local HDF5 `2.1.1` installation at `C:\Program Files\HDF_Group\HDF5\2.1.1` and recorded the `HDF5_ROOT`/`HDF5_DIR` discovery policy in architecture, agent, skill, and handoff documentation.
 
 ## In Progress
 - Ready for the next stage: new solver feature requirements analysis for `mitc4-linear-static-shell`.
@@ -34,6 +35,10 @@
 6. Create `docs/implementation-plans/mitc4-linear-static-shell-implementation-plan.md`.
 
 ## Last Validation
+- 2026-06-08: After HDF5 install/path documentation and HDF5-first result-output agent/skill/doc updates, `python C:\Users\user\.codex\skills\.system\skill-creator\scripts\quick_validate.py` passed for modified FESA skills: `fesa-io-contract`, `fesa-reference-models`, `fesa-reference-comparison`, `fesa-cpp-msvc-tdd`, `fesa-physics-sanity`, `fesa-requirements-baseline`, `fesa-numerical-review`, `fesa-formulation-spec`, `fesa-research-evidence`, and `fesa-release-readiness`.
+- 2026-06-08: After HDF5 install/path documentation and HDF5-first result-output agent/skill/doc updates, `python -m unittest discover -s scripts -p "test_*.py"` passed. 85 tests ran successfully.
+- 2026-06-08: After HDF5 install/path documentation and HDF5-first result-output agent/skill/doc updates, `python scripts/validate_workspace.py` passed through the expected no-op path because no root `CMakeLists.txt` exists yet.
+- 2026-06-08: After HDF5 install/path documentation and HDF5-first result-output agent/skill/doc updates, `git diff --check` passed with only Git line-ending normalization warnings.
 - 2026-06-08: After documenting git repository settings, `python scripts/validate_workspace.py` passed through the expected no-op path because no root `CMakeLists.txt` exists yet.
 - 2026-06-08: After documenting git repository settings, `git diff --check` passed with only Git line-ending normalization warnings.
 - 2026-06-08: After refining `requirement-agent` and `fesa-requirements-baseline` internals, `python C:\Users\baram\.codex\skills\.system\skill-creator\scripts\quick_validate.py .codex\skills\fesa-requirements-baseline` passed.
@@ -48,5 +53,4 @@
 - 2026-06-05: `python scripts/validate_workspace.py` passed through the expected no-op path because no root `CMakeLists.txt` exists yet.
 
 ## Open Questions
-- Exact HDF5 C library installation path is not known.
 - Stored Abaqus S4R/S4 reference artifact generation process is not yet defined.

docs/WORKNOTE.md

@@ -10,6 +10,9 @@ Add dated entries. Do not delete another Agent's note unless the user explicitly
 ### 2026-06-05 - HDF5 Not Found In Standard Paths
 During planning, standard checks for `HDF5_ROOT`, `HDF5_DIR`, `h5dump`, and obvious Program Files HDF5 folders did not find HDF5. Future implementation should not assume HDF5 is locally installed. Use `HDF5_ROOT` or `HDF5_DIR` and fail CMake configuration with a clear diagnostic if missing.
 
+### 2026-06-08 - HDF5 Installed Under HDF_Group
+The local HDF5 install was later confirmed at `C:\Program Files\HDF_Group\HDF5\2.1.1`, and `h5dump.exe -V` reports `2.1.1`. Future CMake work should prefer `HDF5_ROOT=C:\Program Files\HDF_Group\HDF5\2.1.1` or `HDF5_DIR=C:\Program Files\HDF_Group\HDF5\2.1.1\cmake`. Keep the old 2026-06-05 note as historical context for stale sessions, but do not treat HDF5 as currently missing on this machine.
+
 ### 2026-06-05 - Validation Currently Has No CMake Project
 `python scripts/validate_workspace.py` currently exits successfully through the no-op path because there is no root `CMakeLists.txt`. This is expected until the C++ solver project is bootstrapped. Once CMake is introduced, validation must configure, build, and run CTest.
 

docs/build-test-reports/README.md

@@ -22,7 +22,7 @@ Build/Test Executor Agent는 Implementation Agent 이후 독립적으로 C++/MSV
 - CMake files를 수정하지 않는다.
 - requirements, formulations, I/O contracts, reference artifacts, tolerance policies를 수정하지 않는다.
 - Abaqus, Nastran 또는 reference solver를 실행하지 않는다.
-- reference CSV를 생성하지 않는다.
+- reference HDF5 artifact 또는 reference CSV를 생성하지 않는다.
 - release readiness, reference tolerance success, physics validation success를 승인하지 않는다.
 - 최종 reference verification report를 작성하지 않는다.
 

docs/coordination/README.md

@@ -26,7 +26,7 @@ Coordinator Agent는 FESA solver 기능 개발의 전체 lifecycle에서 gate ev
 - requirements, formulations, I/O contracts, numerical review reports를 수정하지 않는다.
 - reference artifacts 또는 tolerance policies를 수정하지 않는다.
 - Abaqus, Nastran 또는 reference solver를 실행하지 않는다.
-- reference CSV를 생성하지 않는다.
+- reference HDF5 artifact 또는 reference CSV를 생성하지 않는다.
 - subagents를 자동 spawn하지 않는다.
 - release readiness를 독립적으로 승인하지 않는다.
 

docs/corrections/README.md

@@ -24,7 +24,7 @@ Correction Agent는 Build/Test Executor Agent, Reference Verification Agent, Phy
 - reference artifacts를 수정하지 않는다.
 - tolerance policies를 수정하지 않는다.
 - Abaqus, Nastran 또는 reference solver를 실행하지 않는다.
-- reference CSV를 생성하지 않는다.
+- reference HDF5 artifact 또는 reference CSV를 생성하지 않는다.
 - release readiness, reference tolerance success, physics validation success를 승인하지 않는다.
 - 최종 reference verification report 또는 physics validation report를 작성하지 않는다.
 

docs/formulations/README.md

@@ -20,7 +20,7 @@ Formulation Agent는 구현 가능한 FEM 정식화 문서를 작성한다.
 - C++ 코드를 구현하지 않는다.
 - C++ API나 파일 구조를 설계하지 않는다.
 - Abaqus, Nastran 또는 레퍼런스 솔버를 직접 실행하지 않는다.
-- reference CSV 결과를 생성하지 않는다.
+- reference HDF5 artifact 또는 reference CSV 결과를 생성하지 않는다.
 - release readiness를 승인하지 않는다.
 - Numerical Review Agent 검토 전 정식화를 최종 승인하지 않는다.
 

docs/implementation-plans/README.md

@@ -2,7 +2,7 @@
 
 이 디렉터리는 Implementation Planning Agent가 작성하거나 제안한 기능별 구현계획 문서를 보관하는 위치다.
 
-Implementation Planning Agent는 승인된 요구조건, 연구 브리프, 정식화, 수치 리뷰, I/O 정의, reference model 계약을 C++/MSVC 구현 전 TDD 작업계획으로 변환한다. Agent는 코드, 테스트, CMake 파일을 작성하지 않고, Abaqus/Nastran을 실행하지 않으며, reference CSV 생성이나 solver 결과 비교, release readiness 승인도 하지 않는다.
+Implementation Planning Agent는 승인된 요구조건, 연구 브리프, 정식화, 수치 리뷰, I/O 정의, reference model 계약을 C++/MSVC 구현 전 TDD 작업계획으로 변환한다. Agent는 코드, 테스트, CMake 파일을 작성하지 않고, Abaqus/Nastran을 실행하지 않으며, reference HDF5 artifact나 reference CSV 생성, solver 결과 비교, release readiness 승인도 하지 않는다.
 
 기본 파일명은 `docs/implementation-plans/<feature-id>-implementation-plan.md` 형식을 사용한다. 각 문서는 Implementation Agent가 먼저 작성해야 할 실패 테스트, 최소 구현 순서, CMake/CTest 등록 계획, acceptance traceability를 제공해야 한다.
 
@@ -23,7 +23,7 @@ Implementation Planning Agent는 승인된 요구조건, 연구 브리프, 정
 - CMake 파일을 수정하지 않는다.
 - CMake/CTest를 실행하지 않는다.
 - Abaqus, Nastran 또는 레퍼런스 솔버를 직접 실행하지 않는다.
-- reference CSV를 생성하지 않는다.
+- reference HDF5 artifact 또는 reference CSV를 생성하지 않는다.
 - solver 결과를 비교하지 않는다.
 - release readiness를 승인하지 않는다.
 - C++ API, class name, storage layout, file ownership을 확정하지 않는다.
@@ -73,7 +73,7 @@ Implementation Planning Agent는 승인된 요구조건, 연구 브리프, 정
 | TEST-001 | 1 | unit | test fails because behavior is missing | test passes after minimal implementation | TASK-001 | ctest -C Debug -R <test-name> |
 | TEST-002 | 2 | integration | integrated path fails before implementation | integrated path passes | TASK-002 | ctest -C Debug -R <test-name> |
 | TEST-003 | 3 | parser/I/O | Abaqus .inp case is not accepted or mapped | input maps to expected semantic model | TASK-003 | ctest -C Debug -R <test-name> |
-| TEST-004 | 4 | reference-comparison | solver CSV comparison fails before implementation | comparison is within planned tolerance | TASK-004 | ctest -C Debug -R <test-name> |
+| TEST-004 | 4 | reference-comparison | solver HDF5 comparison fails before implementation | comparison is within planned tolerance | TASK-004 | ctest -C Debug -R <test-name> |
 
 ## CMake/CTest Plan
 - target_candidates: <library/test executable targets>
@@ -95,8 +95,8 @@ Implementation Planning Agent는 승인된 요구조건, 연구 브리프, 정
 ## Data Flow Contract
 1. Abaqus `.inp` input follows docs/io-definitions/<feature-id>-io.md.
 2. Parser/I/O path maps model data and history data into the internal semantic model.
-3. Solver path produces displacement, reaction, element force, stress, or feature-specific result CSV.
-4. Reference comparison tests compare solver CSV against `references/<feature-id>/<model-id>/` artifacts.
+3. Solver path produces `results.h5` with displacement, reaction, element force, stress, or feature-specific result datasets.
+4. Reference comparison tests compare solver `results.h5` against `references/<feature-id>/<model-id>/` HDF5 artifacts.
 
 ## Acceptance Traceability Matrix
 
@@ -123,7 +123,7 @@ ctest -C Debug -R <feature-or-label>
 - <likely failure classifications and upstream rollback guidance>
 
 ### Reference Verification Agent
-- <planned CSV comparison tests, reference model ids, tolerance mapping, ID matching assumptions>
+- <planned HDF5 comparison tests, reference model ids, tolerance mapping, ID matching assumptions>
 
 ## Open Issues
 - <requirement, formulation, I/O, reference artifact, tolerance, or architecture issue>
@@ -133,7 +133,7 @@ ctest -C Debug -R <feature-or-label>
 
 - 모든 `must` requirement는 최소 하나의 task와 test에 연결되어야 한다.
 - C++ production 변경마다 선행 테스트 파일 또는 테스트 추가 계획이 있어야 한다.
-- reference artifact가 필요한 기능은 `references/<feature-id>/<model-id>/`와 CSV 비교 테스트 계획을 가져야 한다.
+- reference artifact가 필요한 기능은 `references/<feature-id>/<model-id>/`와 HDF5 비교 테스트 계획을 가져야 한다.
 - CMake/CTest 계획은 MSVC x64 Debug 검증 경로와 호환되어야 한다.
 - 구현 계획은 테스트 작성, 실패 확인, 최소 구현, validation 순서를 명시해야 한다.
 - upstream 문서가 불완전하면 값을 임의로 채우지 않고 `needs-upstream-decision` 또는 `blocked`로 표시한다.

docs/io-definitions/README.md

@@ -4,24 +4,25 @@
 
 FESA 솔버의 입력 파일은 Abaqus input file이다. 다만 초기 FESA는 Abaqus 전체 문법 호환을 목표로 하지 않고, 기능별로 지원할 Abaqus keyword subset과 내부 모델 매핑을 명확히 정의한다.
 
-기본 파일명은 `docs/io-definitions/<feature-id>-io.md` 형식을 사용한다. 각 문서는 Requirement Agent, Formulation Agent, Numerical Review Agent의 산출물을 입력으로 받아 Abaqus `.inp` 입력 계약과 결과 CSV schema를 정의해야 한다.
+기본 파일명은 `docs/io-definitions/<feature-id>-io.md` 형식을 사용한다. 각 문서는 Requirement Agent, Formulation Agent, Numerical Review Agent의 산출물을 입력으로 받아 Abaqus `.inp` 입력 계약과 HDF5 결과/reference schema를 정의해야 한다. CSV는 upstream 요구조건이 명시한 export 또는 comparison helper가 있을 때만 추가로 정의한다.
 
 ## I/O Definition Agent 역할
 
-I/O Definition Agent는 Abaqus input file subset, 내부 solver model mapping, output request mapping, comparison CSV schema를 정의한다.
+I/O Definition Agent는 Abaqus input file subset, 내부 solver model mapping, output request mapping, HDF5 result/reference schema, optional CSV export schema를 정의한다.
 
 수행한다:
 - 기능별 supported Abaqus keyword subset을 정의한다.
 - unsupported, ignored-with-warning, requires-user-decision keyword 정책을 정의한다.
 - model data와 history data를 내부 solver 개념으로 매핑한다.
 - node, element, set, material, section, boundary condition, load, step, output request의 의미 계약을 정의한다.
-- `displacements.csv`, `reactions.csv`, `element_forces.csv`, `stresses.csv` schema를 정의한다.
+- `results.h5`의 metadata, mesh, step/frame, nodal/element field output, history output dataset schema를 정의한다.
+- upstream 요구조건이 명시한 경우에만 `displacements.csv`, `reactions.csv`, `element_forces.csv`, `stresses.csv` 같은 optional CSV export schema를 정의한다.
 
 수행하지 않는다:
 - parser를 구현하지 않는다.
 - C++ API나 파일 구조를 설계하지 않는다.
 - Abaqus, Nastran 또는 레퍼런스 솔버를 직접 실행하지 않는다.
-- reference CSV 결과를 생성하지 않는다.
+- reference HDF5 artifact 또는 reference CSV 결과를 생성하지 않는다.
 - solver 결과와 reference 결과를 비교하지 않는다.
 - release readiness를 승인하지 않는다.
 - 명시적으로 정의되지 않은 Abaqus full compatibility를 주장하지 않는다.
@@ -107,7 +108,43 @@ I/O Definition Agent는 Abaqus input file subset, 내부 solver model mapping, o
 - step: <semantic contract>
 - output_request: <semantic contract>
 
-## Output and CSV Schemas
+## HDF5 Result and Reference Schemas
+
+### results.h5
+
+```text
+/metadata
+  feature_id
+  solver_version
+  model_id
+  hdf5_version
+  schema_version
+  units
+  tolerance
+  reference_solver
+
+/mesh/nodes
+/mesh/elements/<element-family>/connectivity
+
+/results/step_<id>/frame_<id>/nodal/<quantity>
+/results/step_<id>/frame_<id>/element/<quantity>
+/results/step_<id>/frame_<id>/history
+```
+
+각 dataset은 path, shape, datatype, ID field, component naming, coordinate system, units, output location, step/frame identity, ID matching rule을 명시해야 한다.
+
+### Required MITC4 Quantity Datasets
+
+| quantity | default dataset path | id/matching fields | component contract |
+| --- | --- | --- | --- |
+| nodal displacement | `/results/step_000/frame_000/nodal/displacement` | node id, component | `U1, U2, U3, UR1, UR2, UR3` |
+| nodal reaction | `/results/step_000/frame_000/nodal/reaction` | node id, component | `RF1, RF2, RF3, RM1, RM2, RM3` |
+| element force/resultant | `/results/step_000/frame_000/element/forces` | element id, Gauss point, component | `N11, N22, N12, M11, M22, M12, Q13, Q23` |
+| stress | `/results/step_000/frame_000/element/stress` | element id, Gauss point, section point, component | `S11, S22, S12, S13, S23` |
+
+## Optional CSV Export Schemas
+
+CSV output is not required for the current MITC4 HDF5-first feature unless an upstream requirement explicitly asks for it. When CSV export is required, it must preserve the same IDs, components, units, coordinate system, output location, and step/frame identity as the HDF5 datasets.
 
 ### displacements.csv
 | column | type | description |
@@ -161,13 +198,13 @@ I/O Definition Agent는 Abaqus input file subset, 내부 solver model mapping, o
 ## Open Issues and Downstream Handoff
 
 ### Reference Model Agent
-- <Abaqus input examples and reference artifact schema needs>
+- <Abaqus input examples and HDF5 reference artifact schema needs>
 
 ### Implementation Planning Agent
-- <parser acceptance cases, unsupported keyword diagnostics, CSV writer tests>
+- <parser acceptance cases, unsupported keyword diagnostics, HDF5 writer tests, optional CSV export tests>
 
 ### Reference Verification Agent
-- <CSV schemas, ID matching rules, units, coordinate conventions, tolerance-relevant fields>
+- <HDF5 dataset schemas, optional CSV schemas, ID matching rules, units, coordinate conventions, tolerance-relevant fields>
 ```
 
 ## 품질 기준
@@ -177,4 +214,5 @@ I/O Definition Agent는 Abaqus input file subset, 내부 solver model mapping, o
 - model data와 history data의 매핑을 구분해야 한다.
 - unsupported keyword 처리 정책을 명확히 해야 한다.
 - 내부 모델 계약은 semantic fields로 작성하고 C++ class/function/API를 확정하지 않는다.
-- CSV schema는 column name, ID field, component naming, coordinate system, units, step/frame identity, quantity location을 포함해야 한다.
+- HDF5 schema는 dataset path, shape, datatype, ID field, component naming, coordinate system, units, step/frame identity, quantity location을 포함해야 한다.
+- Optional CSV schema는 명시적으로 요구된 경우에만 정의하며, HDF5 schema와 동일한 물리 의미와 matching rule을 유지해야 한다.

docs/numerical-reviews/README.md

@@ -20,7 +20,7 @@ Numerical Review Agent는 정식화의 수학적 일관성, 수치 안정성 위
 - 정식화 문서를 직접 수정하지 않는다.
 - C++ API나 파일 구조를 설계하지 않는다.
 - Abaqus, Nastran 또는 레퍼런스 솔버를 직접 실행하지 않는다.
-- reference CSV 결과를 생성하지 않는다.
+- reference HDF5 artifact 또는 reference CSV 결과를 생성하지 않는다.
 - release readiness를 승인하지 않는다.
 - 레퍼런스 결과와 구현 솔버 결과의 일치 여부를 판정하지 않는다.
 

docs/physics-evaluations/README.md

@@ -23,7 +23,7 @@ Physics Evaluation Agent는 Reference Verification Agent가 `pass-for-physics-ev
 - requirements, formulations, I/O contracts, reference model contracts를 수정하지 않는다.
 - reference artifacts 또는 tolerance policies를 수정하지 않는다.
 - Abaqus, Nastran 또는 reference solver를 실행하지 않는다.
-- reference CSV를 생성하지 않는다.
+- reference HDF5 artifact 또는 reference CSV를 생성하지 않는다.
 - reference tolerance를 다시 판정하지 않는다.
 - release readiness를 승인하지 않는다.
 - release notes 또는 final release checklist를 작성하지 않는다.
@@ -39,7 +39,7 @@ EVIDENCE CHECK -> PHYSICS CHECKS -> CLASSIFY -> REPORT
 `EVIDENCE CHECK`에서 다음 항목을 확인한다.
 
 - Reference Verification report status가 `pass-for-physics-evaluation`인지 여부
-- checked solver/reference CSVs
+- checked solver/reference HDF5 files or approved optional CSV extracts
 - compared quantities
 - model purpose
 - documented physical expectations
@@ -93,7 +93,7 @@ EVIDENCE CHECK -> PHYSICS CHECKS -> CLASSIFY -> REPORT
 | evidence | path_or_source | status | notes |
 | --- | --- | --- | --- |
 | reference_verification | docs/reference-verifications/<feature-id>-reference-verification.md | pass-for-physics-evaluation | <summary> |
-| solver_results | <solver CSV path> | present | missing | <summary> |
+| solver_results | <solver results.h5 path or approved CSV extract path> | present | missing | <summary> |
 | reference_results | references/<feature-id>/<model-id>/ | present | missing | <summary> |
 | model_purpose | docs/reference-models/<feature-id>-reference-models.md | documented | missing | <summary> |
 | physical_expectations | <source docs> | documented | missing | <summary> |

docs/project-plan/SOLVER_AGENT_DESIGN.md

@@ -105,7 +105,7 @@
 주요 산출물:
 - 입력 데이터 schema
 - 출력 데이터 schema
-- 결과 비교용 CSV schema
+- 결과 비교용 HDF5 schema와 optional CSV export schema
 - 단위와 좌표계 규약
 
 ### Reference Model Agent

docs/project-plan/SOLVER_IMPLEMENT_INITIAL_PLAN.md

@@ -303,6 +303,7 @@ TBB:
 HDF5:
 - FESA provides an internal RAII wrapper around the HDF5 C API.
 - The HDF5 C library itself must be supplied through `HDF5_ROOT` or `HDF5_DIR`.
+- The current local default is `C:\Program Files\HDF_Group\HDF5\2.1.1`; use `HDF5_ROOT` for this root or `HDF5_DIR` for `C:\Program Files\HDF_Group\HDF5\2.1.1\cmake`.
 - HDF5 is required for solver output and reference comparison.
 
 ## Assumptions

docs/project-plan/SOLVER_SKILL_DESIGN.md

@@ -43,7 +43,7 @@ Agent는 역할과 책임 단위이고, skill은 여러 Agent가 반복적으로
 5. I/O Definition Agent는 `fesa-io-contract`를 사용해 지원할 Abaqus `.inp` keyword subset과 `displacements.csv`, `reactions.csv`, `element_forces.csv`, `stresses.csv` schema를 정의한다.
 6. Reference Model Agent는 `fesa-reference-models`를 사용해 `references/linear-truss-1d/<model-id>/` artifact bundle 계약과 coverage matrix를 작성한다.
 7. Implementation Planning Agent와 Implementation Agent는 `fesa-cpp-msvc-tdd`를 사용해 테스트 작성, 실패 확인, 최소 구현, CMake/CTest 등록, validation을 수행한다.
-8. Reference Verification Agent는 `fesa-reference-comparison`을 사용해 구현 solver CSV와 저장된 reference CSV를 tolerance 기준으로 비교한다.
+8. Reference Verification Agent는 `fesa-reference-comparison`을 사용해 구현 solver HDF5 결과와 저장된 reference HDF5 artifact를 tolerance 기준으로 비교한다.
 9. Physics Evaluation Agent는 `fesa-physics-sanity`를 사용해 global equilibrium, reaction consistency, displacement direction, symmetry, model coverage를 검토한다.
 10. Release Agent는 `fesa-release-readiness`를 사용해 gate evidence, acceptance traceability, known limitations, release notes draft를 작성한다.
 
@@ -54,7 +54,7 @@ Agent는 역할과 책임 단위이고, skill은 여러 Agent가 반복적으로
 - 새로운 솔버 기능 요청을 검증 가능한 요구조건 분석 baseline으로 만든다.
 - `shall` 문장과 `FESA-REQ-<FEATURE>-###` id를 사용한다.
 - 모든 `must` 요구조건은 verification method와 acceptance criteria를 가져야 한다.
-- FEM 정식화, C++ 구현, reference CSV 생성, release readiness 판단은 하지 않는다.
+- FEM 정식화, C++ 구현, reference HDF5 artifact 또는 reference CSV 생성, release readiness 판단은 하지 않는다.
 
 ### `fesa-research-evidence`
 
@@ -81,7 +81,7 @@ Agent는 역할과 책임 단위이고, skill은 여러 Agent가 반복적으로
 
 - FESA solver input이 지원할 Abaqus `.inp` subset을 정의한다.
 - model data와 history data를 구분한다.
-- 내부 semantic model 계약과 output/CSV schema를 정의한다.
+- 내부 semantic model 계약과 HDF5 output schema 및 명시적으로 요구된 optional CSV schema를 정의한다.
 - parser 구현이나 full Abaqus compatibility claim은 하지 않는다.
 
 ### `fesa-reference-models`

docs/reference-models/README.md

@@ -2,7 +2,7 @@
 
 이 디렉터리는 Reference Model Agent가 작성하거나 제안한 기능별 reference model 설계 문서를 보관하는 위치다.
 
-Reference Model Agent는 FESA 기능 검증에 필요한 Abaqus `.inp` 기반 테스트 모델 포트폴리오와 `references/<feature-id>/<model-id>/` artifact bundle 계약을 정의한다. Agent는 Abaqus, Nastran 또는 레퍼런스 솔버를 직접 실행하지 않고, reference CSV 값을 생성하지 않으며, solver 결과 비교나 release readiness 승인도 하지 않는다.
+Reference Model Agent는 FESA 기능 검증에 필요한 Abaqus `.inp` 기반 테스트 모델 포트폴리오와 `references/<feature-id>/<model-id>/` artifact bundle 계약을 정의한다. Agent는 Abaqus, Nastran 또는 레퍼런스 솔버를 직접 실행하지 않고, reference HDF5 artifact나 reference CSV 값을 생성하지 않으며, solver 결과 비교나 release readiness 승인도 하지 않는다.
 
 기본 파일명은 `docs/reference-models/<feature-id>-reference-models.md` 형식을 사용한다. 각 문서는 요구조건, 연구 브리프, 정식화, 수치 리뷰, I/O 정의를 입력으로 받아 구현 전에 준비해야 할 테스트 모델과 reference artifact 요구사항을 정의해야 한다.
 
@@ -12,8 +12,9 @@ Reference Model Agent는 FESA 기능 검증에 필요한 Abaqus `.inp` 기반
 - 기능별 reference model portfolio를 smoke, analytical, patch test, benchmark, regression, negative/invalid-input model로 구분한다.
 - `model.inp`가 I/O Definition Agent의 supported Abaqus keyword subset 안에 있는지 확인한다.
 - `references/<feature-id>/<model-id>/` artifact bundle 구조와 필수 파일을 정의한다.
-- `metadata.json` provenance, 단위, 좌표계, Abaqus version/source, output request, tolerance 정책을 정의한다.
-- `displacements.csv`, `reactions.csv`, `element_forces.csv`, `stresses.csv` 요구사항을 정의한다.
+- `metadata.json` provenance, 단위, 좌표계, Abaqus version/source, output request, HDF5 schema version, tolerance 정책을 정의한다.
+- `results.h5` 또는 feature-specific HDF5 reference result file 요구사항을 정의한다.
+- upstream 요구조건이 명시한 경우에만 `displacements.csv`, `reactions.csv`, `element_forces.csv`, `stresses.csv` 같은 optional CSV export 요구사항을 정의한다.
 - requirement와 model, compared quantity, tolerance, artifact status를 연결하는 Coverage Matrix를 작성한다.
 
 수행하지 않는다:
@@ -21,7 +22,7 @@ Reference Model Agent는 FESA 기능 검증에 필요한 Abaqus `.inp` 기반
 - parser를 구현하지 않는다.
 - C++ API나 파일 구조를 설계하지 않는다.
 - Abaqus, Nastran 또는 레퍼런스 솔버를 직접 실행하지 않는다.
-- reference CSV를 생성하지 않는다.
+- reference HDF5 artifact 또는 reference CSV를 생성하지 않는다.
 - solver 결과를 비교하지 않는다.
 - release readiness를 승인하지 않는다.
 - reference 값, tolerance, Abaqus compatibility를 임의로 만들지 않는다.
@@ -53,11 +54,11 @@ Reference Model Agent는 FESA 기능 검증에 필요한 Abaqus `.inp` 기반
 
 | model_id | category | purpose | status | required_artifacts |
 | --- | --- | --- | --- | --- |
-| <model-id> | smoke | <basic parser/solve path> | draft | model.inp, metadata.json, required CSVs |
-| <model-id> | analytical | <closed-form comparison> | draft | model.inp, metadata.json, required CSVs |
-| <model-id> | patch test | <element consistency check> | draft | model.inp, metadata.json, required CSVs |
-| <model-id> | benchmark | <trusted benchmark comparison> | draft | model.inp, metadata.json, required CSVs |
-| <model-id> | regression | <known defect guard> | draft | model.inp, metadata.json, required CSVs |
+| <model-id> | smoke | <basic parser/solve path> | draft | model.inp, metadata.json, results.h5 |
+| <model-id> | analytical | <closed-form comparison> | draft | model.inp, metadata.json, results.h5 |
+| <model-id> | patch test | <element consistency check> | draft | model.inp, metadata.json, results.h5 |
+| <model-id> | benchmark | <trusted benchmark comparison> | draft | model.inp, metadata.json, results.h5 |
+| <model-id> | regression | <known defect guard> | draft | model.inp, metadata.json, results.h5 |
 | <model-id> | negative/invalid-input | <unsupported keyword or invalid model diagnostic> | draft | model.inp, metadata.json |
 
 ## Model Record
@@ -81,7 +82,7 @@ Reference Model Agent는 FESA 기능 검증에 필요한 Abaqus `.inp` 기반
 - supported_keyword_subset: <keywords from docs/io-definitions/<feature-id>-io.md>
 - model_data: <nodes, elements, sets, material, section, coordinates, units>
 - history_data: <step, procedure, boundary conditions, loads, output requests>
-- output_requests: <requests needed to populate reference CSV files>
+- output_requests: <requests needed to populate reference HDF5 datasets>
 - unsupported_keyword_policy: unsupported | ignored-with-warning | requires-user-decision
 
 ## Artifact Bundle Contract
@@ -92,27 +93,38 @@ references/
     <model-id>/
       model.inp
       metadata.json
-      displacements.csv
-      reactions.csv
-      element_forces.csv
-      stresses.csv
+      results.h5
       README.md
 ```
 
 Required files:
 - `model.inp`: Abaqus input file for the reference model.
 - `metadata.json`: provenance and model contract metadata.
-- `displacements.csv`: nodal displacement reference results.
-- `reactions.csv`: nodal reaction force reference results.
-- `element_forces.csv`: element internal force reference results.
-- `stresses.csv`: stress reference results.
+- `results.h5`: HDF5 reference result artifact containing required metadata, mesh, step/frame, nodal, element, field, and history result datasets.
 - `README.md`: short description, generation notes, and limitations.
 
 Optional files:
+- `displacements.csv`: nodal displacement export when upstream contracts explicitly require CSV.
+- `reactions.csv`: nodal reaction force export when upstream contracts explicitly require CSV.
+- `element_forces.csv`: element internal force export when upstream contracts explicitly require CSV.
+- `stresses.csv`: stress export when upstream contracts explicitly require CSV.
 - `strains.csv`: strain reference results when required.
 - `energy_or_residual.csv`: energy, residual, or convergence reference results when required.
 - `notes.md`: manual review notes.
 
+For the current `mitc4-linear-static-shell` feature, the required stored Abaqus artifacts are:
+
+```text
+references/mitc4-linear-static-shell/<model-id>/
+  model.inp
+  metadata.json
+  abaqus_s4r/results.h5
+  abaqus_s4/results.h5
+  README.md
+```
+
+`abaqus_s4r/results.h5` is the primary pass/fail reference. `abaqus_s4/results.h5` is diagnostic.
+
 ## Metadata JSON Contract
 
 ```json
@@ -132,13 +144,21 @@ Optional files:
   "boundary_condition_summary": "<summary>",
   "load_summary": "<summary>",
   "output_requests": ["U", "RF", "S", "<feature-specific quantities>"],
-  "csv_schema_version": "<version>",
+  "hdf5_schema_version": "<version>",
   "tolerance_policy": "<absolute/relative/norm policy>",
   "limitations": ["<known limitation>"]
 }
 ```
 
-## Reference CSV Requirements
+## Reference HDF5 Requirements
+
+- Required when reference comparison is part of the feature acceptance criteria.
+- Must include metadata, mesh identity, step/frame identity, node and element IDs, component names, coordinate system, units, output locations, and tolerance source.
+- Required quantity datasets must match the paths and component contracts from `docs/io-definitions/<feature-id>-io.md`.
+
+## Optional CSV Export Requirements
+
+CSV exports are not required for the current HDF5-first MITC4 feature unless an upstream document explicitly requires them. When required, they must preserve the same physical meaning and matching keys as the HDF5 datasets.
 
 ### displacements.csv
 - Required when nodal displacement is a verification quantity.
@@ -164,30 +184,30 @@ Optional files:
 
 | requirement_id | model_id | compared_quantity | artifact_file | tolerance | verification_method | status |
 | --- | --- | --- | --- | --- | --- | --- |
-| <req-id> | <model-id> | displacement | displacements.csv | <policy> | reference-comparison | draft |
-| <req-id> | <model-id> | reaction | reactions.csv | <policy> | reference-comparison | draft |
-| <req-id> | <model-id> | element force | element_forces.csv | <policy> | reference-comparison | draft |
-| <req-id> | <model-id> | stress | stresses.csv | <policy> | reference-comparison | draft |
+| <req-id> | <model-id> | displacement | results.h5:/results/.../nodal/displacement | <policy> | reference-comparison | draft |
+| <req-id> | <model-id> | reaction | results.h5:/results/.../nodal/reaction | <policy> | reference-comparison | draft |
+| <req-id> | <model-id> | element force | results.h5:/results/.../element/forces | <policy> | reference-comparison | draft |
+| <req-id> | <model-id> | stress | results.h5:/results/.../element/stress | <policy> | reference-comparison | draft |
 
 ## Artifact Acceptance Checklist
 - 모든 `must` requirement가 최소 하나의 `model_id`와 `compared_quantity`에 연결되어 있다.
 - `model.inp`가 기능별 supported Abaqus keyword subset을 벗어나지 않는다.
-- `metadata.json`에 provenance, Abaqus version/source, units, coordinate system, tolerance, CSV schema version이 기록되어 있다.
-- 필수 CSV 파일이 존재하거나, 기능상 불필요한 파일은 명확한 reason과 함께 제외되어 있다.
-- output request가 필요한 CSV 물리량을 생성할 수 있도록 정의되어 있다.
-- reference CSV가 없으면 status는 `needs-reference-artifacts`다.
+- `metadata.json`에 provenance, Abaqus version/source, units, coordinate system, tolerance, HDF5 schema version이 기록되어 있다.
+- 필수 HDF5 artifact가 존재하거나, 기능상 불필요한 파일은 명확한 reason과 함께 제외되어 있다.
+- output request가 필요한 HDF5 물리량을 생성할 수 있도록 정의되어 있다.
+- reference HDF5 artifact가 없으면 status는 `needs-reference-artifacts`다.
 - tolerance, source, units, coordinate system이 불명확하면 status는 `needs-user-decision`이다.
 
 ## Open Issues and Downstream Handoff
 
 ### I/O Definition Agent
-- <supported keyword, output request, CSV schema clarification>
+- <supported keyword, output request, HDF5 schema clarification>
 
 ### Implementation Planning Agent
 - <tests that should fail before implementation, model order, acceptance criteria>
 
 ### Reference Verification Agent
-- <CSV schema, ID matching, units, coordinate conventions, output locations, tolerance mapping>
+- <HDF5 schema, optional CSV schema, ID matching, units, coordinate conventions, output locations, tolerance mapping>
 
 ### Physics Evaluation Agent
 - <equilibrium, symmetry, displacement direction, stress location, rigid body mode, load path sanity checks>
@@ -198,8 +218,8 @@ Optional files:
 - Reference model의 목적과 검증 대상 requirement가 명확해야 한다.
 - `model.inp`는 Abaqus input file이며, 기능별 supported keyword subset을 따라야 한다.
 - model data와 history data를 구분해야 한다.
-- output request와 required CSV 사이의 연결이 명확해야 한다.
+- output request와 required HDF5 dataset 사이의 연결이 명확해야 한다.
 - `references/<feature-id>/<model-id>/` 구조와 필수 artifact가 명시되어야 한다.
-- `metadata.json`에는 provenance, Abaqus version/source, units, coordinate system, tolerance, CSV schema version이 포함되어야 한다.
-- reference CSV가 없으면 완료 상태가 아니라 `needs-reference-artifacts` 상태로 둔다.
+- `metadata.json`에는 provenance, Abaqus version/source, units, coordinate system, tolerance, HDF5 schema version이 포함되어야 한다.
+- reference HDF5 artifact가 없으면 완료 상태가 아니라 `needs-reference-artifacts` 상태로 둔다.
 - 모든 `must` requirement는 Coverage Matrix에서 model, compared quantity, tolerance, verification method로 추적되어야 한다.

docs/reference-verifications/README.md

@@ -2,17 +2,17 @@
 
 이 디렉터리는 Reference Verification Agent가 작성하거나 제안하는 기능별 reference comparison report를 보관하는 위치다.
 
-Reference Verification Agent는 Build/Test Executor Agent 통과 후 generated solver result CSV와 stored Abaqus reference CSV artifacts를 tolerance 기준으로 비교한다. 이 agent는 comparison과 report만 수행하며, source code, tests, CMake files, requirements, formulations, I/O contracts, reference artifacts, tolerance policies를 수정하지 않는다.
+Reference Verification Agent는 Build/Test Executor Agent 통과 후 generated solver `results.h5`와 stored Abaqus reference HDF5 artifacts를 tolerance 기준으로 비교한다. 이 agent는 comparison과 report만 수행하며, source code, tests, CMake files, requirements, formulations, I/O contracts, reference artifacts, tolerance policies를 수정하지 않는다.
 
 기본 문서명은 `docs/reference-verifications/<feature-id>-reference-verification.md` 형식을 사용한다.
 
 ## Reference Verification Agent 역할
 
 수행한다:
-- `references/<feature-id>/<model-id>/` artifact bundle과 generated solver result CSV를 확인한다.
+- `references/<feature-id>/<model-id>/` artifact bundle과 generated solver `results.h5`를 확인한다.
 - `metadata.json`, schema version, units, coordinate system, step/frame identity, node/element IDs, output location, tolerance source를 확인한다.
-- `displacements.csv`, `reactions.csv`, `element_forces.csv`, `stresses.csv`를 기본 비교 대상으로 삼는다.
-- upstream 문서가 요구할 때만 `strains.csv`, `energy_or_residual.csv`를 추가 비교한다.
+- HDF5 datasets for displacement, reaction, element force/resultant, stress를 기본 비교 대상으로 삼는다.
+- upstream 문서가 요구할 때만 strain, energy, residual HDF5 datasets 또는 optional CSV export를 추가 비교한다.
 - max absolute error, max relative error, RMS error, norm error, worst node/element/component, missing rows, extra rows, pass/fail을 보고한다.
 - 실패를 missing-reference-artifact, missing-solver-output, schema-mismatch, id-mismatch, unit-or-coordinate-mismatch, tolerance-failure, nonfinite-result, upstream-contract, environment로 분류한다.
 
@@ -23,8 +23,8 @@ Reference Verification Agent는 Build/Test Executor Agent 통과 후 generated s
 - requirements, formulations, I/O contracts, reference model contracts를 수정하지 않는다.
 - reference artifacts 또는 tolerance policies를 수정하지 않는다.
 - Abaqus, Nastran 또는 reference solver를 실행하지 않는다.
-- reference CSV를 생성하지 않는다.
-- solver output CSV를 tolerance에 맞추기 위해 보정하지 않는다.
+- reference HDF5 artifact 또는 reference CSV를 생성하지 않는다.
+- solver HDF5 output 또는 optional CSV export를 tolerance에 맞추기 위해 보정하지 않는다.
 - physics validation success 또는 release readiness를 승인하지 않는다.
 
 ## 실행 순서
@@ -38,8 +38,8 @@ ARTIFACT CHECK -> COMPARE -> CLASSIFY -> REPORT
 `ARTIFACT CHECK`에서 다음 항목이 없으면 비교를 시작하지 않는다.
 
 - `metadata.json`
-- required reference CSV files
-- generated solver result CSV files
+- required reference HDF5 files
+- generated solver `results.h5`
 - schema version
 - units
 - coordinate system
@@ -51,20 +51,20 @@ ARTIFACT CHECK -> COMPARE -> CLASSIFY -> REPORT
 ## 비교 대상
 
 기본 비교 대상:
-- `displacements.csv`: nodal displacement
-- `reactions.csv`: nodal reaction force
-- `element_forces.csv`: element internal force
-- `stresses.csv`: element stress
+- `results.h5:/results/.../nodal/displacement`: nodal displacement
+- `results.h5:/results/.../nodal/reaction`: nodal reaction force
+- `results.h5:/results/.../element/forces`: element internal force/resultant
+- `results.h5:/results/.../element/stress`: element stress
 
 선택 비교 대상:
-- `strains.csv`: strain이 acceptance criteria에 포함된 경우
-- `energy_or_residual.csv`: energy, residual, convergence quantity가 acceptance criteria에 포함된 경우
+- strain HDF5 dataset or `strains.csv`: strain이 acceptance criteria에 포함된 경우
+- energy/residual HDF5 dataset or `energy_or_residual.csv`: energy, residual, convergence quantity가 acceptance criteria에 포함된 경우
 
 ## Failure Classification
 
 - `missing-reference-artifact`: required stored reference file 또는 provenance가 없다.
-- `missing-solver-output`: generated solver result CSV 또는 comparison command가 없다.
-- `schema-mismatch`: reference CSV와 solver CSV column/schema가 다르다.
+- `missing-solver-output`: generated solver `results.h5` 또는 comparison command가 없다.
+- `schema-mismatch`: reference HDF5 schema와 solver HDF5 schema가 다르다.
 - `id-mismatch`: node id, element id, step/frame, integration point, component matching이 실패했다.
 - `unit-or-coordinate-mismatch`: units 또는 coordinate system이 비교 가능하지 않다.
 - `tolerance-failure`: schema와 matching은 유효하지만 error가 tolerance를 초과했다.
@@ -93,11 +93,10 @@ ARTIFACT CHECK -> COMPARE -> CLASSIFY -> REPORT
 | --- | --- | --- | --- |
 | reference_bundle | references/<feature-id>/<model-id>/ | present | missing | <notes> |
 | metadata | references/<feature-id>/<model-id>/metadata.json | present | missing | <provenance summary> |
-| reference_displacements | references/<feature-id>/<model-id>/displacements.csv | present | missing | <notes> |
-| reference_reactions | references/<feature-id>/<model-id>/reactions.csv | present | missing | <notes> |
-| reference_element_forces | references/<feature-id>/<model-id>/element_forces.csv | present | missing | <notes> |
-| reference_stresses | references/<feature-id>/<model-id>/stresses.csv | present | missing | <notes> |
-| solver_outputs | <solver output directory> | present | missing | <notes> |
+| reference_results | references/<feature-id>/<model-id>/results.h5 | present | missing | <notes> |
+| solver_results | <solver output path>/results.h5 | present | missing | <notes> |
+| optional_reference_csv_exports | references/<feature-id>/<model-id>/*.csv | present | missing | required only when upstream contracts ask for CSV |
+| optional_solver_csv_exports | <solver output path>/*.csv | present | missing | required only when upstream contracts ask for CSV |
 
 ## Comparison Contract
 - schema_version: <version>
@@ -114,10 +113,10 @@ ARTIFACT CHECK -> COMPARE -> CLASSIFY -> REPORT
 
 | quantity | model_id | artifact_file | compared_rows | missing_rows | extra_rows | max_abs_error | max_rel_error | rms_error | norm_error | worst_id | worst_component | result |
 | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
-| displacement | <model-id> | displacements.csv | <n> | <n> | <n> | <value> | <value> | <value> | <value or N/A> | <node id> | <component> | pass | fail |
-| reaction | <model-id> | reactions.csv | <n> | <n> | <n> | <value> | <value> | <value> | <value or N/A> | <node id> | <component> | pass | fail |
-| element force | <model-id> | element_forces.csv | <n> | <n> | <n> | <value> | <value> | <value> | <value or N/A> | <element id> | <component> | pass | fail |
-| stress | <model-id> | stresses.csv | <n> | <n> | <n> | <value> | <value> | <value> | <value or N/A> | <element/ip id> | <component> | pass | fail |
+| displacement | <model-id> | results.h5:/results/.../nodal/displacement | <n> | <n> | <n> | <value> | <value> | <value> | <value or N/A> | <node id> | <component> | pass | fail |
+| reaction | <model-id> | results.h5:/results/.../nodal/reaction | <n> | <n> | <n> | <value> | <value> | <value> | <value or N/A> | <node id> | <component> | pass | fail |
+| element force | <model-id> | results.h5:/results/.../element/forces | <n> | <n> | <n> | <value> | <value> | <value> | <value or N/A> | <element id> | <component> | pass | fail |
+| stress | <model-id> | results.h5:/results/.../element/stress | <n> | <n> | <n> | <value> | <value> | <value> | <value or N/A> | <element/ip id> | <component> | pass | fail |
 
 ## Failure Classification
 - classification: missing-reference-artifact | missing-solver-output | schema-mismatch | id-mismatch | unit-or-coordinate-mismatch | tolerance-failure | nonfinite-result | upstream-contract | environment | N/A
@@ -151,15 +150,15 @@ ARTIFACT CHECK -> COMPARE -> CLASSIFY -> REPORT
 - `pass-for-physics-evaluation`: required reference comparisons가 모두 통과했고 Physics Evaluation Agent로 넘길 수 있다.
 - `needs-correction`: implementation-owned solver result mismatch 또는 nonfinite result가 있다.
 - `needs-reference-artifacts`: required reference artifact 또는 provenance가 누락됐다.
-- `needs-solver-results`: generated solver result CSV 또는 comparison command가 없다.
+- `needs-solver-results`: generated solver `results.h5` 또는 comparison command가 없다.
 - `needs-upstream-decision`: schema, tolerance, units, coordinate system, output location, ID matching policy가 누락 또는 충돌한다.
 - `blocked`: 사용자 또는 Coordinator Agent 결정 없이는 안전하게 진행할 수 없다.
 
 ## 품질 기준
 
 - 모든 `must` requirement의 reference-comparison 항목은 model id, compared quantity, artifact file, tolerance에 trace되어야 한다.
-- reference artifact는 읽기 전용이다. `model.inp`, `metadata.json`, reference CSV를 수정하지 않는다.
-- solver output CSV는 비교 입력일 뿐이며 tolerance에 맞추기 위해 후처리 보정하지 않는다.
+- reference artifact는 읽기 전용이다. `model.inp`, `metadata.json`, `results.h5`, optional reference CSV를 수정하지 않는다.
+- solver HDF5 output과 optional solver CSV는 비교 입력일 뿐이며 tolerance에 맞추기 위해 후처리 보정하지 않는다.
 - stress/strain은 element id, integration point 또는 recovery location, component naming이 일치할 때만 비교한다.
 - nodal displacement/reaction은 node id, DOF/component, coordinate system, unit이 일치할 때만 비교한다.
 - missing rows와 extra rows를 숨기지 않고 보고한다.

docs/releases/README.md

@@ -2,7 +2,7 @@
 
 이 디렉터리는 Release Agent가 작성하거나 제안하는 기능별 release readiness report를 보관하는 위치다.
 
-Release Agent는 Physics Evaluation Agent가 `pass-for-release-agent`로 넘긴 기능에 대해 최종 gate evidence를 감사한다. 이 Agent는 source code, tests, CMake, upstream 계약, reference artifacts, tolerance policies를 수정하지 않는다. 또한 Abaqus/Nastran 실행, reference CSV 생성, 외부 publish/deploy/package/tag/commit 작업을 수행하지 않는다.
+Release Agent는 Physics Evaluation Agent가 `pass-for-release-agent`로 넘긴 기능에 대해 최종 gate evidence를 감사한다. 이 Agent는 source code, tests, CMake, upstream 계약, reference artifacts, tolerance policies를 수정하지 않는다. 또한 Abaqus/Nastran 실행, reference HDF5 artifact 또는 reference CSV 생성, 외부 publish/deploy/package/tag/commit 작업을 수행하지 않는다.
 
 기본 문서명은 `docs/releases/<feature-id>-release.md` 형식을 사용한다.
 
@@ -24,7 +24,7 @@ Release Agent는 Physics Evaluation Agent가 `pass-for-release-agent`로 넘긴
 - requirements, formulations, I/O contracts, numerical review reports, reference verification reports, physics evaluation reports를 수정하지 않는다.
 - reference artifacts 또는 tolerance policies를 수정하지 않는다.
 - Abaqus, Nastran 또는 reference solver를 실행하지 않는다.
-- reference CSV를 생성하지 않는다.
+- reference HDF5 artifact 또는 reference CSV를 생성하지 않는다.
 - 실패하거나 누락된 upstream gate를 우회하지 않는다.
 - 사용자 명시 요청 없이 publish, deploy, package, tag, commit, external release를 수행하지 않는다.
 

docs/requirements/README.md

@@ -20,7 +20,7 @@ Requirement Agent는 새로운 솔버 기능 요청을 검증 가능한 요구
 - 유한요소 정식화를 확정하지 않는다.
 - C++ API나 파일 구조를 설계하지 않는다.
 - Abaqus, Nastran 또는 레퍼런스 솔버를 직접 실행하지 않는다.
-- reference CSV 결과를 생성하지 않는다.
+- reference HDF5 artifact 또는 reference CSV 결과를 생성하지 않는다.
 - 기능 완료 여부를 승인하지 않는다.
 
 ## 문서 템플릿
@@ -78,10 +78,8 @@ Expected location: `references/<feature-id>/`
 
 - `model.inp`: required | not-applicable
 - `metadata.json`: required
-- `displacements.csv`: required | not-applicable
-- `reactions.csv`: required | not-applicable
-- `element_forces.csv`: required | not-applicable
-- `stresses.csv`: required | not-applicable
+- `results.h5`: required | not-applicable
+- optional_csv_exports: required | not-applicable
 
 ## Requirement Verification Matrix
 
@@ -114,6 +112,6 @@ Expected location: `references/<feature-id>/`
 
 - 모든 `must` 요구조건은 검증 방법과 acceptance criteria를 가져야 한다.
 - 모든 수치 요구조건은 단위, 좌표계, tolerance 또는 `TBD with owner`를 가져야 한다.
-- reference 비교가 필요한 요구조건은 필요한 CSV artifact를 명시해야 한다.
+- reference 비교가 필요한 요구조건은 필요한 HDF5 artifact와 dataset path를 명시해야 한다. CSV artifact는 명시적으로 요구된 export일 때만 포함한다.
 - "빠르게", "정확하게", "Abaqus처럼" 같은 문장은 검증 가능한 기준으로 바꾸거나 open question으로 남겨야 한다.
 - 구현 방법, 정식화 세부식, C++ API는 이 문서에서 확정하지 않는다.

docs/research/README.md

@@ -20,7 +20,7 @@ Research Agent는 FEM 이론, benchmark, verification reference, solver manual,
 - 유한요소 정식화를 확정하지 않는다.
 - C++ API나 파일 구조를 설계하지 않는다.
 - Abaqus, Nastran 또는 레퍼런스 솔버를 직접 실행하지 않는다.
-- reference CSV 결과를 생성하지 않는다.
+- reference HDF5 artifact 또는 reference CSV 결과를 생성하지 않는다.
 - 기능 완료 여부를 승인하지 않는다.
 
 ## Source Reliability Tier