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

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

Manus 방식으로 task_plan·findings·progress 마크다운을 디스크에 남겨, 컨텍스트가 날아가도 작업이 이어지게 하는 스킬.

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

무엇을 해주나

  • 복잡한 작업을 시작할 때 프로젝트 루트에 task_plan.md(단계·상태), findings.md(조사 결과), progress.md(세션 로그) 세 파일을 만들어 "디스크에 있는 작업 기억"을 유지합니다.
  • 훅(UserPromptSubmit / PreToolUse / PreCompact)이 현재 계획을 자동으로 다시 주입하고, Write·Edit 후에는 progress 갱신을 알려줍니다. /clear나 컨텍스트 압축 이후에도 session-catchup.py로 이전 세션 상태를 복구합니다.
  • "계획 먼저 작성", "2회 조회마다 즉시 기록", "3회 실패 시 사용자에게 에스컬레이션" 같은 규칙과 안티패턴 표로 에이전트의 행동 규범을 잡아줍니다.

이런 분께 추천

  • 리팩터링·마이그레이션처럼 툴 호출이 수십 번 필요한 장기 작업을 Claude Code로 진행하는 개발자
  • 세션이 끊기거나 /clear 후 "내가 뭘 하고 있었지?"를 반복하는 사용자
  • 조사·리서치 결과를 매번 잃어버려 같은 검색을 반복하는 사람

활용 예시

  1. 대규모 리팩터링: "인증 모듈을 JWT로 전환해줘"라고 하면 5개 단계로 나눈 task_plan.md를 만들고, 각 단계 완료 시 상태를 complete로 바꾸며 발생한 오류를 표에 기록합니다.
  2. 기술 조사: 여러 라이브러리 문서를 훑을 때 2건마다 핵심 요약을 findings.md에 저장해, 나중에 다시 검색하지 않고 비교 결론을 도출합니다.
  3. 세션 복구: 어제 작업을 이어받을 때 session-catchup.py + git diff --stat로 미반영 변경을 파악하고 계획 파일을 갱신한 뒤 다음 단계부터 바로 진행합니다.

· · · 설치 가이드 · · ·

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

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

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

직접 명령으로 설치하기

git clone https://github.com/OthmanAdi/planning-with-files.git && mkdir -p ~/.claude/skills && cp -r planning-with-files/.mastracode/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/.mastracode/skills/planning-with-files ~/.claude/skills/
  4. 스크립트 실행 권한을 줍니다: chmod +x ~/.claude/skills/planning-with-files/scripts/*.sh
  5. 훅이 다른 경로를 찾지 못하면 셸 설정에 export PWF_SCRIPT_DIR="$HOME/.claude/skills/planning-with-files/scripts"를 추가합니다.
  6. Claude Code를 재시작하고 프로젝트 폴더에서 "이 작업을 단계별로 계획해줘"라고 요청해 task_plan.md가 생성되는지 확인합니다.
  7. Windows에서는 Git Bash 또는 PowerShell을 사용하고, %USERPROFILE%\.claude\skills에 같은 방식으로 복사하세요.
GitHub에서 원본 보기 ↗라이선스: MIT