docs: organize project guidance and module contracts

2026-09-29 00:34:57 +09:00
parent 73db138566
commit a3502c9b97
50 changed files with 1748 additions and 414 deletions
@@ -0,0 +1,17 @@
+# 검증과 reference evidence
+
+Tests는 solver 동작·수학적 일관성·외부 비교 및 개발 실행기의 검증을 소유한다.
+테스트를 통과시키기 위해 제품 계약이나 reference 원본을 변경하지 않는다.
+
+- C++ unit·integration·reference와 Python suite는 서로 다른 범위다. CTest 성공을
+  Python 통과로 보고하지 않는다. CMake/MSVC x64 Debug 기준과 실제 실행 결과를 기록한다.
+- 수치 변화는 analytical/invariant와 독립 review를 결합한다. Finite/solve 성공만 검사하거나
+  implementation 식을 그대로 복사한 oracle로 correctness를 주장하지 않는다.
+- 비교 전에 source identity·location·component·finite를 검증한다. Missing/extra/duplicate를
+  허용하지 않고 node averaging으로 beam endpoint를 collapse하지 않는다.
+- MITC4 U blocking·UR warning-only와 승인된 eigen first-implementation 예외를 유지한다.
+  기준 경계·zero scale·family 분리와 결정적 보고를 테스트한다.
+- Reference의 경로·값·naming·metadata를 임의 수정하지 않는다. 검증용 algebra fixture의
+  입력 자유도를 공개 CLI 지원으로 승격하지 않는다.
+- 과거 profile·phase를 요구하는 테스트가 현행 절차와 다르면 별도 정리 대상으로 보고한다.
+  미실행·skip·제외·실패를 PASS로 계산하거나 폐기된 workflow를 복원하지 않는다.