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

무엇을 해주나

• 복잡한 작업을 시작할 때 task_plan.md(단계·상태), findings.md(조사 결과), progress.md(세션 로그) 세 파일을 프로젝트에 만들어 '디스크 위의 작업기억'으로 씁니다.
• 세션이 끊기거나 컨텍스트가 압축돼도 선택된 플랜 디렉터리에서 상태를 복구합니다(resolve-plan-dir.sh, git diff --stat 병행 확인).
• 라이프사이클 훅(UserPromptSubmit / PreToolUse / PostToolUse / Stop / PreCompact)으로 매 턴 현재 플랜 요약을 다시 주입합니다.
• ### Phase N + **Status:** pending|in_progress|complete 형식을 강제하고 check-complete.sh로 형식·완료 여부를 검증합니다.
• 오류 기록 의무화, 3회 실패 시 사용자에게 에스컬레이션하는 3-Strike 프로토콜, 뷰 2회마다 기록하는 2-Action 규칙 등 운영 규칙을 제공합니다.
• 병렬 작업용 명명 플랜(.planning/<날짜>-<slug>/)과 PLAN_ID/PWF_PLAN_ROOT 핀, 자율(autonomous)·게이트(gated) 모드, SHA-256 플랜 봉인(attestation)까지 지원합니다.

이런 분께 추천

• 툴 호출이 5번 이상 필요한 리서치·리팩터링·구축 작업을 자주 맡기는 분
• 긴 세션에서 에이전트가 목표를 잊거나 같은 실패를 반복하는 게 불만이었던 분
• 한 저장소에서 여러 에이전트를 동시에 돌리며 작업을 분리하고 싶은 분
• 완료 판정을 대화 내용이 아니라 파일 상태로 확정하고 싶은 분

활용 예시

1. 대규모 리팩터링: init-session.sh "Backend Refactor"로 플랜 생성 → export PLAN_ID=... 핀 → 단계별로 Status를 갱신하며 진행, 중단 후 재개 시 플랜 파일만 읽고 바로 이어서 작업.
2. 기술 조사: 문서·웹을 2개 볼 때마다 findings.md에 요약 저장 → 컨텍스트가 압축돼도 조사 결과가 남아 최종 보고서 작성 시 그대로 재사용.
3. 장시간 자동 진행: /plan-loop 10m으로 주기적 점검 + /plan-goal로 '모든 단계 complete'를 종료 조건으로 걸어 완료될 때까지 돌리기.

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

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

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