FESADev/docs/calculation-performance/FEATURED_AGENTS.md

계산 성능 개선 작업 지침

• Feature ID: calculation-performance.
• 목적: 원본 비선형 정적 Hex8 2초, 비선형 동적 Hex8 100초, shell 동적 100초.
• 요구사항·현재 checklist: PRD.
• 사용자 선택과 구현 경계: ADR.
• 적용 공통 기준: AGENTS, 공통 PRD, 공통 ADR, 구조, 검증 규칙.

소유권

메인이 기능 계약·현재 checklist·공유 target/assembly 등록·통합 결과를 관리한다. 측정 도구·빌드 설정, MKL/math/backend, Hex8, reduced shell 작업은 승인 계획의 각 owner가 담당한다. 동시에 다른 owner의 파일을 수정하거나 변경을 되돌리지 않는다. Production MKL·수명·수치 변경에는 독립 수치 검토, 실제 완료 결과에는 필요한 독립 물리 검토를 적용한다. 고정 전문 역할 순회는 하지 않는다.

반드시 보존할 기준

일반 밀집·희소 곱셈과 선형 해법에 MKL을 사용한다. 작은 좌표/특수 정밀도 예외는 실제 위치·연산·이유·근거를 기록한다. Domain·DofManager·local response· assembly·procedure·backend·results·writer의 책임을 유지한다. 불변 준비 데이터와 trial 계산 결과를 구별하고 stale factorization·실패 candidate 노출·비결정적 공유 누적을 허용하지 않는다.

원본·물리식·질량·high+low·시간간격·수용 기준·필수 출력·schema·tolerance를 성능을 위해 바꾸지 않는다. 원본은 scratch에 byte-identical로 복사하여 실행한다. 전체 실행 경과 시간은 VTune 없이 워밍업 없는 모델별 1회가 목표 이내여야 한다. 측정 횟수는 PC 중단 후 사용자의 2026-10-14 변경 지시를 따르며 이전 raw 이력을 보존한다. 현재 AMD PC의 VTune 소프트웨어 수집과 공식 측정은 순차 실행한다.

소비할 상세 계약

• Hex8 최종 인계, 수치 기준, 원본 mapping.
• Shell PRD, 축소좌표 식, schema v2.
• 공통 tolerance, 실행 방법, 수정 영역의 지역 AGENTS.

현재 실행 근거는 .harness/performance/에 보존하고 정식 보고서에서 연결한다. 기존 중단·FAIL/SKIP을 현재 PASS로 표시하지 않는다. 새 회귀와 목표 미달은 완료를 차단하며 승인된 일반 수정에 반복 승인 절차를 추가하지 않는다.