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

무엇을 해주나

• 복잡한 작업을 시작하기 전에 task_plan.md(단계·결정), findings.md(조사 결과), progress.md(세션 로그) 세 파일을 프로젝트 루트에 만들어 "디스크 위의 작업 기억"을 구축합니다.
• 컨텍스트 창이 초기화되거나 /clear 이후에도 계획 파일을 먼저 읽어 상태를 복구합니다. session-catchup.py와 git diff --stat으로 이전 세션의 미반영 변경까지 계획에 반영합니다.
• 오류를 표로 기록하고 같은 실패를 반복하지 않게 하는 3단계(진단 → 대안 → 재검토 → 사용자 에스컬레이션) 오류 프로토콜을 강제합니다.
• 조회/검색 2회마다 핵심 내용을 파일로 저장하는 "2-액션 규칙", 외부에서 가져온 내용은 task_plan.md가 아닌 findings.md에만 기록하는 프롬프트 인젝션 방어 규칙을 포함합니다.

이런 분께 추천

• 여러 단계에 걸친 리팩터링, 신규 기능 구현, 마이그레이션처럼 도구 호출이 5회 이상 필요한 작업을 자주 맡기는 분
• 세션이 길어지면 AI가 목표를 잊거나 앞서 한 결정을 반복해 되묻는 경험이 있는 분
• 자료 조사·경쟁 분석처럼 발견한 정보를 체계적으로 남겨야 하는 비개발 업무 사용자

활용 예시

1. "결제 모듈을 Stripe에서 Toss로 마이그레이션해줘" → 6단계 계획을 task_plan.md에 작성하고 단계마다 상태를 in_progress→complete로 갱신, 실패한 API 호출은 오류 표에 기록.
2. 며칠 뒤 다시 접속 → 계획 파일 3개를 먼저 읽고 catchup 스크립트로 미기록 변경을 확인한 뒤, 중단된 4단계부터 재개.
3. 여러 웹 문서를 조사하는 작업 → 두 번 검색할 때마다 핵심 인용과 링크를 findings.md에 정리하여 스크린샷·본문이 사라져도 근거가 남게 함.

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

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

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