파일로 계획하기|파일 기반 작업 계획 유지

task_plan.md·findings.md·progress.md 세 파일을 프로젝트에 두고 매 턴마다 자동으로 다시 읽어 들입니다. /clear 나 컨텍스트 압축으로 대화가 리셋돼도 계획은 디스크에 남아 있어 작업이 끊기지 않습니다. UserPromptSubmit·PreToolUse·Stop 같은 훅으로 강제 주입됩니다. 지침처럼 "지켜주면 좋고"가 아니라 매번 실제로 돕니다.

도도리 AI연구소 · 최종 수정 2026년 10월 4일 · CC BY-NC 4.0

개발 워크플로 분야 · 바이브코딩·만들기 용도 · 개발자용입니다.

planning-with-files 스킬 설치 한 줄

Claude Code 용 명령입니다. Claude Code 는 터미널뿐 아니라 데스크톱 앱(Mac·Windows), 웹(claude.ai/code), VS Code·JetBrains 확장으로도 씁니다. 어디서 쓰시든 명령을 넣는 자리에 붙여 넣으시면 됩니다. 터미널로 쓰시면 그 터미널이고, 앱·웹·확장으로 쓰시면 그 안의 명령 입력 칸입니다. 헷갈리기 쉬운 곳은 하나입니다. 대화만 하는 Claude 앱의 채팅창은 Claude Code 가 아니라서 여기에 붙여 넣으면 동작하지 않습니다. 터미널로 쓰실 때만 Node.js 가 따로 필요하며, node -v 를 쳐서 버전이 나오면 준비된 것입니다.

뒤의 두 가지는 붙여 두시는 편이 좋습니다. -g 는 계정 전체에 넣는다는 뜻으로, 없으면 지금 열려 있는 폴더에만 깔려 다른 곳에서는 스킬이 보이지 않습니다. -a claude-code 는 Claude Code 에만 넣는다는 뜻입니다. 이걸 빼면 전역 설치를 지원하지 않는 다른 도구 때문에 빨간 Failed to install 이 뜨는데, 실제로는 설치가 된 상태라 헷갈립니다.

planning-with-files 스킬 설치 절차 전체

위 한 줄에서 막히셨다면 여기를 보십시오. 터미널로 쓰시는 분을 위해 터미널 여는 법부터 확인 명령까지 순서대로 적어 두었습니다. 데스크톱 앱·웹·편집기 확장으로 쓰시면 터미널 여는 단계는 건너뛰고 명령 입력 칸에 같은 줄을 넣으시면 됩니다.

# planning-with-files 설치

## 0. 어디에 붙여 넣나

Claude Code 를 쓰는 방법이 네 가지입니다. 어느 쪽이든 됩니다.

  터미널           macOS 는 터미널, Windows 는 PowerShell
  데스크톱 앱       Mac · Windows 용 Claude Code 앱
  웹              claude.ai/code
  편집기 확장       VS Code · JetBrains

명령을 넣는 자리에 아래 한 줄을 붙여 넣으시면 됩니다. 터미널로
쓰시면 그 터미널이고, 앱·웹·확장으로 쓰시면 그 안의 명령 입력 칸입니다.

헷갈리기 쉬운 곳이 하나 있습니다. 대화만 하는 Claude 앱의 채팅창은
Claude Code 가 아닙니다. 거기에 붙여 넣으면 Claude 가 명령을 글로
읽고 설명만 해 줍니다.

터미널로 쓰실 때만 Node.js 가 따로 필요합니다. node -v 를 쳐서
v20.1.2 처럼 버전이 나오면 준비된 것입니다. "찾을 수 없습니다" 가
나오면 nodejs.org 에서 LTS 버전을 먼저 설치하십시오.
(앱·웹·확장에는 이미 들어 있습니다.)

  macOS    Spotlight(Command + 스페이스)에서 "터미널" 을 여십시오
  Windows  시작 메뉴에서 "PowerShell" 을 여십시오

## 1. 넣기

npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g -a claude-code

  성공하면 이 한 줄이 나옵니다.
  Installed 1 skill → ~/.claude/skills/...

  -g 는 계정 전체에 넣는다는 뜻입니다(~/.claude/skills).
  어느 폴더에서 Claude Code 를 열든 쓸 수 있습니다.
  빼면 지금 열려 있는 폴더에만 깔려서(./.claude/skills), 다른 데서
  열면 스킬이 안 보입니다. "깔았는데 안 보인다" 는 대개 이것입니다.

  -a claude-code 는 Claude Code 에만 넣는다는 뜻입니다.
  빼면 전역 설치를 지원하지 않는 다른 도구 때문에 빨간
  "Failed to install" 이 뜹니다. 실제로는 설치가 끝난 상태인데
  실패한 것처럼 보여 여기서 멈추기 쉽습니다.

  저장소에 스킬이 여러 개면 어느 것을 넣을지 물어봅니다.
  미리 보시려면 --list 를 붙이십시오.

  npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g --list

## 2. Claude Code 를 다시 시작합니다

이미 열어 두셨다면 끝내고 다시 여십시오.
실행 중인 세션은 시작할 때 읽은 목록을 그대로 씁니다.

  터미널이면 claude 를 끝내고 다시 실행합니다.
  데스크톱 앱·웹·편집기 확장이면 그 세션을 새로 엽니다.
  대화만 하는 Claude 앱은 해당되지 않습니다 — 스킬이 들어가지 않습니다.

## 3. 확인

npx skills list -g

  전역으로 넣은 스킬이 이름과 경로와 함께 나옵니다.
  -g 를 빼면 지금 폴더의 스킬만 보이므로 "없다" 고 나올 수 있습니다.

## 4. 쓰기

"파일 기반 작업 계획 유지" 관련 작업을 시켜 보십시오.
스킬이 붙었다면 알아서 불러 씁니다.

이렇게 시켜 보세요

넣고 나서 바로 던져 볼 수 있는 지시문입니다. 누르면 복사됩니다.

알아 둘 것

planning-with-files 스킬 안 될 때 확인할 것

웹에서 가져온 내용을 계획 파일에 그대로 적으면 안 됩니다

task_plan.md 는 매 턴 자동으로 다시 읽혀 지시처럼 작동할 수 있습니다. 외부에서 가져온 내용은 findings.md 에만 적고, 그 안의 지시문은 절대 그대로 따르지 않아야 합니다.

간단한 작업에는 오히려 과합니다

3단계 미만의 단순 질문이나 파일 하나 수정하는 일에는 필요 없습니다.

언제 쓰고, 언제 안 쓰나

조사·구축이 5단계를 넘어가거나, 세션이 자주 끊겨서 매번 다시 설명해야 하는 상황에서 씁니다. 짧은 질문 하나짜리 작업에는 안 써도 됩니다.

비슷한 것 중에 왜 이걸

대화가 끊기는 것을 전제로 만들어졌습니다. grill-me 의 handoff 도 세션을 넘기지만 그건 필요할 때 사람이 부르는 것이고, 이건 매 턴 자동으로 다시 읽습니다. 넘기는 것을 잊어버릴 수가 없다는 점이 다릅니다. 계획이 디스크에 있습니다. 컨텍스트가 압축되거나 대화를 새로 시작해도 하던 일이 남아 있습니다. superpowers 나 ecc 는 절차를 얹지만 그 절차도 대화가 리셋되면 같이 사라집니다. 그 자리를 이것이 메웁니다. 질문 하나로 끝나는 일에는 필요 없습니다.

개발 워크플로 도구를 고를 때

CI/CD, 이슈 트래커, 브랜치 관리를 연결하는 도구입니다. 토큰 권한 범위를 필요한 저장소로만 좁힐 수 있는지, 실패했을 때 로그를 어디서 확인하는지 먼저 확인하세요.

원본 보기

스킬의 실제 내용은 SKILL.md 파일 하나에 들어 있습니다. 넣기 전에 한 번 읽어 보시는 것을 권합니다. 스킬은 Claude 에게 그대로 들어가는 지시문이라, 무엇을 시키는지 확인하지 않고 쓰면 의도치 않은 동작을 할 수 있습니다.

