요구사항 컨텍스트 엔지니어링 과 AI 개발환경 셋팅 #2

New Issue

2026-04-07T11:48:02+09:00

kimminsung commented

2026-04-07 11:48:02 +09:00

컨텍스트 엔지니어링 ai 개발환경 셋팅

kimminsung commented

2026-04-07 13:57:05 +09:00

이슈 #2 — 컨텍스트 엔지니어링 & AI 개발환경 셋업 완료

2026-04-07 일괄 완료. 상세 히스토리는 docs/history/2026-04-07_이슈2-*.md 참조.

완료 항목

#	작업	소요	Context	주요 산출물
1	리서치 & 에이전트 분해 (FlaUI/WinAppDriver/AutomationPeer 조사)	~15분	~45k	메모리 `project_recordingtest_plan.md`
2	구현 고려사항 8개 카테고리 정리	~5분	~52k	히스토리
3	Golden-file 회귀 전략 채택 (입력 레코딩 → 리플레이 → 저장파일 diff, ApprovalTests 패턴)	~5분	~58k	메모리 `project_recordingtest_strategy.md`
4	CLAUDE.md 작성	~5분	~63k	`CLAUDE.md`
5	AI 기반 AutomationPeer 부착 옵션 기록	~3분	~70k	메모리 `project_recordingtest_automationpeer_ai.md`
6	CLAUDE.md §0 PROGRESS/PLAN 협업 규칙 추가	~3분	~76k	`CLAUDE.md`
7	SUT (EG-BIM Modeler) 정적 분석 — 187개 플러그인, HmEG/SharpDX/MahApps 스택	~5분	~82k	`docs/sut-catalog/`
8	`.claude/` agents·commands·skills·hooks 셋업	~15분	~95k	`.claude/` 하위
9	Planner / Generator / Evaluator 분리 (Anthropic harness design 원칙)	~10분	~108k	`.claude/agents/planner.md`, `evaluator.md`, CLAUDE.md §0.1
10	병렬 스캐폴드 — Sprint Contracts 5건, SUT 카탈로그, 솔루션 뼈대, PROGRESS/PLAN 부트스트랩	~20분	~130k	`docs/contracts/`, `docs/sut-catalog/`, `recordingtest.sln`, `src/Recordingtest.SutProber/`, `PROGRESS.md`, `PLAN.md`
—	합계	~86분	peak ~130k

SUT 폴더는 .gitignore로 제외.

핵심 결정

1차 전략: Golden-file 회귀 — SUT 침습 최소화, ApprovalTests 패턴. 사용자가 수동 테스트 입력을 레코딩하면 player가 리플레이하고 저장 파일을 베이스라인과 diff한다.
Planner → Generator → Evaluator 분리 — 자기 작업 과대평가 편향 차단. 같은 세션이 구현·평가 겸직 금지.
파일 기반 핸드오프 — 컨텍스트가 차면 요약 대신 PROGRESS.md/PLAN.md/Sprint Contract에 상태를 쏟고 새 세션으로 리셋.
UIA 1순위: FlaUI, 3D 뷰포트는 UIA 사각지대 → 좌표+engine-bridge 하이브리드.

에이전트 / 커맨드 / 스킬 / 훅

Agents: planner, evaluator, sut-explorer, diff-triager, scenario-author
Commands: /contract, /evaluate, /sut-probe, /regress, /approve, /handoff, /progress
Skills: golden-file-normalizer, flaui-cookbook
Hooks: SessionStart(PROGRESS/PLAN 자동 주입), PreToolUse(Bash: SUT 실행 경고 / Edit·Write: SUT 폴더 수정 차단), Stop(핸드오프 리마인더)

다음 단계

P0-1: sut-prober PoC Generator 세션 → /evaluate sut-prober
P1: normalizer / recorder / player / diff-reporter (각 Sprint Contract 존재)

이슈 #2 개발환경 셋업 트랙은 여기서 마감. 후속 작업은 각 모듈 이슈로 분기 예정.

