| name | code-validation |
| description | Sossbar 코드 품질 검증 스킬. guardian 에이전트가 구현된 코드의 타입, 린트, 아키텍처 규칙을 검증하고 수정할 때 사용. |
코드 품질 검증 절차
검증 순서
1단계: 정적 분석 (자동)
pnpm lint
pnpm build
lint/build가 PASS여야 다음 단계로 진행한다.
2단계: 경계면 교차 비교 (수동)
파일을 하나씩 읽는 것이 아니라 경계를 넘나드는 지점을 집중 검사한다:
| 경계면 | 검사 항목 |
|---|
| API 함수 ↔ Zod 스키마 | 응답 shape와 스키마가 일치하는가 |
| Zod 스키마 ↔ 훅 리턴 타입 | infer된 타입이 훅에서 올바르게 흐르는가 |
| 훅 ↔ 컴포넌트 props | 훅 리턴값이 컴포넌트가 기대하는 타입과 맞는가 |
| 도메인 ↔ shared | shared에 올린 것이 실제 2개 이상 도메인에서 쓰이는가 |
3단계: 컨벤션 체크리스트
[ ] default export: Next.js page/layout 외에 없는가
[ ] 화살표 함수 컴포넌트만 사용했는가
[ ] import type 분리했는가
[ ] cn() 사용 (clsx/twMerge 직접 사용 없는가)
[ ] any 없는가
[ ] console 없는가
[ ] 파일이 올바른 도메인/레이어에 위치하는가
[ ] index.ts에서 외부 공개 심볼만 re-export 하는가
4단계: 수정
발견된 문제는 직접 수정한다. 수정 후 pnpm lint && pnpm build 재실행으로 확인.
에스컬레이션 기준
직접 수정하지 않고 오케스트레이터에게 에스컬레이션:
- 도메인 배치 자체가 잘못된 경우 (planner 재실행 필요)
- 순환 참조 발생
- 기존 API 계약과 충돌하는 타입 불일치
report 작성 기준
- "없음"도 명시 (미해결 문제 없음 = 신뢰도 높음)
- 수정한 내용은 파일명 + 무엇을 왜 바꿨는지 기록
- 최종 상태:
DONE (정상) 또는 ESCALATE (에스컬레이션 필요)