docs: align consolidated solver workflow

docs/SOLVER_AGENT_DESIGN.md

@@ -1,415 +1,175 @@
-# 구조해석 솔버 개발 Agent 구성안
+# FESA Solver Agent Design
 
-## 목적
-이 문서는 Abaqus, Nastran과 같은 유한요소법 기반 구조해석 솔버를 개발하기 위한 AI Agent 운영 구성을 정의한다.
+## 목적과 범위
 
-이번 구성안은 ALL-FEM 논문의 구조를 확장하거나 재사용하는 계획이 아니다. 논문은 Agent 설계를 위한 참고 자료로만 사용하며, 본 프로젝트는 C++/MSVC 기반 독립 솔버 개발 워크플로우를 따른다.
+이 문서는 FESA 기능 개발을 조정하는 agent 계층, 8단계 workflow, gate와 산출물 계약을
+정의한다. `coordinator-agent`가 유일한 main agent이며, 나머지 10개 profile은 Coordinator가
+호출하는 sub-agent다. 모든 기능별 agent 산출물은 `docs/<feature-id>/`에 모은다.
 
-## 설계 원칙
-- 기능 요구조건, 이론 정식화, 코드 구현, 검증, 배포 역할을 분리한다.
-- 실행 가능성만으로 성공을 판단하지 않고, 레퍼런스 결과와 물리량을 비교해 기능 완료를 판정한다.
-- 테스트는 구현 전에 준비한다. 개발 대상 솔버 테스트와 레퍼런스 솔버 결과 비교 테스트를 함께 사용한다.
-- Abaqus나 Nastran을 Agent가 직접 실행하지 않는다. 기능이 선언한 기존 `.inp`와 실제
-  비교에 필요한 Abaqus CSV만 read-only 검증 기준으로 사용한다. Canonical naming,
-  README, metadata, version 또는 provenance는 기본 readiness 조건이 아니다.
-- FESA는 Abaqus와 독립적인 solver다. Agent는 Abaqus 내부 formulation, integration,
-  stabilization 또는 recovery equivalence를 요구하거나 추론하지 않는다.
-- 기본 개발 환경은 C++17 이상, MSVC, CMake, CTest이다.
-- 모든 기능은 tolerance 기준을 명시하고, 기준을 만족할 때만 배포 후보가 된다.
-- Harness 운영은 `docs/HARNESS_WORKFLOW.md`의 계획, 독립 Step 실행, PreToolUse/Stop 검증 계층을 따른다.
+이 workflow는 개발 운영 계약이다. Solver C++ 아키텍처, CMake/CTest target, Harness
+executor와 hook, Abaqus reference artifact 또는 승인된 FEM 기능 의미를 바꾸지 않는다.
 
-## Harness Step 실행 계약
+## Agent 계층
 
-계획과 구현 Agent는 작업 전 `docs/HARNESS.md`와 `docs/HARNESS_WORKFLOW.md`를 읽는다.
-Implementation Planning Agent는 multi-Step 초안을 사용자에게 승인받은 뒤 planning files만
-materialize하며 Step을 선택하거나 실행하지 않는다. Executor는 별도의 명시적 사용자 요청으로
-`scripts/execute.py`를 실행할 때 branch, pending Step 선택, retry, timestamps, commits, Step
-advancement와 phase status를 소유한다.
+### Coordinator Agent: main-agent orchestration
 
-Implementation Agent는 approved plan, materialized phase files, Executor-selected current
-`stepN.md`만 사용해 `RED -> observed failure -> minimal GREEN -> focused/full VERIFY`를 완료하고
-다음 Step을 시작하지 않는다. Agent가 쓸 수 있는 Harness metadata는 current Step의 `status`와
-`summary`, `error_message`, `blocked_reason` payload뿐이다. `.codex/hooks.json`이 PreToolUse
-interception과 Stop whole-project validation을 자동 실행하므로 hook entry point를 수동 실행해
-대체하지 않는다. 세부 schema와 recovery 절차는 `docs/HARNESS_WORKFLOW.md`를 따른다.
+Coordinator Agent는 기능 요청을 접수하고 다음 실행 loop를 소유한다.
 
-## 전체 Agent 구성
+```text
+INTAKE -> STATE AUDIT -> WORKLIST UPDATE -> SUB-AGENT DISPATCH
+       -> EVIDENCE CHECK -> GATE DECISION -> STATUS REPORT
+```
 
-### Coordinator Agent
-전체 개발 흐름을 관리하는 상위 조정 Agent이다.
+- `docs/<feature-id>/coordination.md`의 8단계 worklist와 현재 workflow state를 관리한다.
+- 한 번에 다음 유효 단계의 owner만 bounded task로 dispatch한다.
+- 반환된 산출물 경로, status, evidence와 blocker를 검토한 뒤에만 gate를 전환한다.
+- Specialist 판단이나 C++ 구현을 대신하지 않으며, evidence 없이 gate를 통과시키지 않는다.
+- 동일한 normalized failure classification이 두 번 발생하면 자동 재작업을 멈추고
+  `needs-user-decision` 또는 `blocked`로 전환한다.
+- Release evidence가 `ready-for-release`일 때 최종 closure를 기록한다.
 
-책임:
-- 기능 개발 요청을 단계별 작업으로 분해한다.
-- 각 Agent의 산출물을 연결하고 누락된 결정을 추적한다.
-- 요구조건, 정식화, 테스트, 구현, 검증, 배포 단계의 진행 상태를 관리한다.
-- 실패 시 어떤 Agent로 되돌릴지 결정한다.
+Worklist item은 `pending | in-progress | passed | needs-rework | blocked`만 사용한다.
+Sub-agent는 전달받은 단계와 산출물만 처리하며 peer를 호출하거나 다음 단계로 진행하지
+않는다. 완료 시 output paths, status, evidence summary와 blockers를 Coordinator에 반환한다.
 
-주요 산출물:
-- 기능별 개발 계획
-- 단계별 승인 상태
-- 실패 원인과 재작업 지시
+## 10개 sub-agent 역할
 
 ### Requirement Agent
-솔버 기능 요구조건을 정의하는 Agent이다.
 
-책임:
-- 해석 기능의 범위, 입력, 출력, 제약조건을 정의한다.
-- 대상 요소, 재료 모델, 경계조건, 하중 조건, 해석 타입을 명확히 한다.
-- 검증해야 할 물리량과 tolerance 기준을 정한다.
-
-주요 산출물:
-- 기능 요구조건 문서
-- acceptance criteria
-- 검증 물리량 목록
-
-예시 검증 물리량:
-- 절점 변위
-- 반력
-- 요소 내력
-- 응력
-- 변형률
-- 에너지 또는 잔차 기준
+검증 가능한 범위, 제외 범위, `shall` 요구조건, acceptance criteria, verification quantity와
+tolerance baseline을 `requirements.md`에 정의한다.
 
 ### Research Agent
-책, 논문, 매뉴얼, 공개 benchmark를 조사하는 Agent이다.
 
-책임:
-- 유한요소 정식화에 필요한 이론 자료를 수집한다.
-- 요소별 benchmark와 patch test 사례를 찾는다.
-- Abaqus/Nastran 결과와 비교할 수 있는 공개 예제 또는 문헌 해를 조사한다.
-- 자료의 신뢰도와 적용 범위를 평가한다.
-
-주요 산출물:
-- 연구자료 요약
-- 공식, 가정, 한계 정리
-- benchmark 후보 목록
+이론, solver manual, benchmark와 source reliability를 조사하고 확인된 사실과 추론 및
+applicability limit를 `research.md`에 분리해 기록한다.
 
 ### Formulation Agent
-코드 구현을 위한 유한요소 정식화를 작성하는 Agent이다.
 
-책임:
-- 약형, 형상함수, B matrix, constitutive matrix, 수치적분, 요소 강성 행렬을 정의한다.
-- 자유도 배치, 좌표계, 단위계, 부호 규약을 명확히 한다.
-- 선형/비선형, 정적/동적, small/large deformation 여부를 구분한다.
-- 구현 가능한 알고리즘 형태로 정식화를 정리한다.
-
-주요 산출물:
-- 요소별 정식화 문서
-- 알고리즘 의사코드
-- 수치적분 규칙
-- edge case와 singular case 목록
+Strong/weak form, kinematics, constitutive contract, shape functions, element equation, numerical
+integration과 output recovery를 구현 가능한 수치 계약으로 `formulation.md`에 작성한다.
 
 ### Numerical Review Agent
-정식화와 수치 알고리즘을 독립 검토하는 Agent이다.
 
-책임:
-- 수식의 차원, 부호, 좌표 변환, 적분 규칙을 검토한다.
-- rigid body mode, patch test, symmetry, positive definiteness 등 기본 수치 조건을 확인한다.
-- locking, hourglass mode, ill-conditioning 같은 위험을 식별한다.
-- 구현 전 정식화 오류를 줄인다.
-
-주요 산출물:
-- 정식화 리뷰 결과
-- 수치 위험 목록
-- 추가 테스트 요구사항
+독립적인 formulation 검토와 reference readiness를 하나의 merged gate로 소유한다. 차원,
+부호, DOF 순서, 좌표 변환, Jacobian, 적분, 대칭성, rigid-body mode, locking과 검증 위험을
+`numerical-review.md`에 기록한다. 동시에 exact reference input/CSV, blocking/warning quantity,
+source identity/component, row precheck와 승인 tolerance를 `reference-model.md`에 정의한다.
+두 문서가 모두 준비되어야 I/O 단계로 handoff할 수 있다.
 
 ### I/O Definition Agent
-솔버 입력과 출력 데이터 구조를 정의하는 Agent이다.
 
-책임:
-- mesh, node, element, material, section, boundary condition, load, step 입력 형식을 정의한다.
-- authoritative HDF5 result schema와 reference CSV comparison row schema를 정의한다.
-- Abaqus input file과 내부 입력 모델 사이의 대응 관계를 정리한다.
-- 결과 비교를 위해 FESA HDF5 dataset과 Abaqus reference CSV row의 ID/컴포넌트 규약을 맞춘다.
-
-주요 산출물:
-- 입력 데이터 schema
-- 출력 데이터 schema
-- HDF5 result schema
-- 결과 비교용 deterministic CSV view schema
-- 단위와 좌표계 규약
-
-### Reference Model Agent
-TDD와 검증에 사용할 기존 reference case를 inventory하는 Agent이다.
-
-책임:
-- 기능이 요구할 때만 테스트 모델 목적을 구분하고, 기본적으로 기존 case를 사용한다.
-- 기존 reference case의 목적, exact input/required CSV path, blocking/warning quantity와
-  tolerance를 inventory한다.
-- FESA HDF5 quantity와 source ID/component matching을 명시한다.
-- 테스트 모델이 요구조건을 실제로 검증하는지 확인한다.
-
-중요 제약:
-- Agent는 Abaqus를 직접 실행하지 않는다.
-- Abaqus 해석 결과 CSV는 사람이 생성하거나 별도 승인된 절차로 생성해 `reference/<model-id>/`에 저장한다.
-- Agent는 저장된 reference artifact만 사용해 비교한다.
-
-최소 reference case 구조:
-```text
-reference/
-  <case-dir>/
-    <declared-input>.inp
-    <declared-required-quantity>.csv
-```
-
-Directory와 filename은 제공된 값을 그대로 사용한다. Reference Model Agent는 canonical
-이름, README, metadata, provenance 또는 비교하지 않는 quantity CSV를 요구하지 않는다.
+승인된 Abaqus `.inp` subset, semantic model mapping, validation diagnostic, authoritative
+`results.h5` schema와 reference CSV row schema를 `io.md`에 정의한다. Numerical/reference
+gate가 확정한 logical quantity와 source identity를 최종 HDF5 dataset projection 및 CSV
+column mapping으로 연결하는 책임은 이 agent에 있다.
 
 ### Implementation Planning Agent
-코드 구현 전에 작업 단위와 테스트 순서를 설계하는 Agent이다.
 
-책임:
-- 요구조건과 정식화를 C++ 구현 작업으로 분해한다.
-- 먼저 작성할 단위 테스트, 통합 테스트, 레퍼런스 비교 테스트를 정의한다.
-- 기존 architecture와 ownership boundary에 맞춰 변경 파일을 제한한다.
-- 구현 Agent가 따라야 할 acceptance criteria를 제공한다.
-
-주요 산출물:
-- 구현 계획
-- 테스트 우선순위
-- 변경 파일 후보
-- acceptance checklist
-- 사용자 승인 전 multi-Step Harness 초안
-- 승인 후 `phases/index.json`, `phases/<task-name>/index.json`, 자기완결적 `stepN.md`
-
-필수 절차:
-- 구현 계획 요청에서 project-local `$harness` skill을 사용한다.
-- `docs/HARNESS.md`와 `docs/HARNESS_WORKFLOW.md`를 읽고 multi-Step 초안만 사용자에게
-  제시한다.
-- 한 Step은 하나의 layer/module만 다루고 각 Step에 prerequisite file, TDD
-  RED/GREEN/VERIFY, 정확한 MSVC/CMake/CTest command와 금지사항을 포함한다.
-- Step 초안을 먼저 사용자에게 제시한다. 승인 전에는 `phases/` 파일을 생성하지 않는다.
-- 승인 후에는 planning files만 materialize하고 Step 선택/실행은 하지 않는다. Harness executor
-  실행은 별도 사용자 요청이 있을 때만 수행한다.
+승인된 upstream bundle을 자기완결적 TDD Step으로 분해해 `implementation-plan.md`를 만든다.
+계획 요청에서는 project-local `harness`를 사용하고 사용자에게 multi-Step 초안을 먼저
+제시한다. 승인 후에만 phase index와 `stepN.md`를 materialize하며 executor는 별도 명시
+요청이 있을 때만 실행한다.
 
 ### Implementation Agent
-C++ 코드를 구현하는 Agent이다.
 
