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

무엇을 해주나

• Manus 스타일의 "디스크 위 작업 기억" 패턴을 적용합니다. AI가 복잡한 작업을 시작하기 전에 task_plan.md(단계·의사결정), findings.md(조사 결과), progress.md(세션 로그)를 먼저 만들도록 강제합니다.
• 단계가 끝날 때마다 상태를 in_progress → complete로 갱신하고 발생한 오류를 표로 기록해, 같은 실패를 반복하지 않게 합니다.
• 3-스트라이크 오류 프로토콜(진단→대안→재검토→사용자 에스컬레이션)과 2-액션 규칙(조회/검색 2회마다 즉시 파일 저장)을 제공합니다.
• /clear 이후에도 session-catchup.py와 git diff --stat으로 이전 세션 맥락을 복구합니다.
• .planning/YYYY-MM-DD-<슬러그>/ 디렉터리로 여러 작업을 병렬 관리하고, 활성 계획을 스크립트로 전환할 수 있습니다.
• 계획 파일 내용을 "지시"가 아닌 "데이터"로만 취급하도록 하는 프롬프트 인젝션 방어 규칙과 SHA-256 해시 인증(attestation)을 포함합니다.

이런 분께 추천

• 5회 이상 툴 호출이 필요한 리팩터링·조사·프로젝트 구축을 자주 맡기는 분
• 대화가 길어지면 AI가 초기 목표를 잊어버리는 문제를 겪은 분
• 컨텍스트를 비우거나 세션이 끊긴 뒤에도 작업을 이어가고 싶은 분
• 한 저장소에서 여러 작업 트랙을 동시에 굴리는 팀/개인

활용 예시

1. 대규모 리팩터링: "백엔드 인증 모듈을 리팩터링해줘" → 6단계 task_plan.md 생성, 각 단계 완료 시 상태 갱신, 실패한 마이그레이션 오류를 표로 축적.
2. 기술 조사: 여러 라이브러리를 웹에서 비교할 때, 검색 2건마다 findings.md에 요약을 저장해 스크린샷·문서 내용이 컨텍스트에서 사라지는 것을 방지.
3. 세션 복구: /clear 후 다시 시작 → session-catchup.py 실행 결과와 git diff --stat을 대조해 계획 파일을 최신화하고 중단 지점부터 재개.
4. 병렬 작업: ./scripts/init-session.sh "Incident Investigation"으로 장애 조사 계획을 별도 디렉터리에 만들고, set-active-plan.sh로 리팩터링 계획과 번갈아 전환.

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

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

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