promptbyprompt/agent-briefs

에이전트 브리프

하위 에이전트는 빈 메모리로 시작합니다. 오직 당신이 작성한 내용만 알고 있습니다. 하위 에이전트, 워크플로우 또는 긴 작업을 시작하기 전에 이 스킬 폴더에 있는 templates/brief.md로 브리프를 작성하세요.

단계

1. 여러 부분으로 구성된 큰 작업: 먼저 templates/planner.md로 계획 에이전트를 실행합니다. 각각 측정 가능한 done_when이 있는 5~8개의 단계를 반환합니다. 각 단계는 고유한 브리프를 갖습니다.
2. 품질 작업(음악, 사운드, 영상, 글쓰기 스타일): 먼저 templates/reference.md를 따릅니다. 2~3개의 레퍼런스를 수집하고, 측정하고, 차이점을 기록하고, 한 조각을 프로토타입으로 만든 후, 나머지 작업을 진행하기 전에 소유자가 평가하도록 합니다.
3. templates/brief.md의 모든 제목으로 브리프를 작성합니다. 해당되지 않는 제목 아래에는 "없음"이라고 작성합니다. 무언가를 빌드하거나 변경하는 모든 브리프에 templates/test-policy.md를 붙여넣습니다.
4. 빌드 단계 후에는 동일한 기록된 자료를 대상으로 templates/critic.md의 2~3명의 비평가와 병렬로 검토합니다. 병합된 must_fix 목록을 하나의 수정 에이전트에게 전달합니다.
5. 약 15분 이상 실행되는 모든 에이전트 옆에 감시 프로세스를 시작합니다(아래 참조).
6. 사용자에게 시작한 내용, 예산, 정직한 예상 시간을 알립니다. 불확실한 점도 말합니다.

모든 브리지의 규칙

• 먼저 읽기: 긴 맥락을 붙여넣는 대신 파일과 섹션을 가리킵니다.
• 소유자의 말을 인용합니다(필요시 번역). 에이전트가 실제로 요청된 내용을 볼 수 있도록 합니다.
• 소유자가 자리에 없으면 다음과 같이 말합니다: "소유자가 응답할 수 없습니다. 스스로 결정하고 모든 결정을 기록하십시오."
• 완료 기준은 스크립트, 테스트 또는 측정으로 확인 가능해야 합니다. 숫자와 범위를 사용합니다.
• 에이전트는 사람처럼 보고 들을 수 없습니다. 측정(스크린샷, 프레임 수, 음량, 피크)하게 하고, 아무도 보거나 듣지 않은 것을 보고서에 명시하며, 취향은 소유자에게 맡깁니다.
• 모든 브리프에는 시간 예산, 테스트 예산 및 중단 규칙이 있습니다: "시간이 다 되면 멈추고, 남은 것을 기록한 후 반환하십시오." 긴 작업에는 체크포인트도 있습니다("2시간에 X가 시작되지 않았으면 Y로 대체하십시오.").
• 제한 없이 "모든 이전 테스트 재실행" 또는 "모든 것을 계속 작동 유지"라고 작성하지 마십시오. 새 부분이 있는 위치에서 테스트하고, 해당 부분을 변경한 경우에만 이전 테스트를 다시 실행하십시오.
• 시간이 부족할 경우를 대비해 우선순위를 가장 중요한 것부터 나열하고, 나머지에 어떤 일이 발생하는지 명시합니다.
• 산출물은 대체하는 대상의 이름, 형식 및 길이를 유지하여 다음 단계에서 교체할 수 있도록 합니다.
• 진행 파일은 완료된 각 항목당 하나의 타임스탬프가 있는 줄을 얻어 중단 시 작업이 유지되도록 합니다.
• 하드 규칙은 이유를 명시합니다("절대 X를 저장하지 마십시오: 저장하면 해당 레퍼런스가 지워집니다.").
• 이전 실패를 규칙으로 전달합니다("이전 클립이 검게 재생되었습니다: Main 프로필과 yuv420p를 사용하십시오.").
• 위험한 사이드 퀘스트에는 시간 제한을 둡니다: "최대 15분을 소비한 후 Y로 대체하십시오."
• 병렬 에이전트에는 범위 펜스를 제공합니다: "3단계는 당신의 작업이 아닙니다: A 또는 B를 건드리지 마십시오."
• 고정된 반환 형식을 요청합니다: 수행된 작업, 건너뛰고 이유, 측정값, 테스트 시간, 사용된 시간, 나머지 작업 예상 시간, 파일 위치.

감시 프로세스

각 장기 에이전트 옆에 시간 예산을 기다린 후 한 줄을 출력하는 백그라운드 명령을 시작하십시오:

sleep 5400; echo "예산 초과: 3단계 (90분)"

백그라운드에서 실행합니다(Claude Code가 완료 시 알림). 실행되면: 에이전트의 진행 파일을 읽고, 에이전트에게 정리하고 반환하도록 지시하거나 중지하거나 예산을 한 번 연장하고 사용자에게 알립니다. 에이전트가 일찍 반환하면 감시 프로세스를 중지합니다.