-책임:
-- `docs/HARNESS.md`, `docs/HARNESS_WORKFLOW.md`, materialized phase files와
-  Executor-selected current `stepN.md`를 읽고 현재 Step만 수행한다.
-- 테스트를 먼저 작성하고 실패를 확인한다.
-- 정식화와 I/O schema에 맞춰 최소 구현을 작성한다.
-- C++17 이상, MSVC, CMake, CTest 환경에서 동작하도록 구현한다.
-- 불필요한 일반화나 speculative abstraction을 피한다.
-- current Step의 `status`와 `summary`, `error_message`, `blocked_reason`만 기록한다.
-  branch, retry, timestamp, commit, advancement는 Executor에 맡긴다.
-- `.codex/hooks.json`으로 자동 등록된 PreToolUse와 Stop을 사용하며 hook script를 수동
-  검증 대체물로 실행하지 않는다.
-
-주요 산출물:
-- C++ source/header 변경
-- 테스트 코드
-- CMake/CTest 변경
-
-### Build/Test Executor Agent
-빌드와 테스트를 실행하는 Agent이다.
-
-책임:
-- `.harness/config.json` 또는 자동 감지 결과에 맞는 MSVC build/test 명령을 실행한다.
-- MSVC x64 Debug CMake configure/build/CTest 결과를 수집한다.
-- 실패 로그를 요약하고 Correction Agent에 전달한다.
-
-기본 CMake 검증 명령:
-```powershell
-cmake -S . -B .harness/build -A x64
-cmake --build .harness/build --config Debug
-ctest --test-dir .harness/build -C Debug --show-only=json-v1
-ctest --test-dir .harness/build -C Debug --output-on-failure
-```
-
-Preset 또는 직접 MSBuild 프로젝트는 `.harness/config.json`에 선언된 명령을 따른다.
-
-검증 대상:
-- CMake configure
-- MSVC Debug build
-- CTest
-- Harness self-test
+승인된 Step 단위로 `RED -> observed failure -> minimal GREEN -> focused VERIFY`를 수행하고,
+full MSVC x64 Debug build/CTest와 reference comparison까지 하나의 Implementation gate에서
+완료한다. `implementation-report.md`, `build-test.md`, `reference-comparison.md`를 각각 남기며
+최종 성공 status는 `pass-for-physics-evaluation`이다.
 
 ### Correction Agent
-빌드, 테스트, 런타임 실패를 수정하는 Agent이다.
 
-책임:
-- 실패 로그를 원인별로 분류한다.
-- 컴파일 오류, 링크 오류, 테스트 실패, 결과 비교 실패를 구분한다.
-- 최소 수정으로 실패를 해결한다.
-- 같은 실패가 반복되면 Coordinator Agent에 차단 상태를 보고한다.
-
-주요 산출물:
-- 수정 패치
-- 실패 원인 요약
-- 재검증 요청
-
-### Reference Verification Agent
-구현 솔버 결과와 저장된 레퍼런스 결과를 비교하는 Agent이다.
-
-책임:
-- 구현 솔버 `results.h5`의 rows와 `reference/<model-id>/`의 Abaqus reference CSV rows를 비교하고, FESA debug CSV views는 row identity 검토와 report evidence로만 사용한다.
-- 절점 변위, 반력, 요소 내력, 응력의 tolerance 만족 여부를 평가한다.
-- absolute tolerance, relative tolerance, norm-based tolerance를 구분해 적용한다.
-- 결과 차이가 tolerance 밖이면 원인 후보를 분류한다.
-
-주요 산출물:
-- reference comparison report
-- 실패한 물리량과 위치
-- 최대 오차, 평균 오차, norm 오차
+정규 단계가 아닌 on-demand rework sub-agent다. 같은 실패가 반복되거나 원인이 불명확할
+때 Coordinator가 호출한다. Upstream 계약을 바꾸지 않고 최소 수정과 재검증을 수행해
+`corrections.md`에 누적하고 Implementation Agent 재실행 요청을 Coordinator에 반환한다.
 
 ### Physics Evaluation Agent
-수치 결과가 물리적으로 타당한지 검토하는 Agent이다.
 
-책임:
-- 레퍼런스와 수치적으로 비슷해도 물리적으로 이상한 결과가 있는지 확인한다.
-- 변위 방향, 반력 평형, 응력 집중, 대칭 조건, rigid body mode를 검토한다.
-- 테스트 모델이 기능을 충분히 검증하지 못하면 추가 모델을 요구한다.
-
-주요 산출물:
-- 물리 검토 결과
-- 추가 검증 모델 요구사항
-- release 가능 여부 의견
+Reference comparison 이후 equilibrium, reaction consistency, displacement direction, symmetry,
+element force balance, stress/strain sanity, rigid-body mode와 model coverage를 검토해
+`physics-evaluation.md`에 기록한다.
 
 ### Release Agent
-기능 배포 준비를 담당하는 Agent이다.
 
-책임:
-- 요구조건, 테스트, 레퍼런스 비교, 물리 검토가 모두 통과했는지 확인한다.
-- 기능 문서와 release note를 정리한다.
-- 알려진 제한사항과 tolerance 기준을 기록한다.
+Requirements부터 physics까지 gate evidence와 acceptance traceability를 audit하고 known
+limitations, release notes draft와 release verdict를 `release.md`에 기록한다. 내부 readiness
+판정은 publish, deploy, package, tag 또는 external release 권한이 아니다.
 
-주요 산출물:
-- release checklist
-- 기능 문서
-- known limitations
+## 8단계 개발 프로세스
 
-## 개발 프로세스 매핑
+| 단계 | 담당 sub-agent | 필수 skill | `docs/<feature-id>/` 산출물 | 통과 조건 |
+| --- | --- | --- | --- | --- |
+| 1. 요구조건 | `requirement-agent` | `fesa-requirements-baseline` | `requirements.md` | 승인 범위, acceptance criteria, 검증량과 tolerance가 명확함 |
+| 2. 연구 | `research-agent` | `fesa-research-evidence`, 필요 시 `fem-theory-query` | `research.md` | 이론과 검증 evidence 및 적용 한계가 충분함 |
+| 3. 정식화 | `formulation-agent` | `fesa-formulation-spec` | `formulation.md` | 구현 가능한 수치 계약이 완성됨 |
+| 4. 수치 검토 + reference model 계약 | `numerical-review-agent` | `fesa-numerical-review` | `numerical-review.md`, `reference-model.md` | 두 문서가 함께 `pass-for-io-definition`임 |
+| 5. I/O 정의 | `io-definition-agent` | `fesa-io-contract` | `io.md` | Logical reference identity가 최종 HDF5 projection과 연결됨 |
+| 6. 구현 계획 + C++ 구현 + build/test + reference comparison | `implementation-planning-agent`, `implementation-agent` | `fesa-cpp-msvc-tdd`, 계획 시 project-local `harness` | `implementation-plan.md`, `implementation-report.md`, `build-test.md`, `reference-comparison.md` | TDD, full MSVC/CTest와 blocking reference comparison이 모두 통과함 |
+| 7. 물리 검토 | `physics-evaluation-agent` | `fesa-physics-sanity` | `physics-evaluation.md` | 물리 검토가 `pass-for-release-agent`임 |
+| 8. 배포 준비 | `release-agent` | `fesa-release-readiness` | `release.md` | `ready-for-release`이며 Coordinator가 closure를 기록함 |
 
-| 개발 과정 | 담당 Agent | 필수 산출물 |
-| --- | --- | --- |
-| 1. 솔버 기능 요구조건 정의 | Requirement Agent | 요구조건, acceptance criteria |
-| 2. 연구자료 조사 | Research Agent | 자료 요약, benchmark 후보 |
-| 3. 유한요소 정식화 | Formulation Agent, Numerical Review Agent | 정식화 문서, 리뷰 결과 |
-| 4. 입출력 데이터 정의 | I/O Definition Agent | 입력/출력 schema |
-| 5. Reference case 준비 | Reference Model Agent, Implementation Planning Agent | 기존 input/required CSV inventory, 비교 mapping, tolerance |
-| 6. 코드 구현 | Implementation Agent | C++ 코드, 테스트 |
-| 7. 레퍼런스 결과 비교 검증 | Reference Verification Agent, Physics Evaluation Agent | 비교 리포트, 물리 검토 |
-| 8. tolerance 만족 시 완료 | Coordinator Agent | 기능 완료 승인 |
-| 9. 기능 배포 | Release Agent | release checklist, 문서 |
-
-## 표준 작업 흐름
+## 8단계 workflow
 
 ```mermaid
 flowchart TD
-  A["기능 요청"] --> B["Requirement Agent"]
-  B --> C["Research Agent"]
-  C --> D["Formulation Agent"]
-  D --> E["Numerical Review Agent"]
-  E --> F["I/O Definition Agent"]
-  F --> G["Reference Model Agent"]
-  G --> H["Implementation Planning Agent"]
-  H --> I["Implementation Agent"]
-  I --> J["Build/Test Executor Agent"]
-  J --> K{"빌드/테스트 통과?"}
-  K -- "아니오" --> L["Correction Agent"]
-  L --> I
-  K -- "예" --> M["Reference Verification Agent"]
-  M --> N{"tolerance 만족?"}
-  N -- "아니오" --> L
-  N -- "예" --> P["Physics Evaluation Agent"]
-  P --> Q{"물리 검토 통과?"}
-  Q -- "아니오" --> L
-  Q -- "예" --> R["Release Agent"]
+  C["Coordinator: intake 및 worklist"] --> RQ["1. Requirement Agent"]
+  RQ --> RS["2. Research Agent"]
+  RS --> FM["3. Formulation Agent"]
+  FM --> NR["4. Numerical Review Agent<br/>numerical + reference gate"]
+  NR --> IO["5. I/O Definition Agent<br/>final HDF5 projection"]
+  IO --> IP["6. Implementation Planning Agent"]
+  IP --> IM["6. Implementation Agent<br/>TDD + MSVC/CTest + reference comparison"]
+  IM --> OK{"Implementation gate pass?"}
+  OK -- "yes" --> PH["7. Physics Evaluation Agent"]
+  OK -- "repeated or unclear failure" --> CR["Correction Agent<br/>on-demand rework"]
+  CR --> IM
+  PH --> RL["8. Release Agent"]
+  RL --> CL["Coordinator: closure"]
 ```
 
-## 검증 Gate
+Compile, link, ordinary test와 명확한 implementation-owned mismatch는 Implementation Agent가
+먼저 수정한다. 반복되거나 불명확한 실패만 Correction loop로 보낸다. Upstream contract
+gap은 Coordinator가 해당 owner 단계로 되돌린다.
 
-### Gate 1: 요구조건 승인
-통과 조건:
-- 대상 기능과 제외 범위가 명확하다.
-- 입력, 출력, tolerance, 검증 물리량이 정의되어 있다.
-- 레퍼런스 비교 방식이 정해져 있다.
+## Gate 계약
 
-### Gate 2: 정식화 승인
-통과 조건:
-- 요소 정식화와 수치적분 규칙이 문서화되어 있다.
-- 좌표계, 자유도, 부호 규약이 명확하다.
-- Numerical Review Agent가 주요 수치 위험을 검토했다.
+1. Requirements gate: `requirements.md`가 범위, acceptance criteria, 검증량과 tolerance를
+   고정한다.
+2. Research gate: `research.md`가 필요한 이론, benchmark와 applicability evidence를 제공한다.
+3. Formulation gate: `formulation.md`가 구현 가능한 수치 계약을 제공한다.
+4. Numerical/reference merged gate: `numerical-review.md`와 `reference-model.md`가 함께 통과한다.
+5. I/O gate: `io.md`가 source identity와 logical quantity를 authoritative `results.h5` dataset,
+   units, coordinates, component와 CSV column에 최종 투영한다.
+6. Implementation gate: 승인 계획, RED/GREEN/VERIFY evidence, full MSVC x64 Debug build/CTest,
+   deterministic row precheck와 blocking/warning reference comparison이 모두 통과한다.
+7. Physics gate: `physics-evaluation.md`가 `pass-for-release-agent`다.
+8. Release gate: `release.md`가 `ready-for-release`이고 Coordinator가 closure를 기록한다.
 
-### Gate 3: 테스트 준비 승인
-통과 조건:
-- 구현 전 실패해야 하는 테스트가 정의되어 있다.
-- 기능이 요구하는 기존 input/CSV pair와 blocking/warning quantity가 명확하다.
-- 필요한 source ID/component matching과 tolerance가 정의되어 있다.
+Reference comparison은 source identity와 component로 행을 결정적으로 대응시키며 missing,
+extra, duplicate 또는 nonfinite required row를 tolerance 전에 거부한다. CSV는 외부 reference이고
+FESA의 authoritative output은 `results.h5`다.
 
-### Gate 4: 구현 검증
-통과 조건:
-- CMake/MSVC/CTest validation이 통과한다.
-- 단위 테스트와 통합 테스트가 통과한다.
-- 관련 C++ test file이 있고 같은 구현 Step 안에 RED 실패와 후속 GREEN 성공 증거가 있다.
-- Stop의 전체 MSVC build/test 검증이 통과한다.
+## 요구사항 단위 산출물 구조
 
-### Gate 5: 레퍼런스 검증
-통과 조건:
-- 기능이 blocking으로 선언한 Abaqus CSV quantity와 구현 solver HDF5 quantity가
-  tolerance 안에 있다.
-- Warning-only quantity는 결과와 경고가 리포트에 남고 pass/fail을 바꾸지 않는다.
-- Required source row/component의 누락, 추가, 중복 또는 nonfinite 값이 없다.
+```text
+docs/<feature-id>/
+├── coordination.md
+├── requirements.md
+├── research.md
+├── formulation.md
+├── numerical-review.md
+├── reference-model.md
+├── io.md
+├── implementation-plan.md
+├── implementation-report.md
+├── build-test.md
+├── reference-comparison.md
+├── corrections.md
+├── physics-evaluation.md
+└── release.md
+```
 
