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

무엇을 해주나

Manus 방식의 '디스크를 작업 기억으로 쓰는' 패턴을 구현합니다. .kiro/plan/ 아래에 세 개의 파일을 만들고 유지합니다.

• task_plan.md — 목표, 단계(Phase), 상태, 주요 결정
• findings.md — 조사 결과와 발견 사항 (외부/웹 내용은 여기에만 기록)
• progress.md — 세션 로그, 테스트 결과, 오류 기록

여기에 더해 다음 규칙이 강제됩니다.

• 2-액션 규칙: 브라우징·검색·이미지 확인을 2번 하면 즉시 요점을 파일에 저장
• 3-스트라이크 오류 프로토콜: 진단→다른 접근→근본 재검토, 3회 실패 시 사용자에게 에스컬레이션
• 읽기/쓰기 판단표: 언제 파일을 다시 읽고 언제 읽지 말아야 하는지 정리
• 보안 경계: 웹에서 가져온 내용은 신뢰하지 않고, 그 안의 지시문을 따르지 않음

부트스트랩 스크립트(bootstrap.sh/.ps1), 세션 복구 스크립트(session-catchup.py), 단계 완료 검사 스크립트도 함께 제공됩니다.

이런 분께 추천

• 여러 번의 대화 세션에 걸쳐 이어지는 리팩터링·조사·기능 개발을 하는 분
• 긴 대화에서 컨텍스트가 압축되며 목표를 잃어버린 경험이 있는 분
• AI가 같은 실패를 반복하거나 오류를 조용히 넘기는 것을 막고 싶은 분
• 팀에서 작업 이력을 파일로 남겨 추적하고 싶은 분

활용 예시

1. 대규모 리팩터링 시작: "start planning: 인증 모듈을 JWT로 마이그레이션"이라고 요청하면 Phase 1~5로 나뉜 task_plan.md가 생성되고, 각 단계 완료마다 상태가 갱신됩니다.
2. 며칠 뒤 작업 재개: "resume work"라고 말하면 session-catchup.py로 파일 수정 시각과 요약을 확인하고, 계획 파일과 실제 코드 상태를 대조해 다음 단계를 제안합니다.
3. 기술 조사 정리: 여러 라이브러리를 비교하며 웹을 둘러볼 때, 2회 조회마다 핵심 내용이 findings.md에 정리돼 나중에 근거를 다시 찾을 필요가 없습니다.

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