# Step 9: Shell Analysis State

> 과거 개발 계획이다. 아래 작업·상태·예시는 현재 실행 지시가 아니다.
> 현재 구현과 검증 한계는 [기능 요약](../../docs/linear-static-mitc4-shell/README.md)을 따른다.

## 읽어야 할 파일

- `/AGENTS.md`, `../../docs/solver-core/README.md`, `../../docs/solver-core/README.md`, `../../docs/solver-core/README.md`
- `../../docs/solver-core/README.md`, `../../docs/solver-core/README.md`, `/.codex/hooks.json`
- `../../docs/linear-static-mitc4-shell/README.md`
- `../../docs/linear-static-mitc4-shell/README.md` Requirements 026/041-046/048
- `../../docs/linear-static-mitc4-shell/README.md`
- `../../docs/linear-static-mitc4-shell/formulation.md`
- `../../docs/linear-static-mitc4-shell/README.md`
- `../../docs/linear-static-mitc4-shell/README.md` Sections 6.3-6.5
- `../../docs/linear-static-mitc4-shell/README.md`
- phase indexes, `step9.md`, Step 5 recovery types and Step 8 summary
- `/include/fesa/results/result_records.hpp`
- `/include/fesa/analysis/analysis_state.hpp`
- `/src/fesa/analysis/analysis_state.cpp`
- `/tests/unit/results/result_records_test.cpp`

## 작업

1. `MITC4-STATE-001..003`을 먼저 작성한다.
2. Additive shell record types를 정의한다: stable element, GP1..GP4 natural location,
   local 3x3 frame, eight generalized strain/resultant, three section positions의
   `[S11,S22,S12]`.
3. AnalysisState에 shell rows, physical strain energy, six equilibrium components,
   three normalized verification metrics를 candidate-owned storage로 추가한다.
4. Validated candidate가 완성된 뒤에만 state로 commit하며 invalid/nonfinite/
   inventory mismatch가 기존 state를 바꾸지 않게 한다.
5. Nonlinear director history, iteration, velocity, acceleration을 할당하지 않는다.

## Acceptance Criteria

과거 도구 실행·출력 지시는 정리했으며, 현재 검증 방법은 기능 요약을 따른다.

Missing shell state/rollback RED 뒤 minimal GREEN. 이후:

과거 도구 실행·출력 지시는 정리했으며, 현재 검증 방법은 기능 요약을 따른다.

## 검증 및 상태 갱신

RED/VERIFY evidence를 기록하고 현재 Step 상태 payload만 갱신한다.

## 금지사항

- Element calculation, ResultRecovery orchestration, HDF5를 구현하지 마라.
- Nonlinear/dynamic state나 drilling-specific row를 추가하지 마라.
- 직접 commit/hook 실행 또는 reference/upstream 변경을 하지 마라.