docs: refresh Abaqus subroutine guidance

2026-08-18 11:27:22 +09:00
parent a3197dc2e3
commit e76c1b96fd
64 changed files with 498 additions and 4560 deletions
@@ -67,3 +67,10 @@ Abaqus User Subroutine 개발은 일반 application code 개발보다 ABI, solve
 **이유**: Public example은 bug-free 또는 validation-quality artifact라는 보장이 없다. 이 프로젝트의 acceptance는 requirements, reference artifact metadata, comparison evidence, physics sanity를 통해 판단한다.

 **트레이드오프**: 공개 예제를 빠르게 복사해 시작하는 방식보다 느리다. 대신 장기적으로 source provenance와 verification traceability를 유지할 수 있다.
+
+### ADR-010: FEM 이론과 Abaqus manual 사실의 탐색 경로를 분리한다
+**결정**: 유한요소 정식화, residual/tangent, constitutive integration, benchmark, 수치 검증 지식은 `fem-theory-query`를 통해 탐색한다. Abaqus User Subroutine ABI, argument, product applicability, utility routine은 `docs/AbaqusUserSubroutineManual/INDEX_MAP.md`에서 위치를 찾고, `INDEX.md`의 해당 record와 모든 `source_ranges` 원문을 순서대로 읽어 확인한다.
+
+**이유**: FEM 이론 자료와 Abaqus 제품별 ABI 문서는 서로 다른 근거 체계다. 둘을 한 경로로 취급하면 이론적 일반성과 특정 Abaqus version의 interface 사실이 혼동될 수 있다. Generated index summary만 읽는 방식도 원문 제약이나 다중 파일 section을 놓칠 수 있다.
+
+**트레이드오프**: Agent가 질문을 분류하고 둘 이상의 source path를 읽어야 하므로 조사 단계가 늘어난다. 대신 theory claim, Abaqus-specific claim, inference의 provenance가 분명해진다.