Project Guidance Refresh Design

목적

Abaqus User Subroutine 개발 지침을 다음 세 원칙에 맞게 정비한다.

abaverify는 도입하지 않는다. Abaqus 해석은 사용자가 다른 PC에서 수행하고, 이 저장소는 사용자가 첨부한 변위·응력 CSV와 provenance artifact를 schema/tolerance 기준으로 비교한다.

질문의 성격에 따라 근거 경로를 분리한다.

질문	필수 근거 경로
유한요소 정식화, residual/tangent, constitutive integration, benchmark, 수치 검증	`fem-theory-query`
Abaqus User Subroutine argument, update responsibility, product applicability, utility routine	`docs/AbaqusUserSubroutineManual/INDEX_MAP.md` → `INDEX.md` → 선택된 record의 모든 `source_ranges`
프로젝트 workflow와 artifact contract	`AGENTS.md`, `docs/ABAQUS_SUBROUTINE_AGENT_DESIGN.md`, `docs/ARCHITECTURE.md`, `docs/ADR.md`

INDEX.md의 summary와 keyword는 탐색 metadata로만 사용한다. 구현 또는 interface 결정을 내릴 때는 선택된 section의 모든 source span을 순서대로 읽고 원문을 authoritative source로 취급한다.

기본 로컬 gate는 python scripts/validate_workspace.py이다.
Fortran production 변경은 no-Abaqus Fortran/Python driver로 TDD 검증한다.
Abaqus job과 ODB-to-CSV 추출은 사용자가 다른 Abaqus PC에서 수행한다.
사용자는 변위, 응력 또는 feature contract에서 지정한 결과 CSV와 provenance metadata를 제공한다.
이 저장소는 ODB를 직접 파싱하지 않고 CSV schema, matching key, unit, coordinate system, tolerance를 비교한다.
abaverify 관련 agent, skill, command, artifact contract는 추가하지 않는다.

다음 파일에서 source routing과 CSV verification 경계를 일관되게 정리한다.

새 매뉴얼 전용 skill은 만들지 않는다. 전역 AGENTS.md 규칙과 기존 research/interface skill에 index 탐색 절차를 추가하는 것이 더 단순하며 중복을 줄인다.

이미 삭제된 사용자 변경을 보존하고, 남아 있는 versioned project-specific 항목을 제거한다.

공식 매뉴얼의 backward Euler 문구와 generic UEL entry point 설명은 과거 feature 산출물이 아니므로 유지한다.

테스트 대신 다음 문서 검사를 수행한다.

변경 파일을 재독해 source routing과 verification 계약의 충돌을 확인한다.
versioned 파일에서 uel-3d-euler-beam, uel_3d_euler_beam, 3D Euler-Bernoulli 잔존 참조를 검색한다.
매뉴얼을 제외한 project guidance에서 abaverify가 남지 않았는지 확인한다.
변경된 skill frontmatter와 agents/openai.yaml의 의미가 일치하는지 확인한다.
git diff --check와 diff 검토만 수행한다.