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

4.7 KiB

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에 기록한다. ready에서 승인한 채택 계약과 독립 검토·실제 구현 완료 evidence를 구별한다.
  • 수식 원본은 formulation, 구현 순서·코드 연결은 design-plan, 독립 지적과 검산 evidence는 numerical-review가 소유한다. 긴 유도·검토 내용을 PRD나 이 파일에 복제하지 않는다.
  • 현재 checklist는 PRD 한 곳에 둔다. 현재 구현은 사용자의 dryforge:go 요청으로 승인되었다. 외부 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와 결과 schema는 PRD 상세 계약을 따른다. Edge 입력 011은 이번 구현에서 연기한다. 미지원 의미를 임의 default로 처리하지 않는다.
  • 기존 reference .inp와 CSV는 변경하지 않고 진단 비교에 사용한다. 음수 reference는 roundoff로 단정하거나 clamp하지 않고 TOLERANCE를 적용한다. 새 필수 reference는 PRD STH-C08과 STH-ADR-015를 따른다.
  • 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·구현은 design-plan의 작업별 owner에게 할당하고 physics 평가는 독립 검토자에게 할당한다. 필요한 PRD 항목과 관련 전문 문서의 절, 수정 파일, 검증 기준을 전달하고 결과·변경 경로·미해결 항목을 반환한다.

변경 확인

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