Claude Code, 80개 컴포넌트 React 라이브러리 문서 감사: 실제 버그 발견, 새로운 버그 도입

대규모 React 컴포넌트 라이브러리를 유지보수하는 시니어 엔지니어가 Claude Code를 사용해 80개 컴포넌트에 대한 문서를 한 세션에서 감사했습니다. AI는 실제 버그(구식 props, 누락된 경계 사례, 잘못된 사용 예제)를 잡아냈지만, 수동 검토가 필요한 새로운 오류도 도입했습니다.

잘된 점

• 문서화되었지만 소스 코드에 더 이상 존재하지 않는 props 식별
• 최근 커밋에서 추가된 새 props에 대한 문서 누락 플래그 지정
• JSDoc과 실제 TypeScript 타입 간의 불일치한 타입 정의 발견

문제점

• Claude가 존재하지 않는 props를 생성 (할루시네이션)
• 일부 props의 기본값을 잘못 업데이트
• 중복이라고 판단한 유효한 문서 섹션을 제거
• 컴파일되지 않는 예제 코드 생성

전체 글에는 사용된 정확한 프롬프트, 세션 구조, 각 오탐지 및 할루시네이션 분석이 포함되어 있습니다. 저자는 AI 생성 문서 변경 사항을 커밋하기 전에 항상 diff 검토를 권장합니다.