@kood/claude-code 0.6.0 → 0.6.2

package/templates/.claude/instructions/sourcing/reliable-search.md

@@ -0,0 +1,411 @@
+# Reliable Search Guide
+
+**목적**: 검색 결과의 최신성과 신뢰성 보장, 중복 검색 방지 및 효율적 검색 전략
+
+**참조**: @../context-optimization/redundant-exploration-prevention.md
+
+---
+
+## 중복 검색 방지 (Duplicate Search Prevention)
+
+**목적**: 동일 쿼리 반복 실행 방지, 컨텍스트 윈도우 절약, Rate Limiting 회피
+
+### 핵심 규칙
+
+| 규칙 | 실행 |
+|------|------|
+| **같은 쿼리 금지** | 동일 쿼리 반복 실행 금지 (WebSearch + SearXNG 같은 쿼리 금지) |
+| **이전 결과 확인** | 검색 전 이전 검색 결과 확인 |
+| **유사 쿼리 병합** | 유사한 쿼리는 한 번에 실행 |
+| **검색 종료 조건** | 목표 정보 획득, 교차 검증 완료, 검색 깊이 도달 |
+
+### 검색 전 체크리스트
+
+```text
+✓ 이 쿼리를 이미 실행했는가?
+  → YES: 이전 결과 활용 (재검색 금지)
+  → NO: 검색 실행
+
+✓ 이전 결과로 충분한가?
+  → YES: 검색 중단, 다음 단계 진행
+  → NO: 다른 각도의 쿼리 생성
+
+✓ 다른 각도의 쿼리가 필요한가?
+  → YES: 새로운 관점 쿼리 생성
+  → NO: 이전 결과 활용
+
+✓ 같은 채널에 같은 쿼리를 보내는가?
+  → YES: 금지 (WebSearch + SearXNG 같은 쿼리)
+  → NO: 허용
+```
+
+### 허용/금지 패턴
+
+```typescript
+// ❌ 금지: 같은 쿼리 반복
+WebSearch({ query: "React best practices 2026" })
+// ... 작업 ...
+WebSearch({ query: "React best practices 2026" })  // 중복!
+
+// ❌ 금지: 다른 채널에 같은 쿼리
+WebSearch({ query: "Next.js 15 features" })
+SearXNG({ query: "Next.js 15 features" })  // 중복!
+
+// ✅ 올바름: 다른 각도 쿼리
+WebSearch({ query: "React best practices 2026" })
+WebSearch({ query: "React performance optimization 2026" })  // 다른 각도
+
+// ✅ 올바름: 채널별 특화 쿼리
+WebSearch({ query: "Next.js 15 features overview" })  // 개요
+SearXNG({ query: "Next.js 15 breaking changes" })     // 상세 변경사항
+```
+
+---
+
+## 검색 결과 캐싱 전략 (Search Result Caching)
+
+**목적**: 검색 결과 재사용, 동일 세션 내 재검색 방지, 컨텍스트 절약
+
+### 캐싱 규칙
+
+| 규칙 | 실행 |
+|------|------|
+| **파일로 저장** | 장기 세션 시 검색 결과를 파일로 저장 |
+| **요약 형식** | 전문 저장 대신 요약 형식으로 컨텍스트 절약 |
+| **캐시 활용** | 동일 세션 내 재검색 시 캐시 파일 확인 |
+| **주제별 분류** | 주제별 디렉토리 구조로 관리 |
+
+### 저장 위치 및 형식
+
+```markdown
+저장 위치: .claude/research/[topic]/
+
+파일 구조:
+- sources.md: URL + 발행일 + 요약
+- findings.md: 핵심 발견사항
+- queries.md: 실행한 쿼리 목록 (중복 방지)
+```
+
+### 캐시 파일 예시
+
+```markdown
+# .claude/research/react-2026/sources.md
+
+## 검색 쿼리 기록
+- "React best practices 2026" (WebSearch, 2026-02-06)
+- "React performance optimization 2026" (SearXNG, 2026-02-06)
+
+## 출처 목록
+
+### S등급 (공식 문서)
+- https://react.dev/blog/2026/01/react-19-release
+  - 발행일: 2026-01-15
+  - 요약: React 19 정식 릴리스, Server Components 안정화
+  - 핵심: Actions, useOptimistic, use() hook
+
+### A등급 (주요 기술 미디어)
+- https://vercel.com/blog/react-19-adoption
+  - 발행일: 2026-01-20
+  - 요약: React 19 도입 가이드, 마이그레이션 전략
+  - 핵심: 점진적 도입, 호환성 확인
+
+---
+
+# .claude/research/react-2026/findings.md
+
+## 핵심 발견사항 (2026-02-06)
+
+### React 19 주요 변경사항
+1. Server Components 기본 지원
+2. Actions API 안정화
+3. useOptimistic hook 추가
+4. use() hook으로 Promise/Context 처리
+
+### 성능 최적화 패턴
+1. React Compiler 사용 (자동 메모이제이션)
+2. Suspense Boundary 전략적 배치
+3. Streaming SSR 최적화
+
+### 교차 검증 완료
+- Server Components 안정화: 2개 소스 확인 (react.dev, vercel.com)
+- React Compiler: 3개 소스 확인 (공식 문서, Meta blog, Vercel blog)
+```
+
+### 캐시 활용 흐름
+
+```typescript
+// ✅ 올바른 흐름: 캐시 확인 → 검색
+// 1. 캐시 확인
+Read(".claude/research/react-2026/queries.md")
+// → "React best practices 2026" 이미 검색함
+
+// 2-1. 캐시 결과 활용
+Read(".claude/research/react-2026/findings.md")
+// → 핵심 발견사항 확인
+
+// 2-2. 추가 정보 필요 시 다른 각도 쿼리
+WebSearch({ query: "React security best practices 2026" })
+// → 새로운 각도 (보안)
+```
+
+---
+
+## 검색 범위 사전 결정 (Search Scope Pre-Planning)
+
+**목적**: 검색 시작 전 범위와 깊이 결정, 무분별한 검색 방지
+
+### 검색 계획 단계
+
+| 단계 | 결정 사항 | 예시 |
+|------|----------|------|
+| **1. 정보 유형** | 공식 문서 vs 블로그 vs 벤치마크 | 공식 문서: Context7, 벤치마크: WebSearch |
+| **2. 검색 깊이** | Quick(3쿼리) / Medium(5쿼리) / Deep(10쿼리) | 개요: Quick, 완전 분석: Deep |
+| **3. 우선순위 채널** | Context7 → GitHub → WebSearch | 라이브러리 문서 우선 |
+| **4. 종료 조건** | 목표 달성 / 교차 검증 완료 / 깊이 도달 | 2+ 소스 교차 검증 완료 시 종료 |
+
+### 검색 깊이 기준
+
+| 깊이 | 쿼리 수 | 용도 | 예시 |
+|------|---------|------|------|
+| **Quick** | 1-3개 | 개요 파악, 빠른 확인 | "React 19란?", "주요 변경사항" |
+| **Medium** | 4-6개 | 표준 조사, 비교 분석 | "React vs Vue 2026", "성능 비교" |
+| **Deep** | 7-10개 | 완전 분석, 심층 연구 | "React 생태계 전체", "마이그레이션 전략" |
+
+### 검색 시작 전 체크리스트
+
+```text
+✓ 필요한 정보 유형은?
+  - 공식 문서: Context7 MCP → 라이브러리 문서 직접 조회
+  - 코드 예시: GitHub MCP → 리포지토리/코드 검색
+  - 최신 동향: WebSearch/SearXNG → 블로그/미디어
+  - 벤치마크: WebSearch → 성능 비교 자료
+
+✓ 검색 깊이는?
+  - Quick: 개요만 필요
+  - Medium: 비교 분석 필요
+  - Deep: 완전한 이해 필요
+
+✓ 우선순위 채널은?
+  1순위: Context7 (라이브러리 공식 문서)
+  2순위: GitHub (코드, 이슈, 릴리스)
+  3순위: WebSearch/SearXNG (웹 검색)
+
+✓ 검색 종료 조건은?
+  - 목표 정보 획득
+  - 교차 검증 완료 (2+ 소스)
+  - 검색 깊이 도달
+```
+
+### 채널별 우선순위 전략
+
+```typescript
+// ✅ 올바른 흐름: 우선순위대로 검색
+
+// Phase 1: Context7 (라이브러리 문서)
+Context7_resolve_library_id({ libraryName: "react" })
+Context7_query_docs({
+  libraryId: "react",
+  query: "Server Components"
+})
+// → 공식 문서로 기본 정보 확보
+
+// Phase 2: GitHub (코드 예시, 이슈)
+GitHub_search_repositories({
+  query: "react server components production",
+  sort: "stars"
+})
+// → 실제 구현 사례 확인
+
+// Phase 3: WebSearch (최신 동향, 블로그)
+WebSearch({
+  query: "React Server Components production experience 2026"
+})
+// → 실전 경험, 문제 해결 사례 확인
+
+// 종료 조건 확인:
+// ✓ 목표 정보 획득 (Server Components 개념, 구현, 경험)
+// ✓ 교차 검증 완료 (공식 문서 + GitHub + 블로그)
+// → 검색 종료
+```
+
+### 검색 종료 조건
+
+| 조건 | 기준 | 처리 |
+|------|------|------|
+| **목표 정보 획득** | 필요한 정보 모두 확보 | 즉시 검색 종료 |
+| **교차 검증 완료** | 핵심 주장 2+ 소스 확인 | 추가 검색 불필요 |
+| **검색 깊이 도달** | Quick(3) / Medium(5) / Deep(10) | 종료 조건 재평가 |
+| **중복 결과 반복** | 새로운 정보 없음 (3회 연속) | 검색 종료 |
+
+---
+
+## 날짜 인식 검색 (Date-Aware Search)
+
+| 규칙 | 실행 |
+|------|------|
+| **연도 포함** | 모든 검색 쿼리에 현재 연도 포함 (예: "React best practices 2026") |
+| **기간 필터** | SearXNG: `time_range=year`, WebSearch: 쿼리에 연도 추가 |
+| **한국어 쿼리** | "2026년 기준", "최신" 키워드 포함 |
+| **영어 쿼리** | "2025-2026", "latest", "current" 키워드 포함 |
+
+```typescript
+// ✅ 올바른 검색 쿼리
+WebSearch({ query: "AI agent frameworks comparison 2026" })
+WebSearch({ query: "SaaS 시장 트렌드 2026년" })
+
+// ❌ 연도 없는 검색 (오래된 결과 반환 위험)
+WebSearch({ query: "AI agent frameworks comparison" })
+```
+
+---
+
+## 출처 신뢰도 등급
+
+| 등급 | 소스 유형 | 예시 |
+|------|----------|------|
+| **S (최고)** | 공식 문서, 논문, 1차 데이터 | docs.prisma.io, arxiv.org, 정부 통계 |
+| **A (높음)** | 공식 블로그, 주요 기술 미디어, 검증된 벤치마크 | engineering.fb.com, infoq.com, GitHub Releases |
+| **B (보통)** | 개인 기술 블로그, 커뮤니티, Stack Overflow | dev.to, medium.com, reddit.com |
+| **C (낮음)** | AI 생성 의심 콘텐츠, 오래된 문서, 미검증 주장 | 날짜 없는 블로그, SEO 스팸 |
+
+### 신뢰도 검증 규칙
+
+| 체크 | 기준 | 처리 |
+|------|------|------|
+| **날짜 확인** | 발행일 12개월 이내 | 초과 시 "⚠ 오래된 자료" 표기 |
+| **저자 확인** | 실명/소속 확인 가능 | 익명 → 등급 1단계 하향 |
+| **교차 검증** | 핵심 주장은 2개+ 소스 확인 | 단일 소스 주장 → "미검증" 표기 |
+| **이해충돌** | 벤더 자사 제품 주장 | "벤더 출처" 명시, 독립 소스 교차 확인 |
+
+---
+
+## 검색 쿼리 패턴
+
+### 다각도 쿼리 생성
+
+```
+기본: "[주제] [연도]"
+심층: "[주제] benchmark performance [연도]"
+비교: "[주제A] vs [주제B] comparison [연도]"
+한국어: "[주제] 최신 동향 [연도]년"
+실패 사례: "[주제] pitfalls mistakes lessons learned"
+```
+
+### 채널별 최적 쿼리
+
+| 채널 | 쿼리 전략 |
+|------|----------|
+| **WebSearch** | 연도 포함, 영어+한국어 병렬 |
+| **SearXNG** | `time_range=year` + 연도 키워드 |
+| **Firecrawl** | 공식 문서 URL 직접 지정 |
+| **GitHub** | `created:>YYYY-01-01` 필터, stars 정렬 |
+
+---
+
+## Smart Tier Fallback
+
+```
+Tier 1 (MCP, ToolSearch로 감지):
+  SearXNG MCP  → 메타검색 (246+ 엔진, 시간 필터 지원)
+  Firecrawl MCP → 페이지→MD 변환, 사이트 구조 파악
+  GitHub MCP   → 코드/리포/이슈/릴리스 검색
+  Context7 MCP → 라이브러리 문서 즉시 조회
+
+Tier 2 (내장, 항상 가용):
+  WebSearch → 웹 검색 (연도 키워드 필수)
+  WebFetch  → 페이지 직접 읽기
+  gh CLI    → GitHub API (Bash via explore)
+
+Tier 3: Playwright → SPA/JS 렌더링 필요 시 (crawler skill)
+```
+
+**MCP는 main agent가 직접 실행** (subagent는 MCP 도구 사용 불가)
+
+| MCP 도구 | 용도 | 미설치 시 폴백 |
+|----------|------|--------------|
+| `firecrawl_map/scrape/crawl` | 사이트 구조/페이지 수집 | WebFetch (페이지별) |
+| SearXNG `web_search` | 246+ 엔진 메타검색 | WebSearch (내장) |
+| `search_repositories/code/issues` | GitHub 리포/코드/이슈 | `gh search` (Bash) |
+| `resolve-library-id` + `query-docs` | 라이브러리 문서 조회 | WebFetch (직접) |
+
+### MCP 감지 (Phase 0 공통)
+
+```
+ToolSearch("firecrawl") → Firecrawl 활성화
+ToolSearch("searxng")   → SearXNG 활성화
+ToolSearch("github")    → GitHub MCP 활성화
+ToolSearch("context7")  → Context7 활성화
+```
+
+---
+
+## 수집 후 검증
+
+| 단계 | 검증 |
+|------|------|
+| **날짜 체크** | 핵심 소스 발행일 확인, 12개월 초과 시 표기 |
+| **등급 분류** | 각 소스에 S/A/B/C 등급 부여 |
+| **교차 검증** | 핵심 주장 2개+ 소스 확인 |
+| **편향 체크** | 벤더/광고 소스 식별, 독립 소스 보완 |
+
+### researcher 에이전트 프롬프트 필수 포함
+
+```
+"검색 시 현재 연도(YYYY) 포함, 12개월 이내 자료 우선.
+ 각 출처: URL + 발행일 + 소스 유형(공식/블로그/커뮤니티).
+ 핵심 주장은 2개+ 소스로 교차 검증.
+ 중복 검색 방지: 이전 쿼리 확인, 같은 쿼리 재실행 금지."
+```
+
+---
+
+## 검색 효율성 모니터링
+
+### 검색 통계 추적
+
+**세션 내 검색 패턴 모니터링**
+
+```markdown
+# 검색 통계 (세션 내)
+
+## 검색 쿼리 기록
+- "React best practices 2026" (WebSearch, 2026-02-06 10:30)
+- "React performance optimization 2026" (SearXNG, 2026-02-06 10:35)
+- "Next.js 15 features" (Context7, 2026-02-06 10:40)
+
+## 검색 효율성 지표
+| 지표 | 목표 | 현재 | 상태 |
+|------|------|------|------|
+| **중복 검색률** | < 5% | 0% | ✅ 우수 |
+| **검색 깊이** | Quick(3) | 3회 | ✅ 정상 |
+| **교차 검증** | 2+ 소스 | 3개 | ✅ 완료 |
+| **캐시 활용률** | > 30% | 0% | ⚠️ 신규 주제 |
+
+## 경고
+✅ 중복 검색 없음
+✅ 검색 깊이 적절
+```
+
+### 검색 품질 체크리스트
+
+```text
+✓ 중복 검색 방지
+  - [ ] 이전 쿼리 확인
+  - [ ] 같은 쿼리 재실행 금지
+  - [ ] 유사 쿼리 병합
+
+✓ 검색 범위 계획
+  - [ ] 정보 유형 결정
+  - [ ] 검색 깊이 설정
+  - [ ] 우선순위 채널 선택
+
+✓ 결과 검증
+  - [ ] 날짜 확인 (12개월 이내)
+  - [ ] 등급 분류 (S/A/B/C)
+  - [ ] 교차 검증 (2+ 소스)
+
+✓ 캐싱 전략
+  - [ ] 검색 결과 저장
+  - [ ] 요약 형식 작성
+  - [ ] 캐시 활용 확인
+```

