Files

minsung 0f0324efb5 sut-prober snake_case JSON + scaffolding review 1회차

- SutProber JsonNamingPolicy.SnakeCaseLower (strict contract compliance)
- Regenerated docs/sut-catalog/*.json
- CoverageTests: accept both snake_case and PascalCase (resilience)
- docs/history: scaffolding review 1회차 (no removals, audit only)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-07 20:41:51 +09:00

3.5 KiB

Raw Blame History

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	설치 스크립트	유지

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

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

이번 감사에서 정리한 것

없음 (감사만, 삭제 보류)

다음 감사 권장 시점

engine-bridge v3 완료 후
smoke 2회차 pass 후
또는 PoC 모듈이 3개 더 추가됐을 때

추가 follow-up

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

3.5 KiB Raw Blame History