docs: align guidance with simplified agent and harness workflow

This commit is contained in:
KOKO\Mimi
2026-09-07 22:12:48 +09:00
parent d7e9629640
commit 5e2a30fce0
10 changed files with 593 additions and 1304 deletions
+12 -10
View File
@@ -4,7 +4,7 @@
이 문서는 FESA production 및 test C++의 코드 스타일, 객체 설계, 문서화와 검증 규칙을
정의하는 project-local source of truth다. 새 C++를 작성하거나 기존 C++를 리팩터링하는
사람과 Implementation Agent는 작업 전에 이 문서를 읽어야 한다.
메인 assistant와 구현 담당자는 작업에 관련된 규칙을 확인한다.
[Google C++ Style Guide](https://google.github.io/styleguide/cppguide.html)를 baseline으로
사용한다. 이 문서, `AGENTS.md`, 승인된 feature contract와 architecture/ADR이 Google guide의
@@ -217,12 +217,14 @@ contract language는 현재 외부 계약을 유지한다.
## Test와 변경 관리
- Production C++ 변경은 관련 C++ test와 같은 patch에 있어야 한다.
- Behavior 또는 interface 변경은 `RED -> observed failure -> minimal GREEN -> VERIFY`를
따른다.
- Production 동작·interface 변경은 해당 의미를 확인하는 테스트를 추가·수정하여 검증한다.
- 버그는 가능한 경우 실패를 재현한 뒤 최소 수정하고 관련 검사를 실행한다. 기존 coverage가
충분한 rename/refactor에는 형식적인 새 테스트를 요구하지 않는다.
- Refactoring test는 base interface 사용, ownership/lifetime, invalid combination,
deterministic order와 current numerical result preservation을 검증한다.
- Focused test 뒤에 full MSVC x64 Debug build와 CTest를 실행한다.
- 개발 중에는 관련 검사를 실행하고, 솔버 기능 완료 시 full MSVC x64 Debug build와 CTest를
한 번 수행한다. 요청이나 넓은 변경 영향으로 필요한 경우에도 실행하며 이후 변경·실패가
없으면 반복하지 않는다. 문서만 수정할 때는 정적 검토를 수행한다.
- B33/MITC4 output 경계를 건드린 변경은 승인된 reference comparison을 다시 실행한다.
- Reference artifact, input path와 tolerance를 리팩터링에 맞춰 수정하지 않는다.
- Commit은 review 가능한 module slice로 제한하고 Conventional Commits를 사용한다.
@@ -243,14 +245,14 @@ doxygen Doxyfile
Generated Doxygen HTML과 tool cache/build output은 source control에 넣지 않는다.
## Implementation Agent Checklist
## 구현 담당자 Checklist
Implementation Agent는 C++ Step을 시작하기 전에 다음을 확인한다.
메인 또는 구현 agent는 할당된 C++ 작업 전에 다음을 확인한다.
- 이 문서와 feature implementation plan을 읽었다.
- 관련 코딩 규칙·Feature 계약과 필요한 경우의 구현 계획을 확인했다.
- 변경할 base/concrete/module owner가 승인 설계와 일치한다.
- 관련 test file과 RED condition이 Step에 명시되어 있다.
- 변경 동작을 확인할 검사와 가능한 버그 재현 조건을 정했다.
- Public API naming과 production Doxygen가 이 문서에 맞는다.
- Vendor dependency와 ownership direction이 역전되지 않는다.
- Stable identity, numerical order, HDF5와 reference contract가 보존된다.
- Formatting, Doxygen, focused/full MSVC/CTest acceptance command가 계획되어 있다.
- Formatting, Doxygen와 변경 영향에 맞는 MSVC/CTest·reference 검증 범위 및 명령을 정했다.