코드베이스와 문서로 정보 정확성을 확인

코드베이스와 문서로 정보 정확성을 확인

프로젝트 내 코드베이스, 문서(docs/, README.md 등)를 참조하여 주어진 정보의 정확성을 확인하는 명령어입니다.

사용법

# 기본 사용법
/check-fact "Flutter 앱에서 Riverpod 을 사용하고 있다"

# 여러 정보를 한 번에 확인
/check-fact "이 프로젝트는 GraphQL 을 사용하고 auto_route 로 라우팅을 관리한다"

# 특정 기술 사양에 대한 확인
/check-fact "인증에는 JWT 를 사용하고 Firebase Auth 는 사용하지 않는다"

확인 프로세스

1. 정보원 우선순위

   • 코드베이스 (가장 신뢰도 높음)
   • README.md, docs/ 내 문서
   • package.json, pubspec.yaml 등 설정 파일
   • Issue, Pull Request 토론 기록

2. 판정 결과 분류

   • ✅ 맞음 - 정보가 코드베이스와 완전히 일치
   • ❌ 틀림 - 정보가 명확히 잘못됨
   • ⚠️ 부분적으로 맞음 - 부분적으로 정확하지만 불완전
   • ❓ 판단 불가 - 확인에 필요한 정보 부족

3. 근거 명시

   • 해당 파일명과 라인 번호
   • 관련 코드 스니펫
   • 문서의 해당 부분

보고 형식

## 팩트 체크 결과

### 검증 대상
"[사용자가 제공한 정보]"

### 결론
[✅/❌/⚠️/❓] [판정 결과]

### 근거
- **파일**: `path/to/file.dart:123`
- **내용**: [해당 코드/문장]
- **보충**: [추가 설명]

### 상세 설명
[틀린 경우 올바른 정보 제시]
[부분적으로 맞는 경우 부정확한 부분 지적]
[판단 불가인 경우 부족한 정보 설명]

기본 사용 예시

# 프로젝트 기술 스택 확인
/check-fact "이 앱은 Flutter + Riverpod + GraphQL 구성으로 되어있다"

# 구현 상태 확인
/check-fact "다크모드 기능이 구현되어 있고 사용자 설정에서 전환 가능하다"

# 아키텍처 확인
/check-fact "상태관리는 모두 Riverpod 으로 하고 BLoC 은 사용하지 않는다"

# 보안 구현 확인
/check-fact "인증 토큰은 secure storage 에 암호화해서 저장한다"

Claude 와의 연동

# 코드베이스 전체 분석 후 확인
ls -la && find . -name "pubspec.yaml" -exec cat {} \;
/check-fact "이 프로젝트에서 사용하는 주요 의존성은..."

# 특정 기능의 구현 상태 확인
grep -r "authentication" . --include="*.dart"
/check-fact "인증 기능은 커스텀 구현이고 써드파티 인증은 사용하지 않는다"

# 문서와의 일치성 확인
cat README.md
/check-fact "README 에 기재된 기능은 모두 구현되었다"

활용 시나리오

• 기술 사양서 작성 시: 기재 내용의 정확성 확인
• 프로젝트 인수인계 시: 기존 구현의 이해도 확인
• 클라이언트 보고 전: 구현 상황의 사실 확인
• 기술 블로그 작성 시: 글 내용의 정확성 검증
• 면접·설명 자료 작성 시: 프로젝트 개요의 정확성 확인

주의사항

• 코드베이스가 가장 신뢰도 높은 정보원입니다
• 문서가 오래된 경우 구현을 우선합니다
• 판단에 필요한 정보가 부족한 경우 솔직히 "판단 불가"로 합니다
• 보안 관련 정보는 특히 신중하게 검증합니다