코딩 에이전트가 우리를 매니저로 만들었어요..!
Claude Code 팀의 Addy Osmani 아티클에서 모범사례 vs. 안티패턴만 빠르게 봐도 정말 큰 도움이 됩니다.
- 스스로 결과를 검증할 수단을 주세요
모범사례: 테스트 스위트, 빌드, 스크린샷처럼 에이전트가 자기 작업을 검증할 수 있는 수단을 주고, 그 결과를 증거로 보여달라고 하세요.
안티패턴: "다 된 것 같다"를 완료 확인으로 받아들이는 것. 그러면 검증을 전부 당신이 하게 되고, 당신이 에이전트의 테스트 스위트가 됩니다.
↓
- 맥락을 분명하게 전달하세요
모범사례: 저장소를 살펴봐서는 알 수 없는 내용을 분명하게 정리해 주세요. 작업의 목표와 그것이 중요한 이유, 제약 조건, 범위 밖의 항목, 성공 기준 같은 것들입니다.
안티패턴: 진짜 기대치는 머릿속에만 두고 한 줄짜리 작업만 넘기는 것. 또는 에이전트가 코드만 읽어도 알 수 있는 내용으로 브리프를 부풀리는 것.
↓
- 교정할 때마다 쌓이게 하세요
모범사례: 같은 것을 두 번 이상 교정했다면 팀 공용 CLAUDE.md에 적거나 공유 스킬로 만드세요. 그리고 새 모델이 나오면서 그 교정이 덜 필요해졌는지 가끔 확인하세요.
안티패턴: 세션마다 같은 것을 손으로 고치거나, 내 컴퓨터에만 있는 암묵지에 기대는 것.
↓
- 판단은 맡기고, 꼭 지켜야 할 것만 강제하세요
모범사례: 기본적으로는 에이전트가 판단하게 두고, 반드시 해야 하거나 절대 하면 안 되는 몇 가지에만 훅이나 거부 규칙 같은 강제 수단을 쓰세요.
안티패턴: 규칙을 전부 대문자로 쓰거나, 있으면 좋은 정도의 선호를 훅으로 만들거나, 새 모델에는 이미 필요 없어진 옛 모델 시절의 습관을 계속 유지하는 것.
↓
- 만들기 전에 계획하세요
모범사례: 에이전트가 코딩을 시작하기 전에 계획에 합의하세요. 계획에 깔린 가정을 확인하고, 작업을 서로 겹치지 않는 병렬 작업으로 나누세요.
안티패턴: 여러 에이전트가 겹치는 작업을 동시에 하게 두고, 오후 내내 머지 충돌과 서로 다른 결정을 정리하느라 시간을 쓰는 것.
↓
- 일찍 방향을 잡고, 빨리 리셋하세요
모범사례: 처음 1분을 지켜보면서 방향을 잡아 주세요. 엇나가는 게 보이면 바로 바로잡으세요. 이미 두 번 교정했는데도 안 된다면 새 세션에서 더 나은 프롬프트로 다시 시작하세요.
안티패턴: 요청 자체를 고치지 않고 세 번째, 네 번째 교정을 시도하는 것.
↓
- 일은 위임하되, 판단은 절대 위임하지 마세요
모범사례: 일은 에이전트가 하고, 제품 결정, 보안 경계, 무엇을 출시할지 같은 중요한 결정은 당신이 하세요. 모든 diff를 그것 때문에 한밤중에 장애 호출을 받게 될 것처럼 다루세요.
안티패턴: 테스트가 통과했고 이름도 그럴듯하다는 이유로 큰 diff를 승인하는 것. 이건 코드 리뷰가 아니라 코드 추인입니다.
↓
- 당신 없이도 돌아가는 실행을 설계하세요
모범사례: 자율 작업을 맡기기 전에 완료 기준, 자체 검증, 경계, 가드레일, 사람의 승인 지점을 정하세요.
안티패턴: 완료 기준이나 멈출 지점 없이 오래 걸리는 작업을 자기 전에 걸어 두었다가, 다음 날 아침 모델이 밤새 잘못된 전제로 일했다는 걸 알게 되는 것.
↓
- 주의력이 아니라 검증을 늘리세요
모범사례: 체크, 목표, 새 리뷰어가 감시 역할을 넘겨받을 수 있는 속도만큼만 에이전트를 늘리고, 처리량뿐 아니라 품질도 측정하세요.
안티패턴: 제대로 리뷰할 수 있는 것보다 많은 세션을 열고, AI가 쓴 코드의 양으로 성공을 측정하는 것.
↓
- 무엇을 만들지 않을지 정하세요
모범사례: 누가 필요로 하는지, 효과가 있었는지 어떻게 알 수 있는지, 어떤 신호가 보이면 멈출지 묻고, 동시에 진행하는 작업(WIP)을 제한하세요.
안티패턴: 만드는 데 돈이 안 드니 그럴듯한 아이디어를 전부 PR로 만드는 것. 그러면 팀이 리뷰하고 보안을 챙기고 유지보수해야 하는 잡동사니 서랍이 생깁니다.
↓
- 비유가 들어맞지 않는 지점
모범사례: 관리의 모범사례를 따르되, 에이전트만의 차이를 고려하세요. 재작업 비용이 거의 없고, 쉽게 동의하며, 강점이 모델이 나올 때마다 바뀐다는 점 같은 것들입니다.
안티패턴: 에이전트를 주니어 개발자와 똑같다고 생각하거나, 에이전트 다섯 개를 돌릴 수 있으니 사람 다섯 명도 관리할 수 있다고 생각하는 것.
↓
- 직함은 필요 없다
모범사례: 좋은 소프트웨어가 만들어지게 하는 데 힘을 쏟으세요. 맥락을 정하고, 완료를 정의하고, 리뷰를 잘하는 것입니다.
안티패턴: 설명도 부족하고 검증도 없이 에이전트를 돌리면서, 자신이 쓴 코드 줄 수로 스스로를 평가하는 것.
