docs: refresh Abaqus subroutine guidance

This commit is contained in:
KOKO\Mimi
2026-08-18 11:27:22 +09:00
parent a3197dc2e3
commit e76c1b96fd
64 changed files with 498 additions and 4560 deletions
+20
View File
@@ -9,6 +9,8 @@
- 기본 검증은 Abaqus를 실행하지 않는다.
- Abaqus 해석 실행과 ODB CSV 추출은 사용자가 외부 Abaqus PC에서 수행한다.
- 이 프로젝트는 ODB를 직접 파싱하지 않고, 추출된 CSV와 metadata를 검증한다.
- FEM 이론과 solver 지식은 `fem-theory-query`를 통해 탐색한다.
- Abaqus User Subroutine manual 사실은 local index로 section을 찾은 뒤 원문 source span에서 확인한다.
- Requirements, research, formulation, interface, test model, implementation, validation 산출물을 섞지 않는다.
## 디렉토리 구조
@@ -18,6 +20,7 @@
├── hooks/ # Codex hook scripts
└── skills/ # Abaqus workflow, review, TDD, validation instructions
docs/
├── AbaqusUserSubroutineManual/ # INDEX_MAP, INDEX, and authoritative manual chunks
├── requirements/ # Feature requirement specs and verification matrices
├── research/ # Source-backed research briefs
├── formulations/ # FEM formulation specs
@@ -69,6 +72,22 @@ User request
- Skill instructions는 `.codex/skills/*/SKILL.md`에 있고, 각 skill은 input, workflow, output contract, quality gate, handoff를 정의한다.
- Coordinator Agent는 workflow state와 blocker routing만 담당하고 specialist work를 직접 수행하지 않는다.
## 근거 탐색 구조
```text
FEM theory or numerical verification question
-> fem-theory-query
-> configured FEM wiki evidence
Abaqus User Subroutine ABI or manual question
-> docs/AbaqusUserSubroutineManual/INDEX_MAP.md
-> matching record in INDEX.md
-> every source_ranges span in order
-> authoritative manual evidence
```
`INDEX.md`의 summary, keyword, content anchor는 검색을 위한 metadata다. Agent는 이 metadata만으로 ABI, argument, product support, update responsibility를 확정하지 않는다.
## Fortran TDD 구조
```text
Fortran production change
@@ -84,6 +103,7 @@ Fortran production change
`scripts/validate_fortran.py``tests/fortran/manifest.json`이 있을 때 Intel oneAPI Fortran compiler를 찾아 test executable을 compile/run한다. Compiler discovery는 `ifx`를 우선하고 `ifort`를 fallback으로 사용한다.
## Abaqus ABI 설계
- Selected entry point의 manual 근거는 `INDEX_MAP.md``INDEX.md`를 거쳐 모든 source span을 읽은 뒤 interface contract에 기록한다.
- Abaqus ABI wrapper는 manual signature와 include convention을 보존한다.
- Abaqus/Standard Fortran wrapper는 `aba_param.inc` convention을 따른다.
- Abaqus/Explicit Fortran wrapper는 `vaba_param.inc` convention을 따른다.