modify docu

docs/SOLVER_SKILL_DESIGN.md

@@ -13,7 +13,7 @@ Agent는 역할과 책임 단위이고, skill은 여러 Agent가 반복적으로
 - Skill 본문은 agent TOML의 역할 설명을 반복하지 않고, 입력, 절차, 산출물, 금지사항, 품질 gate, handoff를 정의한다.
 - Skill은 `AGENTS.md`와 `docs/SOLVER_AGENT_DESIGN.md`를 공통 상위 기준으로 읽는다.
 - Abaqus, Nastran 또는 reference solver 실행은 skill 범위에 포함하지 않는다.
-- Reference CSV 생성 또는 수정은 skill 범위에 포함하지 않는다.
+- Reference HDF5 파일 또는 deterministic CSV view 생성/수정은 skill 범위에 포함하지 않는다.
 - C++ 구현 관련 skill은 C++17 이상, MSVC, CMake, CTest, TDD 원칙을 따른다.
 - 기본 workspace validation 명령은 `python scripts/validate_workspace.py`이다.
 
@@ -40,10 +40,10 @@ Agent는 역할과 책임 단위이고, skill은 여러 Agent가 반복적으로
 2. Research Agent는 `fesa-research-evidence`를 사용해 truss/bar element 이론, benchmark 후보, source reliability, applicability limits를 정리한다.
 3. Formulation Agent는 `fesa-formulation-spec`을 사용해 strong form, weak form, shape functions, B matrix, element stiffness, output recovery를 정리한다.
 4. Numerical Review Agent는 `fesa-numerical-review`를 사용해 rigid body modes, patch test, stiffness symmetry, Jacobian, locking 위험을 검토하고 `pass-for-implementation-planning` 여부를 판단한다.
-5. I/O Definition Agent는 `fesa-io-contract`를 사용해 지원할 Abaqus `.inp` keyword subset과 `displacements.csv`, `reactions.csv`, `element_forces.csv`, `stresses.csv` schema를 정의한다.
+5. I/O Definition Agent는 `fesa-io-contract`를 사용해 지원할 Abaqus `.inp` keyword subset, `results.h5` schema, `csv/displacements.csv`, `csv/reactions.csv`, `csv/element_forces.csv`, `csv/stresses.csv` view 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 `results.h5`와 저장된 `reference.h5`를 tolerance 기준으로 비교하고 deterministic CSV view를 검토한다.
 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/CSV view 생성, release readiness 판단은 하지 않는다.
 
 ### `fesa-research-evidence`
 
@@ -81,15 +81,15 @@ Agent는 역할과 책임 단위이고, skill은 여러 Agent가 반복적으로
 
 - FESA solver input이 지원할 Abaqus `.inp` subset을 정의한다.
 - model data와 history data를 구분한다.
-- 내부 semantic model 계약과 output/CSV schema를 정의한다.
+- 내부 semantic model 계약, HDF5 output schema, deterministic CSV view schema를 정의한다.
 - parser 구현이나 full Abaqus compatibility claim은 하지 않는다.
 
 ### `fesa-reference-models`
 
 - smoke, analytical, patch test, benchmark, regression, negative/invalid-input 모델을 구분한다.
 - `references/<feature-id>/<model-id>/` artifact bundle 계약을 정의한다.
-- `model.inp`, `metadata.json`, `displacements.csv`, `reactions.csv`, `element_forces.csv`, `stresses.csv`를 기준 artifact로 둔다.
-- Reference CSV가 없으면 완료 상태가 아니라 `needs-reference-artifacts`로 둔다.
+- `model.inp`, `metadata.json`, `reference.h5`, `csv/displacements.csv`, `csv/reactions.csv`, `csv/element_forces.csv`, `csv/stresses.csv`를 기준 artifact로 둔다.
+- `reference.h5` 또는 required deterministic CSV view가 없으면 완료 상태가 아니라 `needs-reference-artifacts`로 둔다.
 
 ### `fesa-cpp-msvc-tdd`
 
@@ -109,7 +109,7 @@ ctest -C Debug -R <feature-or-label>
 ### `fesa-reference-comparison`
 
 - `ARTIFACT CHECK -> COMPARE -> CLASSIFY -> REPORT` 순서로 수행한다.
-- `metadata.json`, schema version, units, coordinate system, step/frame identity, ID matching, output location, tolerance source를 확인한다.
+- `metadata.json`, `results.h5`, `reference.h5`, deterministic CSV views, schema version, units, coordinate system, step/frame identity, ID matching, output location, tolerance source를 확인한다.
 - max absolute error, max relative error, RMS error, norm error, missing rows, extra rows를 보고한다.
 - Reference pass는 physics validation이나 release readiness를 의미하지 않는다.