# 계산 성능 개선 작업 지침

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

## 소유권

메인이 기능 계약·현재 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 최종 인계](../hex8-structural-analysis/final-handoff.md),
  [수치 기준](../hex8-structural-analysis/numeric-controls.md),
  [원본 mapping](../hex8-structural-analysis/reference-model.md).
- [Shell PRD](../hht-implicit-dynamics/PRD.md),
  [축소좌표 식](../hht-implicit-dynamics/formulation-reduced-coordinate.md),
  [schema v2](../hht-implicit-dynamics/io-reduced-coordinate.md).
- [공통 tolerance](../TOLERANCE.md), [실행 방법](../operations.md),
  수정 영역의 지역 AGENTS.

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