사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/justin/jww-skills --skill jww-bounded-investigation시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Bounded Investigation
Keep a multi-file investigation bounded by delegating broad discovery and recording the evidence needed to verify the conclusion. Targeted reads and narrow commands are assumed; they are not what this skill adds.
When to Use
Invoke this when the work is investigation and the relevant code is not yet located, such as:
- a stack trace or error with no obvious owning file
- a "why does X happen" question naming a behavior but no source
- an audit or archaeology pass that will span many files
Skip it once the relevant files are identified, or for ordinary edits to known code.
Delegate Fan-Out Searches
Delegate a sweep to a read-only search agent when the harness provides one, delegation is authorized, and both conditions hold:
- the location is unknown — many candidate files, uncertain naming, or a
whole-repository code search
- you need the conclusion, not the surrounding code
Run the search yourself when the target is specific enough that the output is small, or when judging the surrounding code matters more than finding it. Keep synthesis and verification in the primary agent: inspect the cited source before relying on a delegated conclusion.
Keep an Evidence Ledger
Keep the ledger in your working notes or a scratch file for the session; it is not committed. Record one line per finding: the source, the observation, and what it rules in or out.
src/Session/Store.swift:88 — writes cache off the main actor — explains the
crash, rules out the decoder pathRecord ruled-out branches and sources that were checked and added nothing. Without them, the same file gets read again later in the same investigation.
The ledger is the raw material for a handoff: its lines become the Decisions and Touched sections of jww-handoff, so keeping it makes that handoff nearly free to write.
Report
Lead with the conclusion, then the evidence that supports it and the caveats that affect trusting it. Cite by file and line so the reasoning can be rechecked without reproducing the search.
