Initial commit

commands/check-fact.md

@@ -0,0 +1,104 @@
+## 팩트 체크
+
+프로젝트 내 코드베이스, 문서(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 에 기재된 기능은 모두 구현되었다"
+```
+
+### 활용 시나리오
+
+- 기술 사양서 작성 시: 기재 내용의 정확성 확인
+- 프로젝트 인수인계 시: 기존 구현의 이해도 확인
+- 클라이언트 보고 전: 구현 상황의 사실 확인
+- 기술 블로그 작성 시: 글 내용의 정확성 검증
+- 면접·설명 자료 작성 시: 프로젝트 개요의 정확성 확인
+
+### 주의사항
+
+- 코드베이스가 가장 신뢰도 높은 정보원입니다
+- 문서가 오래된 경우 구현을 우선합니다
+- 판단에 필요한 정보가 부족한 경우 솔직히 "판단 불가"로 합니다
+- 보안 관련 정보는 특히 신중하게 검증합니다