modify documents

docs/ARCHITECTURE.md

@@ -5,6 +5,8 @@ FESA는 MITC4 Shell 요소 기반 구조해석에서 시작해 비선형 정적
 
 초기 구현은 정확도와 테스트 가능성을 우선한다. 단, 대규모 모델을 목표로 하므로 자유도 관리, 희소 행렬 조립, 선형 솔버, 병렬 실행 계층은 초기부터 성능 확장이 가능하도록 분리한다.
 
+문서 우선순위와 구현 전 준비 기준은 `docs/README.md`를 따른다.
+
 ## 설계 원칙
 - Domain 객체는 입력 모델의 의미를 보존하고 가능한 한 불변에 가깝게 유지한다.
 - 해석 중 변하는 물리량과 반복 상태는 AnalysisState에 명시적으로 분리한다.
@@ -243,6 +245,18 @@ Abaqus input file
 -> 다음 step 진행
 ```
 
+## Phase 1 실행 경계
+Phase 1 solver path는 다음 경계를 구현 단위로 삼는다.
+
+1. `InputParser`는 `docs/ABAQUS_INPUT_SUBSET.md`의 subset만 받아 `Domain`을 만든다.
+2. `DomainValidator` 또는 동등한 검증 계층은 missing reference, unsupported feature, singular-prone model 상태를 조기에 진단한다.
+3. `AnalysisModelBuilder`는 현재 step의 active element/load/boundary/property/material view를 구성한다.
+4. `DofManager`는 6 DOF node model, constrained/free partition, equation numbering, sparse pattern input, full/reduced vector reconstruction을 소유한다.
+5. `Assembler`는 full reaction recovery에 필요한 full-space stiffness/load 정보를 보존하거나 재구성 가능한 형태로 유지한다.
+6. `LinearStaticAnalysis`는 reduced free-DOF system을 풀고 `AnalysisState`에 full `U`, `Fext`, `Fint`, `R`을 갱신한다.
+7. `ResultsWriter`는 `docs/RESULTS_SCHEMA.md`의 최소 Phase 1 outputs를 쓴다.
+8. `ReferenceComparator` 또는 테스트 harness는 `docs/VERIFICATION_PLAN.md`의 reference artifact와 비교한다. 초기 reference 입력은 `references/*.inp`와 Abaqus-exported `references/*_displacements.csv`이다.
+
 ## Phase 1 구현 범위
 - MITC4 Shell 요소
 - 선형 탄성 재료
@@ -257,7 +271,7 @@ Abaqus input file
 - step/frame 기반 결과 저장의 최소 구조
 - double precision과 int64 indexing
 - singular system 진단
-- reference 모델 결과 비교 테스트
+- `references/`의 Abaqus `.inp`와 `*_displacements.csv` 기반 reference 모델 결과 비교 테스트
 
 ## 성능 확장 방향
 - 행렬 조립은 element 단위 병렬화를 고려해 설계한다.
@@ -268,8 +282,9 @@ Abaqus input file
 - 정확도 검증이 끝나기 전에는 MITC4 element formulation을 과도하게 최적화하지 않는다.
 
 ## 상세 설계 문서
+- `docs/README.md`: 문서 index, 우선순위, Phase 1 hard invariants, implementation readiness checklist
 - `docs/NUMERICAL_CONVENTIONS.md`: DOF, 좌표계, 단위, 부호, precision, reaction recovery, singular diagnostics
 - `docs/ABAQUS_INPUT_SUBSET.md`: Phase 1 Abaqus input keyword subset과 unsupported feature
-- `docs/VERIFICATION_PLAN.md`: reference 폴더 구조, benchmark matrix, tolerance 정책
+- `docs/VERIFICATION_PLAN.md`: `references/` 폴더 구조, benchmark matrix, CSV reference result 형식, tolerance 정책
 - `docs/RESULTS_SCHEMA.md`: HDF5 step/frame/field/history schema
 - `docs/MITC4_FORMULATION.md`: MITC4 baseline formulation 계약과 open decisions