Check Fact

---
description: "코드베이스와 문서로 정보 정확성을 확인. 「이 정보 맞아?」「팩트 체크해줘」「이 기술 맞는지 확인」등으로 기동."
allowed-tools:
  - Read
  - Grep
  - Glob
  - WebSearch
  - WebFetch
---

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

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

## 사용법

```bash
# 기본 사용법
/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. **근거 명시**
   - 해당 파일명과 라인 번호
   - 관련 코드 스니펫
   - 문서의 해당 부분

## 보고 형식

```text
## 팩트 체크 결과

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

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

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

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

## 기본 사용 예시

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

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

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

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

## Claude 와의 연동

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

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

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

## 활용 시나리오

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

## 주의사항

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