modify framework

AGENTS.md

@@ -1,21 +1,44 @@
-# 프로젝트: {프로젝트명}
+# Project: FESA Harness
 
 ## 기술 스택
-- {프레임워크 (예: Next.js 15)}
-- {언어 (예: TypeScript strict mode)}
-- {스타일링 (예: Tailwind CSS)}
+- C++17 이상
+- MSVC on Windows
+- CMake + CTest
+- Harness scripts in Python 3
 
 ## 아키텍처 규칙
-- CRITICAL: {절대 지켜야 할 규칙 1 (예: 모든 API 로직은 app/api/ 라우트 핸들러에서만 처리)}
-- CRITICAL: {절대 지켜야 할 규칙 2 (예: 클라이언트 컴포넌트에서 직접 외부 API를 호출하지 말 것)}
-- {일반 규칙 (예: 컴포넌트는 components/ 폴더에, 타입은 types/ 폴더에 분리)}
+- CRITICAL: 기본 검증 경로는 `python scripts/validate_workspace.py`이다.
+- CRITICAL: C++ 빌드는 CMake/MSVC/x64/Debug 기준으로 검증한다.
+- CRITICAL: 새 기능 또는 동작 변경은 테스트를 먼저 작성하고 실패를 확인한 뒤 구현한다.
+- CRITICAL: Abaqus reference artifact나 solver 코드 복원은 명시적으로 요청된 phase에서만 수행한다.
+- Harness runner는 `scripts/execute.py`에 둔다.
+- Codex hook 정책은 `.codex/hooks/`에 둔다.
+- Harness planning/review instructions are stored in `.codex/skills/`.
+- Generated phase execution outputs remain ignored under `phases/**/step*-output.json`.
 
 ## 개발 프로세스
-- CRITICAL: 새 기능 구현 시 반드시 테스트를 먼저 작성하고, 테스트가 통과하는 구현을 작성할 것 (TDD)
-- 커밋 메시지는 conventional commits 형식을 따를 것 (feat:, fix:, docs:, refactor:)
+- TDD를 기본으로 한다. C++ production file을 바꿀 때는 관련 C++ test file이 있어야 한다.
+- 커밋 전 hook은 Harness Python self-test와 workspace validation을 실행해야 한다.
+- 커밋 메시지는 conventional commits 형식을 따른다: `feat:`, `fix:`, `docs:`, `refactor:`, `test:`.
+- 계획이 필요한 장기 작업은 Harness phase로 나누고, 각 step은 독립 실행 가능해야 한다.
 
 ## 명령어
-npm run dev      # 개발 서버
-npm run build    # 프로덕션 빌드
-npm run lint     # ESLint
-npm run test     # 테스트
+```bash
+python -m unittest discover -s scripts -p "test_*.py"
+python scripts/validate_workspace.py
+python scripts/execute.py <phase-dir>
+python scripts/execute.py <phase-dir> --push
+```
+
+## MSVC 검증 기본값
+- Generator: `Visual Studio 17 2022`
+- Platform: `x64`
+- Config: `Debug`
+- Build directory: `build/msvc-debug`
+
+Override variables:
+- `HARNESS_VALIDATION_COMMANDS`
+- `HARNESS_CMAKE_GENERATOR`
+- `HARNESS_CMAKE_PLATFORM`
+- `HARNESS_CMAKE_CONFIG`
+- `HARNESS_BUILD_DIR`