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

무엇을 해주나

• 복잡한 작업을 시작하기 전에 task_plan.md(단계·상태), findings.md(조사 결과), progress.md(세션 로그) 를 프로젝트 루트에 만들도록 강제합니다.
• 컨텍스트 창을 RAM, 파일시스템을 디스크로 보는 "Manus 방식" 패턴을 적용해 /clear나 컨텍스트 압축 후에도 작업 상태가 살아남습니다.
• 훅(UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact)이 계획 내용을 자동으로 다시 주입하고, 파일을 수정할 때마다 진행 로그 갱신을 상기시킵니다.
• session-catchup.py로 이전 세션에서 동기화되지 않은 변경을 감지해 git diff --stat과 함께 계획 파일을 복구합니다.
• 2-액션 규칙, 3-스트라이크 오류 프로토콜, 읽기/쓰기 판단표, 5문항 리부트 테스트 같은 구체적 운용 규칙을 제공합니다.

이런 분께 추천

• 긴 리팩터링·마이그레이션처럼 도구 호출이 수십 번 필요한 작업을 자주 하는 개발자
• 세션이 끊기거나 /clear 후 "어디까지 했지?"를 반복하는 사용자
• 리서치·자료 조사 결과를 체계적으로 남기고 싶은 기획자·분석가

활용 예시

1. 대규모 마이그레이션: "이 프로젝트를 TypeScript로 전환해줘" → 단계별 phase가 담긴 task_plan.md가 생성되고, 각 단계 완료 시 상태가 complete로 갱신됩니다.
2. 세션 복구: 어제 작업을 이어갈 때 session-catchup.py가 미반영 변경을 리포트하고 계획 파일을 최신화한 뒤 다음 단계로 진행합니다.
3. 오류 추적: 빌드 실패가 반복되면 오류 표에 시도 횟수와 해결책이 기록되고, 3회 실패 시 사용자에게 상황을 정리해 에스컬레이션합니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/OthmanAdi/planning-with-files/HEAD/.mastracode/skills/planning-with-files/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

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