# 2026-04-07 Scaffolding Review 1회차

- **작업**: `.claude/` 비계 주기 감사 (harness design 원칙)
- **소요 시간**: ~10분
- **Context 사용량**: ~420k tokens (orchestrator 누적)

## 범위

PoC 8개 완료 + smoke 2차 fix 완료 시점에서 `.claude/` 하위 agents/commands/skills/hooks 인벤토리 감사.

## 인벤토리

### Agents (5) — 모두 유효
| Agent | 사용 이력 | 평가 |
|-------|----------|------|
| planner | 간접 사용 (orchestrator가 contract 직접 작성) | 유지 — `/contract` 커맨드 경유 가치 있음 |
| evaluator | 10+ Evaluator 사이클에서 사용 | 핵심 |
| sut-explorer | 미사용 (sut-prober 코드로 대체) | **검토 대상**: 실행 이력 없음. 향후 dynamic 분석 필요 시 부활 |
| diff-triager | 미사용 (아직 실제 실패 triage 미발생) | 유지 — 첫 회귀 실패 시 필요 |
| scenario-author | 미사용 | 유지 — 향후 자연어 → yaml 변환 시 필요 |

### Commands (7) — 대부분 미사용
| Command | 사용 이력 | 평가 |
|---------|----------|------|
| contract | 미사용 (orchestrator 직접 작성) | **검토**: 실질 가치 재검토 |
| evaluate | 미사용 (Agent tool 직접 호출로 대체) | **검토**: 실질 가치 재검토 |
| sut-probe | 미사용 (sut-prober exe 직접 실행) | **검토** |
| regress | 미사용 (test-runner 미배포) | 유지 — 러너 배포 후 사용 예정 |
| approve | 미사용 | 유지 — baseline 승격 워크플로에 필요 |
| handoff | 미사용 (직접 PROGRESS 편집) | **검토** |
| progress | 미사용 (orchestrator가 직접 read) | **검토** |

**관찰**: 커맨드는 명시적 슬래시 호출이 필요한데 orchestrator 세션에서는 일반 도구 호출이 더 빠름. 커맨드는 **사용자 직접 호출 용도**로 한정 가치.

### Skills (3) — 적절
| Skill | 평가 |
|-------|------|
| flaui-cookbook | 유지 — recorder/player 작업 시 참조 |
| golden-file-normalizer | 유지 — normalizer 규칙 저작 시 참조 |
| aptabase | 별도 플러그인 (외부 서비스), 유지 |

### Hooks (7 active) — 핵심
| Hook | 사용 이력 | 평가 |
|------|----------|------|
| session-start-progress.sh | 세션마다 PROGRESS/PLAN 주입 | 핵심 |
| stop-handoff-reminder.sh | 세션 종료 시 경고 | 유지 |
| guard-sut-folder.sh | SUT 폴더 보호 | 핵심 |
| guard-sut-launch.sh | SUT 실행 경고 | 유지 |
| aptabase-* | 외부 텔레메트리 | 별도 관리 |
| install-git-hook.sh | 설치 스크립트 | 유지 |

## 권고 (실행 보류, 검토만)

1. **미사용 커맨드 4개** (`contract`, `evaluate`, `handoff`, `progress`): orchestrator 세션 관점에선 redundant. 단 **사용자가 직접 `/handoff` 같은 걸 치는 시나리오**는 유효. 삭제 대신 문서화로 보완 권장.
2. **`sut-explorer` 에이전트**: 미사용. 정적 분석은 `sut-prober` 코드가 담당. 제거 후보.
3. **`diff-triager` 에이전트**: 아직 트리거된 적 없지만 첫 실 regression 실패 시 필요 → 유지.
4. **`scenario-author` 에이전트**: 향후 자연어 시나리오 변환 시 가치. 유지.

## 이번 감사에서 정리한 것
- 없음 (감사만, 삭제 보류)

## 다음 감사 권장 시점
- engine-bridge v3 완료 후
- smoke 2회차 pass 후
- 또는 PoC 모듈이 3개 더 추가됐을 때

## 추가 follow-up

`.claude/settings.json`의 hooks 섹션에 `aptabase-*` 관련 등록 상태와 현재 운영 일치 여부는 aptabase skill 담당 범위라 감사 제외.