## 이슈 #2 — 컨텍스트 엔지니어링 & AI 개발환경 셋업 완료 2026-04-07 일괄 완료. 상세 히스토리는 `docs/history/2026-04-07_이슈2-*.md` 참조. ### 완료 항목 | # | 작업 | 소요 | Context | 주요 산출물 | |---|------|------|---------|------------| | 1 | 리서치 & 에이전트 분해 (FlaUI/WinAppDriver/AutomationPeer 조사) | ~15분 | ~45k | 메모리 `project_recordingtest_plan.md` | | 2 | 구현 고려사항 8개 카테고리 정리 | ~5분 | ~52k | 히스토리 | | 3 | **Golden-file 회귀 전략 채택** (입력 레코딩 → 리플레이 → 저장파일 diff, ApprovalTests 패턴) | ~5분 | ~58k | 메모리 `project_recordingtest_strategy.md` | | 4 | CLAUDE.md 작성 | ~5분 | ~63k | `CLAUDE.md` | | 5 | AI 기반 AutomationPeer 부착 옵션 기록 | ~3분 | ~70k | 메모리 `project_recordingtest_automationpeer_ai.md` | | 6 | CLAUDE.md §0 PROGRESS/PLAN 협업 규칙 추가 | ~3분 | ~76k | `CLAUDE.md` | | 7 | SUT (EG-BIM Modeler) 정적 분석 — 187개 플러그인, HmEG/SharpDX/MahApps 스택 | ~5분 | ~82k | `docs/sut-catalog/` | | 8 | `.claude/` agents·commands·skills·hooks 셋업 | ~15분 | ~95k | `.claude/` 하위 | | 9 | **Planner / Generator / Evaluator** 분리 (Anthropic harness design 원칙) | ~10분 | ~108k | `.claude/agents/planner.md`, `evaluator.md`, CLAUDE.md §0.1 | | 10 | 병렬 스캐폴드 — Sprint Contracts 5건, SUT 카탈로그, 솔루션 뼈대, PROGRESS/PLAN 부트스트랩 | ~20분 | ~130k | `docs/contracts/`, `docs/sut-catalog/`, `recordingtest.sln`, `src/Recordingtest.SutProber/`, `PROGRESS.md`, `PLAN.md` | | — | **합계** | **~86분** | peak ~130k | | SUT 폴더는 `.gitignore`로 제외. ### 핵심 결정 - **1차 전략: Golden-file 회귀** — SUT 침습 최소화, ApprovalTests 패턴. 사용자가 수동 테스트 입력을 레코딩하면 player가 리플레이하고 저장 파일을 베이스라인과 diff한다. - **Planner → Generator → Evaluator 분리** — 자기 작업 과대평가 편향 차단. 같은 세션이 구현·평가 겸직 금지. - **파일 기반 핸드오프** — 컨텍스트가 차면 요약 대신 PROGRESS.md/PLAN.md/Sprint Contract에 상태를 쏟고 새 세션으로 리셋. - **UIA 1순위: FlaUI**, 3D 뷰포트는 UIA 사각지대 → 좌표+engine-bridge 하이브리드. ### 에이전트 / 커맨드 / 스킬 / 훅 - **Agents**: `planner`, `evaluator`, `sut-explorer`, `diff-triager`, `scenario-author` - **Commands**: `/contract`, `/evaluate`, `/sut-probe`, `/regress`, `/approve`, `/handoff`, `/progress` - **Skills**: `golden-file-normalizer`, `flaui-cookbook` - **Hooks**: SessionStart(PROGRESS/PLAN 자동 주입), PreToolUse(Bash: SUT 실행 경고 / Edit·Write: SUT 폴더 수정 차단), Stop(핸드오프 리마인더) ### 다음 단계 P0-1: `sut-prober` PoC Generator 세션 → `/evaluate sut-prober` P1: normalizer / recorder / player / diff-reporter (각 Sprint Contract 존재) 이슈 #2 개발환경 셋업 트랙은 여기서 마감. 후속 작업은 각 모듈 이슈로 분기 예정.

kimminsung referenced this issue from a commit

2026-04-07 13:57:22 +09:00

Set up AI dev environment for recordingtest (#2)

kimminsung referenced this issue

2026-04-07 14:04:32 +09:00

sut-prober PoC 구현 및 검증 #3

kimminsung referenced this issue

2026-04-07 14:09:57 +09:00

normalizer PoC 구현 및 검증 #4

kimminsung referenced this issue

2026-04-07 14:10:02 +09:00

diff-reporter PoC 구현 및 검증 #5