claude.dev 우선 엔지니어링 플레이북
Anthropic 팀은 claude.dev에서 에이전트와 함께 소프트웨어를 구축하는 방법을 공개합니다. 이 스킬은 해당 가이드라인을 포스트별로 요약하여 제공합니다. 현재까지 2026-10-15 기준 (16개 포스트).
답변 방법
- 아래 표에서 질문의 주제를 찾고 해당 참조 파일을 먼저 읽은 후 답변하세요. 세부 사항이나 정확한 문구가 필요하면
posts/에서 포스트 요약본을 여세요.
- 답변을 다음과 같은 형식으로 구성하세요:
- Anthropic 팀의 방식: 적용되는 가이드라인과 각 항목을
https://claude.dev/blog/<slug>/ 형식의 포스트에 연결하세요.
- claude.dev 외: 포스트에서 다루지 않는 내용은 일반적인 관행에서 답변하고, 그렇게 표시하세요. 포스트가 질문 전체를 다루는 경우 이 부분은 생략하세요.
posts/의 요약본에서만 인용하고, 절대 기억에서 인용하지 마세요.- 요약본의 "변경될 수 있는 세부 사항" (모델명, 가격, 노력 기본값)은 해당 모델 또는 버전에만 유효합니다. 반복하기 전에 현재 상태를 확인하세요.
- 사용자가 최신 가이드라인을 요청하거나, 질문이 위 날짜 이후의 내용과 관련된 경우, https://claude.dev/rss.xml을 읽고 해당 날짜보다 최신 포스트가 있다면 먼저 읽고 답변하세요.
주제
| 질문 내용 | 읽을 파일 |
|---|
| 코드 리뷰, 승인, 병합, 플래그, 배포, 롤백, 변경 소유권 | references/shipping.md |
| 테스트, 평가, 골든 케이스, 그레이더, 벤치마크, CI 게이트, 에이전트의 자체 검증 | references/verification.md |
| 에이전트에게 작업 위임: 태스크 명세, CLAUDE.md, 노력, 모델 선택, 로컬/클라우드 세션, 서브에이전트, 스킬, 출력 형식 | references/delegation.md |
| 무인 또는 스케줄 기반 에이전트 실행: 실행 간 상태, 자격 증명, 예산, 가드레일 | references/automation.md |
| 에이전트 구축: 도구, 컨텍스트, 프롬프트 캐싱, 워크플로 | references/agent-design.md |
| 태스크당 비용, 변경당 인간 시간, 롤백, 인시던트 | references/measurement.md |
핵심 규칙
- 결승선과 이를 증명할 검증을 명명하고, 실행하도록 두세요. (Opus 5.5 플레이북, 클라우드 세션)
- 증거 없는 주장 금지. 에이전트는 실제 검증을 실행하고 사람이 살펴보기 전에 출력을 보여주며, 다른 에이전트가 검증을 수행합니다. (코드 리뷰, 동적 워크플로)
- 문제를 잡아야 할 검증이 무엇인지 물어보고, 사람이 코드를 읽었는지 묻지 마세요. 인간 승인은 위험에 따라 확장되며, 변경 사항이 등급을 결정하고, 에이전트의 승인은 절대 사람의 승인으로 간주되지 않습니다. (코드 리뷰)
- 시스템을 변경당 인간 시간으로 판단하고, 롤백과 인시던트를 가드레일로 사용하세요. (코드 리뷰)
- 골든 케이스는 현실에서 비롯되며, 두 명의 전문가가 각 판결에 동의할 수 있어야 합니다. 인시던트를 평가 케이스로 전환하고, 그레이더를 신뢰하기 전에 채점된 기록을 읽으세요. (코드 리뷰, 평가 설계)
- 튜너가 본 적 없는 케이스에서 노이즈를 이긴 개선만 신뢰하세요. (평가 설계)
- 에이전트에게 실제 결과를 추적하는 것으로 입증된 목표 숫자를 주고, 모든 승리를 CI에 기록하세요. (claude.ai 3배 빠르게)
- 실수를 되돌리기 쉽게 만드세요: 병합 큐, 단기 플래그, 단계적 배포, 빠른 롤백, 모든 변경 사항에 대한 명명된 소유자. (코드 리뷰, claude.ai 3배 빠르게)
- 무인 에이전트는 실패를 크게 알립니다: 실패한 읽기는 조용한 날이 아니며, 목적지가 확인하기 전까지는 아무것도 완료된 것으로 간주되지 않습니다. (에이전트 자동화)
- 컨텍스트를 간결하게 유지하고 에이전트가 나머지를 찾도록 하세요. 모델이 개선됨에 따라 규칙을 삭제하세요. (컨텍스트 엔지니어링, 에이전트처럼 보기)
- 토큰이 아닌 완료된 작업에 대해 비용을 지불하세요: 검증은 더 많은 노력보다 저렴하고, 재시도는 어떤 절약보다 비용이 더 듭니다. (태스크 비용)
출처