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

무엇을 해주나

Manus 스타일의 "디스크 위 작업 기억" 패턴을 Claude Code에 적용합니다. 복잡한 작업을 시작하기 전에 세 개의 마크다운 파일을 프로젝트 루트에 만들고 계속 갱신합니다.

• task_plan.md — 단계(phase) 목록과 상태, 주요 결정 기록
• findings.md — 조사·발견 내용 저장 (이미지/브라우저 결과처럼 휘발되기 쉬운 정보 우선)
• progress.md — 세션 로그, 테스트 결과, 수정 파일 기록

여기에 더해 훅이 자동으로 붙어서, 프롬프트 제출·도구 호출·컨텍스트 압축(PreCompact)·세션 종료 시점에 현재 계획을 다시 주입하거나 진행 상황 갱신을 상기시켜 줍니다. /clear 이후에는 session-catchup.py로 이전 세션 상태를 복구할 수 있습니다.

문서에는 3회 실패 시 사용자에게 에스컬레이션하는 "3-Strike 에러 프로토콜", 읽기/쓰기 판단 매트릭스, 안티패턴 표 등 실전 규칙이 촘촘히 정리돼 있습니다.

이런 분께 추천

• 리팩터링, 마이그레이션처럼 도구 호출이 수십 번 필요한 장기 작업을 자주 하는 분
• 컨텍스트가 꽉 차거나 /clear 후에 에이전트가 목표를 잊어버려 답답했던 분
• 조사 결과와 시행착오를 기록으로 남겨 팀과 공유하고 싶은 분

활용 예시

1. 레거시 모듈 마이그레이션: "이 서비스를 TypeScript로 옮기는 계획을 세워줘"라고 하면 단계별 task_plan.md를 만들고 각 파일 이관이 끝날 때마다 상태를 complete로 바꿔 갑니다.
2. 기술 조사: 여러 라이브러리를 비교할 때 검색 2회마다 핵심 내용을 findings.md에 적어두어, 컨텍스트가 잘려도 비교표가 남습니다.
3. 중단된 작업 재개: 다음 날 세션에서 catchup 스크립트와 git diff --stat을 돌려 어디까지 했는지 복원하고 이어서 진행합니다.

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