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

무엇을 해주나

• 복잡한 작업을 시작할 때 계획 파일(task_plan.md) 을 먼저 만들게 하고, 조사 결과는 findings.md, 세션 로그와 테스트 결과는 progress.md에 누적합니다.
• 세션이 끊기거나 컨텍스트가 압축(compact)돼도 프로젝트 안의 계획 파일을 다시 읽어 현재 단계·목표·학습 내용을 복원합니다.
• UserPromptSubmit, PreToolUse, PostToolUse, Stop, PreCompact 훅으로 선택된 계획 컨텍스트를 자동 주입합니다.
• init-session.sh(초기화), check-complete.sh(단계 완료 검증), set-active-plan.sh --list(저장된 계획 목록), session-catchup.py --metadata/--replay(동일 프로젝트 세션 기록 집계·제한적 재생) 등 보조 스크립트를 제공합니다.
• 오류 처리 규약(3-스트라이크), '2회 조회 후 즉시 기록' 규칙, 외부 웹 내용은 findings.md에만 쓰는 보안 경계까지 규정합니다.

이런 분께 추천

• 리서치·리팩터링·신규 프로젝트 구축처럼 도구 호출이 5번 이상 필요한 장시간 작업을 자주 맡기는 분
• 세션이 길어지면 에이전트가 목표를 잊고 같은 실패를 반복하는 문제를 겪는 분
• 여러 작업/워크트리를 병행하며 PLAN_ID로 계획을 분리 관리하고 싶은 분

활용 예시

1. 대규모 리팩터링: init-session.sh "Auth 리팩터링"으로 계획 디렉터리를 만들고 단계별로 task_plan.md 상태를 in_progress → complete로 갱신.
2. 기술 조사: 웹 검색 2회마다 핵심 내용을 findings.md에 저장해 멀티모달·브라우저 결과가 컨텍스트에서 사라지는 것을 방지.
3. 중단된 작업 재개: 다음 날 set-active-plan.sh --list로 계획을 찾고, 계획 파일 3종 + git diff --stat으로 상태를 복원한 뒤 이어서 작업.

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

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

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