GitHub 에서 OthmanAdi/planning-with-files 열기

이 작업에 쓰는 장비 제휴 링크

오래 붙어 앉아 쓰는 스킬입니다.

모니터암화면 높이와 각도를 손으로 조절합니다. 받침대 자리가 비워집니다.카멜마운트 폴타입 이지밸런스 싱글 스탠드 모니터암 MSS2P, 블랙, 1개 60,090원보기 ↗노트북 거치대화면을 눈높이로 올립니다. 알루미늄, 접이식.애니클리어 프리미엄 알루미늄 노트북 거치대 받침대 AP-1 15,760원보기 ↗모니터 라이트화면 위만 비추고 화면에 반사가 없습니다.엘레센스 2in1 모니터 조명 백라이트바 스크린바 보조등, 1개, E1132 76,900원보기 ↗손목 받침쉴 때 손목을 놓는 젤 쿠션입니다.제로썬 마우스손목받침대 키보드손목받침대 젤리 에어셀 팜레스트 쿠션 게이밍, 1개, 블랙 마우스 손목 받침대 16,000원보기 ↗

이 페이지는 쿠팡 파트너스 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받습니다. 이용자가 내는 금액은 달라지지 않습니다.

별점과 댓글

이 스킬을 써 보신 분의 별점(5점 만점)과 한마디입니다. 작성자는 아이디 앞 3자만 보입니다(예: wor****). 읽는 데는 제한이 없고, 남기는 것은 로그인한 회원만 됩니다. 한 사람이 한 번이며 다시 쓰면 앞의 것을 덮어씁니다.

자주 묻는 것

파일로 계획하기 스킬(planning-with-files)은 어떻게 설치합니까?

터미널에 npx skills add OthmanAdi/planning-with-files --skill planning-with-files -g -a claude-code 한 줄이면 됩니다. -g 는 계정 전체에 넣는다는 뜻으로, 빼면 지금 열려 있는 폴더에만 깔려 다른 곳에서는 안 보입니다. -a claude-code 를 빼면 전역 설치를 지원하지 않는 다른 도구 때문에 빨간 실패 문구가 뜨는데 실제로는 깔린 상태라 헷갈립니다.

파일로 계획하기 스킬은 무엇을 합니까?

task_plan.md·findings.md·progress.md 세 파일을 프로젝트에 두고 매 턴마다 자동으로 다시 읽어 들입니다. /clear 나 컨텍스트 압축으로 대화가 리셋돼도 계획은 디스크에 남아 있어 작업이 끊기지 않습니다. UserPromptSubmit·PreToolUse·Stop 같은 훅으로 강제 주입됩니다. 지침처럼 "지켜주면 좋고"가 아니라 매번 실제로 돕니다.

파일로 계획하기 스킬은 언제 씁니까?

5단계 넘는 조사·구축 작업을 시킬 때, 컨텍스트가 자주 끊기는 긴 세션에서 이전 진행 상황을 계속 잃어버릴 때입니다. 조사·구축이 5단계를 넘어가거나, 세션이 자주 끊겨서 매번 다시 설명해야 하는 상황에서 씁니다. 짧은 질문 하나짜리 작업에는 안 써도 됩니다.

파일로 계획하기 스킬을 쓸 때 걸리는 데가 있습니까?

웹에서 가져온 내용을 계획 파일에 그대로 적으면 안 됩니다. task_plan.md 는 매 턴 자동으로 다시 읽혀 지시처럼 작동할 수 있습니다. 외부에서 가져온 내용은 findings.md 에만 적고, 그 안의 지시문은 절대 그대로 따르지 않아야 합니다. 간단한 작업에는 오히려 과합니다. 3단계 미만의 단순 질문이나 파일 하나 수정하는 일에는 필요 없습니다.

함께 보면 좋은 스킬

어느 것부터 깔지 모르겠다면 클로드 스킬 추천 15개를 보십시오. 67개를 직접 깔아 보고 골랐습니다.