김경종
59 lines
1.7 KiB
Markdown
59 lines
1.7 KiB
Markdown
# 아키텍처
|
|
|
|
## 목표
|
|
이 저장소의 현재 책임은 C++/MSVC 프로젝트를 위한 Codex Harness scaffold를 제공하는 것이다. Harness는 phase execution, edit guard, commit validation, workspace validation을 분리해서 관리한다.
|
|
|
|
## 디렉토리 구조
|
|
```text
|
|
.codex/
|
|
├── hooks/ # Codex hook scripts
|
|
└── skills/ # Harness planning/review instructions
|
|
docs/ # Project and Harness guidance
|
|
scripts/
|
|
├── execute.py # Phase step executor
|
|
├── validate_workspace.py
|
|
└── test_*.py # Harness self-tests
|
|
phases/ # Optional generated phase plans
|
|
```
|
|
|
|
## 데이터 흐름
|
|
```text
|
|
User-approved task
|
|
-> Harness phase files under phases/
|
|
-> scripts/execute.py injects AGENTS.md and docs/*.md
|
|
-> Codex executes one step at a time
|
|
-> step updates phases/{phase}/index.json
|
|
-> validation runs through scripts/validate_workspace.py
|
|
```
|
|
|
|
## Hook 흐름
|
|
```text
|
|
apply_patch/Edit/Write
|
|
-> .codex/hooks/tdd-guard.py
|
|
-> C++ production changes require related tests
|
|
|
|
git commit command
|
|
-> .codex/hooks/pre_commit_checks.py
|
|
-> Python Harness self-tests
|
|
-> scripts/validate_workspace.py
|
|
```
|
|
|
|
## Validation 흐름
|
|
```text
|
|
HARNESS_VALIDATION_COMMANDS set
|
|
-> run exact commands
|
|
|
|
CMakePresets.json has msvc-debug configure preset
|
|
-> cmake --preset msvc-debug
|
|
-> cmake --build preset binary dir --config Debug
|
|
-> ctest --test-dir preset binary dir -C Debug
|
|
|
|
CMakeLists.txt exists
|
|
-> cmake -S . -B build/msvc-debug -G "Visual Studio 17 2022" -A x64
|
|
-> cmake --build build/msvc-debug --config Debug
|
|
-> ctest --test-dir build/msvc-debug --output-on-failure -C Debug
|
|
|
|
No CMake project
|
|
-> print guidance and exit successfully
|
|
```
|