연구 브리프 작성 가이드

이 디렉터리는 Research Agent가 작성하거나 제안한 기능별 연구 브리프를 보관하는 위치다.

기본 파일명은 docs/research/<feature-id>-research.md 형식을 사용한다. 각 브리프는 Requirement Agent의 요구조건을 입력으로 받아 Formulation Agent, Numerical Review Agent, Reference Model Agent, Implementation Planning Agent가 사용할 수 있는 근거 자료를 제공해야 한다.

Research Agent 역할

Research Agent는 FEM 이론, benchmark, verification reference, solver manual, 논문 자료를 조사한다.

수행한다:

기능 요구조건과 관련된 이론 자료를 조사한다.
요소별 benchmark, patch test, MMS, MES, convergence study 후보를 찾는다.
Abaqus/Nastran 결과와 비교 가능한 공개 benchmark 또는 문헌 해를 정리한다.
자료의 신뢰도, 적용 범위, 한계, 상충 여부를 평가한다.
downstream agent가 사용할 수 있도록 출처와 근거를 추적 가능하게 남긴다.

수행하지 않는다:

C++ 코드를 구현하지 않는다.
유한요소 정식화를 확정하지 않는다.
C++ API나 파일 구조를 설계하지 않는다.
Abaqus, Nastran 또는 레퍼런스 솔버를 직접 실행하지 않는다.
reference HDF5 artifact 또는 reference CSV 결과를 생성하지 않는다.
기능 완료 여부를 승인하지 않는다.

Source Reliability Tier

tier	source type	examples	use
Tier 1	공식 표준, 공식 solver manual, 공식 benchmark, 공공기관 자료	ASME V&V 10, Abaqus Verification Guide, Abaqus Benchmarks Guide, NAFEMS benchmarks, NASA FEMCI, official solver manuals	우선 근거
Tier 2	peer-reviewed paper, reproducible arXiv preprint, textbook	MMS/MES 논문, finite element textbook	이론/검증 후보
Tier 3	vendor example, university course note, technical blog	공개 강의노트, 기술 블로그	보조 근거
Reject	forum answer, LLM summary, unsourced page, illegal PDF mirror, citation 없는 wiki성 문서	forum, mirror PDF, 출처 없는 요약	primary evidence로 사용 금지

문서 템플릿

# <feature title> Research Brief

## Metadata
- feature_id: <feature-id>
- source_requirement: docs/requirements/<feature-id>.md
- status: draft | needs-user-decision | ready-for-formulation
- owner_agent: research-agent
- date: <YYYY-MM-DD>

## Research Questions
- <Requirement Agent 또는 사용자가 넘긴 조사 질문>

## Source Inventory

| source_type | title | author_or_org | URL_or_DOI | access_date | reliability_tier | notes |
| --- | --- | --- | --- | --- | --- | --- |
| standard | ASME V&V 10 | ASME | <URL> | <YYYY-MM-DD> | Tier 1 | VVUQ framework |

## Extracted Facts
- <정식화에 필요한 사실, benchmark 조건, 검증 물리량, 재료/좌표/단위 가정>

## Candidate Benchmarks

| benchmark_id | source | benchmark_type | physics | target_quantities | artifact_needs | applicability |
| --- | --- | --- | --- | --- | --- | --- |
| <id> | <source title> | analytical \| NAFEMS \| Abaqus Verification/Benchmark \| NASA/FEMCI \| paper-derived | <physics> | <targets> | <needed artifacts> | <limits> |

## Verification Relevance
- code_verification: <관련성>
- solution_verification: <관련성>
- validation: <관련성>
- reference_comparison: <관련성>

## Applicability Limits
- linear_or_nonlinear: <scope>
- deformation: small | large | TBD
- element_type: <scope>
- material_model: <scope>
- geometry: <scope>
- boundary_conditions: <scope>
- loads: <scope>
- coordinate_system: <scope>
- units: <scope>

## Open Issues
- <근거 부족, 상충 자료, 유료/비공개 자료, 사용자 결정 필요 사항>

## Downstream Handoff

### Formulation Agent
- <이론 사실, governing assumptions, candidate equations, unresolved formulation questions>

### Numerical Review Agent
- <수치 위험, convergence expectations, patch test/MMS/MES evidence, source disagreements>

### Reference Model Agent
- <benchmark candidates, required reference artifacts, target quantities, source limitations>

### Implementation Planning Agent
- <verification scenarios and testable acceptance evidence>

품질 기준

모든 외부 근거는 source metadata와 reliability tier를 가져야 한다.
verified fact와 inference를 구분해야 한다.
benchmark 후보는 target quantity와 applicability limit을 가져야 한다.
Abaqus Benchmarks Guide와 Abaqus Verification Guide의 용도를 구분해야 한다.
NAFEMS benchmark는 independent standard test와 target value 후보로 기록해야 한다.
MMS/MES 자료는 code verification 후보로 기록하되 정식화 확정으로 취급하지 않는다.
사용 불가능하거나 유료/비공개인 자료는 Open Issues에 남겨야 한다.