docs: organize project guidance and module contracts

scripts/AGENTS.md

@@ -0,0 +1,13 @@
+# 개발 실행 진입점
+
+이 영역은 명시적으로 요청된 검증 실행과 비교 도구를 제공한다. 솔버의 제품 runtime이나
+자동 작업 승인·commit·push·release 절차를 소유하지 않는다.
+
+- execute.py는 인자 없는 build/test 진입점이다. 과거 phase 인자, 자동 retry·내부 LLM·
+  파일명 TDD gate·대화 종료 hook을 복원하지 않는다.
+- 명령 성공의 범위를 실제 실행한 검사로 제한한다. C++ 실행기가 Python 회귀나 별도
+  reference 비교까지 자동 수행한다고 보고하지 않는다.
+- Config·preset·실행 명령은 신뢰가 필요한 실행 입력이다. shell=False나 timeout을
+  sandbox라고 설명하지 않는다.
+- 변경 동작은 해당 Python 검사로 검증하고 문서만 수정하면 실행하지 않는다.
+  기능별 source/reference를 실행기 편의를 위해 rename·rewrite하지 않는다.

scripts/msvc_harness/AGENTS.md

@@ -0,0 +1,15 @@
+# Build와 test 실행기
+
+이 package는 config·project 감지·toolchain 선택, adapter 명령 계획과 process 실행을 소유한다.
+수치 acceptance나 Feature 상태, Git와 agent 인계는 소유하지 않는다.
+
+- Explicit config와 metadata에 따라 CMake/MSBuild를 선택한다. 모호한 project 감지를
+  첫 번째 파일로 해결하거나 C++ source 존재만으로 별도 gate를 만들지 않는다.
+- CMake 경로는 configure 이후 MSVC metadata와 CTest의 비어 있지 않은 JSON discovery를
+  검사한다. Preset 네 필드와 실제 binaryDir의 일치를 보존한다.
+- Argv list와 shell=False를 사용하고 cwd를 검증한다. CLI의 전체 deadline과 step timeout
+  중 남은 범위를 적용한다. Backend side effect 전체를 격리한다고 주장하지 않는다.
+- Nonzero·timeout·결과 검사 실패는 stage/argv/cwd와 출력 tail을 포함해 반환한다.
+  자동 retry·commit·push·phase 결과 파일 생성을 추가하지 않는다.
+- Config precedence, ambiguous metadata, non-MSVC, empty discovery, timeout 경계,
+  backend exit와 runner exit 구분을 process seam으로 검증한다.

scripts/verification/AGENTS.md

@@ -0,0 +1,14 @@
+# 외부 결과 비교 도구
+
+이 영역은 승인된 reference와 FESA HDF5의 deterministic comparison을 소유한다.
+솔버 실행, reference 생성·수정과 물리식 채택을 소유하지 않는다.
+
+- 비교 전 필요한 source instance·label·component·step/frame을 일대일 대응한다.
+  누락·추가·중복·nonfinite와 schema 오류를 tolerance로 무시하지 않는다.
+- Reference 값만으로 family scale을 만들고 approved near-zero·row·RMS·zero-scale 규칙을
+  적용한다. 임의 absolute floor·값 보정·nearest-time matching을 추가하지 않는다.
+- 현재 HHT 비교기는 지정된 729-node 모델과 101 frames의 선택 절점 U/UR용이다.
+  다른 모델을 인자로 받는다는 이유로 범용 comparator라 설명하지 않는다.
+- U blocking과 UR warning-only를 유지하고 warning도 결정적인 순서로 보고한다.
+- Identity 변형·frame 누락·비유한 값·tolerance 경계·zero scale·report 재현성을 검증한다.
+  변위 비교 성공을 가속도·에너지·시간수렴 검증으로 확대하지 않는다.