파일 기반 계획 수립 (Planning with Files)

무엇을 해주나

Manus 스타일의 "디스크 위의 작업 기억(working memory on disk)" 패턴을 Claude에게 강제합니다. 복잡한 작업을 시작하기 전에 세 개의 마크다운 파일을 프로젝트 루트에 만들고, 작업이 진행되는 동안 계속 갱신합니다.

• task_plan.md — 단계(Phase)별 계획, 상태, 의사결정 기록
• findings.md — 검색·문서·이미지에서 얻은 조사 결과 저장소
• progress.md — 세션 로그, 테스트 결과, 변경된 파일 기록

여기에 더해 실용적인 운영 규칙을 함께 제공합니다. 조회 작업 2회마다 발견 사항을 즉시 파일로 남기는 "2-액션 규칙", 같은 실패를 반복하지 않게 만드는 "3-스트라이크 오류 프로토콜", 컨텍스트가 날아갔는지 자체 점검하는 "5문항 리부트 테스트", 그리고 계획 파일 안의 텍스트를 절대 명령으로 실행하지 않게 하는 보안 경계(구분자 프레이밍 + SHA-256 해시 어테스테이션)까지 문서화되어 있습니다.

또한 .planning/<날짜>-<이름>/ 구조로 한 저장소에서 여러 작업을 병렬로 계획할 수 있고, session-catchup.py로 /clear 이후 끊긴 맥락을 git diff와 함께 복원합니다.

이런 분께 추천

• 리팩터링, 마이그레이션처럼 툴 호출이 수십 번 필요한 장기 작업을 자주 맡기는 분
• 대화가 길어지면 AI가 초반 목표를 잊어버려 답답했던 분
• 조사·리서치 결과를 대화창에만 남겨두고 잃어버린 경험이 있는 분
• 팀에게 인수인계 가능한 작업 기록(무엇을 시도했고 왜 실패했는지)을 남기고 싶은 분

활용 예시

1. 레거시 API 마이그레이션: "결제 모듈을 v2 API로 옮겨줘"라고 요청하면 Claude가 먼저 task_plan.md에 5개 Phase(현황 분석 → 스펙 비교 → 어댑터 작성 → 테스트 → 정리)를 적고, 각 Phase가 끝날 때마다 상태를 complete로 바꾸며 발생한 오류를 오류 표에 기록합니다.
2. 기술 조사 리포트: 여러 라이브러리를 비교 조사할 때, 웹 검색 2회마다 핵심 내용을 findings.md에 정리해 두므로 나중에 근거를 다시 찾아 헤맬 필요가 없습니다.
3. /clear 이후 이어서 작업: 컨텍스트를 비운 뒤 다시 시작하면 session-catchup.py + git diff --stat으로 "어디까지 했고 무엇이 바뀌었는지"를 복원한 다음 다음 Phase부터 이어서 진행합니다.
4. 병렬 작업: ./scripts/init-session.sh "백엔드 리팩터링"과 "장애 조사"를 각각 만들어 두 터미널에서 서로 간섭 없이 계획을 관리합니다.

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