| name | find-context |
| description | 현재 대화 주제와 관련된 과거 의사결정(why)과 교훈(lessons learned)을 프로젝트 문서에서 찾아 리포트한다. PRD, 기획 문서, wrap-up/history, CLAUDE.md 등을 스캔한다. |
Find Context
현재 대화/작업과 관련된 과거 맥락을 프로젝트 문서에서 찾아 정리해주는 유틸리티 skill.
Usage
/find-context — 최근 대화 흐름에서 주제 추론/find-context {주제} — 주제를 직접 지정 (예: /find-context 결제 플로우)
When to Use
- 사용자가
/find-context 를 입력했을 때
- 사용자가 "예전에 왜 이렇게 했더라", "과거 결정 확인", "관련 맥락 찾아줘" 라고 물을 때
- 새로운 작업을 시작하기 전, 관련 기록이 있는지 확인이 필요할 때
Instructions
이 skill은 유틸리티 도구입니다. 다른 단계 skill과 달리 "설명 → 이해 확인" 패턴 없이 바로 진단을 실행합니다.
Step 1: 주제(topic) 확정
우선순위:
- 인자로 주제가 들어왔으면 그것을 주제로 사용
- 없으면 최근 대화에서 중심 주제의 키워드를 2~5개 추출
- 예: "결제 플로우", "인증 방식", "프로필 화면 구조"
- 주제가 모호하면 AskUserQuestion 한 번만 물어봐서 확정
- question: "어떤 주제에 대한 과거 맥락을 찾을까요?"
- options: 최근 대화에서 추출한 후보 주제 2~4개 + "직접 입력"
Step 2: 검색 대상 탐색
존재하는 경로만 검색 대상으로 삼는다. 없으면 건너뛴다.
docs/prd/**/*.md ← 상세 PRD
docs/**/*.md ← 기타 기획/설계 문서
CLAUDE.md ← 프로젝트 설계도
.omniscitus/**/*.md ← wrap-up / history units (omniscitus 사용 시)
.claude/member/*/done/**/*.md ← 완료된 작업 단위 (팀 기반 워크플로우 시)
_weekly/**/*.md ← 주간 요약
Glob으로 존재 여부만 빠르게 확인한 뒤, 존재하는 경로에서만 Grep을 수행한다.
Step 3: 신호 필터링 (단순 매치가 아닌 'why' / 'lessons learned' 추출)
단순히 키워드만 찾지 말고, 의미 있는 신호가 섞인 부분을 골라낸다.
"Why" (의사결정) 신호:
- 결정, 선택, 이유, 왜냐하면, 때문에, 대신, rationale, decided, why
- ~로 정했다, ~를 선택한 이유, Trade-off, 대안으로는, 고려한 선택지
"Lessons Learned" (교훈) 신호:
- 교훈, 배운 점, 주의, 실패, 삽질, 피해야, 하지 말, gotcha, pitfall, lesson
- ~가 문제였다, ~할 때 주의, 다시는, 이번에 깨달은 것
주제 키워드와 이 신호 단어가 같은 섹션(±10줄 이내)에 같이 나타나는 경우를 우선 추출한다.
Step 4: 리포트 작성
아래 형식으로 출력한다.
# 🔍 Find Context Report
**주제**: {주제}
**스캔한 문서**: N개 / **매치 섹션**: M개
## 📌 의사결정 (Why)
### 1. {결정 항목 요약}
- **출처**: `docs/prd/checkout/payment.md:42`
- **결정**: {무엇을 결정했는지 — 한 줄}
- **이유**: {why — 한두 줄}
### 2. ...
## 💡 교훈 (Lessons Learned)
### 1. {교훈 요약}
- **출처**: `.omniscitus/2026-W12.md:15`
- **내용**: {교훈}
- **맥락**: {어떤 상황에서 얻은 교훈인지}
## 🔗 추가로 읽어볼 만한 문서
- `path:L123` — {한 줄 설명}
- ...
---
💬 **다음 행동 제안**:
이 맥락을 반영해서 {현재 대화 중인 작업}을 진행할까요?
아니면 더 좁혀서 찾고 싶은 부분이 있나요?
결과가 없을 때
원칙
- 재사용성 우선: 이 skill은 문서를 요약·인용만 한다. 문서를 수정하지 않는다.
- 출처 필수: 모든 항목은
file:line 출처를 포함 (사용자가 직접 원문을 확인할 수 있도록).
- 추측 금지: 문서에 없는 이유를 만들어내지 않는다. 신호가 약하면 "명시되지 않음"이라고 표시.
- 1가설 1검증과는 다르다: 이건 탐색/리포트 도구이므로 여러 문서를 병렬로 스캔해도 됨.
