docs(mitc4): record drilling choices and current verification limits

docs/linear-static-mitc4-shell/README.md

@@ -11,6 +11,13 @@ Composite·offset·material nonlinearity·mixed beam-shell은 이 기능 범위
 
 ## 채택한 수식과 이유
 
+2026-10-20부터 모델 전체의 drilling 방식은 코드의 단일 설정으로 선택한다.
+기본 `kDirectSpring`은 초기 global 단위 director `d0`와 전체 회전 `phi`에 대해
+`gamma=d0·phi`, `Udrill=0.5*kd*sum(gamma²)`를 사용한다.
+`kLegacyCorotatedTwist`는 기존 상대 비틀림 방식이다. 선형 정적과 원형상 고유치의
+drilling block은 두 선택에서 같으며, 차이를 만들기 위해 physical 강성을 바꾸지 않는다.
+직접 방식은 유한 강체 회전의 인공 에너지·모멘트를 허용한다.
+
 각 절점의 6 global DOF에서 director 접평면의 5 physical DOF를 분리한다.
 Bilinear geometry와 canonical edge-midpoint tying으로 공변 횡전단장을 보간한다.
 이는 직접 shear interpolation의 locking을 줄이기 위한 MITC 선택이다.
@@ -48,6 +55,11 @@ Key는 frame·instance·source node·component이며 row-set·finite·unit/locat
 그 밖은 relative error `<=5%`, family `RMS(error)/S<=1%`를 동시에 요구한다.
 `S=0`은 exact zero다. UR 수치 실패는 warning이며 잘못된 identity를 허용하는 의미는 아니다.
 내부 free residual·전역 force/moment balance는 normalized `1e-10` 한계다.
+직접 방식의 기존 전역 gate는 raw moment에서 별도 내부 spatial drilling moment를
+차감한 값을 사용한다. 기존 방식은 raw 판정을 유지하며 분모·허용치는 같다.
+기존 `global/equilibrium`은 raw 값이다. 새 파일에는 실제 방식과 진단 version,
+`global/drilling_moment[3]`, `global/equilibrium_with_drilling[6]`을 추가한다.
+선형 변위 비교기에 새 평형 수치 family를 추가하지 않고 진단의 형식·관계만 사전검사한다.
 
 ## 구현과 데이터 흐름
 
@@ -61,6 +73,11 @@ Procedure는 해석 상태, writer는 serialization을 소유하며 element에 e
 
 ## 검증 의미와 한계
 
+2026-10-20 source `6bbbb2b`의 두 방식 별도 실행에서 정식 S4 입력의 생성·U 비교를
+통과했고 실제 선형 변위도 정확히 같았다. 직접 방식의 인공 torque·보정 부호·실제
+불평형 거부 검사를 포함했다. 전체 Debug 검사는 Native/CTest 각각
+1035개 중1024 PASS·기존10 FAIL·1 INCONCLUSIVE SKIP으로 전체 수치 검증 통과는 아니다.
+
 과거 S4 reference는 147 blocking U rows와 평형·대칭·constitutive·physical energy 검사를 통과했다.
 그때 중심 U3는 약 `-2.35504418e-5`, normalized free residual은 약 `1.08e-14`였다.
 이는 당시 실행 evidence이며 이번 문서 정리에 따른 현재 build/test 통과 선언이 아니다.