add euler beam uel phase

2026-06-11 11:08:44 +09:00
parent 986cc9888e
commit 3f6275201e
11 changed files with 625 additions and 0 deletions
@@ -0,0 +1,58 @@
+# Step 3: numerical-review
+
+## Read First
+
+- `/AGENTS.md`
+- `/docs/ABAQUS_SUBROUTINE_AGENT_DESIGN.md`
+- `/docs/ARCHITECTURE.md`
+- `/docs/ADR.md`
+- `/.codex/skills/abaqus-subroutine-numerical-review/SKILL.md`
+- `/docs/requirements/uel-3d-euler-beam.md`
+- `/docs/research/uel-3d-euler-beam-research.md`
+- `/docs/formulations/uel-3d-euler-beam.md`
+- `/docs/numerical-reviews/README.md`
+
+## Task
+
+Create `/docs/numerical-reviews/uel-3d-euler-beam.md`.
+
+Independently review the formulation before any implementation. Check:
+
+- Local stiffness matrix completeness, units, symmetry, and positive semidefiniteness before boundary conditions.
+- Rigid-body mode count for a free two-node 3D beam.
+- Correct association of `Iy`, `Iz`, local bending planes, and rotational DOFs.
+- Transformation orthonormality and behavior for reversed node order.
+- Residual sign convention for Abaqus `UEL`.
+- Tolerance choices for degeneracy and floating-point checks.
+- Patch, cantilever, axial, torsion, and orientation regression tests needed downstream.
+
+Record each finding as `pass`, `needs-change`, or `blocked`. If the formulation needs correction, update only the numerical review document with explicit required upstream changes and mark this phase step `blocked`; do not silently patch formulation content in this review step.
+
+Do not create or modify Fortran source, tests, reference artifacts, or implementation plans in this step.
+
+## Tests To Write First
+
+- None. This is a numerical review artifact step.
+
+## Acceptance Criteria
+
+```bash
+python -m unittest discover -s scripts -p "test_*.py"
+python scripts/validate_reference_artifacts.py
+python scripts/validate_workspace.py
+```
+
+The step is complete only when `/docs/numerical-reviews/uel-3d-euler-beam.md` gives a clear proceed/block decision for implementation readiness.
+
+## Validation Notes
+
+- Downstream implementation must not override a blocked numerical finding.
+- Update `/phases/uel-3d-euler-beam/index.json` step 3 with `completed`, `error`, or `blocked` and a concrete summary or reason.
+
+## Forbidden
+
+- Do not add JavaScript/TypeScript/npm fallback.
+- Do not run Abaqus analyses from this project.
+- Do not generate reference CSVs.
+- Do not create Fortran production source.
+- Do not break existing tests.