에이전트 프롬프팅
독자는 당신의 맥락이 전혀 없는 유능한 모델입니다. 최종적으로 참이어야 할 것과 그 이유를 말하고, 모델이 경로를 계획하도록 두세요: 모델이 계획할 수 있는 작업을 위해 작성된 경로는 잘못된 단계를 포함하더라도 충실히 따라집니다. 포장 방식(브리프, 핸드오프, 스킬)은 다르지만, 작성 방식은 동일합니다.
핵심
무엇을 넣을까. 라인 테스트: 독자가 작업과 훈련에서 이를 유추할 수 있는가? 독자가 직접 찾을 수 없는 사실, 사용자의 관례, 계약, 하드 제약 조건 및 완료 기준은 테스트를 통과하지 못하므로 남깁니다. 계획 가능한 작업을 위한 경로는 테스트를 통과하므로 제거합니다. 기준 체크리스트는 최종 상태이고, 단계 체크리스트는 경로입니다.
자기 완결성. 새로운 세션은 프롬프트와 디스크만 읽습니다. 모든 메시지는 변경 사항이 제자리에 적용된 완전한 현재 규칙 집합을 전달하며, "이전처럼, 그리고 이 변경 사항을 추가"라고 하지 않습니다. 모든 문서는 의존하는 모든 상시 규칙을 다시 명시하며, "상위 문서에 따름"이라고 하지 않습니다.
이유를 긍정적으로 명시. 모델은 이유로부터 일반화하므로, 각 규칙은 그 이유를 함께 전달합니다("단락당 한 줄로 연속해서 작성, 채팅 상자가 줄바꿈을 의도된 것으로 처리하기 때문"). 대상 행동을 명시하세요; 금지는 금지된 행동을 맥락으로 끌어들여 더 접근하기 쉽게 만들므로, 하드 가드레일로서만 사용하고 긍정적인 대상을 함께 제시하세요. 압박 언어(MUST, CRITICAL, 대문자)는 현재 모델에서 과도하게 트리거되므로, "X를 사용할 때"와 같이 작성하세요.
주요 용어는 한 곳에, 무의미한 표현 금지. 모델이 이미 알고 있는 단어(영수증, 전쟁의 안개, 빠른 루프)가 구절보다 낫고, 사용자 자신의 용어가 둘 다보다 낫습니다. 각 의미는 한 곳에 위치합니다. 독자가 기본적으로 따르는 문장은 말하는 데 부담을 주므로 아무것도 하지 않습니다: 문장에서 단어가 아닌 문장 자체를 삭제하세요.
프롬프트 구조
- 의도 — 더 큰 목표, 누구를 위한 것인지, 출력이 무엇을 가능하게 하는지; 모델은 이를 프롬프트가 미치지 못하는 미세 결정에 사용합니다.
- 최종 상태 — 완료되었을 때 무엇이 존재하는지, 어떤 속성을 가지는지, 사용자가 무엇을 할 수 있는지. 확인 가능하고, 철저해야 합니다: "수정된 모든 파일이 설명됨"은 "변경 목록 생성"이 강요하지 않는 작업을 강제합니다. 결과물의 형식은 여기에 있습니다. 절차가 아니라 속성입니다.
- 하드 제약 조건 — 위반할 수 없는 것: 읽기 전용 소스, 예산, 용어, 출처. 사용자가 명시한 제약 조건을 그대로, 절대 자체 경제 기본값을 사용하지 않습니다.
- 체크포인트 — 지침이 여전히 필요한 한 곳: 인간에게 멈춰야 할 때(파괴적이거나 되돌릴 수 없는 작업, 실제 범위 변경, 인간만이 가진 입력)와 범위를 벗어난 것이 무엇인지.
- 자유 조항 — 재구성 및 반대할 수 있는 권한. 모호한 경우, 일상적인 판단을 내리고 가정을 명시하세요; 답변이 나중에 문제를 방지할 수 있을 때(예: 실질적으로 다른 작업으로 이어지는 해석이나 되돌리기 어려운 선택) 질문하세요. 사용자는 그러한 질문을 환영합니다. 무인 실행에서는 질문이 안전한 기본값이 적용된 판결이 되고 작업은 계속됩니다.
- 영수증 — 모든 브리프에서: 완료를 보고하기 전에 각 주장을 이 세션의 산출물과 대조하여 감사하고, 확인되지 않은 것은 명확히 말하세요. 이는 허구적인 상태 보고를 거의 제거합니다.
순서가 중요한 단계(마이그레이션, 안전 프로토콜)나 단계를 건너뛰는 것이 실패인 경우에는 순서가 있는 단계를 사용하세요. 그런 경우, 독자가 복사하여 체크할 수 있는 체크리스트가 산문보다 낫습니다.
보내기 전에
번호가 매겨진 절차를 최종 상태 문장으로 바꿀 수 있나요? 남아있는 모든 줄이 제약 조건, 체크포인트, 검증 규칙 또는 결과물 사양인가요? 독자가 멈추거나, 속도를 늦추거나, 사용자가 명시하지 않은 이유로 범위를 줄이게 하는 문장이 있나요? 독자가 이 대화에 참여했어야 실행할 수 있었을까요?
분기
- 모델링할 수 있는 독자에게 한 번 보내는 메시지(하위 에이전트 디스패치, 다른 세션용 프롬프트, 핸드오프, 외부 AI에 보내는 메시지) →
references/briefs.md - 무인 실행을 위한 브리프, 체크포인트 메모 및 판결, 마감 기한 내 시퀀싱 →
references/autonomous-runs.md - 지속 문서(스킬, CLAUDE.md, 참조 문서), 그리고 언제 Anthropic의
skill-creator에 스킬 빌드를 넘길지 →references/skills-and-docs.md - 독자의 모델 또는 노력 수준 선택, 또는 Opus 대신 Haiku나 Fable용으로 작성 →
references/models.md