docs(performance): initialize approved optimization scope

This commit is contained in:
KOKO\Mimi
2026-10-14 08:36:40 +09:00
parent eaa5cbeb21
commit 560ccf8e6b
4 changed files with 456 additions and 0 deletions
@@ -0,0 +1,44 @@
# 계산 성능 개선 작업 지침
- 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회 뒤 5회 모두 목표 이내여야 한다.
현재 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로 표시하지 않는다. 새 회귀와 목표 미달은
완료를 차단하며 승인된 일반 수정에 반복 승인 절차를 추가하지 않는다.