planning-with-files 스킬
긴 작업의 계획과 진행을 파일에 남기고 호스트별 훅을 활용합니다.
커뮤니티 · OthmanAdi| 작성자 | OthmanAdi |
|---|---|
| 라이선스 | MIT |
| 소스 | OthmanAdi/planning-with-files · GitHub의 SKILL.md |
| 프로젝트 웹사이트 | planningwithfiles.tech |
| 작동 환경 | Claude Code · Codex, Gemini CLI, Cursor, Copilot |
| 소스 확인 날짜 |
planning-with-files: 긴 작업의 계획과 진행을 파일에 남기고 호스트별 훅을 활용합니다.
v3.28.2는 프로젝트 복구, 명시적 기록 읽기, 선택적 게이트 지속을 구분합니다.
스킬의 SKILL.md에서: # Planning with Files
하는 일
- 계획 선택, 발견과 진행 저장.
얻을 수 있는 결과물
- Markdown, 선택적 구조화 장부, 복구 상태.
이럴 때 사용하세요
- 지속 문맥이 필요한 장기 작업.
이럴 때는 맞지 않습니다
- 모든 호스트의 중단 제어가 같다고 가정.
필요한 것
- 로컬 파일, shell/PowerShell, 해당 Python 보조 도구. 훅 지원은 호스트별.
스킬에 들어 있는 파일
| 파일 또는 폴더 | 용도 |
|---|---|
SKILL.md | 시작 지침과 작업별 흐름. |
2026-11-16 기준 저장소에 있는 라이선스: MIT.
예시 프롬프트
설치한 뒤 아래 중 하나를 입력해 보세요. 스킬 이름을 넣으면 그 스킬이 확실히 사용됩니다.
- 영구 프로젝트 파일로 계획해 줘.
- 선택한 계획만 복구해 줘.
- 이 호스트의 완료 제어를 설명해 줘.
planning-with-files 설치 방법
설치 준비
전체 폴더·스크립트·서식을 복사하고 훅을 검토하세요. 폴더 발견만으로 훅이 설정되지는 않습니다.
스킬은 SKILL.md 파일이 든 폴더입니다. 한 번만 설치하면, 에이전트가 세션을 시작할 때마다 짧은 설명을 읽고 요청이 맞을 때만 전체 지침을 불러옵니다. 사용하는 곳을 고르세요.
Claude Code: 스킬 폴더에 복사
이 컴퓨터의 모든 프로젝트에서 쓰려면 스킬 폴더를 ~/.claude/skills/에 넣고, 저장소에서 함께 작업하는 모든 사람과 공유하려면 저장소 안의 .claude/skills/에 넣으세요(커밋하세요).
git clone --depth 1 https://github.com/OthmanAdi/planning-with-files.git
mkdir -p ~/.claude/skills
cp -R planning-with-files/skills/planning-with-files ~/.claude/skills/Claude Code는 세션 중에도 이 폴더의 새 스킬이나 변경된 스킬을 알아챕니다. 세션을 시작할 때 skills 폴더가 없었다면 /reload-skills를 한 번 실행하세요. 그런 다음 /planning-with-files를 입력하거나 작업을 설명하면 됩니다.
Windows에서는 Git Bash나 WSL에서 명령어를 실행하거나, 파일 탐색기로 같은 위치에 폴더를 복사하세요.
Codex, Gemini CLI, Cursor, GitHub Copilot
이 에이전트들은 같은 SKILL.md 폴더를 읽습니다. 네 가지 모두가 프로젝트 안에서 인식하는 폴더는 .agents/skills/이므로, 아래 명령은 스킬을 그곳에 복사합니다.
git clone --depth 1 https://github.com/OthmanAdi/planning-with-files.git
mkdir -p .agents/skills
cp -R planning-with-files/skills/planning-with-files .agents/skills/| 에이전트 | 프로젝트 폴더 | 사용자 폴더 | 참고 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | $를 입력하거나 /skills를 실행해 스킬을 고르세요. 작업이 맞으면 Codex가 스스로 스킬을 고르기도 합니다. |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 또는 gemini skills install <git URL> --path <folder> --consent로 Git에서 설치하세요. Google은 2026년 6월 18일 무료 등급과 Google One 사용자의 Gemini CLI를 Antigravity CLI로 대체했습니다. Antigravity는 프로젝트에서는 .agents/skills/를, 사용자용으로는 ~/.gemini/config/skills/를 사용합니다. |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | Agent 채팅에서 /를 입력해 스킬을 고르세요. Cursor는 Claude Code의 .claude/skills/ 폴더도 읽습니다. |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | Copilot CLI, 클라우드 에이전트, 그리고 VS Code, Visual Studio, JetBrains의 에이전트 모드에서 작동합니다(IDE 지원은 버전에 따라 다름). 또는 gh skill install OWNER/REPOSITORY SKILL를 실행하세요(공개 프리뷰, GitHub CLI 2.90.0 이상). |
이 단계의 출처
2026-11-14에 각 업체의 문서와 대조해 확인했습니다:
선택한 한 계획
이름 선택으로 몰래 작업이 바뀌는 것을 막습니다. 가드는 권고이며 잠금·병합이 아닙니다.
호스트 능력
레거시·자율·게이트 모드는 다릅니다. 차단 중단 훅 없이는 최고 제어가 불가하며 완료도 보장하지 않습니다.
planning-with-files에 관한 질문
이 사이트가 실행하나요?
아니요. 출처 기반 설치 안내이며 구성한 에이전트 환경에서 실행합니다.
전체 클라우드 흐름을 검증했나요?
아니요. 일반 업로드와 API 실행 안내는 생략하며 로컬 요건과 호스트 능력은 여전히 필요합니다.
기록을 자동으로 읽나요?
기본은 프로젝트 계획만입니다. 메타데이터나 제한 재생에는 명시 모드와 요청이 필요합니다.
검증값은 보안 서명인가요?
아니요. 저장값이 신뢰될 때만 변경을 찾으며 주입된 글을 안전하게 만들지 않습니다.
더 많은 AI 스킬
관련 스킬
free-tools 스킬
커뮤니티 · Corey Haines무료 도구 아이디어를 사용자 가치·사업 적합성·유지비로 평가합니다.site-architecture 스킬
커뮤니티 · Corey Haines계층·탐색·URL·유용한 내부 링크를 설계합니다.n8n 자체 호스팅 스킬
커뮤니티 · Romuald CzłonkowskiDocker 기반 n8n을 배포·유지하며 Caddy HTTPS, 비공개 서비스와 검증된 백업을 구성합니다.n8n Code JavaScript 스킬
커뮤니티 · Romuald Członkowski실행 모드에 맞는 데이터 접근과 반환으로 n8n JavaScript Code 노드를 작성하거나 디버깅합니다.n8n Code Python 스킬
커뮤니티 · Romuald Członkowski명확한 샌드박스 및 모드 제한에 따라 n8n 2.x Code 노드용 네이티브 Python을 작성합니다.n8n Code Tool 스킬
커뮤니티 · Romuald Członkowskiquery 입력과 문자열 출력을 사용하는 n8n Custom Code Tool을 작성합니다.