POTAL 프로젝트 명령어 파일 생성 + 로그 자동 기록 스킬. Claude Code 터미널용 명령어 파일(.md)을 만들 때 반드시 사용. 트리거: '명령어 파일', '명령어 만들어', 'CLAUDE_CODE_', '터미널에 넣을', '터미널 명령어', 'command file'. 명령어 파일을 생성하면 자동으로 (1) COWORK_CONVERSATION_LOG.md 대화 로그 업데이트 (2) EXECUTION_STATUS.md 실행 상태 추적 파일 업데이트를 함께 수행. 세션 시작 시에도 이 스킬을 사용하여 현재 상태를 자동 파악. 명령어 파일을 만드는 모든 상황에서 반드시 이 스킬을 사용할 것.
Claude Code 터미널용 명령어 파일을 만들 때, 로그 기록을 자동으로 함께 수행하여 "로그 까먹음" 문제를 구조적으로 방지한다.
명령어 파일 생성과 로그 기록은 분리할 수 없는 하나의 행위다. 명령어 파일만 만들고 로그를 안 쓰면 다음 세션에서 맥락을 잃는다.
새 세션이 시작되거나 컨텍스트가 끊긴 후 재개할 때, 어떤 작업이든 하기 전에 아래 2개 파일을 반드시 읽는다:
1. docs/sessions/COWORK_CONVERSATION_LOG.md — 마지막 항목부터 역순으로 읽어 현재 상태 파악
2. docs/sessions/EXECUTION_STATUS.md — 명령어 파일별 실행 상태 (DONE/IN_PROGRESS/NOT_STARTED)
읽은 후 은태님에게 한 줄 요약을 보고한다:
"마지막 작업: [내용]. 미실행 명령어: [N]개. 이어서 진행하겠습니다."
절대 로그를 안 읽고 즉흥으로 움직이지 않는다.
명령어 파일을 만들 때 아래 3단계를 하나의 작업으로 수행한다. 1단계만 하고 2~3단계를 빼먹으면 안 된다.
CLAUDE_CODE_[내용].md/Users/maegbug/potal/ 또는 현재 워크스페이스)명령어 파일을 만든 직후, 아래 포맷으로 로그를 추가한다:
### [HH:MM KST] [제목]
- 은태님 지시: [원문 요약]
- 결정: [무엇을 왜]
- 생성한 명령어 파일: **`파일명.md`**
- 내용 요약: [명령어 파일이 하는 일 1줄]
- 다음 단계: [이 파일을 어느 터미널에 넣을지]
명령어 파일의 실행 상태를 기록/갱신한다:
| 파일명 | 상태 | 터미널 | 시간 | 비고 |
|--------|------|--------|------|------|
| CLAUDE_CODE_FIX_17_AUTO.md | NOT_STARTED | - | - | 17개 순차 실행 |
상태값:
NOT_STARTED — 생성됨, 아직 터미널에 안 넣음IN_PROGRESS — 터미널에서 실행 중DONE — 실행 완료, 결과 확인됨FAILED — 실행 중 에러, 재실행 필요은태님이 터미널 결과 스크린샷을 공유하면:
DONE 또는 FAILED로 갱신세션이 끝나기 전에 반드시:
명령어 파일을 만들 때마다 스스로에게 물어본다:
하나라도 빠지면 명령어 파일 생성이 완료된 게 아니다.