Research first
API가 이럴 거라고 생각하며 코드를 작성하지 마세요. 먼저 확인하세요.
단순하지 않은 edit 또는 write 작업 전에는 반드시 다음 단계를 수행하세요:
1. 조사: research/findings/<topic>.md
- 먼저
research/findings/를 확인하세요. 누군가 이미 조사했다면 재사용하세요. - 그런 다음 코드베이스를 grep 하세요. 외부 문서가 필요하다면 웹 검색을 수행하세요. 최신 문서를 얻기 위해 검색 시 2026년을 사용하세요.
- 찾은 내용을 인용하세요. 문서가 없으면 가설을 검증할 작은 재현 코드를 작성하세요.
- 결과를
research/findings/<slug>.md에 저장하여 다음 세션에서 작업을 반복하지 않도록 하세요.
템플릿:
# Findings: <topic>
Date: 2026-09-04
Sources: [url, url]
Existing code: `path:line`: what we found
## Verdict
Recommended approach: ...
Alternatives: ...
Risks: ...
2. 계획: research/plans/<task>.md
# Plan: <task>
Research: research/findings/<topic>.md
Approach: ...
Files to change: [list]
Tests: ...
Rollback: ...
3. 승인
계획을 사용자에게 보여주세요. 사용자가 승인할 때까지 코딩을 시작하지 마세요. 아주 작은 단일 파일 수정의 경우 자동 승인 본능이 통과시킬 수도 있습니다.
4. 구현 및 검증
계획을 실행하고, 테스트를 수행하고, harness bench --quick을 실행한 다음, harness memory sync를 실행하여 다음 세션이 무엇이 효과적이었는지 기억하도록 하세요.
Notes
- 이미 조사 결과가 존재하면 다시 수행하지 마세요.
- 파일을 읽어 사실을 확인하고, 추측하지 마세요. 찾은 내용이 예상과 다르면 그렇게 말하고 파일을 신뢰하세요.
- 작업이 끝난 후에는 실제로 효과가 있었던 내용으로 조사 결과를 업데이트하세요.
하지 말아야 할 것
read또는grep전에edit하기- API 시그니처 추측하기
- 3개 이상의 파일을 수정해야 할 때 "작은 작업이니까"라는 이유로 계획을 건너뛰기