일일 마스터 프롬프트 만들기
개요
일일 마스터 프롬프트는 하나의 독립적인 파일 DAILY_PROMPT.md로, 새로운 세션이 이를 실행하여 프로젝트를 이어받고, 하루 작업을 수행한 후 다음 날을 위해 준비 상태로 남겨둘 수 있게 합니다. 프로젝트의 기억은 다섯 개의 상태 파일에 저장되며, 대화 내용에는 저장되지 않습니다. 첫 실행 후 사용자는 다음만 입력하면 됩니다:
Read <폴더>/DAILY_PROMPT.md and execute it.
사용자 입력: $ARGUMENTS (폴더 및/또는 프로젝트 설명; 둘 중 하나는 없을 수 있음).
완료 시 존재하는 것
모든 것은 프로젝트 폴더(<폴더>)에 위치하며, ${CLAUDE_SKILL_DIR}/templates/의 템플릿에서 빌드됩니다:
| 파일 | 내용 | 변경 사항 |
|---|---|---|
DAILY_PROMPT.md | 미션, 마일스톤, 규칙, 컨텍스트 맵, 세션 절차 | 사용자가 요청할 때만 변경 |
BACKLOG.md | ID와 상태가 있는 정렬된 작업 항목 | 매 실행마다 변경 |
DEVLOG.md | 각 실행의 날짜별 추가 전용 로그 | 매 실행마다 변경 |
HANDOFF.md | 현재 상태, 다음 3개 작업, 경고 | 매 실행마다 다시 작성됨 |
QUESTIONS.md | 사용자를 위한 질문 (각 질문에 추천 포함) | 실행 시 질문, 사용자가 답변 |
APPROVALS.md | 승인 대기 중인 위험하거나 되돌릴 수 없는 작업 | 실행 시 요청, 사용자가 결정 |
진행 상황은 상태 파일에 저장됩니다. DAILY_PROMPT.md에는 몇 주 동안 변하지 않는 내용만 저장됩니다.
단계
- 폴더 찾기. 인수에 있는 폴더를 사용합니다. 그렇지 않으면 프로젝트의 사양이나 코드가 있는 폴더를 사용합니다. 여러 개가 해당되면 물어봅니다.
- 질문하지 않고 읽어서 컨텍스트 수집. 사용자의 설명;
README*,CLAUDE.md,AGENTS.md; 사양(GDD, PRD, 로드맵,docs/);git log --oneline -30및git status; 2-3 레벨 파일 트리; 빌드, 테스트, 린트 및 실행 명령을 드러내는 매니페스트와 스크립트; 작업에 필요한 연결된 MCP 서버; TODO/FIXME 주석; 기존 상태 파일. 완료된 것과 완료되지 않은 것을 분리합니다. - 파일이 말하지 않는 것에 대해서만 질문 (AskUserQuestion 호출, 최대 4개 질문). 질문 목록: 현재 마일스톤 및 완료 정의; 완료된 항목 확인 방법; 엄격한 규칙 (절대 게시/배포 금지, 새 종속성 전에 질문, 브랜치 및 푸시 정책); 실행이 대면, 비대면 또는 둘 다인지 여부. 아무도 답하지 않으면 가장 안전한 해석(비대면, 푸시 없음, 게시 없음)을 취하고 각 가정을
QUESTIONS.md에 "답변될 때까지 가정됨" 줄과 함께 기록합니다. DAILY_PROMPT.md작성.DAILY_PROMPT.template.md를 사용합니다. 모든 섹션은 이 프로젝트의 실제 경로, 명령, 도구 및 마일스톤을 명명합니다. 일일 실행 줄에는 저장소 루트(사용자가 Claude를 여는 위치)를 기준으로 한 상대 경로를 작성하고 절대 경로는 사용하지 않습니다. 폴더가 루트 자체인 경우 줄은Read DAILY_PROMPT.md and execute it.입니다. 프로젝트 실행 또는 테스트가 실제 데이터(사용자 파일, 라이브 계정, 프로덕션, 게시된 장소)에 영향을 미칠 수 있는 경우, 임시 또는 테스트 복사본을 사용하는 기본 규칙과 확인 방법을 추가합니다.- 상태 파일 생성. 템플릿에서 생성합니다. 기존 파일이 있으면 병합하고, 덮어쓰거나 사용자의 기록 순서를 변경하지 않습니다.
BACKLOG.md를 마일스톤, 사격의 차이, TODO 및 사용자 목표에서 채워, 항목 1이 오늘 시작할 수 있고 각 항목이 하나의 세션에 맞도록 정렬하며, 각 항목에 구체적인 "완료 조건"을 포함합니다.HANDOFF.md를 시작 상태로 채웁니다. 예제 항목이 아직 적용되지 않는 템플릿은 헤더와 형식 줄을 유지하고 항목 대신없음.을 넣습니다. 확인:grep -n "{{" <폴더>/*.md가 아무것도 반환하지 않아야 합니다. - 커밋. 폴더가 git 저장소에 있으면 새 파일을 커밋합니다 (
chore: add daily master prompt). 저장소의 커밋 규칙을 따릅니다. - 첫 실행. 사용자가 하지 말라고 하지 않는 한, 지금
DAILY_PROMPT.md를 실행합니다. 정확히 새 세션이 실행하는 방식과 동일하게 실행합니다. 이것이 프롬프트의 테스트입니다: 단계가 모호하거나, 실패했거나, 파일에 없는 지식이 필요했을 때 프롬프트를 수정하고 수정 사항을DEVLOG.md에 기록합니다. - 인계. 사용자에게 생성된 내용, 첫 실행이 수행한 작업을 알리고, 코드 블록으로 일일 줄을 제공합니다:
Read <폴더>/DAILY_PROMPT.md and execute it./daily-master-prompt:run <폴더>도 같은 기능임을 언급하고, 해당 줄이 예약된 작업의 프롬프트로도 작동한다고 알립니다.
기존 프롬프트 업데이트
DAILY_PROMPT.md가 이미 존재하면, 먼저 해당 파일과 모든 상태 파일을 읽습니다. 사용자가 추가 사항을 요청한 경우, 변경 사항을 해당 위치에 적용하거나 ## 추가 사항 아래에 날짜가 있는 항목으로 추가합니다. 모든 상태를 유지합니다. 변경 사항을 DEVLOG.md에 기록합니다.
일반적인 실수
| 실수 | 결과 | 대신 해야 할 일 |
|---|---|---|
| 일반적인 프롬프트 ("프로젝트 작업") | 매 실행마다 프로젝트를 다시 발견함 | 실제 경로, 명령, 마일스톤, 완료 정의 |
진행 상황을 DAILY_PROMPT.md에 기록 | 프롬프트가 오래되어 상태 파일과 모순됨 | 진행 상황은 BACKLOG/HANDOFF/DEVLOG에 저장 |
| 확인 단계 없음 | 작동하지 않는 "완료" 항목 | 항목당 구체적인 확인 (테스트, 빌드, 플레이테스트, 린트) |
| 첫 번째 차단기에서 실행 중단 | 비대면 날짜에 아무것도 생성되지 않음 | QUESTIONS/APPROVALS에 기록하고 다음 항목 계속 진행 |
| 백로그 항목이 너무 큼 | 매일 절반만 완료된 작업 | 하나의 항목이 하나의 세션에 맞도록 분할 |
| 기존 상태 파일 덮어쓰기 | 사용자가 기록을 잃음 | 병합 |