modify template

2026-06-10 17:12:23 +09:00
parent 2d59191df2
commit df3cc3e890
186 changed files with 24935 additions and 2 deletions
@@ -0,0 +1,34 @@
+# Architecture Decision Records
+
+## 철학
+Harness는 현재 프로젝트의 실제 기술 스택을 반영해야 한다. C++/MSVC 프로젝트에서 npm, Next.js, TypeScript test naming을 기본값으로 두면 agent prompt와 hook policy가 잘못된 구현을 유도한다.
+
+---
+
+### ADR-001: C++ 전용 Harness
+**결정**: Harness scaffold는 C++/MSVC 전용으로 운영한다. JavaScript/TypeScript fallback은 유지하지 않는다.
+
+**이유**: FESA 개발 환경은 MSVC 기반 C++이다. 언어별 fallback을 남기면 validation, TDD guard, acceptance criteria가 흐려진다.
+
+**트레이드오프**: 같은 Harness scaffold를 JS/TS 프로젝트에 재사용할 수 없다. 필요하면 별도 template이나 language registry를 새 ADR로 설계한다.
+
+### ADR-002: CMake/MSVC/x64/Debug 기본 검증
+**결정**: 기본 workspace validation은 CMake, Visual Studio 17 2022 generator, x64 platform, Debug config, CTest로 수행한다.
+
+**이유**: MSVC 환경에서 CMake/CTest는 source tree가 복원되거나 새 C++ project가 추가될 때 가장 일관된 build/test entry point다.
+
+**트레이드오프**: Visual Studio solution-only project는 기본 지원하지 않는다. 명시적으로 필요하면 `HARNESS_VALIDATION_COMMANDS`로 override한다.
+
+### ADR-003: 엄격한 C++ TDD Guard
+**결정**: C++ production file 변경은 관련 C++ test file이 없으면 차단한다.
+
+**이유**: Harness의 핵심 목적은 agent가 검증 없는 C++ 변경을 만들지 않도록 하는 것이다. Header 중심 C++ 구조에서도 module 또는 basename 기반 테스트 존재를 확인한다.
+
+**트레이드오프**: 초기 scaffolding 작업에서 guard가 엄격하게 느껴질 수 있다. 문서, CMake 설정, Harness metadata는 guard 대상에서 제외한다.
+
+### ADR-004: Harness 자체 테스트 우선
+**결정**: commit hook은 먼저 Python Harness self-test를 실행한 뒤 workspace validation을 실행한다.
+
+**이유**: 현재 저장소에는 C++ source tree가 없을 수 있다. Harness가 스스로 검증 가능해야 이후 phase generation과 source restoration을 안전하게 진행할 수 있다.
+
+**트레이드오프**: commit 시간이 조금 늘어난다. 대신 hook/validation regressions를 빠르게 잡는다.
@@ -0,0 +1,58 @@
+# 아키텍처
+
+## 목표
+이 저장소의 현재 책임은 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
+```
@@ -0,0 +1,22 @@
+# PRD: C++/MSVC Harness
+
+## 목표
+Codex Harness가 C++/MSVC 프로젝트에서 phase planning, TDD guard, commit validation, workspace validation을 일관되게 수행하게 한다.
+
+## 사용자
+- Windows/MSVC 기반 C++ 개발자
+- Harness phase를 작성하고 실행하는 Codex agent
+- Harness 결과를 검토하는 reviewer
+
+## 핵심 기능
+1. CMake/MSVC/x64/Debug 기반 workspace validation
+2. C++ source/header 변경에 대한 엄격한 TDD guard
+3. npm 없이 Python self-test와 CMake/CTest 검증을 수행하는 pre-commit hook
+4. C++ 프로젝트에 맞는 Harness workflow/review prompt
+5. CMake project가 아직 없어도 Harness 자체 테스트가 가능한 no-op validation path
+
+## 제외 사항
+- 이전 FESA solver source tree 복원
+- JavaScript/TypeScript fallback 유지
+- Abaqus reference artifact 생성 또는 solver reference 비교 구현
+- Visual Studio `.sln`/`.vcxproj` 전용 MSBuild workflow
@@ -0,0 +1,76 @@
+# UI 디자인 가이드
+
+## 디자인 원칙
+1. {원칙 1 — 예: "도구처럼 보여야 한다. 마케팅 페이지가 아니라 매일 쓰는 대시보드."}
+2. {원칙 2}
+3. {원칙 3}
+
+## AI 슬롭 안티패턴 — 하지 마라
+| 금지 사항 | 이유 |
+|-----------|------|
+| backdrop-filter: blur() | glass morphism은 AI 템플릿의 가장 흔한 징후 |
+| gradient-text (배경 그라데이션 텍스트) | AI가 만든 SaaS 랜딩의 1번 특징 |
+| "Powered by AI" 배지 | 기능이 아니라 장식. 사용자에게 가치 없음 |
+| box-shadow 글로우 애니메이션 | 네온 글로우 = AI 슬롭 |
+| 보라/인디고 브랜드 색상 | "AI = 보라색" 클리셰 |
+| 모든 카드에 동일한 rounded-2xl | 균일한 둥근 모서리는 템플릿 느낌 |
+| 배경 gradient orb (blur-3xl 원형) | 모든 AI 랜딩 페이지에 있는 장식 |
+
+## 색상
+### 배경
+| 용도 | 값 |
+|------|------|
+| 페이지 | {예: #0a0a0a} |
+| 카드 | {예: #141414} |
+
+### 텍스트
+| 용도 | 값 |
+|------|------|
+| 주 텍스트 | {예: text-white} |
+| 본문 | {예: text-neutral-300} |
+| 보조 | {예: text-neutral-400} |
+| 비활성 | {예: text-neutral-500} |
+
+### 데이터/시맨틱 색상
+| 용도 | 값 |
+|------|------|
+| {긍정/성공} | {예: #22c55e} |
+| {부정/에러} | {예: #ef4444} |
+| {중립/기본} | {예: #525252} |
+
+## 컴포넌트
+### 카드
+```
+{예: rounded-lg bg-[#141414] border border-neutral-800 p-6}
+```
+
+### 버튼
+```
+Primary: {예: rounded-lg bg-white text-black hover:bg-neutral-200}
+Text:    {예: text-neutral-500 hover:text-neutral-300}
+```
+
+### 입력 필드
+```
+{예: rounded-lg bg-neutral-900 border border-neutral-800 px-4 py-3}
+```
+
+## 레이아웃
+- 전체 너비: {예: max-w-5xl}
+- 정렬: {예: 좌측 정렬 기본. 중앙 정렬 금지}
+- 간격: {예: gap-3~4, 섹션 간 space-y-8}
+
+## 타이포그래피
+| 용도 | 스타일 |
+|------|--------|
+| 페이지 제목 | {예: text-4xl font-semibold text-white} |
+| 카드 제목 | {예: text-sm font-medium text-neutral-400} |
+| 본문 | {예: text-sm text-neutral-300 leading-relaxed} |
+
+## 애니메이션
+- {허용할 애니메이션만 나열. 예: fade-in (0.4s), slide-up (0.5s)}
+- {그 외 모든 애니메이션 금지}
+
+## 아이콘
+- {예: SVG 인라인, strokeWidth 1.5}
+- {예: 아이콘 컨테이너(둥근 배경 박스)로 감싸지 않는다}