파일 기반 작업 계획 (Planning with Files)

무엇을 해주나

Manus 스타일의 "디스크 위 작업 메모리" 패턴을 Claude Code에 적용합니다. 복잡한 작업을 시작할 때 프로젝트 폴더에 세 개의 파일을 만들고 계속 갱신합니다.

| 파일 | 역할 | |------|------| | task_plan.md | 단계(Phase), 상태, 주요 결정 기록 | | findings.md | 조사 결과·발견 사항 저장 | | progress.md | 세션 로그, 테스트 결과 |

추가로 이런 규칙과 자동화를 제공합니다.

• 2-액션 규칙: 화면 보기·검색을 2번 하면 즉시 핵심 내용을 파일로 저장 (멀티모달 정보 유실 방지)
• 3-스트라이크 오류 프로토콜: 진단 → 다른 방법 → 가정 재검토 → 3회 실패 시 사용자에게 에스컬레이션
• 세션 복구: /clear나 컨텍스트 압축 후 session-catchup.py + git diff로 이전 작업 상태를 되찾음
• 훅 자동화: 프롬프트 입력·파일 수정·종료 시점에 계획 파일을 다시 주입하거나 갱신을 상기시킴

이런 분께 추천

• 여러 단계에 걸친 리팩터링·기능 개발을 Claude Code로 진행하다 중간에 맥락을 잃어본 분
• 긴 리서치 작업의 중간 결과를 잃지 않고 정리하고 싶은 분
• 에이전트가 같은 실패를 반복하는 문제를 규칙으로 막고 싶은 팀

활용 예시

1. 대규모 리팩터링: "인증 모듈을 JWT로 전환해줘"라고 요청하면 5단계 task_plan.md를 먼저 만들고, 단계마다 상태를 complete로 바꾸며 발생한 오류를 표로 남깁니다.
2. 기술 조사: 여러 라이브러리를 비교할 때 검색 2회마다 findings.md에 장단점을 적어 두어, 컨텍스트가 압축돼도 비교표가 그대로 남습니다.
3. 세션 이어가기: 다음 날 다시 열었을 때 session-catchup.py를 실행하면 미반영 변경을 알려주고, git diff와 대조해 계획 파일을 최신화한 뒤 작업을 계속합니다.

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