파일 기반 플래닝 (Planning with Files)

무엇을 해주나

Manus 스타일의 "디스크를 작업 기억으로 쓰는" 패턴을 Claude Code에 이식한 스킬입니다. 컨텍스트 창을 RAM, 파일 시스템을 디스크로 보고 중요한 내용은 전부 파일에 적어 둡니다.

• task_plan.md — 단계(Phase), 목표, 의사결정, 오류 로그
• findings.md — 리서치·웹 검색 결과 등 외부에서 가져온 정보
• progress.md — 세션 로그, 테스트 결과

여기에 더해:

• 세션 시작 시 기존 플래닝 파일을 먼저 읽고, session-catchup.py로 /clear 이전 맥락을 복구
• 2-액션 규칙: 화면/브라우저/검색 조작 2회마다 발견 내용을 즉시 파일에 저장
• 3-스트라이크 오류 프로토콜: 진단 → 대안 시도 → 근본 재검토 → 3회 실패 시 사용자에게 에스컬레이션
• .planning/YYYY-MM-DD-슬러그/ 구조로 여러 작업 계획을 병렬 관리
• attest-plan.sh로 계획 파일을 SHA-256 해시로 잠가, 몰래 수정된 계획이 모델 컨텍스트에 주입되는 것을 차단

이런 분께 추천

• 도구 호출이 5회 이상 이어지는 리팩터링·기능 구현을 자주 맡기는 분
• 컨텍스트가 길어지면 Claude가 처음 목표를 잊어버리는 문제를 겪은 분
• /clear나 세션 재시작 후 "어디까지 했더라"를 매번 다시 설명하는 게 지겨운 분
• 한 저장소에서 여러 작업(리팩터링 + 장애 조사)을 동시에 굴리는 팀

활용 예시

1. 대규모 리팩터링: "인증 모듈을 JWT로 전환하는 계획을 세워줘"라고 하면 Phase 1~6으로 나눈 task_plan.md를 만들고, 각 단계 완료 시 상태를 complete로 갱신하며 발생한 에러를 표로 기록합니다.
2. 기술 리서치: 여러 라이브러리를 웹에서 비교할 때 검색 2회마다 결과를 findings.md에 정리해, 컨텍스트가 넘쳐도 비교 근거가 사라지지 않습니다.
3. 중단된 작업 재개: 어제 /clear한 뒤 오늘 다시 시작하면 catchup 스크립트와 git diff --stat을 대조해 계획 파일을 최신 상태로 맞춘 뒤 이어서 작업합니다.
4. 병렬 작업: init-session.sh "Backend Refactor"와 init-session.sh "Incident Investigation"으로 계획을 분리하고, PLAN_ID 환경변수로 터미널마다 다른 계획에 고정합니다.

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 OthmanAdi/planning-with-files 의 .continue/skills/planning-with-files 폴더를 내 ~/.claude/skills/othmanadi-planning-with-files-3/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.