package/templates/.claude/instructions/validation/forbidden-patterns.md

@@ -260,6 +260,51 @@ const handleSubmit = () => {
 ✅ 기존 문서 수정 우선
 ```
 
+## 탐색 및 범위
+
+### 금지 17: 탐색 루프
+
+**같은 파일을 3회 이상 읽기 금지 (변경 후 확인 제외)**
+
+```typescript
+// ❌ 금지: 동일 파일 반복 읽기
+Read("src/auth.ts")  // 1회
+// ... 다른 작업 ...
+Read("src/auth.ts")  // 2회
+// ... 다른 작업 ...
+Read("src/auth.ts")  // 3회 → 금지!
+
+// ✅ 올바름: 1회 읽기 → 결과 활용
+Read("src/auth.ts")  // 1회: 내용 파악 후 기억
+Edit(...)            // 수정
+Read("src/auth.ts")  // 2회: 변경 확인 (허용)
+```
+
+**탐색 루프 감지 시:**
+1. 즉시 중단
+2. 이미 읽은 내용 기반으로 다음 단계 진행
+3. 추가 정보 필요 시 explore 에이전트에 위임
+
+### 금지 18: 범위 축소
+
+**"모든 X" / "전체 X" 지시에서 전체 대상 열거 없이 작업 시작 금지**
+
+```typescript
+// ❌ 금지: 열거 없이 일부만 처리
+// 사용자: "모든 SKILL.md에서 TodoWrite를 TaskCreate로 변경"
+Edit("skills/plan/SKILL.md", ...)     // plan만 수정
+Edit("skills/ralph/SKILL.md", ...)    // ralph만 수정
+// → 나머지 스킬 누락!
+
+// ✅ 올바름: 전체 열거 → 전체 처리
+Glob({ pattern: "**/SKILL.md" })      // 전체 대상 확인
+// → 결과: 19개 파일
+TaskCreate({ subject: "19개 SKILL.md TodoWrite→TaskCreate 교체", ... })
+// → 19개 모두 처리
+Glob({ pattern: "**/SKILL.md" })      // 재스캔 확인
+Grep({ pattern: "TodoWrite", glob: "**/SKILL.md" })  // 누락 0개 확인
+```
+
 ## 종합 체크리스트
 
 작업 시작 전:
@@ -269,6 +314,7 @@ const handleSubmit = () => {
 - [ ] 검증 단계 스킵하지 않기
 - [ ] 병렬 실행 가능 여부 확인
 - [ ] 에이전트 활용 계획
+- [ ] "모든 X" 작업: 전체 열거 확인 (금지 18)
 
 작업 중:
 
@@ -277,5 +323,6 @@ const handleSubmit = () => {
 - [ ] Prisma 자동 실행 금지
 - [ ] 수동 검증/인증 금지
 - [ ] 문서 업데이트 누락 방지
+- [ ] 탐색 루프 방지: 같은 파일 3회+ 읽기 금지 (금지 17)
 
 **금지 패턴 회피 → 품질 향상 + 안정성 확보**

package/templates/.claude/instructions/validation/required-behaviors.md

@@ -295,6 +295,124 @@ Task(subagent_type="planner", model="opus", ...)
 Task(subagent_type="explore", ...)
 ```
 
+## 탐색 효율
+
+### 필수 19: 파일 인벤토리 생성
+
+**복잡한 작업(5개+ 파일 수정) 시작 전 TaskCreate로 대상 파일 목록 등록**
+
+```typescript
+// ✅ 필수: 작업 대상 파일 인벤토리
+TaskCreate({
+  subject: "auth 리팩토링 대상 파일",
+  description: "src/middleware/auth.ts, src/functions/auth.ts, src/routes/login/..."
+})
+
+// ❌ 금지: 인벤토리 없이 즉시 구현 시작
+Edit({ file_path: "src/middleware/auth.ts", ... })
+```
+
+### 필수 20: 동일 파일 중복 읽기 금지
+
+**같은 파일을 2회 이상 Read 금지 (변경 후 재확인은 허용)**
+
+```typescript
+// ✅ 허용: 수정 후 재확인
+Read("src/auth.ts")  // 1회: 내용 파악
+Edit(...)            // 수정
+Read("src/auth.ts")  // 2회: 변경 확인 (허용)
+
+// ❌ 금지: 같은 내용 반복 읽기
+Read("src/auth.ts")  // 1회
+// ... 다른 작업 ...
+Read("src/auth.ts")  // 2회: 변경 없이 재읽기
+```
+
+### 필수 21: Explore 에이전트 thoroughness 명시
+
+**Explore 에이전트 호출 시 탐색 깊이 반드시 지정**
+
+```typescript
+// ✅ 필수: thoroughness 명시
+Task(subagent_type="explore", model="haiku",
+     prompt="[quick] src/routes/ 디렉토리 파일 목록 확인")
+Task(subagent_type="explore", model="haiku",
+     prompt="[very thorough] 인증 관련 모든 파일 및 의존성 완전 분석")
+
+// ❌ 금지: thoroughness 누락
+Task(subagent_type="explore", model="haiku",
+     prompt="인증 관련 파일 분석")
+```
+
+### 필수 22: 탐색 결과 즉시 요약
+
+**탐색/분석 결과는 즉시 요약 후 다음 단계 진행. 요약 없이 추가 탐색 금지.**
+
+```typescript
+// ✅ 올바른 흐름
+Task(subagent_type="explore", ...)  // 탐색
+// → 결과 요약: "인증은 3개 파일, 미들웨어 1개, 라우트 2개"
+// → 다음 단계: 구현 시작
+
+// ❌ 금지: 요약 없이 추가 탐색
+Task(subagent_type="explore", ...)  // 탐색 1
+Task(subagent_type="explore", ...)  // 요약 없이 탐색 2
+Task(subagent_type="explore", ...)  // 요약 없이 탐색 3
+```
+
+## 범위 완전성
+
+### 필수 23: 전체 대상 열거
+
+**"모든 X" / "전체 X" 지시 시 Glob/Grep으로 전체 대상 목록 먼저 생성**
+
+```typescript
+// ✅ 필수: 전체 대상 열거 후 작업
+Glob({ pattern: "**/*.prisma" })  // 전체 대상 확인
+// → 결과: 5개 파일 발견
+TaskCreate({ subject: "prisma 파일 5개 수정", ... })
+
+// ❌ 금지: 열거 없이 작업 시작
+Edit({ file_path: "prisma/schema/user.prisma", ... })  // 일부만 수정
+```
+
+### 필수 24: 열거 목록 TaskCreate 등록
+
+**전체 대상 열거 후 TaskCreate에 등록하고 하나씩 완료 체크**
+
+```typescript
+// ✅ 필수: 목록화 후 순차 처리
+TaskCreate({ subject: "user.prisma 수정", ... })
+TaskCreate({ subject: "post.prisma 수정", ... })
+TaskCreate({ subject: "comment.prisma 수정", ... })
+// → 각각 완료 시 TaskUpdate로 체크
+
+// ❌ 금지: 목록화 없이 기억에 의존
+```
+
+### 필수 25: 완료 후 재스캔
+
+**"모든 X" 작업 완료 후 Glob/Grep 재스캔 1회 실행 (놓친 항목 확인)**
+
+```typescript
+// ✅ 필수: 작업 완료 후 재스캔
+// ... 모든 파일 수정 완료 ...
+Glob({ pattern: "**/*.prisma" })  // 재스캔
+Grep({ pattern: "TodoWrite", ... })  // 누락 확인
+// → "놓친 항목 0개" 확인 후 완료 선언
+
+// ❌ 금지: 재스캔 없이 완료 선언
+```
+
+### 필수 26: 부분 완료 시 명시적 보고
+
+**전체 작업 중 일부만 완료된 경우 남은 작업을 명시적으로 보고**
+
+```markdown
+✅ "5개 중 3개 완료. 남은 항목: comment.prisma, like.prisma"
+❌ (암묵적 종료 — 남은 작업 언급 없이 작업 끝냄)
+```
+
 ## 종합 체크리스트
 
 작업 시작 전:
@@ -302,6 +420,8 @@ Task(subagent_type="explore", ...)
 - [ ] Sequential Thinking 실행 (MEDIUM 이상)
 - [ ] 파일 읽기 계획 (병렬 여부)
 - [ ] 에이전트 활용 계획
+- [ ] 복잡한 작업: 파일 인벤토리 생성 (필수 19)
+- [ ] "모든 X" 작업: 전체 대상 열거 (필수 23)
 
 코드 작성 시: