클로드스킬마트스킬 둘러보기스킬이 뭐예요?
 
← 목록으로

파일 기반 계획 관리 (Planning with Files)

task_plan.md·findings.md·progress.md를 디스크에 유지해 컨텍스트가 날아가도 작업이 이어지게 만드는 Manus 스타일 계획 스킬.

자동화·워크플로중급★ 26,060⑂ 2,177AI 점수 9/10마지막 업데이트: 2026. 8. 9.

무엇을 해주나

Claude Code가 복잡한 작업을 시작할 때 **파일 3개를 프로젝트 폴더에 만들어 '디스크 위의 작업 기억'**으로 사용하게 합니다.

  • task_plan.md — 단계(Phase), 상태, 다음 할 일, 의사결정 기록
  • findings.md — 조사·발견 내용 저장(이미지/브라우저 결과는 즉시 텍스트로)
  • progress.md — 세션 로그, 테스트 결과, 에러 기록

여기에 훅(UserPromptSubmit / PreToolUse / PostToolUse / Stop / PreCompact)이 붙어서, 대화가 압축되거나 /clear로 초기화되어도 계획 내용을 다시 주입해 줍니다. session-catchup.py로 이전 세션 맥락을 복구하고, git diff와 비교해 계획 파일을 최신화하는 절차까지 정해져 있습니다.

추가로 3-스트라이크 에러 프로토콜(같은 실패 반복 금지), 병렬 작업용 .planning/<날짜-슬러그>/ 분리, 계획 파일 해시 증명(attestation), 자율/게이트 모드 등 고급 기능을 제공합니다.

이런 분께 추천

  • 리팩터링, 마이그레이션처럼 여러 세션에 걸친 장기 작업을 하는 개발자
  • 컨텍스트가 꽉 차 압축될 때마다 AI가 목표를 잊어버리는 게 답답한 사람
  • 조사·리서치 결과를 흘리지 않고 문서로 남기고 싶은 사람
  • 같은 저장소에서 여러 작업을 동시에 진행하며 계획을 분리하고 싶은 팀

활용 예시

  1. 레거시 API 마이그레이션: "이 프로젝트를 v2 API로 옮겨줘"라고 하면 Phase 1~6으로 쪼갠 task_plan.md가 생성되고, 각 단계 완료 시 상태가 complete로 갱신됩니다. 다음 날 새 세션을 켜도 훅이 계획을 다시 읽어 이어서 진행합니다.
  2. 기술 조사: 라이브러리 3개를 비교 조사할 때, 2번의 검색·문서 열람마다 핵심 내용을 findings.md에 즉시 기록해 컨텍스트가 넘쳐도 자료가 남습니다.
  3. 병렬 작업: ./scripts/init-session.sh "Backend Refactor"와 "Incident Investigation"을 각각 실행해 두 계획을 분리하고, set-active-plan.sh로 현재 작업 계획을 전환합니다.

· · · 설치 가이드 · · ·

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

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

직접 명령으로 설치하기

git clone https://github.com/OthmanAdi/planning-with-files.git /tmp/planning-with-files && mkdir -p ~/.claude/skills && cp -r /tmp/planning-with-files/skills/planning-with-files ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 터미널을 열고 원하는 폴더로 이동합니다.
  2. 저장소를 내려받습니다: git clone https://github.com/OthmanAdi/planning-with-files.git
  3. 스킬 폴더를 복사합니다: mkdir -p ~/.claude/skills && cp -r planning-with-files/skills/planning-with-files ~/.claude/skills/
  4. (슬래시 명령 /plan-goal, /plan-loop까지 쓰려면) Claude Code에서 플러그인으로 설치하세요: /plugin marketplace add OthmanAdi/planning-with-files → /plugin install planning-with-files
  5. 스크립트 실행 권한을 줍니다: chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh
  6. Claude Code를 재시작하고 "이 작업을 단계별로 계획해줘"처럼 요청하면 스킬이 활성화됩니다.
  7. 설치가 잘 됐는지 확인하려면 /plan-doctor 또는 sh ~/.claude/skills/planning-with-files/scripts/plan-doctor.sh를 실행해 훅 상태를 점검합니다.
  8. 계획 파일은 작업 중인 프로젝트 폴더에 생기니, 스킬 설치 폴더와 혼동하지 마세요.
GitHub에서 원본 보기 ↗라이선스: MIT