김경종
59 lines
2.2 KiB
Markdown
59 lines
2.2 KiB
Markdown
# 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.
|