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

무엇을 해주나

Manus 스타일의 "디스크 위 작업 기억" 패턴을 Claude에게 강제합니다. 복잡한 작업을 시작하기 전에 세 개의 마크다운 파일을 프로젝트 루트에 만들고 계속 갱신합니다.

• task_plan.md — 단계(Phase), 진행 상태, 주요 결정
• findings.md — 조사·검색·문서 열람으로 얻은 사실
• progress.md — 세션 로그, 테스트 결과

여기에 더해 실용적인 규칙들이 담겨 있습니다: 조회 작업 2번마다 결과를 파일로 저장하는 2-액션 규칙, 같은 실패를 반복하지 않게 하는 3-스트라이크 오류 프로토콜, 세션이 끊긴 뒤 session-catchup.py + git diff로 상태를 복원하는 절차, 그리고 웹에서 가져온 내용은 반드시 findings.md에만 쓰라는 프롬프트 인젝션 방어 지침입니다.

이런 분께 추천

• 리팩터링, 마이그레이션처럼 여러 세션에 걸치는 개발 작업을 하는 분
• /clear나 컨텍스트 한계로 Claude가 앞 내용을 잊어버려 답답했던 분
• 조사 → 정리 → 실행 흐름을 문서로 남기고 싶은 리서처·기획자
• 에이전트가 같은 오류를 무한 반복하는 상황을 막고 싶은 분

활용 예시

1. 레거시 API 마이그레이션: "v1 API를 v2로 마이그레이션할 계획을 세워줘"라고 하면 6개 Phase로 나눈 task_plan.md를 만들고, 각 엔드포인트 조사 결과를 findings.md에 적어둡니다. 다음 날 새 세션에서 세 파일만 읽고 Phase 3부터 바로 이어갑니다.
2. 경쟁 서비스 리서치: 웹 검색 두 번마다 핵심 내용을 findings.md에 저장해, 스크린샷·페이지 내용이 컨텍스트에서 밀려나도 근거가 남습니다.
3. 빌드 오류 디버깅: 시도 1은 원인 수정, 시도 2는 다른 방법, 시도 3은 가정 재검토 후에도 실패하면 시도 내역과 오류 로그를 정리해 사용자에게 판단을 요청합니다.

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