오케스트레이션 AI 에이전트가 설치된 코딩 CLI에 작업을 위임하고, diff를 검토한 뒤 직접 커밋할 수 있도록 해 주는 에이전트 스킬 모음입니다.
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 통계는 매일 갱신됩니다.
관련 프로젝트
AI 코딩 에이전트를 위한 로컬 우선 영구 메모리로, 결정과 교훈을 SQLite에 저장하고 MCP를 통해 Claude Code, Cursor 및 다른 클라이언트에 제공합니다.
Claude Code, Codex CLI, Cursor CLI, Gemini CLI를 위한 쉬운 에이전트 스킬로 세션 보고서를 한눈에 이해할 수 있는 결론으로 바꿉니다.
Claude Code, Codex, Gemini CLI, Cursor 등을 위한 공식 벤더 팀과 커뮤니티의 Agent Skills 1,000개 이상을 엄선해 모은 디렉터리입니다.
코드를 작성하기 전에 제안, 사양, 작업을 합의하는 AI 코딩 어시스턴트용 사양 기반 개발 워크플로
Poteto의 pstack Cursor 스킬 스택을 포팅해 Claude Code, Codex, Copilot, Pi 등의 에이전트 하네스에 코딩 작업용 구조화된 워크플로를 제공하는 프로젝트입니다.