-### Gate 6: 배포 승인
-통과 조건:
-- 요구조건의 acceptance criteria가 모두 만족된다.
-- 문서와 release note가 준비되어 있다.
-- 남은 제한사항이 명확히 기록되어 있다.
-
-## FESA HDF5 / Abaqus Reference CSV 비교 기준
-
-권장 비교 방식:
-- authoritative 비교는 FESA `results.h5` rows와 Abaqus reference CSV rows 기준으로 수행한다.
-- FESA HDF5에서 추출한 deterministic CSV view는 debugging/review 보조 artifact로만 사용한다.
-- scalar 값: absolute tolerance와 relative tolerance를 함께 적용한다.
-- vector 값: component-wise 비교와 norm 비교를 함께 기록한다.
-- stress tensor: component-wise 비교를 기본으로 하고, 필요한 경우 principal stress 또는 von Mises stress를 추가 비교한다.
-- 반력: 전체 하중 평형과 개별 구속 자유도 반력을 모두 확인한다.
-
-권장 리포트 항목:
-- model name
-- compared quantity
-- number of compared rows
-- maximum absolute error
-- maximum relative error
-- RMS error
-- worst node or element id
-- pass/fail
-
-## 반복 실패 처리
-
-반복 실패가 발생하면 Correction Agent가 무한 수정 루프를 계속하지 않는다. 다음 중 하나로 분류해 Coordinator Agent에 보고한다.
-
-- 요구조건 불명확
-- 정식화 오류 가능성
-- reference artifact 오류 가능성
-- I/O schema 불일치
-- 구현 결함
-- tolerance 기준 부적절
-- 테스트 모델이 기능을 과도하게 또는 불충분하게 검증함
-
-Coordinator Agent는 분류 결과에 따라 Requirement, Formulation, I/O Definition, Reference Model, Implementation Agent 중 적절한 단계로 되돌린다.
-
-## 초기 적용 우선순위
-
-1. 선형 정적 해석의 최소 골격
-2. Isoparametric 3D Euler beam element
-3. 1D truss 또는 bar element
-4. 2D plane stress/plane strain element
-5. 3D solid element
-6. material model 확장
-7. nonlinear 또는 dynamic analysis 확장
-
-각 단계는 요구조건, 정식화, 테스트모델, 구현, 레퍼런스 비교, 배포 Gate를 독립적으로 통과해야 한다.
-
-## 운영 메모
-
-- Agent 산출물은 가능한 한 문서, 테스트, 비교 리포트 형태로 남긴다.
-- 사람이 제공한 Abaqus reference artifact는 현재 path/name 그대로 read-only로 사용한다.
-  별도 provenance, README 또는 metadata가 없다는 이유로 gate를 차단하지 않는다.
-- reference artifact가 바뀌면 기능 구현 변경과 같은 수준으로 검토한다.
-- 기능 구현 완료 판정은 build/test와 기능별 blocking reference validation 통과를 기준으로
-  한다. Physics evaluation과 release readiness는 별도 후속 배포 gate다.
+산출물이 필요하지 않았거나 기존 workflow에 없었던 경우 placeholder를 만들지 않는다.
+`corrections.md`는 실제 on-demand correction이 발생했을 때만 생성한다. Reference input/CSV는
+현재 path와 name 그대로 read-only로 사용하고, 문서 정리를 위해 rename 또는 보정하지 않는다.

docs/SOLVER_SKILL_DESIGN.md

@@ -1,204 +1,193 @@
-# FESA Solver Skill Rebuild Plan
+# FESA Solver Skill Design
 
 ## 목적
 
-이 문서는 FESA 유한요소 기반 구조해석 솔버 개발에 사용할 project-local Codex skill 구성을 정의한다.
+이 문서는 FESA의 8단계 feature workflow에서 사용하는 project-local skill 구성을 정의한다.
+Agent는 역할과 책임 단위이고 skill은 여러 agent가 재사용하는 절차, 품질 gate와 handoff
+단위다. 모든 feature별 skill output은 `docs/<feature-id>/`에 기록한다.
 
-Agent는 역할과 책임 단위이고, skill은 여러 Agent가 반복적으로 사용하는 절차와 검증 도구 단위다. 따라서 skill은 Agent와 1:1로 대응하지 않는다. 대신 요구조건, 연구, 정식화, I/O 계약, reference model, C++ TDD 구현, reference 비교, 물리 검토, release readiness처럼 솔버 개발 과정에서 반복되는 작업 흐름을 기준으로 구성한다.
+실제 실행 지침의 source of truth는 각 `.codex/skills/<skill-name>/SKILL.md`다. 이 문서는
+skill inventory와 책임 분리를 사람이 읽을 수 있게 설명한다.
 
 ## 설계 원칙
 
-- Skill은 `.codex/skills/<skill-name>/SKILL.md`에 둔다.
-- 각 skill은 필수 frontmatter `name`, `description`과 UI metadata `agents/openai.yaml`을 가진다.
-- Skill 본문은 agent TOML의 역할 설명을 반복하지 않고, 입력, 절차, 산출물, 금지사항, 품질 gate, handoff를 정의한다.
-- Skill은 `AGENTS.md`와 `docs/SOLVER_AGENT_DESIGN.md`를 공통 상위 기준으로 읽는다.
-- Abaqus, Nastran 또는 reference solver 실행은 skill 범위에 포함하지 않는다.
-- Abaqus reference CSV 파일 생성/수정은 skill 범위에 포함하지 않는다.
-- C++ 구현 관련 skill은 C++17 이상, MSVC, CMake, CTest, TDD 원칙을 따른다.
-- C++ 검증 명령은 `.harness/config.json` 또는 `docs/HARNESS.md`의 자동 감지 기본값을 따른다.
-- Harness Python 변경은 `uv run --with pytest python -m pytest -v -rs`로 검증한다.
+- 각 skill은 `SKILL.md`의 `name`, `description` frontmatter와 `agents/openai.yaml` UI metadata를
+  가진다.
+- Skill은 입력, workflow, output contract, boundaries, quality gate와 handoff를 정의한다.
+- 공통 상위 계약은 `AGENTS.md`와 `docs/SOLVER_AGENT_DESIGN.md`다.
+- Abaqus, Nastran 또는 다른 reference solver 실행과 reference CSV 생성/수정은 skill 범위가
+  아니다.
+- C++ 절차는 C++17 이상, MSVC x64 Debug, CMake/CTest와 TDD를 따른다.
+- 검증 명령은 `.harness/config.json`을 우선하고 없으면 `docs/HARNESS.md`의 자동 감지
+  기본값을 따른다.
+- Skill output path에는 agent별 폴더를 만들지 않고 `docs/<feature-id>/`만 사용한다.
 
-## Skill 구성
+## 8개 workflow skill
 
-| Skill | 적용 개발 과정 | 주요 사용자 Agent | 대표 산출물 |
+| Skill | 8단계 적용 과정 | 주요 사용자 sub-agent | `docs/<feature-id>/` 대표 산출물 |
 | --- | --- | --- | --- |
-| `fesa-requirements-baseline` | 1. 솔버 기능 요구조건 정의 | Requirement Agent, Coordinator Agent | `docs/requirements/<feature-id>.md` |
-| `fesa-research-evidence` | 2. 책, 논문 등 연구자료 조사 | Research Agent, Formulation Agent | `docs/research/<feature-id>-research.md` |
-| `fesa-formulation-spec` | 3. 코드 구현을 위한 유한요소 정식화 | Formulation Agent, Implementation Planning Agent | `docs/formulations/<feature-id>-formulation.md` |
-| `fesa-numerical-review` | 3. 정식화 독립 수치 검토 | Numerical Review Agent, Coordinator Agent | `docs/numerical-reviews/<feature-id>-review.md` |
-| `fesa-io-contract` | 4. 솔버 입출력 데이터 정의 | I/O Definition Agent, Reference Verification Agent | `docs/io-definitions/<feature-id>-io.md` |
-| `fesa-reference-models` | 5. TDD/reference 테스트모델 작성 | Reference Model Agent, Implementation Planning Agent | `docs/reference-models/<feature-id>-reference-models.md` |
-| `fesa-cpp-msvc-tdd` | 6. 코드 구현 및 build/test correction | Implementation Planning Agent, Implementation Agent, Build/Test Executor Agent, Correction Agent | implementation plan/report, build/test report, correction report |
-| `fesa-reference-comparison` | 7. reference solver 결과와 구현 solver 결과 비교 | Reference Verification Agent | `docs/reference-verifications/<feature-id>-reference-verification.md` |
-| `fesa-physics-sanity` | 8. tolerance 통과 후 물리 타당성 검토 | Physics Evaluation Agent | `docs/physics-evaluations/<feature-id>-physics-evaluation.md` |
-| `fesa-release-readiness` | 9. 솔버 기능 배포 준비 | Release Agent, Coordinator Agent | `docs/releases/<feature-id>-release.md` |
+| `fesa-requirements-baseline` | 1. 요구조건 | Requirement Agent | `requirements.md` |
+| `fesa-research-evidence` | 2. 연구 | Research Agent | `research.md` |
+| `fesa-formulation-spec` | 3. 정식화 | Formulation Agent | `formulation.md` |
+| `fesa-numerical-review` | 4. 수치 검토 + reference readiness | Numerical Review Agent | `numerical-review.md`, `reference-model.md` |
+| `fesa-io-contract` | 5. I/O 정의 | I/O Definition Agent | `io.md` |
+| `fesa-cpp-msvc-tdd` | 6. 구현 계획 + C++ 구현 + build/test + reference comparison | Implementation Planning Agent, Implementation Agent, Correction Agent | `implementation-plan.md`, `implementation-report.md`, `build-test.md`, `reference-comparison.md`, 필요 시 `corrections.md` |
+| `fesa-physics-sanity` | 7. 물리 검토 | Physics Evaluation Agent | `physics-evaluation.md` |
+| `fesa-release-readiness` | 8. 배포 준비 | Release Agent | `release.md` |
 
-## 개발 과정별 사용 예
-
-예시 기능: `isoparametric-3d-euler-beam`
-
-1. Requirement Agent는 `fesa-requirements-baseline`을 사용해 기능 범위, 제외 범위, 입력, 출력, 검증 물리량, tolerance, `Requirement Verification Matrix`를 작성한다.
-2. Research Agent는 `fesa-research-evidence`를 사용해 3D Euler beam 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, `results.h5` schema, reference CSV comparison row schema를 정의한다.
-6. Reference Model Agent는 `fesa-reference-models`를 사용해 기존 input/required CSV
-   reference-case inventory와 비교 mapping을 작성한다.
-7. Implementation Planning Agent는 먼저 project-local `harness`를 사용해 사용자 승인용
-   multi-Step 초안을 만들고, 승인 후 phase files를 생성한다. 그 뒤 Implementation Agent와
-   함께 `fesa-cpp-msvc-tdd` 계약에 따라 RED/GREEN/VERIFY를 수행한다.
-8. Reference Verification Agent는 `fesa-reference-comparison`을 사용해 구현 solver `results.h5` rows와 Abaqus reference CSV rows를 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를 작성한다.
+통합 후 FESA workflow skill은 위 8개가 전부다.
 
 ## Skill별 핵심 계약
 
 ### `fesa-requirements-baseline`
 
-- 기능 요청을 검증 가능한 요구조건 baseline으로 만든다.
+- 기능 요청을 검증 가능한 baseline으로 만든다.
 - `shall` 문장과 `FESA-REQ-<FEATURE>-###` id를 사용한다.
-- 모든 `must` 요구조건은 verification method와 acceptance criteria를 가져야 한다.
-- FEM 정식화, C++ 구현, Abaqus reference CSV 생성 또는 수정, release readiness 판단은 하지 않는다.
+- 모든 `must` 요구조건에 verification method와 acceptance criteria를 연결한다.
+- FEM 정식화, C++ 구현, reference value 생성 또는 release 판정은 하지 않는다.
 
 ### `fesa-research-evidence`
 
-- 연구 질문, source inventory, source reliability tier, benchmark 후보를 정리한다.
-- 검증된 사실과 추론을 분리한다.
-- source gap은 open issue로 남긴다.
-- FEM 정식화 확정이나 reference value 생성을 하지 않는다.
+- Research question, source inventory, reliability tier, benchmark 후보와 applicability limit를
+  정리한다.
+- 검증된 사실과 추론을 분리하고 source gap은 open issue로 남긴다.
+- FEM 정식화나 reference value를 확정하지 않는다.
 
 ### `fesa-formulation-spec`
 
-- strong form, weak form, discretization, kinematics, constitutive contract, element equations를 구분해 작성한다.
-- Jacobian, derivative transform, numerical integration, output recovery, numerical risks를 명시한다.
-- C++ API, parser, file ownership은 설계하지 않는다.
-- Numerical Review Agent 검토 전 최종 승인 상태로 두지 않는다.
+- Strong form, weak form, discretization, kinematics, constitutive contract와 element equation을
+  구분한다.
+- Jacobian, derivative transform, numerical integration, output recovery와 numerical risk를
+  명시한다.
+- C++ API, parser ownership 또는 file layout을 설계하지 않는다.
+- Numerical Review 전에는 최종 구현 승인 상태로 두지 않는다.
 
 ### `fesa-numerical-review`
 
-- 정식화를 수치 알고리즘 계약으로 독립 검토한다.
-- dimensions, signs, DOF ordering, coordinate transforms, Jacobian, integration rule, stiffness symmetry, rigid body modes, patch test, hourglass, locking을 확인한다.
-- `pass-for-implementation-planning`은 구현 계획 가능 상태만 의미한다.
-- 정식화 문서를 직접 수정하지 않는다.
-- 이후 Reference Model 문서, artifact naming, README, metadata, provenance 또는 portfolio가
-  없다는 이유로 formulation verdict를 실패시키지 않는다.
+이 skill은 numerical correctness와 reference readiness 절차를 함께 소유한다.
+
+```text
+FORMULATION REVIEW -> REFERENCE CASE INVENTORY -> CLASSIFY -> REPORT -> I/O HANDOFF
+```
+
+- Dimensions, signs, DOF order, coordinate transform, Jacobian, integration, stiffness symmetry,
+  rigid-body mode, patch test, hourglass와 locking을 독립 검토한다.
+- 기존 exact input/required CSV를 inventory하고 blocking/warning quantity, source identity와
+  component matching, missing/extra/duplicate/nonfinite row precheck와 승인 tolerance를 정한다.
+- `numerical-review.md`와 `reference-model.md`를 함께 산출한다.
+- Logical quantity와 source identity까지만 정의한다. 최종 HDF5 dataset projection은 I/O
+  Definition Agent에 handoff한다.
+- 두 문서가 준비된 `pass-for-io-definition`만 다음 단계 진행을 허용한다.
 
 ### `fesa-io-contract`
 
-- FESA solver input이 지원할 Abaqus `.inp` subset을 정의한다.
-- model data와 history data를 구분한다.
-- 내부 semantic model 계약, HDF5 output schema, reference CSV comparison row schema를 정의한다.
-- parser 구현이나 full Abaqus compatibility claim은 하지 않는다.
-
-### `fesa-reference-models`
-
-- 기능이 실제로 사용하는 기존 reference case를 inventory한다.
-- Exact input/required CSV path, case purpose, blocking/warning quantity, HDF5 projection,
-  source ID/component matching과 tolerance만 정의한다.
-- Required comparison file이 없을 때만 `needs-reference-artifacts`로 둔다. Canonical naming,
-  README, metadata, provenance와 비교하지 않는 quantity CSV는 요구하지 않는다.
+- 지원할 Abaqus `.inp` keyword subset, semantic model mapping과 validation rule을 정의한다.
+- Authoritative `results.h5` schema, units, coordinates, step/frame, row identity와 component를
+  정의한다.
+- Reference readiness의 logical quantity/source identity를 최종 HDF5 dataset projection과
+  CSV column mapping으로 연결한다.
+- Parser 구현이나 full Abaqus compatibility를 주장하지 않는다.
 
 ### `fesa-cpp-msvc-tdd`
 
