docs: scope eigen2 research through io definition

2026-09-08 21:13:21 +09:00
parent 3e8ca1b995
commit be5c0e5777
3 changed files with 27 additions and 8 deletions
@@ -38,3 +38,11 @@
 - 결정: 메인이 관리 문서·검토·커밋을 맡고 Requirement specialist는 할당된 요구사항 문서만 작성한다. 상태는 PRD checklist에만 둔다.
 - 영향: 고정 9단계 dispatch, 별도 planning/correction/release profile, 자동 Git·hook, phase payload·retry budget을 새 요구사항으로 복원하지 않는다.
 - 검증: 문서·ID·출처·링크·scope의 정적 확인을 수행한다. 실제 동작 검증 의무와 기존 명시 감사 요구의 보존은 문서 작성과 별개이며 이번에는 실행하지 않는다.
+
+## MFE2-ADR-005 — Research부터 I/O 계약까지의 후속 작업
+
+- 상태: 사용자 명시 요청, 2026-09-08. Owner: 메인 assistant.
+- 결정: requirement r1을 기준으로 research, formulation, 독립 numerical review, io-definition을 진행하고 변경을 커밋한다. ADR-001의 requirement-only 작업 범위는 이 후속 요청으로 확장된다.
+- 승인 근거: “research 단계부터 io-definition 단계까지 작업을 진행”, “작업시간이 30분 이상 걸리면 작업을 중지하고 진행사항과 오래걸리는 이유를 보고”.
+- 영향: 기존 수식·control·schema는 새 전문 검토를 거쳐 채택 여부를 명시한다. 문서 승인과 실제 solver 검증을 구분하며 구현·reference 실행·push는 수행하지 않는다.
+- 제한: 2026-09-08 12:07:56 UTC부터 12:37:56 UTC까지. 제한 내 미완료 작업은 통과로 바꾸지 않고 상태·원인을 보고한다.
@@ -3,8 +3,8 @@
 - Feature ID: `mitc4-shell-feast-eigen2`
 - Owner: 메인 assistant
 - Requirement baseline revision: `r1`
- 현재 작업: requirement 단계만. Research·formulation·I/O 설계·구현·실행 검증은 이번 요청에 포함하지 않는다.
- 목적: 기존 작업의 유용한 요구·근거를 검토하여 MITC4 질량행렬과 FEAST 고유진동 해석의 새 요구사항 baseline을 작성한다.
+- 현재 작업: requirement r1을 기준으로 research → formulation → numerical-review → io-definition을 진행한다. 구현·solver 실행 검증은 포함하지 않는다.
+- 목적: MITC4 질량행렬과 FEAST 고유진동 해석의 요구사항을 이론·수학·수치 검토·입출력 계약으로 구체화한다.
 - 현재 checklist: [PRD](PRD.md#현재-checklist).

 기준: [프로젝트 지침](../../AGENTS.md), [프로젝트 PRD](../PRD.md),
@@ -19,7 +19,8 @@
 - Requirement는 관찰 가능한 동작·범위·검증 의도를 소유한다. 특정 lumping/축소 수식, FEAST parameter, HDF5 layout, 수치 threshold는 새로 결정하지 않는다.
 - `reference/temp` 예제는 원본·옛 경로·복사본·cache를 통해서도 검증에 사용하지 않는다. 제외 목록은 requirements의 원본 정의를 따른다.
 - 변경은 할당된 이 폴더의 문서로 제한한다. 기존 Feature·phase·source·test·config·reference는 수정하지 않는다.
- 이번 요구사항 정리의 완료는 solver 기능 완료가 아니다. 명시적으로 제외된 후속 작업을 진행하거나 빈 후속 보고서를 만들지 않는다.
+- 이번 문서 작업의 완료는 solver 기능 완료가 아니다. 구현 등 요청 범위 밖의 작업을 진행하거나 빈 후속 보고서를 만들지 않는다.
+- 사용자 시간 제한은 [PRD](PRD.md)의 시작 시각부터 30분이다. 도달하면 중지하고 실제 진행 상태와 오래 걸린 이유를 보고한다.

 ## 문서 목록과 소유권

@@ -3,7 +3,7 @@
 - Feature ID: `mitc4-shell-feast-eigen2`
 - Owner: 메인 assistant
 - Requirement baseline revision: `r1`
- 상태: requirement baseline r1 작성 및 정적 확인 완료. 이번 요청의 범위는 requirement 단계까지이며 solver 구현·실행 검증은 미실행이다.
+- 상태: requirement baseline r1 완료. 후속 요청에 따라 research부터 io-definition까지 진행 중이며 solver 구현·실행 검증은 미실행이다.

 기준: [프로젝트 지침](../../AGENTS.md), [프로젝트 PRD](../PRD.md),
 [공통 ADR](../ADR.md#adr-028). 지역 지침은 [FEATURED_AGENTS](FEATURED_AGENTS.md),
@@ -16,9 +16,13 @@
 변경사항을 Git에 커밋하도록 요청했다. 이어 **모든 단계를 진행하지 말고 requirement
 단계만 진행**하도록 범위를 명시했다.

-이번 산출물은 요구사항·acceptance intent와 검증 의도다. 이후의 research, 정식화 채택,
-독립 numerical review, I/O 설계, 구현 계획·코드, build/test·reference 비교와 release
-감사는 수행하지 않는다. 별도 coordinator나 phase 상태기계를 만들지 않는다.
+이후 사용자가 **research부터 io-definition까지** 진행하도록 요청했다. 현재 범위는 research,
+formulation, 독립 numerical review, I/O 계약 문서와 단계별 커밋이다. 구현 계획·코드,
+solver build/test·reference 비교와 release 감사는 포함하지 않는다.
+별도 coordinator나 phase 상태기계를 만들지 않는다.
+
+작업시간 제한은 30분이다. 시작은 2026-09-08 12:07:56 UTC이며 12:37:56 UTC에 도달하면
+진행 중인 작업을 중지하고 실제 완료·미완료 항목과 지연 이유를 보고한다.

 ## 솔버 기능의 요구 범위 요약

@@ -58,4 +62,10 @@
 - [x] 메인이 사용자 요구 coverage, 전문 owner 경계와 미해결 사항을 정적으로 확인한다.
 - [x] 상대 링크·ID를 검사하고 커밋 대상이 새 Feature 문서 5개뿐인지 확인한다.

-이번 checklist의 완료는 요구사항 작업의 완료만 뜻한다. 다음 단계는 자동으로 시작하지 않는다.
+- [ ] Research: 기존 근거의 적용 범위와 부족한 이론·backend 근거를 확인한다.
+- [ ] Formulation: 질량·안정화·축소·고유치 해법의 구현 가능한 수학 계약을 작성한다.
+- [ ] Numerical review: 독립 계산·검토로 정식화와 검증 계획의 적합성을 판단한다.
+- [ ] I/O definition: 입력·진단·결과 schema·reference mapping 계약을 정의한다.
+- [ ] 신규 문서의 링크·계약 일관성과 변경 범위를 확인하고 단계별 변경을 커밋한다.
+
+이 checklist는 문서 작업 상태다. Solver 구현·실제 FEAST 실행·회귀 및 외부 reference 비교의 통과를 뜻하지 않는다.