# PLAN.md

## Purpose

이 파일은 여러 AI Agent가 같은 작업을 이어받을 때 현재 목표와 실행 계획을 빠르게 파악하기 위한 공유 계획서이다.

## Current Objective

3D Euler-Bernoulli beam Abaqus/Standard `UEL` 구현을 하네스 phase 흐름에 따라 진행한다.

## Active Phase

- Phase directory: `phases/uel-3d-euler-beam`
- Current planned entry point: `python scripts/execute.py uel-3d-euler-beam`
- First pending step: `step7` Fortran implementation

## Planned Steps

1. Requirements: `docs/requirements/uel-3d-euler-beam.md`
2. Research: `docs/research/uel-3d-euler-beam-research.md`
3. Formulation: `docs/formulations/uel-3d-euler-beam.md`
4. Numerical review: `docs/numerical-reviews/uel-3d-euler-beam.md`
5. Interface contract: `docs/io-definitions/uel-3d-euler-beam.md`
6. Test/reference model plan: `docs/reference-models/uel-3d-euler-beam.md`
7. RED no-Abaqus Fortran tests and manifest - completed
8. GREEN Fortran implementation - next
9. Validation, physics sanity, and readiness audit

## Success Criteria

- Every must requirement has verification method, acceptance criteria, and tolerance or decision owner.
- Fortran production changes follow RED -> GREEN -> VERIFY.
- No-Abaqus tests pass through `python scripts/validate_fortran.py` when compiler and manifest are available.
- Workspace validation passes through `python scripts/validate_workspace.py`.
- Solver-result validation is marked complete only after externally generated ODB-extracted CSV artifacts are provided and validated.

## Out Of Scope Until Explicitly Approved

- Running Abaqus jobs from this repository.
- Direct ODB parsing in this repository.
- Fabricating reference CSV, `.msg`, `.dat`, `.log`, or `.sta` evidence.
- Geometric nonlinearity, Timoshenko shear deformation, mass, damping, distributed loads, plasticity, damage, thermal strain, warping torsion, and section offsets for the first UEL implementation.

## Open Decisions

- Confirm exact first-scope beam assumptions in the requirements step.
- Decide `PROPS`/`JPROPS` ordering and orientation-vector convention in the interface step.
- Decide exact no-Abaqus Fortran source and test file layout in the reference model step.