-- C++ 구현을 `RED -> GREEN -> VERIFY` 순서로 수행한다.
-- C++ production 변경에는 관련 C++ test file이 있어야 한다.
-- 기본 검증 명령:
+이 skill은 implementation planning, TDD implementation, MSVC validation, failure correction과
+reference comparison 절차를 함께 소유한다.
+
+```text
+RED -> OBSERVED FAILURE -> MINIMAL GREEN -> FOCUSED VERIFY
+    -> FULL MSVC BUILD/CTEST -> ARTIFACT CHECK
+    -> COMPARE -> CLASSIFY -> REPORT
+```
+
+- Planning 시 project-local `harness`로 user-approved multi-Step plan을 만들고
+  `implementation-plan.md`를 산출한다.
+- C++ production 변경에는 관련 C++ test가 있어야 하며 targeted RED와 후속 GREEN evidence를
+  기록한다.
+- `.harness/config.json`이 선택한 MSVC x64 Debug build/CTest를 실행하고 명령, exit code,
+  duration, output tail과 failure classification을 `build-test.md`에 기록한다.
+- Reference artifact check 뒤 HDF5/CSV row를 source identity와 component로 대응시킨다.
+  Missing, extra, duplicate와 nonfinite required row는 tolerance 전에 실패하며 warning-only
+  quantity는 blocking result를 바꾸지 않는다.
+- Implementation-owned 실패를 먼저 수정한다. 반복되거나 불명확한 실패는 Coordinator를
+  통해 Correction Agent로 보내고 `corrections.md`에 재작업 evidence를 남긴다.
+- 성공 시 `implementation-report.md`, `build-test.md`, `reference-comparison.md`와
+  `pass-for-physics-evaluation` handoff를 반환한다.
+- Requirements, formulation, numerical/reference 계약, I/O 계약, reference artifact 또는
+  tolerance policy를 변경해 결과를 맞추지 않는다.
+
+기본 validation sequence는 다음과 같다.
 
 ```powershell
 cmake -S . -B .harness/build -A x64
 cmake --build .harness/build --config Debug
 ctest --test-dir .harness/build -C Debug -R <feature-or-label> --output-on-failure
+ctest --test-dir .harness/build -C Debug --show-only=json-v1
 ctest --test-dir .harness/build -C Debug --output-on-failure
 ```
 
-Preset 또는 직접 MSBuild 프로젝트는 `.harness/config.json`의 설정을 사용한다. Harness
-Python, Hook, agent config를 변경한 경우에는 다음 명령도 실행한다.
-
-```powershell
-uv run --with pytest python -m pytest -v -rs
-```
-
-- 실패는 `configure | compile | link | test | reference-comparison | harness | environment | upstream-contract`로 분류한다.
-- 요구조건, 정식화, I/O 계약, reference artifact, tolerance policy를 바꾸지 않는다.
-
-### project-local `harness`
-
-- Implementation Planning Agent가 구현 요청을 여러 독립 Step으로 분해할 때 사용한다.
-- 한 Step은 하나의 layer/module만 소유하고 prerequisite file, TDD RED/GREEN/VERIFY,
-  exact acceptance command와 구체적 금지사항을 포함한다.
-- 사용자에게 Step 초안을 먼저 제시한다. 승인 후에만 `phases/index.json`,
-  `phases/<task-name>/index.json`, `phases/<task-name>/stepN.md`를 생성한다.
-- 계획 작성과 executor 실행을 구분하며, `scripts/execute.py`는 별도 사용자 요청 없이
-  실행하지 않는다.
-
-### `fesa-reference-comparison`
-
-- `ARTIFACT CHECK -> COMPARE -> CLASSIFY -> REPORT` 순서로 수행한다.
-- 선언된 input, required Abaqus CSV, `results.h5`, source ID/component mapping과 tolerance를
-  확인한다. Missing/extra/duplicate/nonfinite required row는 비교 전에 실패한다.
-- max absolute error, max relative error, RMS error, norm error, missing rows, extra rows를 보고한다.
-- Reference pass는 physics validation이나 release readiness를 의미하지 않는다.
-
 ### `fesa-physics-sanity`
 
-- Reference comparison 통과 후 물리 타당성을 검토한다.
-- global equilibrium, reaction consistency, displacement direction, symmetry, element force balance, stress/strain sanity, rigid body mode, model coverage를 확인한다.
+- Implementation gate 통과 후 equilibrium, reaction consistency, displacement direction,
+  symmetry, element force balance, stress/strain sanity, rigid-body mode와 model coverage를
+  검토한다.
 - 문서화된 물리 기대값이 없으면 pass를 선언하지 않는다.
 - `pass-for-release-agent`는 Release Agent 검토 가능 상태만 의미한다.
 
 ### `fesa-release-readiness`
 
-- `GATE AUDIT -> TRACEABILITY CHECK -> RELEASE DOCUMENTATION -> RELEASE VERDICT` 순서로 수행한다.
-- `pass-for-reference-verification`, `pass-for-physics-evaluation`, `pass-for-release-agent` evidence를 요구한다.
-- Known Limitations와 Release Notes Draft를 작성한다.
-- 사용자 명시 요청 없이 publish, deploy, package, tag, commit, external release를 수행하지 않는다.
+- `GATE AUDIT -> TRACEABILITY CHECK -> RELEASE DOCUMENTATION -> RELEASE VERDICT` 순서를 따른다.
+- Requirements부터 physics까지 동일 feature evidence와 필수 pass status를 확인한다.
+- Known limitations, Release Notes Draft와 `ready-for-release` 여부를 기록한다.
+- 사용자 요청 없이 publish, deploy, package, tag, commit 또는 external release를 수행하지
+  않는다.
 
-## Agent와 Skill 관계
+## Supporting skills
 
-| Agent | 주로 사용하는 Skill |
+다음은 8개 workflow skill 수에 포함하지 않는 supporting skill이다.
+
+- `fem-theory-query`: FEM wiki의 이론, benchmark, solver manual과 verification evidence 조회.
+- project-local `harness`: Implementation Planning의 Step 초안, 사용자 승인 후 phase
+  materialization과 별도 요청에 의한 executor 실행.
+- `review`: AGENTS, architecture, tests와 build requirement에 대한 repository change review.
+
+Implementation Planning Agent는 project-local `harness`를 반드시 사용한다. 사용자에게
+자기완결적 Step 초안을 먼저 제시하고 승인 후에만 `phases/index.json`,
+`phases/<task-name>/index.json`, `phases/<task-name>/stepN.md`를 생성한다. `scripts/execute.py`는
+별도 사용자 요청 없이 실행하지 않는다.
+
+## Agent와 skill 관계
+
+| Agent | 주로 사용하는 skill |
 | --- | --- |
-| Coordinator Agent | `fesa-requirements-baseline`, `fesa-reference-models`, `fesa-release-readiness` |
+| Coordinator Agent | 단계 owner가 반환한 skill evidence를 audit하고 dispatch/closure 관리 |
 | Requirement Agent | `fesa-requirements-baseline` |
-| Research Agent | `fesa-research-evidence` |
+| Research Agent | `fesa-research-evidence`, 필요 시 `fem-theory-query` |
 | Formulation Agent | `fesa-formulation-spec` |
-| Numerical Review Agent | `fesa-numerical-review` |
+| Numerical Review Agent | `fesa-numerical-review`, 필요 시 `fem-theory-query` |
 | I/O Definition Agent | `fesa-io-contract` |
-| Reference Model Agent | `fesa-reference-models` |
-| Implementation Planning Agent | project-local `harness`, `fesa-formulation-spec`, `fesa-reference-models`, `fesa-cpp-msvc-tdd` |
+| Implementation Planning Agent | project-local `harness`, `fesa-cpp-msvc-tdd` |
 | Implementation Agent | `fesa-cpp-msvc-tdd` |
-| Build/Test Executor Agent | `fesa-cpp-msvc-tdd` |
 | Correction Agent | `fesa-cpp-msvc-tdd` |
-| Reference Verification Agent | `fesa-reference-comparison`, `fesa-io-contract` |
 | Physics Evaluation Agent | `fesa-physics-sanity` |
 | Release Agent | `fesa-release-readiness` |
 
 ## 검증 기준
 
-Skill 구성은 실제 `.codex/skills/` 파일을 source of truth로 삼아 정적 계약과 repository
-pytest suite로 검증한다.
+Skill 구성은 실제 `.codex/skills/` 파일과 repository pytest suite를 기준으로 검증한다.
 
-검증 항목:
-
-- 10개 solver skill의 `SKILL.md` 존재 여부
+- 8개 FESA workflow skill의 `SKILL.md` 존재 여부
 - YAML frontmatter의 `name`, `description`
-- 공통 섹션: `Inputs`, `Workflow`, `Output Contract`, `Boundaries`, `Quality Gate`, `Handoff`
+- 공통 section: `Inputs`, `Workflow`, `Output Contract`, `Boundaries`, `Quality Gate`, `Handoff`
 - `AGENTS.md`와 `docs/SOLVER_AGENT_DESIGN.md` 참조
-- skill-specific 핵심 문구와 산출물 경로
-- `agents/openai.yaml` UI metadata
-- 이 문서가 아니라 실제 skill 파일이 기준이 되도록 `docs/SOLVER_SKILL_DESIGN.md`에 대한 skill 본문 참조 금지
+- Skill-specific procedure와 `docs/<feature-id>/` output contract
+- `agents/openai.yaml` UI metadata와 skill name reference
+- TOML 및 YAML metadata parseability
 
-검증 명령:
+Repository validation은 다음 명령을 사용한다.
 
 ```powershell
 uv run --with pytest python -m pytest -v -rs
 ```
 
-개별 skill schema를 점검할 때는 현재 Codex 설치에 포함된 `skill-creator` validator를
-사용하되 사용자 홈을 하드코딩한 경로를 프로젝트 계약으로 두지 않는다.
-
-## v1 범위
-
-- v1은 `SKILL.md`와 `agents/openai.yaml`만 포함한다.
-- 별도 `scripts/`, `references/`, `assets/`는 만들지 않는다.
-- 반복 사용 중 절차가 안정화되면 deterministic comparison script, reference artifact template, report template 같은 resource를 별도 후속 작업으로 분리한다.
-- 이 문서는 skill 구성을 설명하는 계획 문서이며, 실제 실행 지침의 source of truth는 각 `.codex/skills/<skill-name>/SKILL.md`이다.
+개별 skill schema는 현재 Codex 설치의 `skill-creator` validator로 점검하되 사용자 홈의
+절대 경로를 프로젝트 계약으로 두지 않는다.

docs/linear-static-3d-euler-beam/build-test.md

@@ -4,8 +4,8 @@
 
 - feature_id: `linear-static-3d-euler-beam`
 - source_commit: `400db191ce9f766ca6b34e5b609eaa13c54ccfa3`
-- source_implementation_report: `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`
-- source_implementation_plan: `docs/implementation-plans/linear-static-3d-euler-beam.md`
+- source_implementation_report: `docs/linear-static-3d-euler-beam/implementation-report.md`
+- source_implementation_plan: `docs/linear-static-3d-euler-beam/implementation-plan.md`
 - status: `pass-for-reference-verification`
 - owner_agent: `build-test-executor-agent`
 - date: `2026-08-09`

docs/linear-static-3d-euler-beam/formulation.md

@@ -3,8 +3,8 @@
 ## Metadata
 
 - feature_id: `3d-isoparametric-euler-beam`
-- source_requirement: `docs/requirements/linear-static-3d-euler-beam.md`
-- source_research: `docs/research/linear-static-3d-euler-beam-research.md`
+- source_requirement: `docs/linear-static-3d-euler-beam/requirements.md`
+- source_research: `docs/linear-static-3d-euler-beam/research.md`
 - approved_design: `docs/superpowers/specs/2026-08-08-linear-static-3d-euler-beam-design.md`
 - status: `ready-for-numerical-review`
 - owner_agent: `formulation-agent`
@@ -1584,7 +1584,7 @@ deficiency는 별도의 under-integration 위험이다.
 ### 20.2 근거의 적용 경계
 
 Tier와 provenance가 정리된 research brief는
-`docs/research/linear-static-3d-euler-beam-research.md`에 있다. Wiki와 원출처는 핵심
+`docs/linear-static-3d-euler-beam/research.md`에 있다. Wiki와 원출처는 핵심
 beam 이론과 Abaqus component 의미를 제공하고, 이 문서의 DOF 순서,
 $\theta_y=-w'$ 부호, guide-vector 축, 12×12 행렬, line-load vector, 결과 위치와
 tolerance는 승인된 project requirement/design과 결합한 FESA 계약이다. 따라서 exact

docs/linear-static-3d-euler-beam/implementation-plan.md

@@ -11,12 +11,12 @@
 ## Metadata
 
 - feature_id: `linear-static-3d-euler-beam`
-- source_requirement: `docs/requirements/linear-static-3d-euler-beam.md`
-- source_research: `docs/research/linear-static-3d-euler-beam-research.md`
-- source_formulation: `docs/formulations/3d-isoparametric-euler-beam-formulation.md`
-- source_numerical_review: `docs/numerical-reviews/linear-static-3d-euler-beam-review.md`
-- source_io_definition: `docs/io-definitions/linear-static-3d-euler-beam-io.md`
-- source_reference_models: `docs/reference-models/linear-static-3d-euler-beam-reference-models.md`
+- source_requirement: `docs/linear-static-3d-euler-beam/requirements.md`
+- source_research: `docs/linear-static-3d-euler-beam/research.md`
+- source_formulation: `docs/linear-static-3d-euler-beam/formulation.md`
+- source_numerical_review: `docs/linear-static-3d-euler-beam/numerical-review.md`
+- source_io_definition: `docs/linear-static-3d-euler-beam/io.md`
+- source_reference_models: `docs/linear-static-3d-euler-beam/reference-model.md`
 - approved_design: `docs/superpowers/specs/2026-08-08-linear-static-3d-euler-beam-design.md`
 - phase_steps: `phases/linear-static-3d-euler-beam/step7.md` through `step24.md`
 - status: `ready-for-implementation`
