파일 기반 플래닝 (planning-with-files)

무엇을 해주나

컨텍스트 창을 RAM, 파일 시스템을 디스크로 취급하는 "디스크 위의 작업 기억" 패턴을 Claude Code에 심어줍니다. 복잡한 작업을 시작하면 프로젝트 루트에 세 개의 파일을 만들고 계속 갱신합니다.

• task_plan.md — 단계(Phase)별 계획과 상태, 주요 결정
• findings.md — 조사 결과·발견 사항(외부에서 가져온 내용은 여기에만 저장)
• progress.md — 세션 로그, 테스트 결과, 오류 기록

여기에 더해 UserPromptSubmit·PreToolUse·PostToolUse·Stop·PreCompact 훅으로 계획을 매 턴 다시 주입하고, /clear 이후에는 session-catchup.py로 이전 세션 맥락을 복구합니다. 3-스트라이크 오류 프로토콜, 2-액션 규칙(조회 2회마다 결과를 파일로 저장), 병렬 플랜 디렉터리(.planning/<날짜>-<슬러그>/), SHA-256 계획 서명(attestation), 자율/게이트 모드까지 갖춘 상당히 성숙한 워크플로 스킬입니다.

이런 분께 추천

• 툴 호출이 5회 이상 필요한 다단계 작업이나 리서치를 자주 맡기는 분
• 긴 세션에서 Claude가 목표를 잊거나 같은 실패를 반복하는 게 답답했던 분
• 여러 작업을 같은 저장소에서 병렬로 굴리며 각각의 계획을 분리하고 싶은 분
• 자동 컴팩션(/compact) 이후 맥락이 날아가는 문제를 겪은 분

활용 예시

1. 대규모 리팩터링: "백엔드 인증 모듈을 리팩터링해줘"라고 하면 6단계 계획을 task_plan.md에 쓰고, 각 단계 완료마다 상태를 complete로 바꾸며 발생한 오류를 표로 남깁니다. 중간에 /clear를 해도 다음 턴에 계획을 다시 읽고 이어갑니다.
2. 경쟁 제품 리서치: 웹 검색 2회마다 핵심 내용을 findings.md에 즉시 저장해, 스크린샷·페이지 내용이 컨텍스트에서 밀려나도 정보가 남습니다.
3. 병렬 작업: ./scripts/init-session.sh "Backend Refactor"와 "Incident Investigation"을 각각 실행해 두 개의 격리된 계획 디렉터리를 만들고, set-active-plan.sh로 현재 작업 대상을 전환합니다.

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