docs: add 3d euler beam phase

2026-06-12 17:26:01 +09:00
parent 825e03dbaf
commit 13cf2af899
13 changed files with 891 additions and 0 deletions
@@ -0,0 +1,60 @@
+# Step 1: research-evidence
+
+## Read These Files First
+
+Read the following files before editing:
+
+- `/AGENTS.md`
+- `/docs/PRD.md`
+- `/docs/ARCHITECTURE.md`
+- `/docs/ADR.md`
+- `/docs/requirements/euler-beam-3d.md`
+- `/docs/research/README.md`
+
+## Task
+
+Create `/docs/research/euler-beam-3d-research.md`.
+
+Summarize the evidence needed to implement the approved kernel-first 3D Euler-Bernoulli beam increment. The document must be implementation-oriented and must include:
+
+- supported theory: straight prismatic Euler-Bernoulli beam, axial, torsion, and two uncoupled bending planes
+- assumptions and applicability limits
+- local DOF ordering and sign convention used by the planned matrix
+- source reliability classification
+- benchmark-style checks that do not require external reference solver execution:
+  - local stiffness symmetry
+  - axial-only response
+  - torsion-only response
+  - bending about local `y`
+  - bending about local `z`
+  - rigid body translation/rotation zero internal forces in local coordinates
+  - global transform identity for an axis-aligned beam
+- risks: orientation vector parallel to element axis, near-zero length, nonpositive section constants, ill-conditioning for very slender elements
+
+If internet access or a FEM wiki is used, cite sources briefly. Do not include long copyrighted excerpts.
+
+Do not create C++ files in this step.
+
+## Tests To Write First
+
+- No C++ test is required in this documentation-only step.
+
+## Acceptance Criteria
+
+```powershell
+python -m unittest discover -s scripts -p "test_*.py"
+python scripts/validate_workspace.py
+```
+
+## Verification Notes
+
+1. Confirm the research document ties each source or theory point to a planned implementation check.
+2. Confirm unresolved items are listed as risks or open issues instead of silently assumed.
+3. Update `phases/euler-beam-3d/index.json` step 1:
+   - success: `"status": "completed"`, `"summary": "3D Euler beam research evidence added"`
+   - failure after retries: `"status": "error"`, `"error_message": "<specific error>"`
+   - blocked: `"status": "blocked"`, `"blocked_reason": "<specific reason>"`
+
+## Forbidden
+
+- Do not modify source, test, reference, or I/O contract files.