Repolode
OthmanAdi

OthmanAdi/planning-with-files

AI 코딩 에이전트가 작업 계획을 파일로 저장해 컨텍스트 초기화, /clear, 충돌 후에도 유지하는 파일 기반 계획 수립 스킬입니다.

스타
27,923
포크
2,313
열린 이슈
11
마지막 커밋
3일 전

어떤 프로젝트인가요?

Planning with Files는 AI 코딩 에이전트를 위한 스킬로, 작업 계획과 조사 노트, 진행 상황을 프로젝트 내 Markdown 파일 세 개(task_plan.md, findings.md, progress.md)에 저장합니다. 상태가 컨텍스트 창이 아니라 디스크에 저장되므로, 에이전트는 /clear, 컨텍스트 압축 또는 충돌 후에도 현재 단계부터 작업을 재개할 수 있습니다.

라이프사이클 훅은 각 턴이 시작될 때 현재 계획의 컨텍스트를 다시 주입하고, 완료 확인 기능은 계획의 단계가 끝났는지 보고합니다. 병렬 작업은 .planning/ 아래의 별도 디렉터리를 사용하고, 활성 계획 포인터로 작업할 계획을 선택할 수 있습니다. 자동 복구는 프로젝트 파일만 읽으며, 로컬 에이전트 세션 기록을 읽으려면 catchup 모드를 명시적으로 사용해야 합니다.

이 스킬은 npx skills, Claude Code 플러그인 마켓플레이스 또는 npm으로 설치할 수 있으며, Claude Code, Codex CLI, Cursor, OpenCode, Hermes Agent 등의 네이티브 플러그인 통합과 여러 언어로 번역된 버전을 제공합니다.

핵심 기능

  • 01계획, 조사 결과, 진행 상황을 프로젝트 내 Markdown 파일로 저장
  • 02라이프사이클 훅을 통해 각 턴에 현재 계획을 다시 주입
  • 03/clear, 컨텍스트 압축 또는 세션 충돌 후 계획 복구
  • 04계획의 모든 단계가 완료됐는지 확인해 보고
  • 05병렬 작업을 위한 격리된 계획 디렉터리
  • 06Agent Skills 표준을 통해 다양한 코딩 에이전트에 설치

활용 사례

  • 여러 세션에 걸쳐 진행되는 장기 리팩터링 또는 마이그레이션
  • 에이전트가 /clear 후에도 진행 상황을 놓치면 안 되는 여러 단계의 코딩 작업
  • 에이전트 작업 중 결정 사항과 테스트 결과를 감사 가능한 기록으로 보관

포함된 컬렉션

토픽

자주 묻는 질문

planning-with-files은(는) 무엇인가요?
AI 코딩 에이전트가 작업 계획을 파일로 저장해 컨텍스트 초기화, /clear, 충돌 후에도 유지하는 파일 기반 계획 수립 스킬입니다. Planning with Files는 AI 코딩 에이전트를 위한 스킬로, 작업 계획과 조사 노트, 진행 상황을 프로젝트 내 Markdown 파일 세 개(task_plan.md, findings.md, progress.md)에 저장합니다. 상태가 컨텍스트 창이 아니라 디스크에 저장되므로, 에이전트는 /clear, 컨텍스트 압축 또는 충돌 후에도 현재 단계부터 작업을 재개할 수 있습니다.
planning-with-files은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
planning-with-files은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
planning-with-files은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. planning-with-files의 마지막 커밋은 2026년 11월 4일입니다.
planning-with-files은(는) 어디에 사용할 수 있나요?
여러 세션에 걸쳐 진행되는 장기 리팩터링 또는 마이그레이션 에이전트가 /clear 후에도 진행 상황을 놓치면 안 되는 여러 단계의 코딩 작업 에이전트 작업 중 결정 사항과 테스트 결과를 감사 가능한 기록으로 보관
planning-with-files은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/OthmanAdi/planning-with-files

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트