FESADev/docs/shell-transient-heat-transfer/FEATURED_AGENTS.md

Shell Transient Heat Transfer 지역 작업 지침

• Feature ID: shell-transient-heat-transfer
• 메인 owner: 메인 assistant
• 적용 범위: docs/shell-transient-heat-transfer/의 계약·계획·검토 문서. 이 파일은 src/, include/, tests/에 자동 적용되는 지침이 아니다.
• 현재 범위·상태·checklist 원본: Feature PRD.

기준: 프로젝트 지침, 프로젝트 PRD, 공통 ADR, ARCHITECTURE, Feature 문서 관리. 이 파일은 자동 로드되는 AGENTS.md가 아니며, Feature 작업 시 명시적으로 참조한다.

계약과 작업 경계

• 인터뷰에서 합의한 지원 범위는 PRD, 채택 상태·이유·영향은 ADR에 기록한다. Proposed 수치 방법과 독립 검토 결과를 사용자 채택 승인이나 구현 완료로 바꾸지 않는다.
• 수식 원본은 formulation, 구현 순서·코드 연결은 design-plan, 독립 지적과 검산 evidence는 numerical-review가 소유한다. 긴 유도·검토 내용을 PRD나 이 파일에 복제하지 않는다.
• 현재 checklist는 PRD 한 곳에 둔다. 문서 작성 요청만으로 solver 구현·외부 실행·커밋을 수행하지 않는다.
• 변경이 보간·물성·geometry 근사·초기 상태·적분·시간 갱신 의미를 바꾸면 관련 ADR과 정식화를 먼저 갱신하고 필요한 독립 numerical review를 받는다. Specialist는 할당 문서만 수정한다.

이 Feature에서 보존할 의미

• 현재 목표는 단일 step의 uncoupled 열해석이다. 초기의 두께 방향 등온 선택은 대체되었으며 현재 요구는 균질 단면의 온도점 5개와 면내·두께 방향 열전달이다.
• Source DOF 11/13/15는 각각 아랫면/중앙면/윗면이다. Source DOF, 내부 equation 번호, 온도점·적분점·flux recovery 위치를 구분한다.
• 제안의 54개 직접 적분 위치와 24개 flux trace 위치는 서로 다르다. 중앙면의 두께 미분 양쪽 값을 평균하거나 요소 경계를 넘어 flux를 합치지 않는다.
• 반력 열률은 열용량 항을 포함한 full residual로 정의하는 제안이다. Fourier flux와 반력 열률을 같은 observable로 대체하지 않는다.
• Thin-shell 곡률 근사, 다른 두께·fold의 접속, 초기 온도 jump, edge 입력과 결과 schema는 PRD 미결정 계약을 먼저 확인한다. 미지원 의미를 임의 default로 처리하지 않는다.
• Reference는 PRD가 지정한 기존 .inp와 CSV를 그대로 사용한다. 음수 reference는 roundoff로 단정하거나 clamp하지 않고 TOLERANCE를 적용한다.
• All-constrained와 단면 전체 end 온도 지정은 검산용 algebra/assembly fixture다. 내부 온도점 경계조건을 공개 입력 기능으로 확대하는 근거로 사용하지 않는다.

문서 소유권과 인계

문서	Owner	책임
FEATURED_AGENTS.md	메인 assistant	지역 지침·소유권·문서 연결
PRD.md	메인 assistant	요구사항·제외·acceptance·현재 checklist
ADR.md	메인 assistant	결정·제안 상태·근거와 미해결 선택
design-plan.md	메인 assistant	방법론 요약·코드 연결·구현 순서
formulation.md	formulation-agent	수식·geometry·보간·적분·시간 갱신·recovery
numerical-review.md	numerical-review-agent	독립 검산·수치 위험·검증 설계

후속 I/O·구현·physics 작업의 owner는 실제 할당 시 기록한다. 필요한 PRD 항목과 관련 전문 문서의 절, 수정 파일, 검증 기준을 전달하고 결과·변경 경로·미해결 항목을 반환한다.

변경 확인

문서 변경은 요구사항 ID·결정 상태·수식의 위치/부호·상대 링크·diff 정합으로 확인한다. 문서만 바꾸면 build/test를 실행하지 않는다. 구현 시 검증 명령과 단계별 기준은 계획안의 검증 실행 및 프로젝트 지침을 따른다. 정확 산술 검산, solver build/CTest, 외부 reference 비교, 실제 결과의 physics 검토를 서로 다른 evidence로 기록하고 미실행 항목을 통과로 표시하지 않는다.