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

무엇을 해주나

• 복잡한 작업을 시작하기 전에 task_plan.md(단계·상태), findings.md(조사 결과), progress.md(세션 로그) 를 프로젝트 폴더에 만들어 "디스크 위의 작업 기억"으로 씁니다.
• 각 단계는 ### Phase N: 이름 + **Status:** pending/in_progress/complete 형식으로 관리되며, check-complete.sh --validate 로 형식 검증을 합니다.
• 라이프사이클 훅(UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact)이 현재 플랜 내용을 자동으로 다시 주입해, 컨텍스트가 압축되거나 세션이 끊겨도 상태를 복구합니다.
• 2-액션 규칙(열람/검색 2회마다 즉시 기록), 3-스트라이크 오류 프로토콜(진단→대안→재검토→사용자 에스컬레이션), 오류 로그 테이블 등 실전 규칙을 강제합니다.
• set-active-plan.sh --list 로 저장된 플랜 목록과 진행도를 확인하고, 승인된 것만 아카이브할 수 있습니다.

이런 분께 추천

• 도구 호출이 5회 이상 필요한 리서치·리팩터링·신규 기능 구현을 자주 맡기는 분
• 대화가 길어지면 에이전트가 목표를 잊거나 같은 실패를 반복하는 문제를 겪는 분
• 여러 세션에 걸친 작업, 혹은 여러 작업을 병렬로 돌리며 플랜을 분리하고 싶은 분

활용 예시

1. 멀티 세션 기능 개발: "결제 모듈 리팩터링" 플랜을 초기화하고 Phase 1~5를 잡아둔 뒤, 다음 날 세션을 열면 훅이 현재 Phase와 findings를 자동 복원합니다.
2. 경쟁사 리서치: 웹 페이지 2개를 읽을 때마다 핵심 수치를 findings.md에 적어, 스크린샷/멀티모달 정보가 컨텍스트에서 사라지기 전에 텍스트로 보존합니다.
3. 까다로운 버그 추적: 시도한 수정과 오류 메시지를 ## Errors Encountered 표에 기록해, 같은 실패를 반복하지 않고 3회 실패 시 사용자에게 상황을 정리해 보고합니다.

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

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

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