검증됨코딩·앱 만들기
내 일에 바로 쓰는 방법
코딩 에이전트 위임 브리프
코딩 에이전트가 코드를 만지기 전에 범위, 파일, 제약, 검증 명령을 먼저 준다.
원본 근거Claude Code best practices확인 2026-07-07
이럴 때 쓰기Coding agents · Bug fixes · Feature slices
얻는 결과다음에도 재사용할 수 있는 작업 시작점
핵심 아이디어
자율 코딩 에이전트는 명확한 수직 슬라이스, 수용 기준, 실제 테스트/빌드 명령이 있을 때 더 잘 작동한다.
왜 효과적인가
그렇지 않으면 에이전트는 너무 넓게 탐색하거나 관련 없는 파일을 바꾸거나 검증 없이 그럴듯한 수정에서 멈춘다.
약한 예
UI 버그 고쳐줘.
좋은 패턴
작업: /ko 홈 모바일 overflow 수정. src/pages/[lang]/index.astro와 PatternCard만 수정. 수용 기준: 390px 가로 스크롤 없음, npm run build 통과, 스크린샷 경로 포함.
내 일에 맞게 바꾸기
작업 단위허용 파일금지 변경수용 기준검증 명령
작업 템플릿
목표: [달성하려는 것]
맥락: [배경, 대상, 제약]
사용 패턴: 코딩 에이전트 위임 브리프
변수: 작업 단위, 허용 파일, 금지 변경, 수용 기준, 검증 명령
출력: [정확한 출력 형식]
마무리 전: 한계와 개선점 1개를 적기운영 레시피
- 먼저 약한 버전을 적어 어떤 문제를 고치는지 확인한다.
- 지시문을 무작정 길게 만들지 말고 빠진 변수를 추가한다.
- 모델에게 출력 형식을 한 번 명확히 따르게 한다.
- 첫 답변을 아래 체크리스트로 검토한다.
- 개선된 버전을 재사용 패턴으로 저장한다.
품질 체크리스트
- 단순 작업이 아니라 실제 목표를 알려줬는가?
- 답을 요구하기 전에 출력 형식을 정했는가?
- 예시, 제약, 품질 기준을 넣었는가?
- 한계, 불확실성, 실패 케이스를 요구했는가?
- 다음에도 재사용 가능한 패턴으로 남겼는가?
모델별 노트
Claude Code
긴 컨텍스트, 비평, 구조화된 글쓰기에 강합니다. 섹션과 예시를 명확히 주는 편이 좋습니다.
Codex
작업 범위와 검증 명령이 명확할 때 가장 잘 작동합니다.
ChatGPT
빠른 반복과 일상 템플릿에 강합니다. 출력 형식과 가정을 명확히 적는 편이 좋습니다.
한계
비밀, 과금, 삭제/파괴 작업, 애매한 제품 판단은 사람 승인 없이 위임하지 말 것.
다음에 볼 것
이 내용을 재사용 워크플로로 바꾸세요.
프롬프트 디버깅 체크리스트와 솔로 빌더 AI 세팅 팩을 언어별 .md 파일로 받을 수 있습니다.