modify documents

docs/ARCHITECTURE.md

@@ -1,13 +1,14 @@
 # Architecture: Abaqus User Subroutine Development
 
 ## 목표
-이 저장소는 Abaqus User Subroutine 개발을 위한 agent-driven workflow와 검증 체계를 제공한다. 핵심 아키텍처는 단계별 specialist agent, gate 문서, no-Abaqus Fortran TDD, opt-in Abaqus validation, reference artifact metadata validation으로 구성된다.
+이 저장소는 Abaqus User Subroutine 개발을 위한 agent-driven workflow와 검증 체계를 제공한다. 핵심 아키텍처는 단계별 specialist agent, gate 문서, no-Abaqus Fortran TDD, 외부 생성 ODB 추출 CSV validation, reference artifact metadata validation으로 구성된다.
 
 ## 주요 원칙
 - Abaqus User Subroutine 개발이 프로젝트의 중심이다.
 - Fortran source는 Abaqus ABI wrapper와 testable kernel/driver logic을 가능한 한 분리한다.
 - 기본 검증은 Abaqus를 실행하지 않는다.
-- Abaqus 실행과 reference artifact 생성은 명시적으로 승인된 환경에서만 수행한다.
+- Abaqus 해석 실행과 ODB CSV 추출은 사용자가 외부 Abaqus PC에서 수행한다.
+- 이 프로젝트는 ODB를 직접 파싱하지 않고, 추출된 CSV와 metadata를 검증한다.
 - Requirements, research, formulation, interface, test model, implementation, validation 산출물을 섞지 않는다.
 
 ## 디렉토리 구조
@@ -38,7 +39,7 @@ scripts/
 tests/
 └── fortran/manifest.json       # Optional no-Abaqus Fortran test manifest
 references/
-└── <feature-id>/<model-id>/    # Optional approved Abaqus reference artifacts
+└── <feature-id>/<model-id>/    # External Abaqus result artifacts for CSV comparison
 phases/
 └── <phase-id>/                 # Optional staged execution plans
 ```
@@ -98,10 +99,17 @@ references/<feature-id>/<model-id>/
 ├── job.msg.tail.txt
 ├── job.dat.tail.txt
 ├── job.log.tail.txt
-└── *.csv
+├── job.sta.tail.txt
+├── result.odb.sha256           # Optional when ODB cannot or should not be stored
+├── extraction/
+│   └── extract_odb_to_csv.py    # Optional provenance copy of user-run extraction script
+└── extracted/
+    └── *.csv
 ```
 
-`metadata.json` schema version은 `abaqus-user-subroutine-artifact-v1`이다. `artifact_status=ready-for-comparison`인 artifact는 Abaqus version, precision, command, compiler vendor/name/version, entry points, source file hashes, input file, output tails, declared CSV files를 모두 가져야 한다.
+`metadata.json` schema version은 `abaqus-user-subroutine-artifact-v1`이다. `artifact_status=ready-for-comparison`인 artifact는 Abaqus version, precision, compiler vendor/name/version, entry points, source file hashes, input file, output tails, ODB extraction provenance, declared CSV files를 모두 가져야 한다.
+
+수치 검증은 ODB 직접 parsing이 아니라 `extracted/*.csv`의 schema/tolerance comparison이다. CSV row는 비교 가능한 최소 식별자로 step, frame/time, instance, node 또는 element label, integration point, section point, output position, component, coordinate system, unit, value를 포함해야 한다. Feature별 interface contract는 필요한 column과 tolerance를 더 좁게 정의한다.
 
 Reference artifacts는 생성 후 검증 입력으로 취급한다. Validation agent는 source code, tests, tolerances, reference artifacts를 임의 수정하지 않는다.
 
@@ -114,10 +122,20 @@ Default workspace validation:
 -> scripts/validate_reference_artifacts.py
 -> scripts/validate_fortran.py
 -> optional CMake/CTest path if CMake project exists
--> optional Abaqus command path only when HARNESS_ABAQUS_VALIDATION=run
 ```
 
-`HARNESS_ABAQUS_VALIDATION=detect`는 Abaqus executable 탐지만 보고한다. `HARNESS_ABAQUS_VALIDATION=run`은 `HARNESS_ABAQUS_VALIDATION_COMMANDS`가 없으면 configuration error로 실패한다.
+Standard numerical validation flow:
+```text
+Fortran subroutine implemented
+-> user-authored model.inp
+-> user runs Abaqus with the subroutine on another PC
+-> user extracts ODB quantities to CSV
+-> user places model.inp, extracted CSV, msg/dat/log/sta tails, and metadata under references/
+-> scripts/validate_reference_artifacts.py checks artifact completeness
+-> comparison tooling checks CSV schema, IDs, units, coordinate systems, and tolerances
+```
+
+Existing Abaqus execution environment variables are treated as legacy/diagnostic script capabilities, not the project validation workflow. New documents and agents should describe solver evidence as externally generated artifacts, not as commands run by this repository.
 
 ## Hook 흐름
 ```text