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

무엇을 해주나

AI 에이전트의 컨텍스트 창을 "RAM", 파일시스템을 "디스크"로 보는 Manus 방식의 작업 관리 패턴입니다. 복잡한 작업을 시작하기 전에 세 개의 마크다운 파일을 프로젝트 루트에 만들고 계속 갱신하도록 강제합니다.

• task_plan.md — 단계(phase), 진행 상태, 주요 결정
• findings.md — 조사·발견 내용 저장
• progress.md — 세션 로그, 테스트 결과

여기에 훅(UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact)이 붙어 프롬프트마다 현재 계획을 다시 주입하고, 파일을 수정하면 진행 상황 갱신을 상기시키며, /clear 이후에는 session-catchup.py로 이전 세션 맥락을 복구합니다. 3단계 오류 대응 프로토콜, 2-액션 규칙(뷰/검색 2회마다 즉시 기록), 읽기/쓰기 판단 표, 안티패턴 목록까지 포함되어 있습니다.

이런 분께 추천

• 긴 리팩터링·마이그레이션처럼 툴 호출이 수십 번 이어지는 작업을 자주 하는 분
• 대화가 길어져 컴팩션되거나 /clear 후 맥락이 사라져 답답했던 분
• 리서치 결과나 에러 이력을 체계적으로 남기고 싶은 개발자·기획자
• Cursor와 Claude Code를 오가며 같은 계획 파일을 공유하고 싶은 팀

활용 예시

1. 대규모 리팩터링: "이 저장소를 TypeScript로 마이그레이션해줘"라고 요청하면 먼저 task_plan.md에 5~7개 페이즈를 만들고, 각 페이즈 완료 시 상태를 complete로 바꾸며 실패한 빌드 오류를 표로 누적 기록합니다.
2. 기술 조사: 여러 라이브러리를 비교 조사할 때 검색 2회마다 findings.md에 요약을 저장해, 컨텍스트가 압축돼도 비교표가 그대로 남습니다.
3. 세션 복구: 어제 작업을 /clear 후 이어갈 때 catchup 스크립트와 git diff --stat를 함께 확인해 계획 파일을 최신화한 뒤 다음 페이즈부터 바로 재개합니다.

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