@@ -519,7 +519,7 @@ Every task below is one Harness Step and one independent review gate. Each task
 | create | `src/fesa/CMakeLists.txt` | `fesa_solver`, warning isolation, and later production source registration |
 | create | `tests/CMakeLists.txt` | GoogleTest targets/discovery, common feature label, test meta-target |
 | create | `tests/unit/build_info_test.cpp` | compile/runtime contract for solver version |
-| create | `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md` | cumulative Step 7-24 evidence ledger |
+| create | `docs/linear-static-3d-euler-beam/implementation-report.md` | cumulative Step 7-24 evidence ledger |
 
 - Consumes: repository toolchain and approved dependency locations; no solver module.
 - Produces: normalized dependency aliases `Fesa::MKL`, `Fesa::TBB`, and `Fesa::HDF5`; `fesa_solver`; `fesa_unit_tests`; custom target `fesa_tests`; common CTest label `linear-static-3d-euler-beam`; and `solverVersion()`.
@@ -1071,7 +1071,7 @@ if ($LASTEXITCODE -eq 0) { throw "HDF5 API leaked into public headers:`n$hdf5Lea
 
 ## Implementation Report Evidence Contract
 
-`docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md` is created in TASK-07 and appended in TASK-08 through TASK-24. It must use this fixed structure for every Step:
+`docs/linear-static-3d-euler-beam/implementation-report.md` is created in TASK-07 and appended in TASK-08 through TASK-24. It must use this fixed structure for every Step:
 
 ```markdown
 ## Step 16 — euler-beam-element

docs/linear-static-3d-euler-beam/implementation-report.md

@@ -3,7 +3,7 @@
 ## Metadata
 
 - feature_id: `linear-static-3d-euler-beam`
-- source_plan: `docs/implementation-plans/linear-static-3d-euler-beam.md`
+- source_plan: `docs/linear-static-3d-euler-beam/implementation-plan.md`
 - source_design: `docs/superpowers/specs/2026-08-08-linear-static-3d-euler-beam-design.md`
 - status: `in-progress`
 - owner_agent: `implementation-agent`
@@ -18,7 +18,7 @@
   `include/fesa/build_info.hpp`, `src/fesa/build_info.cpp`,
   `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
   `tests/unit/build_info_test.cpp`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`
+  `docs/linear-static-3d-euler-beam/implementation-report.md`
 - requirement_ids: `FESA-REQ-LS3DEB-030`, `FESA-REQ-LS3DEB-034`
 - test_ids: `T07-BUILD-001`, `T07-BUILD-002`
 
@@ -56,7 +56,7 @@
   `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
   `tests/unit/core/source_identity_test.cpp`,
   `tests/unit/core/diagnostic_test.cpp`, `tests/unit/core/status_test.cpp`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`
+  `docs/linear-static-3d-euler-beam/implementation-report.md`
 - requirement_ids: `FESA-REQ-LS3DEB-033`, `FESA-REQ-LS3DEB-034`
 - test_ids: `T08-CORE-001`, `T08-CORE-002`, `T08-CORE-003`
 
@@ -95,7 +95,7 @@
   `src/fesa/math/matrix.cpp`, `tests/unit/math/vector_test.cpp`,
   `tests/unit/math/matrix_test.cpp`, `src/fesa/CMakeLists.txt`,
   `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`
 - requirement_ids: `FESA-REQ-LS3DEB-025`, `FESA-REQ-LS3DEB-034`
 - test_ids: `T09-DENSE-001`, `T09-DENSE-002`
@@ -153,7 +153,7 @@
   `include/fesa/model/domain.hpp`, `src/fesa/model/domain.cpp`,
   `tests/unit/model/model_types_test.cpp`, `tests/unit/model/domain_test.cpp`,
   `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`,
   `.superpowers/sdd/linear-static-3d-euler-beam/task-10-report.md`
 - requirement_ids: `FESA-REQ-LS3DEB-015`, `FESA-REQ-LS3DEB-016`,
@@ -200,7 +200,7 @@
   `tests/unit/io/abaqus/input_syntax_test.cpp`,
   `tests/unit/io/abaqus/input_reader_test.cpp`, `src/fesa/CMakeLists.txt`,
   `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`,
   `.superpowers/sdd/linear-static-3d-euler-beam/task-11-report.md`
 - requirement_ids: `FESA-REQ-LS3DEB-010`, `FESA-REQ-LS3DEB-034`,
@@ -248,7 +248,7 @@
   `src/fesa/io/abaqus/domain_mapper.cpp`,
   `tests/unit/io/abaqus/domain_mapper_test.cpp`,
   `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`,
   `.superpowers/sdd/linear-static-3d-euler-beam/task-12-report.md`
 - requirement_ids: `FESA-REQ-LS3DEB-001`, `FESA-REQ-LS3DEB-002`,
@@ -368,7 +368,7 @@
   `src/fesa/analysis/analysis_model.cpp`,
   `tests/unit/analysis/analysis_model_test.cpp`, `src/fesa/CMakeLists.txt`,
   `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`,
   `.superpowers/sdd/linear-static-3d-euler-beam/task-13-report.md`
 - requirement_ids: `FESA-REQ-LS3DEB-001`, `FESA-REQ-LS3DEB-021`,
@@ -413,7 +413,7 @@
 - changed_files: `include/fesa/fem/dof_manager.hpp`,
   `src/fesa/fem/dof_manager.cpp`, `tests/unit/fem/dof_manager_test.cpp`,
   `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`,
   `.superpowers/sdd/linear-static-3d-euler-beam/task-14-report.md`
 - requirement_ids: `FESA-REQ-LS3DEB-003`, `FESA-REQ-LS3DEB-007`,
@@ -470,7 +470,7 @@
   `tests/unit/results/result_records_test.cpp`,
   `tests/unit/analysis/analysis_state_test.cpp`, `src/fesa/CMakeLists.txt`,
   `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`,
   `.superpowers/sdd/linear-static-3d-euler-beam/task-15-report.md`
 - requirement_ids: `FESA-REQ-LS3DEB-003`, `FESA-REQ-LS3DEB-023`,
@@ -522,7 +522,7 @@
   `src/fesa/elements/euler_beam_3d.cpp`,
   `tests/unit/elements/euler_beam_3d_test.cpp`, `src/fesa/CMakeLists.txt`,
   `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`,
   `.superpowers/sdd/linear-static-3d-euler-beam/task-16-report.md`
 - requirement_ids: `FESA-REQ-LS3DEB-002`, `FESA-REQ-LS3DEB-004`,
@@ -639,7 +639,7 @@
   `src/fesa/assembly/parallel_for.cpp`,
   `tests/unit/assembly/parallel_for_test.cpp`, `src/fesa/CMakeLists.txt`,
   `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`,
   `.superpowers/sdd/linear-static-3d-euler-beam/task-17-report.md`
 - requirement_ids: `FESA-REQ-LS3DEB-024`, `FESA-REQ-LS3DEB-025`,
@@ -728,7 +728,7 @@
   `tests/unit/math/sparse_matrix_test.cpp`,
   `tests/unit/assembly/sparse_assembler_test.cpp`, `src/fesa/CMakeLists.txt`,
   `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`
 - requirement_ids: `FESA-REQ-LS3DEB-024`, `FESA-REQ-LS3DEB-025`,
   `FESA-REQ-LS3DEB-034`, `FESA-REQ-LS3DEB-035`
@@ -818,7 +818,7 @@
   `src/fesa/constraints/essential_constraints.cpp`,
   `tests/unit/constraints/essential_constraints_test.cpp`,
   `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`
 - requirement_ids: `FESA-REQ-LS3DEB-007`, `FESA-REQ-LS3DEB-022`,
   `FESA-REQ-LS3DEB-027`, `FESA-REQ-LS3DEB-034`,
@@ -871,7 +871,7 @@
   `tests/unit/solvers/linear/linear_solver_test.cpp`,
   `tests/unit/solvers/linear/mkl_pardiso_solver_test.cpp`,
   `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`
 - requirement_ids: `FESA-REQ-LS3DEB-025`, `FESA-REQ-LS3DEB-026`,
   `FESA-REQ-LS3DEB-034`, `FESA-REQ-LS3DEB-035`
@@ -978,7 +978,7 @@
   `src/fesa/assembly/load_assembler.cpp`,
   `tests/unit/assembly/load_assembler_test.cpp`, `src/fesa/CMakeLists.txt`,
   `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`
 - requirement_ids: `FESA-REQ-LS3DEB-007`, `FESA-REQ-LS3DEB-011`,
   `FESA-REQ-LS3DEB-027`, `FESA-REQ-LS3DEB-034`
@@ -1030,7 +1030,7 @@
   `src/fesa/results/result_recovery.cpp`,
   `tests/unit/results/result_recovery_test.cpp`, `src/fesa/CMakeLists.txt`,
   `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`
 - requirement_ids: `FESA-REQ-LS3DEB-004`, `FESA-REQ-LS3DEB-027`,
   `FESA-REQ-LS3DEB-031`, `FESA-REQ-LS3DEB-032`,
@@ -1142,7 +1142,7 @@
   `tests/unit/io/hdf5/hdf5_results_writer_test.cpp`,
   `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
   `cmake/FesaDependencies.cmake`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`
 - requirement_ids: `FESA-REQ-LS3DEB-003`, `FESA-REQ-LS3DEB-015`,
   `FESA-REQ-LS3DEB-019`, `FESA-REQ-LS3DEB-020`,
@@ -1225,7 +1225,7 @@
   `tests/reference/reference_comparison_test.cpp`,
   `tests/reference/b33_reference_comparison_test.cpp`,
   `src/fesa/CMakeLists.txt`, `tests/CMakeLists.txt`,
-  `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`,
+  `docs/linear-static-3d-euler-beam/implementation-report.md`,
   `phases/linear-static-3d-euler-beam/index.json`
 - requirement_ids: `FESA-REQ-LS3DEB-001`, `FESA-REQ-LS3DEB-002`,
   `FESA-REQ-LS3DEB-005`, `FESA-REQ-LS3DEB-020`,

docs/linear-static-3d-euler-beam/io.md

@@ -3,10 +3,10 @@
 ## Metadata
 
 - feature_id: `linear-static-3d-euler-beam`
-- source_requirement: `docs/requirements/linear-static-3d-euler-beam.md`
-- source_formulation: `docs/formulations/3d-isoparametric-euler-beam-formulation.md`
-- source_numerical_review: `docs/numerical-reviews/linear-static-3d-euler-beam-review.md`
-- source_research: `docs/research/linear-static-3d-euler-beam-research.md`
+- source_requirement: `docs/linear-static-3d-euler-beam/requirements.md`
+- source_formulation: `docs/linear-static-3d-euler-beam/formulation.md`
+- source_numerical_review: `docs/linear-static-3d-euler-beam/numerical-review.md`
+- source_research: `docs/linear-static-3d-euler-beam/research.md`
 - approved_design: `docs/superpowers/specs/2026-08-08-linear-static-3d-euler-beam-design.md`
 - status: `ready-for-implementation-planning`
 - owner_agent: `io-definition-agent`

docs/linear-static-3d-euler-beam/numerical-review.md

@@ -3,9 +3,9 @@
 ## Metadata
 
 - feature_id: `linear-static-3d-euler-beam`
-- source_formulation: `docs/formulations/3d-isoparametric-euler-beam-formulation.md`
-- source_requirements: `docs/requirements/linear-static-3d-euler-beam.md`
-- source_research: `docs/research/linear-static-3d-euler-beam-research.md`
+- source_formulation: `docs/linear-static-3d-euler-beam/formulation.md`
+- source_requirements: `docs/linear-static-3d-euler-beam/requirements.md`
+- source_research: `docs/linear-static-3d-euler-beam/research.md`
 - approved_design: `docs/superpowers/specs/2026-08-08-linear-static-3d-euler-beam-design.md`
 - status: `pass-for-implementation-planning`
 - owner_agent: `numerical-review-agent`

docs/linear-static-3d-euler-beam/physics-evaluation.md

@@ -5,12 +5,12 @@
 - feature_id: `linear-static-3d-euler-beam`
 - model_id: `cantilever-beam-b33`
 - evaluated_head: `d76d052456ec134a98bcd5aa3b3c18a6b0ad6ba4`
-- source_reference_verification_report: `docs/reference-verifications/linear-static-3d-euler-beam-reference-verification.md`
-- source_reference_model: `docs/reference-models/linear-static-3d-euler-beam-reference-models.md`
-- source_requirement: `docs/requirements/linear-static-3d-euler-beam.md`
-- source_formulation: `docs/formulations/3d-isoparametric-euler-beam-formulation.md`
-- source_numerical_review: `docs/numerical-reviews/linear-static-3d-euler-beam-review.md`
-- source_io_definition: `docs/io-definitions/linear-static-3d-euler-beam-io.md`
+- source_reference_verification_report: `docs/linear-static-3d-euler-beam/reference-comparison.md`
+- source_reference_model: `docs/linear-static-3d-euler-beam/reference-model.md`
+- source_requirement: `docs/linear-static-3d-euler-beam/requirements.md`
+- source_formulation: `docs/linear-static-3d-euler-beam/formulation.md`
+- source_numerical_review: `docs/linear-static-3d-euler-beam/numerical-review.md`
+- source_io_definition: `docs/linear-static-3d-euler-beam/io.md`
 - status: `pass-for-release-agent`
 - owner_agent: `physics-evaluation-agent`
 - date: `2026-08-09`
@@ -26,7 +26,7 @@ artifact identity was reproduced before the physics checks and again after the t
 
 | evidence | exact path or identity | status | notes |
 | --- | --- | --- | --- |
-| reference verification | `docs/reference-verifications/linear-static-3d-euler-beam-reference-verification.md` | pass-for-physics-evaluation | Required gate satisfied. |
+| reference verification | `docs/linear-static-3d-euler-beam/reference-comparison.md` | pass-for-physics-evaluation | Required gate satisfied. |
 | solver HDF5 | `.harness/build/reference/cantilever-beam-b33/results.h5` | present and readable | 25,336 bytes; post-acceptance-run SHA-256 `13ECCF68262C14BBDE0F63667C0F10896ACD40EFEC56E8C9121C298333FD9B6D`. |
 | comparison evidence | `.harness/build/reference/cantilever-beam-b33/comparison.json` | present and passing | 128,118 bytes; SHA-256 `258347AEA791D981AEA9B2BCAD85DE5344D4859ECA3692DC5E7AA01A848F8E0D`; `passed=true`, 176 rows, 16 metrics. |
 | reference input | `reference/cantilever beam/cantilever beam.inp` | exact read-only artifact | SHA-256 `E406EA9560321B791DB829E03BD24593B9875E0195D35B86BD931EDA122EF3`; `TYPE=B33`. |

docs/linear-static-3d-euler-beam/reference-comparison.md

@@ -5,11 +5,11 @@
 - feature_id: `linear-static-3d-euler-beam`
 - model_id: `cantilever-beam-b33`
 - source_head: `451d9077ea70e3087454db3760e677da0095d27f`
-- source_build_test_report: `docs/build-test-reports/linear-static-3d-euler-beam.md`
-- source_reference_models: `docs/reference-models/linear-static-3d-euler-beam-reference-models.md`
-- source_io_definition: `docs/io-definitions/linear-static-3d-euler-beam-io.md`
-- source_implementation_plan: `docs/implementation-plans/linear-static-3d-euler-beam.md`
-- source_implementation_report: `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`
+- source_build_test_report: `docs/linear-static-3d-euler-beam/build-test.md`
+- source_reference_models: `docs/linear-static-3d-euler-beam/reference-model.md`
+- source_io_definition: `docs/linear-static-3d-euler-beam/io.md`
+- source_implementation_plan: `docs/linear-static-3d-euler-beam/implementation-plan.md`
+- source_implementation_report: `docs/linear-static-3d-euler-beam/implementation-report.md`
 - status: `pass-for-physics-evaluation`
 - owner_agent: `reference-verification-agent`
 - date: `2026-08-09`

docs/linear-static-3d-euler-beam/reference-model.md

@@ -3,11 +3,11 @@
 ## Metadata
 
 - feature_id: `linear-static-3d-euler-beam`
-- source_requirement: `docs/requirements/linear-static-3d-euler-beam.md`
-- source_research: `docs/research/linear-static-3d-euler-beam-research.md`
-- source_formulation: `docs/formulations/3d-isoparametric-euler-beam-formulation.md`
-- source_numerical_review: `docs/numerical-reviews/linear-static-3d-euler-beam-review.md`
-- source_io_definition: `docs/io-definitions/linear-static-3d-euler-beam-io.md`
+- source_requirement: `docs/linear-static-3d-euler-beam/requirements.md`
+- source_research: `docs/linear-static-3d-euler-beam/research.md`
+- source_formulation: `docs/linear-static-3d-euler-beam/formulation.md`
+- source_numerical_review: `docs/linear-static-3d-euler-beam/numerical-review.md`
+- source_io_definition: `docs/linear-static-3d-euler-beam/io.md`
 - approved_design: `docs/superpowers/specs/2026-08-08-linear-static-3d-euler-beam-design.md`
 - status: `ready-for-implementation-planning`
 - owner_agent: `reference-model-agent`

docs/linear-static-3d-euler-beam/release.md

@@ -4,17 +4,17 @@
 
 - feature_id: `linear-static-3d-euler-beam`
 - approved_design: `docs/superpowers/specs/2026-08-08-linear-static-3d-euler-beam-design.md` (`status: approved`; approved 2026-08-08, amended 2026-08-09)
-- source_requirement: `docs/requirements/linear-static-3d-euler-beam.md`
-- source_research: `docs/research/linear-static-3d-euler-beam-research.md`
-- source_formulation: `docs/formulations/3d-isoparametric-euler-beam-formulation.md`
-- source_numerical_review: `docs/numerical-reviews/linear-static-3d-euler-beam-review.md`
-- source_io_definition: `docs/io-definitions/linear-static-3d-euler-beam-io.md`
-- source_reference_model: `docs/reference-models/linear-static-3d-euler-beam-reference-models.md`
-- source_implementation_plan: `docs/implementation-plans/linear-static-3d-euler-beam.md`
-- source_implementation_report: `docs/implementation-plans/linear-static-3d-euler-beam-implementation-report.md`
-- source_build_test_report: `docs/build-test-reports/linear-static-3d-euler-beam.md`
-- source_reference_verification_report: `docs/reference-verifications/linear-static-3d-euler-beam-reference-verification.md`
-- source_physics_evaluation_report: `docs/physics-evaluations/linear-static-3d-euler-beam-physics-evaluation.md`
+- source_requirement: `docs/linear-static-3d-euler-beam/requirements.md`
+- source_research: `docs/linear-static-3d-euler-beam/research.md`
+- source_formulation: `docs/linear-static-3d-euler-beam/formulation.md`
+- source_numerical_review: `docs/linear-static-3d-euler-beam/numerical-review.md`
+- source_io_definition: `docs/linear-static-3d-euler-beam/io.md`
+- source_reference_model: `docs/linear-static-3d-euler-beam/reference-model.md`
+- source_implementation_plan: `docs/linear-static-3d-euler-beam/implementation-plan.md`
+- source_implementation_report: `docs/linear-static-3d-euler-beam/implementation-report.md`
+- source_build_test_report: `docs/linear-static-3d-euler-beam/build-test.md`
+- source_reference_verification_report: `docs/linear-static-3d-euler-beam/reference-comparison.md`
+- source_physics_evaluation_report: `docs/linear-static-3d-euler-beam/physics-evaluation.md`
 - audited_head: `822b06be3d2128d5dfdc5e394078abbb9dcd5a50`
 - reference_model_id: `cantilever-beam-b33`
 - reference_schema: `abaqus-cae-report-csv-v0`

docs/linear-static-3d-euler-beam/requirements.md

@@ -9,7 +9,7 @@
 - date: `2026-08-09`
 - approved_design: `docs/superpowers/specs/2026-08-08-linear-static-3d-euler-beam-design.md`
 - approval_basis: design `status: approved`, user approval on `2026-08-08`, and amendment on `2026-08-09`
-- source_formulation: `docs/formulations/3d-isoparametric-euler-beam-formulation.md`
+- source_formulation: `docs/linear-static-3d-euler-beam/formulation.md`
 - reference_baseline: `reference/cantilever beam/` at source commit `2b34d0b`
 
 ## Purpose

docs/linear-static-3d-euler-beam/research.md

@@ -3,9 +3,9 @@
 ## Metadata
 
 - feature_id: `linear-static-3d-euler-beam`
-- source_requirement: `docs/requirements/linear-static-3d-euler-beam.md`
+- source_requirement: `docs/linear-static-3d-euler-beam/requirements.md`
 - approved_design: `docs/superpowers/specs/2026-08-08-linear-static-3d-euler-beam-design.md`
-- source_formulation: `docs/formulations/3d-isoparametric-euler-beam-formulation.md`
+- source_formulation: `docs/linear-static-3d-euler-beam/formulation.md`
 - status: `ready-for-formulation`
 - owner_agent: `research-agent`
 - date: `2026-08-09`
@@ -32,7 +32,7 @@ This brief supplies evidence for formulation alignment and later verification pl
 | S4 | Isoparametric mapping and quadrature synthesis | FEM wiki, with Bathe, Logan, Abaqus, and local source provenance | [[Isoparametric Finite Elements]] | *Finite Element Procedures*; Logan textbook; *Abaqus Theory Manual*; *Abaqus Analysis User's Guide, Volume IV* | Tier 2 synthesis; Tier 1 where Abaqus-specific | natural coordinates, Jacobian mapping, quadrature choice, under-integration risk |
 | S5 | FEM program verification workflow | FEM wiki, with textbook and official-manual provenance | [[Finite Element Program Implementation]]; [[Finite Element Modeling and Convergence Checks]] | *Finite Element Procedures*; Logan textbook; Abaqus user guides; production solver manuals | Tier 2 synthesis; Tier 1 for cited official-manual behavior | element-local/global separation, sparse assembly context, constraint/solve/recovery workflow, benchmark and equilibrium checks |
 | P1 | Approved FESA feature contract | FESA project | N/A | approved requirements and design named in Metadata | Project contract, not external evidence | exact V0 scope, fixed tolerance policy, read-only reference inventory, required output and orchestration |
-| P2 | Existing candidate formulation | FESA project | cites [[Beam and Frame Finite Elements]], [[Isoparametric Finite Elements]], and S5 pages | `docs/formulations/3d-isoparametric-euler-beam-formulation.md` | Candidate derivation, not an approved source | equations and sign choices that downstream Formulation and Numerical Review agents must check |
+| P2 | Existing candidate formulation | FESA project | cites [[Beam and Frame Finite Elements]], [[Isoparametric Finite Elements]], and S5 pages | `docs/linear-static-3d-euler-beam/formulation.md` | Candidate derivation, not an approved source | equations and sign choices that downstream Formulation and Numerical Review agents must check |
 
 The wiki source records identify S1 as high-confidence manual provenance, S2 as a high-confidence textbook source, and S3 as a current textbook source. P1 and P2 are intentionally not assigned an external reliability tier.
 

docs/linear-static-mitc4-shell/build-test.md

@@ -7,7 +7,7 @@
 - source_implementation_report: `N/A`; Harness completion evidence is recorded in
   `phases/linear-static-mitc4-shell/index.json`
 - source_implementation_plan:
-  `docs/implementation-plans/linear-static-mitc4-shell-implementation-plan.md`
+  `docs/linear-static-mitc4-shell/implementation-plan.md`
 - status: `pass-for-reference-verification`
 - owner_agent: `build-test-executor-agent`
 - date: `2026-08-13`

docs/linear-static-mitc4-shell/formulation.md

@@ -3,9 +3,9 @@
 ## Metadata
 
 - feature_id: `linear-static-mitc4-shell`
-- source_requirement: `docs/requirements/linear-static-mitc4-shell.md`
-- source_research: `docs/research/linear-static-mitc4-shell-research.md`
-- source_numerical_review: `docs/numerical-reviews/linear-static-mitc4-shell-review.md`
+- source_requirement: `docs/linear-static-mitc4-shell/requirements.md`
+- source_research: `docs/linear-static-mitc4-shell/research.md`
+- source_numerical_review: `docs/linear-static-mitc4-shell/numerical-review.md`
 - status: `approved-for-implementation-planning`
 - owner_agent: `formulation-agent`
 - date: `2026-08-13`
@@ -1586,7 +1586,7 @@ procedure.
 
 The detailed source tiers, extracted facts, page references, benchmark provenance,
 and evidence limits are owned by
-`docs/research/linear-static-mitc4-shell-research.md`. The primary local source set
+`docs/linear-static-mitc4-shell/research.md`. The primary local source set
 under `docs/reference-papers/MITC4/` includes:
 
 - `AContinuumMechanicsBasedFourNodeShell_001.md` and `_002.md`;

docs/linear-static-mitc4-shell/implementation-plan.md

@@ -14,15 +14,15 @@
 - approval_state: `harness-step-draft-approved-2026-08-12`
 - owner_agent: `implementation-planning-agent`
 - date: `2026-08-13`
-- source_requirement: `docs/requirements/linear-static-mitc4-shell.md`
-- source_research: `docs/research/linear-static-mitc4-shell-research.md`
-- source_formulation: `docs/formulations/mitc4-shell-formulation.md`
+- source_requirement: `docs/linear-static-mitc4-shell/requirements.md`
+- source_research: `docs/linear-static-mitc4-shell/research.md`
+- source_formulation: `docs/linear-static-mitc4-shell/formulation.md`
 - source_numerical_review:
-  `docs/numerical-reviews/linear-static-mitc4-shell-review.md`
+  `docs/linear-static-mitc4-shell/numerical-review.md`
 - source_io_definition:
-  `docs/io-definitions/linear-static-mitc4-shell-io.md`
+  `docs/linear-static-mitc4-shell/io.md`
 - source_reference_models:
-  `docs/reference-models/linear-static-mitc4-shell-reference-models.md`
+  `docs/linear-static-mitc4-shell/reference-model.md`
 - target_platform: `Windows x64 / MSVC / C++17`
 - build_system: `CMake + CTest`
 - execution_infrastructure: `Python Harness`
@@ -79,12 +79,12 @@ HDF5 temporary/self-check/atomic replacement는 재사용한다.
 
 | gate | evidence | status | planning consequence |
 | --- | --- | --- | --- |
-| Requirements | `docs/requirements/linear-static-mitc4-shell.md`, 001-072 approved | pass | 모든 must를 task/test에 추적 |
-| Research | `docs/research/linear-static-mitc4-shell-research.md` | pass | source-backed MITC4 tying/director/drilling 경계 유지 |
-| Formulation | `docs/formulations/mitc4-shell-formulation.md`, `approved-for-implementation-planning` | pass | linear sections만 구현; Section 15 future nonlinear 제외 |
-| Numerical Review | `docs/numerical-reviews/linear-static-mitc4-shell-review.md` | pass | critical blocker 없음; planning authorized |
-| I/O | `docs/io-definitions/linear-static-mitc4-shell-io.md`, `approved-for-implementation-planning` | pass | keyword, diagnostic, HDF5 schema를 그대로 구현 |
-| Reference Model | `docs/reference-models/linear-static-mitc4-shell-reference-models.md` | pass | sole S4 input/CSV pair만 read-only acceptance input으로 사용 |
+| Requirements | `docs/linear-static-mitc4-shell/requirements.md`, 001-072 approved | pass | 모든 must를 task/test에 추적 |
+| Research | `docs/linear-static-mitc4-shell/research.md` | pass | source-backed MITC4 tying/director/drilling 경계 유지 |
+| Formulation | `docs/linear-static-mitc4-shell/formulation.md`, `approved-for-implementation-planning` | pass | linear sections만 구현; Section 15 future nonlinear 제외 |
+| Numerical Review | `docs/linear-static-mitc4-shell/numerical-review.md` | pass | critical blocker 없음; planning authorized |
+| I/O | `docs/linear-static-mitc4-shell/io.md`, `approved-for-implementation-planning` | pass | keyword, diagnostic, HDF5 schema를 그대로 구현 |
+| Reference Model | `docs/linear-static-mitc4-shell/reference-model.md` | pass | sole S4 input/CSV pair만 read-only acceptance input으로 사용 |
 | Repository seams | parser/model, element/analysis, result/reference 영역 read-only 조사 | pass | candidate files와 current signatures 확인 |
 | Toolchain paths | GoogleTest/MKL/TBB/HDF5 config directories 존재 | pass | Section 10의 exact configure command 사용 가능 |
 
@@ -576,7 +576,7 @@ ctest --test-dir .harness/build -C Debug -R "Mitc4ReferenceComparison|Mitc4S4Ref
 Planning-document verification:
 
 ```powershell
-git diff --check -- docs/implementation-plans/linear-static-mitc4-shell-implementation-plan.md
+git diff --check -- docs/linear-static-mitc4-shell/implementation-plan.md
 git status --short
 git diff --name-only
 ```

docs/linear-static-mitc4-shell/io.md

@@ -3,10 +3,10 @@
 ## Metadata
 
 - feature_id: `linear-static-mitc4-shell`
-- source_requirement: `docs/requirements/linear-static-mitc4-shell.md`
-- source_research: `docs/research/linear-static-mitc4-shell-research.md`
-- source_formulation: `docs/formulations/mitc4-shell-formulation.md`
-- source_numerical_review: `docs/numerical-reviews/linear-static-mitc4-shell-review.md`
+- source_requirement: `docs/linear-static-mitc4-shell/requirements.md`
+- source_research: `docs/linear-static-mitc4-shell/research.md`
+- source_formulation: `docs/linear-static-mitc4-shell/formulation.md`
+- source_numerical_review: `docs/linear-static-mitc4-shell/numerical-review.md`
 - source_commits: requirements/research/formulation policy revision `73df844`
 - status: `approved-for-implementation-planning`
 - owner_agent: `io-definition-agent`
@@ -629,7 +629,7 @@ administration and reference-portfolio expansion are removed scope.
 
 ### 11.2 Reference Model Agent
 
-- Write `docs/reference-models/linear-static-mitc4-shell-reference-models.md` using
+- Write `docs/linear-static-mitc4-shell/reference-model.md` using
   this exact keyword/HDF5/reference-row contract.
 - Record only the two exact existing input/displacement pairs, comparison components,
   HDF5 projection, source-row identity, fixed absolute MITC4 tolerance and immutability rule.

docs/linear-static-mitc4-shell/numerical-review.md

@@ -3,11 +3,11 @@
 ## 1. Metadata
 
 - feature_id: `linear-static-mitc4-shell`
-- source_formulation: `docs/formulations/mitc4-shell-formulation.md`
-- source_requirements: `docs/requirements/linear-static-mitc4-shell.md`
-- source_research: `docs/research/linear-static-mitc4-shell-research.md`
-- source_io_definition: `docs/io-definitions/linear-static-mitc4-shell-io.md`
-- source_reference_inventory: `docs/reference-models/linear-static-mitc4-shell-reference-models.md`
+- source_formulation: `docs/linear-static-mitc4-shell/formulation.md`
+- source_requirements: `docs/linear-static-mitc4-shell/requirements.md`
+- source_research: `docs/linear-static-mitc4-shell/research.md`
+- source_io_definition: `docs/linear-static-mitc4-shell/io.md`
+- source_reference_inventory: `docs/linear-static-mitc4-shell/reference-model.md`
 - repository_policy: `AGENTS.md`, `docs/SOLVER_AGENT_DESIGN.md`,
   `docs/numerical-reviews/README.md`
 - reviewed_head: `cf769aa` (`mathematical implementation baseline`)

docs/linear-static-mitc4-shell/physics-evaluation.md

@@ -6,16 +6,16 @@
 - model_id: `shell-s4`
 - evaluated_head: `820ba30c717b3d0e113775608e20dfd5fbc05d53`
 - source_build_test_report:
-  `docs/build-test-reports/linear-static-mitc4-shell-build-test.md`
+  `docs/linear-static-mitc4-shell/build-test.md`
 - source_reference_verification_report:
-  `docs/reference-verifications/linear-static-mitc4-shell-reference-verification.md`
+  `docs/linear-static-mitc4-shell/reference-comparison.md`
 - source_reference_model:
-  `docs/reference-models/linear-static-mitc4-shell-reference-models.md`
-- source_requirement: `docs/requirements/linear-static-mitc4-shell.md`
-- source_formulation: `docs/formulations/mitc4-shell-formulation.md`
+  `docs/linear-static-mitc4-shell/reference-model.md`
+- source_requirement: `docs/linear-static-mitc4-shell/requirements.md`
+- source_formulation: `docs/linear-static-mitc4-shell/formulation.md`
 - source_numerical_review:
-  `docs/numerical-reviews/linear-static-mitc4-shell-review.md`
-- source_io_definition: `docs/io-definitions/linear-static-mitc4-shell-io.md`
+  `docs/linear-static-mitc4-shell/numerical-review.md`
+- source_io_definition: `docs/linear-static-mitc4-shell/io.md`
 - status: `pass-for-release-agent`
 - owner_agent: `physics-evaluation-agent`
 - date: `2026-08-13`
@@ -33,8 +33,8 @@ not executed.
 
 | evidence | exact path or identity | status | notes |
 | --- | --- | --- | --- |
-| build/test report | `docs/build-test-reports/linear-static-mitc4-shell-build-test.md` | `pass-for-reference-verification` | Clean MSVC x64 Debug build, focused `87/87`, lifecycle `10/10`, reference `8/8`, and full `144/144` CTest passed. |
-| reference verification | `docs/reference-verifications/linear-static-mitc4-shell-reference-verification.md` | `pass-for-physics-evaluation` | Required prerequisite satisfied; 147/147 blocking U rows passed and no UR warning was emitted. |
+| build/test report | `docs/linear-static-mitc4-shell/build-test.md` | `pass-for-reference-verification` | Clean MSVC x64 Debug build, focused `87/87`, lifecycle `10/10`, reference `8/8`, and full `144/144` CTest passed. |
+| reference verification | `docs/linear-static-mitc4-shell/reference-comparison.md` | `pass-for-physics-evaluation` | Required prerequisite satisfied; 147/147 blocking U rows passed and no UR warning was emitted. |
 | solver HDF5 | `.harness/build/reference/mitc4-shell-s4-comparison/results.h5` | present and readable | Freshly generated, 95,024 bytes; observed raw SHA-256 `E102D80E82BA133EBDF1C5532F3A0A4FE9984AB6CC36D00264399F7308D9230F` (inventory only). |
 | comparison ledger | `.harness/build/reference/mitc4-shell-s4-comparison/comparison.json` | present and passing | 94,349 bytes; SHA-256 `8E8DEA51B6F7C663BACC41FDA6103A4596DB26E02F1EAD6069D458F51E0102E6`; `passed=true`. |
 | declared S4 input | `reference/shell/shell.inp` | present, unchanged, read-only | SHA-256 `4005851E1AB22FD3A16AC17A8D5DA3E051233F69F37419079F3553AD134ECFCF`. |

docs/linear-static-mitc4-shell/reference-comparison.md

@@ -6,11 +6,11 @@
 - model_id: `shell-s4`
 - source_head: `820ba30c717b3d0e113775608e20dfd5fbc05d53`
 - source_build_test_report:
-  `docs/build-test-reports/linear-static-mitc4-shell-build-test.md`
+  `docs/linear-static-mitc4-shell/build-test.md`
 - source_reference_models:
-  `docs/reference-models/linear-static-mitc4-shell-reference-models.md`
-- source_io_definition: `docs/io-definitions/linear-static-mitc4-shell-io.md`
-- source_requirements: `docs/requirements/linear-static-mitc4-shell.md`
+  `docs/linear-static-mitc4-shell/reference-model.md`
+- source_io_definition: `docs/linear-static-mitc4-shell/io.md`
+- source_requirements: `docs/linear-static-mitc4-shell/requirements.md`
 - status: `pass-for-physics-evaluation`
 - owner_agent: `reference-verification-agent`
 - date: `2026-08-13`

docs/linear-static-mitc4-shell/reference-model.md

@@ -3,8 +3,8 @@
 ## Metadata
 
 - feature_id: `linear-static-mitc4-shell`
-- source_requirement: `docs/requirements/linear-static-mitc4-shell.md`
-- source_io_definition: `docs/io-definitions/linear-static-mitc4-shell-io.md`
+- source_requirement: `docs/linear-static-mitc4-shell/requirements.md`
+- source_io_definition: `docs/linear-static-mitc4-shell/io.md`
 - status: `approved-for-implementation-planning`
 - owner_agent: `reference-model-agent`
 - date: `2026-08-13`

docs/linear-static-mitc4-shell/release.md

@@ -3,19 +3,19 @@
 ## Metadata
 
 - feature_id: `linear-static-mitc4-shell`
-- source_requirement: `docs/requirements/linear-static-mitc4-shell.md`
-- source_research: `docs/research/linear-static-mitc4-shell-research.md`
-- source_formulation: `docs/formulations/mitc4-shell-formulation.md`
-- source_numerical_review: `docs/numerical-reviews/linear-static-mitc4-shell-review.md`
-- source_io_definition: `docs/io-definitions/linear-static-mitc4-shell-io.md`
-- source_reference_model: `docs/reference-models/linear-static-mitc4-shell-reference-models.md`
-- source_implementation_plan: `docs/implementation-plans/linear-static-mitc4-shell-implementation-plan.md`
+- source_requirement: `docs/linear-static-mitc4-shell/requirements.md`
+- source_research: `docs/linear-static-mitc4-shell/research.md`
+- source_formulation: `docs/linear-static-mitc4-shell/formulation.md`
+- source_numerical_review: `docs/linear-static-mitc4-shell/numerical-review.md`
+- source_io_definition: `docs/linear-static-mitc4-shell/io.md`
+- source_reference_model: `docs/linear-static-mitc4-shell/reference-model.md`
+- source_implementation_plan: `docs/linear-static-mitc4-shell/implementation-plan.md`
 - source_implementation_evidence: `phases/linear-static-mitc4-shell/index.json`
 - source_implementation_report: `N/A`; the project Harness phase index is the implementation completion ledger for this execution
 - source_correction_report: `N/A`; no final Build/Test, Reference Verification, or Physics Evaluation failure was handed to Correction Agent
-- source_build_test_report: `docs/build-test-reports/linear-static-mitc4-shell-build-test.md`
-- source_reference_verification_report: `docs/reference-verifications/linear-static-mitc4-shell-reference-verification.md`
-- source_physics_evaluation_report: `docs/physics-evaluations/linear-static-mitc4-shell-physics-evaluation.md`
+- source_build_test_report: `docs/linear-static-mitc4-shell/build-test.md`
+- source_reference_verification_report: `docs/linear-static-mitc4-shell/reference-comparison.md`
+- source_physics_evaluation_report: `docs/linear-static-mitc4-shell/physics-evaluation.md`
 - audited_source_head: `820ba30c717b3d0e113775608e20dfd5fbc05d53`
 - audited_branch: `feat-linear-static-mitc4-shell`
 - status: `ready-for-release`
@@ -40,18 +40,18 @@
 
 | gate | source | expected status/evidence | observed status/evidence | verdict |
 | --- | --- | --- | --- | --- |
-| requirements | `docs/requirements/linear-static-mitc4-shell.md` | approved scope, acceptance criteria, tolerance and reference boundary | `approved`; requirements `001-072` are all `must` and covered without gaps | pass |
-| research | `docs/research/linear-static-mitc4-shell-research.md` | approved evidence with applicability limits | `approved`; no research-owned blocking decision remains | pass |
-| formulation | `docs/formulations/mitc4-shell-formulation.md` | implementation-ready current linear formulation | `approved-for-implementation-planning`; future nonlinear Section 15 remains explicitly non-executable | pass |
-| numerical review | `docs/numerical-reviews/linear-static-mitc4-shell-review.md` | `pass-for-implementation-planning` | `pass-for-implementation-planning`; no current-scope blocker | pass |
-| I/O definition | `docs/io-definitions/linear-static-mitc4-shell-io.md` | approved input/HDF5/comparison contract | `approved-for-implementation-planning`; exact S4-only acceptance boundary and fixed tolerance are present | pass |
-| reference model | `docs/reference-models/linear-static-mitc4-shell-reference-models.md` | approved exact artifact inventory and row mapping | `approved-for-implementation-planning`; both declared files exist and match hashes | pass |
-| implementation plan | `docs/implementation-plans/linear-static-mitc4-shell-implementation-plan.md` | approved TDD plan tracing every `must` requirement | `ready-for-implementation`; ranges cover `001-072` exactly once | pass |
+| requirements | `docs/linear-static-mitc4-shell/requirements.md` | approved scope, acceptance criteria, tolerance and reference boundary | `approved`; requirements `001-072` are all `must` and covered without gaps | pass |
+| research | `docs/linear-static-mitc4-shell/research.md` | approved evidence with applicability limits | `approved`; no research-owned blocking decision remains | pass |
+| formulation | `docs/linear-static-mitc4-shell/formulation.md` | implementation-ready current linear formulation | `approved-for-implementation-planning`; future nonlinear Section 15 remains explicitly non-executable | pass |
+| numerical review | `docs/linear-static-mitc4-shell/numerical-review.md` | `pass-for-implementation-planning` | `pass-for-implementation-planning`; no current-scope blocker | pass |
+| I/O definition | `docs/linear-static-mitc4-shell/io.md` | approved input/HDF5/comparison contract | `approved-for-implementation-planning`; exact S4-only acceptance boundary and fixed tolerance are present | pass |
+| reference model | `docs/linear-static-mitc4-shell/reference-model.md` | approved exact artifact inventory and row mapping | `approved-for-implementation-planning`; both declared files exist and match hashes | pass |
+| implementation plan | `docs/linear-static-mitc4-shell/implementation-plan.md` | approved TDD plan tracing every `must` requirement | `ready-for-implementation`; ranges cover `001-072` exactly once | pass |
 | implementation | `phases/linear-static-mitc4-shell/index.json` at source HEAD | completed RED/GREEN/VERIFY execution | Steps `0-13` are `completed`; all 14 `stepN-output.json` records have `exitCode=0`; top-level phase is `completed` | pass |
 | correction | final downstream reports and commit/Harness history | no unresolved implementation-owned failure | `N/A`; final Build/Test and Reference Verification classify correction handoff as `N/A`; historical pre-gate Step 13 retries are closed | pass |
-| build/test | `docs/build-test-reports/linear-static-mitc4-shell-build-test.md` | `pass-for-reference-verification` | `pass-for-reference-verification`; clean MSVC x64 Debug build, focused `87/87`, `10/10`, `8/8`, full `144/144`, Harness Python `7/7`, zero warnings | pass |
-| reference verification | `docs/reference-verifications/linear-static-mitc4-shell-reference-verification.md` | `pass-for-physics-evaluation` | `pass-for-physics-evaluation`; exact `294/294` row identity, blocking U `147/147`, UR warnings `0`, invalid rows `0` | pass |
-| physics evaluation | `docs/physics-evaluations/linear-static-mitc4-shell-physics-evaluation.md` | `pass-for-release-agent` | `pass-for-release-agent`; equilibrium, reaction, direction, symmetry, recovery, stress signs, residual and physical energy pass | pass |
+| build/test | `docs/linear-static-mitc4-shell/build-test.md` | `pass-for-reference-verification` | `pass-for-reference-verification`; clean MSVC x64 Debug build, focused `87/87`, `10/10`, `8/8`, full `144/144`, Harness Python `7/7`, zero warnings | pass |
+| reference verification | `docs/linear-static-mitc4-shell/reference-comparison.md` | `pass-for-physics-evaluation` | `pass-for-physics-evaluation`; exact `294/294` row identity, blocking U `147/147`, UR warnings `0`, invalid rows `0` | pass |
+| physics evaluation | `docs/linear-static-mitc4-shell/physics-evaluation.md` | `pass-for-release-agent` | `pass-for-release-agent`; equilibrium, reaction, direction, symmetry, recovery, stress signs, residual and physical energy pass | pass |
 
 ### Gate Consistency and Staleness Audit
 
@@ -238,10 +238,10 @@ The Release Agent did not run Abaqus. It independently read the complete upstrea
 
 ### Artifacts
 
-- Release report: `docs/releases/linear-static-mitc4-shell-release.md`
-- Build/Test report: `docs/build-test-reports/linear-static-mitc4-shell-build-test.md`
-- Reference Verification report: `docs/reference-verifications/linear-static-mitc4-shell-reference-verification.md`
-- Physics Evaluation report: `docs/physics-evaluations/linear-static-mitc4-shell-physics-evaluation.md`
+- Release report: `docs/linear-static-mitc4-shell/release.md`
+- Build/Test report: `docs/linear-static-mitc4-shell/build-test.md`
+- Reference Verification report: `docs/linear-static-mitc4-shell/reference-comparison.md`
+- Physics Evaluation report: `docs/linear-static-mitc4-shell/physics-evaluation.md`
 - Declared reference pair: `reference/shell/shell.inp`, `reference/shell/shell displacements.csv`
 - Build-local deterministic ledger: `.harness/build/reference/mitc4-shell-s4-comparison/comparison.json`
 
@@ -282,7 +282,7 @@ The Release Agent did not run Abaqus. It independently read the complete upstrea
 - publish_deploy_package_tag_commit_performed: `false`
 - owned_report_created: `true`
 - pre_existing_untracked_reports_preserved: `true`
-- notes: before this report was created, the worktree had no tracked/staged diff and contained only the three upstream gate reports as untracked files. This audit adds only `docs/releases/linear-static-mitc4-shell-release.md`; generated build-local evidence remains ignored under `.harness/build/`.
+- notes: before this report was created, the worktree had no tracked/staged diff and contained only the three upstream gate reports as untracked files. This audit adds only `docs/linear-static-mitc4-shell/release.md`; generated build-local evidence remains ignored under `.harness/build/`.
 
 ## Open Issues
 

docs/linear-static-mitc4-shell/requirements.md

@@ -9,7 +9,7 @@
 - date: `2026-08-13`
 - approval_basis: 사용자와 확정한 선형 정적 범위, `S4`/`S4R` 매핑, 6자유도 외부 계약, drilling 안정화, 자동 director 생성, 결과 및 검증 계약
 - current_product_state: `requirements-approved-not-implemented`
-- formulation_alignment: `docs/formulations/mitc4-shell-formulation.md`는 이 baseline의 6자유도 및 고정 drilling 안정화 계약과 정렬함
+- formulation_alignment: `docs/linear-static-mitc4-shell/formulation.md`는 이 baseline의 6자유도 및 고정 drilling 안정화 계약과 정렬함
 - reference_inventory_state: full-integration FESA-MITC4의 Abaqus acceptance comparison은 `reference/shell/`의 S4 input/displacement CSV만 기존 경로와 이름 그대로 사용함; S4R source support는 reference artifact 없이 mapping/kernel/HDF5 tests로 검증함
 
 ## Purpose
@@ -39,7 +39,7 @@ Formulation, Numerical Review, I/O, Reference Model, Implementation Planning 및
 - `docs/PRD.md`, `docs/ARCHITECTURE.md`, `docs/ADR.md`: end-to-end feature boundary,
   ownership, linear-static lifecycle, deterministic assembly, HDF5, reference immutability 및
   failure atomicity
-- `docs/formulations/mitc4-shell-formulation.md`: 후속 정렬이 필요한 선행 draft이며 이
+- `docs/linear-static-mitc4-shell/formulation.md`: 후속 정렬이 필요한 선행 draft이며 이
   approved requirements baseline을 변경하는 근거로 사용하지 않음
 
 ## In Scope
@@ -250,7 +250,7 @@ and tangent derivation may remain in the formulation document.
 
 ### Formulation Agent
 
-- Revise `docs/formulations/mitc4-shell-formulation.md` to align with global 6-DOF input/output and a physical 5-DOF MITC4 kernel plus numerical drilling embedding.
+- Revise `docs/linear-static-mitc4-shell/formulation.md` to align with global 6-DOF input/output and a physical 5-DOF MITC4 kernel plus numerical drilling embedding.
 - Keep current-product equations strictly linear static; retain geometric-nonlinear residual/tangent only as clearly separated future formulation.
 - Define local frames, transformations, generalized component order, quadrature/tying, stress/resultant recovery and consistent units/signs.
 - Do not introduce distributed-load product support or make `S4R` select reduced integration.

docs/linear-static-mitc4-shell/research.md

@@ -3,7 +3,7 @@
 ## Metadata
 
 - feature_id: `linear-static-mitc4-shell`
-- source_requirement: `docs/requirements/linear-static-mitc4-shell.md`
+- source_requirement: `docs/linear-static-mitc4-shell/requirements.md`
 - status: `approved`
 - owner_agent: `research-agent`
 - date: `2026-08-13`
@@ -52,7 +52,7 @@ formulation-equivalent to Abaqus S4 or S4R.
 | S12 | Abaqus, [LE3 Hemispherical Shell with Point Loads](https://docs.software.vt.edu/abaqusv2024/English/SIMACAEBMKRefMap/simabmk-c-le3.htm) and [The Pinched Cylinder Problem](https://docs.software.vt.edu/abaqusv2025/English/SIMACAEBMKRefMap/simabmk-c-pinchcyl.htm) | Tier 1 | authoritative point-load-compatible curved-shell benchmark definitions, target displacements, S4/S4R convergence, and distorted-mesh evidence | official input decks contain semantics such as explicit normals or symmetry shorthand that require an approved FESA-subset adaptation |
 | S13 | Abaqus, [Shell Thickness and Section Points](https://docs.software.vt.edu/abaqusv2024/English/SIMACAEGSARefMap/simagsa-c-shlthick.htm) and [Whole and Partial Model Variables](https://docs.software.vt.edu/abaqusv2024/English/SIMACAEOUTRefMap/simaout-c-std-wholeandpartialmodelvariables.htm) | Tier 1 | bottom/middle/top linear-elastic stress recovery precedent and separate reporting of artificial energy that includes drill constraints | no drill-specific acceptable artificial-energy percentage is stated |
 | S14 | configured FEM wiki pages `[[MITC4 Shell Element]]`, `[[MITC Shell Kinematics]]`, `[[Assumed Transverse Shear Strain Interpolation]]`, `[[Shell Locking Phenomenon]]`, `[[Shell Element Benchmark Testing]]`, and `[[Scordelis-Lo Shell Benchmark]]` | Tier 3 synthesis | navigation between local raw sources; locking, tying, and benchmark terminology | key claims are cited to S1–S13 rather than relying on the wiki alone |
-| P1 | `docs/requirements/linear-static-mitc4-shell.md`, `docs/PRD.md`, `docs/ARCHITECTURE.md`, and `docs/ADR.md` | Project contract | exact FESA scope, six-global-DOF interface, source identity, output, verification, lifecycle, and reference immutability | does not prove numerical correctness by itself |
+| P1 | `docs/linear-static-mitc4-shell/requirements.md`, `docs/PRD.md`, `docs/ARCHITECTURE.md`, and `docs/ADR.md` | Project contract | exact FESA scope, six-global-DOF interface, source identity, output, verification, lifecycle, and reference immutability | does not prove numerical correctness by itself |
 
 The informal `docs/reference-papers/MITC4/MITC공부/` notes were used only as a
 navigation aid. No key numerical decision relies on them.

docs/superpowers/plans/2026-08-12-independent-reference-validation-policy.md

@@ -64,9 +64,9 @@
 ### Task 3: Revise MITC4 requirements and formulation
 
 **Files:**
-- Modify: `docs/requirements/linear-static-mitc4-shell.md`
-- Modify: `docs/research/linear-static-mitc4-shell-research.md`
-- Modify: `docs/formulations/mitc4-shell-formulation.md`
+- Modify: `docs/linear-static-mitc4-shell/requirements.md`
+- Modify: `docs/linear-static-mitc4-shell/research.md`
+- Modify: `docs/linear-static-mitc4-shell/formulation.md`
 
 **Interfaces:**
 - Consumes: Tasks 1-2 policy and approved fixed drilling rule
@@ -83,8 +83,8 @@
 ### Task 4: Revise MITC4 I/O and reference-case inventory
 
 **Files:**
-- Modify: `docs/io-definitions/linear-static-mitc4-shell-io.md`
-- Create: `docs/reference-models/linear-static-mitc4-shell-reference-models.md`
+- Modify: `docs/linear-static-mitc4-shell/io.md`
+- Create: `docs/linear-static-mitc4-shell/reference-model.md`
 
 **Interfaces:**
 - Consumes: Task 3 requirements/formulation
@@ -100,7 +100,7 @@
 ### Task 5: Rerun MITC4 numerical review under the approved policy
 
 **Files:**
-- Modify: `docs/numerical-reviews/linear-static-mitc4-shell-review.md`
+- Modify: `docs/linear-static-mitc4-shell/numerical-review.md`
 
 **Interfaces:**
 - Consumes: Tasks 1-4 current source-of-truth documents

docs/superpowers/specs/2026-08-08-linear-static-3d-euler-beam-design.md

@@ -8,7 +8,7 @@
 - approved_by: user
 - approved_on: `2026-08-08`
 - amended_on: `2026-08-09`
-- source_formulation: `docs/formulations/3d-isoparametric-euler-beam-formulation.md`
+- source_formulation: `docs/linear-static-3d-euler-beam/formulation.md`
 - reference_baseline: `reference/cantilever beam/` from source commit `2b34d0b`
 - implementation_environment: C++17, MSVC, CMake, CTest, GoogleTest, Intel oneMKL, Intel oneTBB, HDF5
 
@@ -76,13 +76,13 @@ authoritative HDF5 파일 `results.h5`에 기록하는 FESA V0 파이프라인
 
 | Step | Name | Primary output |
 | ---: | --- | --- |
-| 0 | `requirements-baseline` | `docs/requirements/linear-static-3d-euler-beam.md` |
-| 1 | `research-evidence` | `docs/research/linear-static-3d-euler-beam-research.md` |
-| 2 | `formulation-alignment` | `docs/formulations/3d-isoparametric-euler-beam-formulation.md` |
-| 3 | `numerical-review` | `docs/numerical-reviews/linear-static-3d-euler-beam-review.md` |
-| 4 | `io-contract` | `docs/io-definitions/linear-static-3d-euler-beam-io.md` |
-| 5 | `reference-model-contract` | `docs/reference-models/linear-static-3d-euler-beam-reference-models.md` |
-| 6 | `implementation-plan` | `docs/implementation-plans/linear-static-3d-euler-beam.md` |
+| 0 | `requirements-baseline` | `docs/linear-static-3d-euler-beam/requirements.md` |
+| 1 | `research-evidence` | `docs/linear-static-3d-euler-beam/research.md` |
+| 2 | `formulation-alignment` | `docs/linear-static-3d-euler-beam/formulation.md` |
+| 3 | `numerical-review` | `docs/linear-static-3d-euler-beam/numerical-review.md` |
+| 4 | `io-contract` | `docs/linear-static-3d-euler-beam/io.md` |
+| 5 | `reference-model-contract` | `docs/linear-static-3d-euler-beam/reference-model.md` |
+| 6 | `implementation-plan` | `docs/linear-static-3d-euler-beam/implementation-plan.md` |
 
 ### 3.2 C++ TDD 구현
 
@@ -111,10 +111,10 @@ authoritative HDF5 파일 `results.h5`에 기록하는 FESA V0 파이프라인
 
 | Step | Name | Primary output |
 | ---: | --- | --- |
-| 25 | `build-test-verification` | `docs/build-test-reports/linear-static-3d-euler-beam.md` |
-| 26 | `reference-verification` | `docs/reference-verifications/linear-static-3d-euler-beam-reference-verification.md` |
-| 27 | `physics-sanity` | `docs/physics-evaluations/linear-static-3d-euler-beam-physics-evaluation.md` |
-| 28 | `release-readiness` | `docs/releases/linear-static-3d-euler-beam-release.md` |
+| 25 | `build-test-verification` | `docs/linear-static-3d-euler-beam/build-test.md` |
+| 26 | `reference-verification` | `docs/linear-static-3d-euler-beam/reference-comparison.md` |
+| 27 | `physics-sanity` | `docs/linear-static-3d-euler-beam/physics-evaluation.md` |
+| 28 | `release-readiness` | `docs/linear-static-3d-euler-beam/release.md` |
 
 ## 4. 아키텍처와 소유권
 
@@ -173,7 +173,7 @@ V0에서는 velocity, acceleration, temperature, iteration history를 할당하
 ### 4.5 요소 계약
 
 `EulerBeam3D`는
-`docs/formulations/3d-isoparametric-euler-beam-formulation.md`의 부호, DOF 순서,
+`docs/linear-static-3d-euler-beam/formulation.md`의 부호, DOF 순서,
 2점 Gauss rule, transformation을 따른다. 구현 API는 다음 책임을 분리한다.
 
 ```cpp