modify AGENTS.md, agents, references
This commit is contained in:
@@ -15,6 +15,7 @@
|
||||
- 프로젝트의 배경, 목적, 사용자, 범위는 `docs/PRD.md`에서 확인한다.
|
||||
- 전체 아키텍처와 모듈별 책임은 `docs/ARCHITECTURE.md`에서 확인한다.
|
||||
- 주요 아키텍처 결정과 그 이유 및 트레이드오프는 `docs/ADR.md`에서 확인한다.
|
||||
- C++ naming, formatting, Doxygen와 변경 검증 규약은 `docs/CODINGSTYLE.md`를 따른다.
|
||||
- 외부 reference tolerance 값, 판정 과정, 보고서와 변경 관리는
|
||||
`docs/TOLERANCE.md`를 따른다.
|
||||
- AI 에이전트는 설계나 구현 결정을 내리기 전에 PRD에서 제품 범위를, ARCHITECTURE에서 소유권과 데이터 흐름을, ADR에서 이미 결정된 트레이드오프를 먼저 확인한다. 기능별 요구조건, 연구, 정식화, 수치/reference 검토, I/O, 구현, 검증, 물리 및 release 의미는 `docs/<feature-id>/`의 승인 문서를 source of truth로 삼는다.
|
||||
@@ -75,7 +76,7 @@
|
||||
|
||||
### 선형 정적 해석 불변식
|
||||
|
||||
- `Analysis::run()`의 실제 단계와 객체별 책임은 `docs/ARCHITECTURE.md`의 해석 실행 흐름을 따른다.
|
||||
- `LinearStaticAnalysis::Run()`의 실제 단계와 객체별 책임은 `docs/ARCHITECTURE.md`의 해석 실행 흐름을 따른다.
|
||||
- Full stiffness를 stable free/constrained 순서로 `Kff/Kfc/Kcf/Kcc`에 분할하고, `Kff` factorization을 load assembly보다 먼저 수행한다.
|
||||
- Effective RHS는 `Ff - Kfc * dc`이며 substitution 뒤 full displacement를 복구한다. 모든 DOF가 constrained인 유효한 모델의 `0 x 0 Kff`를 singular error로 바꾸지 않는다.
|
||||
- Reaction과 free-equilibrium evidence는 조립된 full residual `K*d - F`에서 구한다. Constrained 성분은 physical reaction이고 free 성분은 residual evidence다.
|
||||
@@ -105,15 +106,7 @@
|
||||
## 개발 프로세스
|
||||
- TDD를 기본으로 한다. 구현은 `RED -> GREEN -> VERIFY` 순서를 따른다.
|
||||
- CRITICAL: 빌드 경고를 새로 추가하지 말 것.
|
||||
- 기능 개발은 다음 8단계 gate를 순서대로 통과해야 한다.
|
||||
1. 요구조건
|
||||
2. 연구
|
||||
3. 정식화
|
||||
4. 수치 검토 + reference model 계약
|
||||
5. I/O 정의
|
||||
6. 구현 계획 + C++ 구현 + build/test + reference comparison
|
||||
7. 물리 검토
|
||||
8. 배포 준비
|
||||
- 기능 개발은 아래 `Agent/Skill Workflow` 표의 8단계 gate를 순서대로 통과해야 한다.
|
||||
- 커밋 메시지는 conventional commits 형식을 따른다: `feat:`, `fix:`, `docs:`, `refactor:`, `test:`, `chore:`.
|
||||
|
||||
## Agent/Skill Workflow
|
||||
@@ -156,8 +149,8 @@ uv run --with pytest python -m pytest -v -rs
|
||||
### Phase 실행
|
||||
|
||||
```powershell
|
||||
python scripts/execute.py <phase-name>
|
||||
python scripts/execute.py <phase-name> --push
|
||||
python scripts/execute.py <phase-dir>
|
||||
python scripts/execute.py <phase-dir> --push
|
||||
```
|
||||
|
||||
### CMake/CTest 프로젝트
|
||||
|
||||
Reference in New Issue
Block a user