에이전트 작업 브리프
에이전트나 서브에이전트에게 일을 넘기기 전, 목표·가설·검증 기준을 다섯 줄로 적게 해주는 브리핑 스킬.
자동화·워크플로입문★ 537⑂ 41AI 점수 9/10마지막 업데이트: 2026. 11. 4.
무엇을 해주나
- 작업을 위임하기 전에 위험도(stakes) 를 먼저 판정하게 합니다. 버려도 되는 스크립트면 그냥 넘기고, 사용자·돈·권한·데이터에 닿는 일이면 전 단계를 수행합니다.
- 결과를 보기 전에 가설 한 줄을 적게 해, 그럴듯한 답변이 기본값이 되는 것을 막습니다.
- 목표 / 사용자 / 범위 밖 / 제약을 내 말로 적게 합니다. 단계가 아니라 결과를 적는 것이 핵심입니다.
- 결과물을 보기 전에 "검증됐다"의 정의를 못 박습니다(지정된 테스트 통과, 명령어와 기대 출력, 로그/스크린샷, 원본 데이터로 재계산한 수치 등).
- 에이전트가 "나와 함께 생각하는지, 나 대신 생각하는지" 모드를 명시하게 하고, 후자라면 더 엄격한 리뷰를 요구합니다.
- 작업 상단에 바로 붙여 넣을 수 있는 카드 템플릿을 제공합니다.
이런 분께 추천
- 서브에이전트를 자주 띄우거나 PR·분석·문서 작성을 통째로 위임하는 분
- 에이전트 결과물이 "맞는 건지 그럴듯한 건지" 구분이 안 돼 리뷰가 힘들었던 분
- 팀에 위임 표준 양식을 만들고 싶은 테크리드·관리자
활용 예시
- 플래키 테스트 조사 위임: "compaction.e2e 실패는 모델 문제가 아니라 요약 쓰기와 다음 턴의 경합"이라는 가설을 먼저 적고, 검증 기준을 "해당 테스트 통과 + 기존 코드에서는 실패하는 새 테스트 추가"로 못 박은 뒤 에이전트에 전달.
- 배포되는 기능 PR 위임: 범위 밖에 public API와 lockfile을 명시하고, 완료 조건을
명령어 실행 결과 + 출력으로 지정한 뒤 작업 후 증거 중심 리뷰를 진행. - 분석 문서 위임: 모드를 "나 대신 생각해줘"로 지정하고, 완료 시 실행한 명령과 출력 → 요약 → 가정·결정 순으로 보고하도록 카드에 적어 전달.
· · · 설치 가이드 · · ·
설치 없이 지금 한 번 써보기
아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.
이 파일의 지시를 읽고 그대로 따라서 나를 도와줘: https://raw.githubusercontent.com/MiniMax-AI/mcode-stack/HEAD/stacks/ronny/skills/agent-brief/SKILL.md 내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)
Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.
↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
AI 스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 MiniMax-AI/mcode-stack 의 stacks/ronny/skills/agent-brief 폴더를 내 ~/.claude/skills/agent-brief/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/MiniMax-AI/mcode-stack.git /tmp/mcode-stack && mkdir -p ~/.claude/skills/agent-brief && cp -r /tmp/mcode-stack/stacks/ronny/skills/agent-brief/* ~/.claude/skills/agent-brief/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 엽니다.
- 저장소를 내려받습니다:
git clone https://github.com/MiniMax-AI/mcode-stack.git /tmp/mcode-stack - 스킬 폴더를 만듭니다:
mkdir -p ~/.claude/skills/agent-brief - 파일을 복사합니다:
cp -r /tmp/mcode-stack/stacks/ronny/skills/agent-brief/* ~/.claude/skills/agent-brief/ ~/.claude/skills/agent-brief/SKILL.md파일이 있는지 확인합니다.- Claude Code를 재시작한 뒤, "이 작업을 서브에이전트에 넘기기 전에 브리프를 써줘"처럼 요청해 스킬이 발동하는지 확인합니다.
- (선택) 본문에서 함께 권장하는
evidence-first-review스킬도 같은 저장소에서 복사해 두면 리뷰 단계까지 이어집니다.
GitHub에서 원본 보기 ↗라이선스: MIT