AI 보조 개발3 분 읽기

브레인스토밍 → 플랜 → 검증: 에이전트를 정직하게 만드는 규율

코딩 에이전트의 가장 큰 품질 레버는 모델이 아니라 — 설계 전 브레인스토밍, 문서화된 플랜, 어떤 '완료' 주장 전의 검증을 강제하는 프로세스다.

#claude-code#workflow#verification#agents
개념 도식: 에이전트 워크플로 규율
글 내용을 요약한 개념 도식.

제 에이전트 산출물을 가장 개선한 건 더 나은 프롬프트가 아니었습니다. 에이전트가 단계를 건너뛰지 못하게 막은 것이었습니다.

모델이 아니라 프로세스

내버려 두면 유능한 에이전트는 곧장 구현으로 뛰어들어, 성공을 선언하고, 넘어갑니다. 가장 비싼 실패는 전부 그 도약에서 왔습니다. 그래서 고정된 순서를 돌리고, 건너뛰지 못하게 합니다:

  1. 설계 전 브레인스토밍. 코드를 쓰기 전에 의도와 선택지를 탐색. 잘못된 가정이 값싸게 잡히는 지점입니다.
  2. 플랜을 적는다. 커밋된 스펙/플랜 문서로, "무엇을 만드는가"를 명시적·검토 가능하게 — 에이전트 머릿속에 한 턴 담아두지 않고.
  3. 완료 주장 전에 검증. 증거 없는 "고쳤어요"는 없음. 체크를 돌리고, 출력을 읽고, 그다음 주장.

탐색으로 범위를 정한 병렬 작업

낯선 코드베이스를 건드리는 건 먼저 읽기전용 탐색 에이전트를 병렬로 보냅니다 — 결과 API·저장·배포 경로를 지도화 — 그 지도를 구현 스펙에 먹입니다. 구현자는 탐색과 구축을 동시에 하지 않습니다. 탐색은 자기 단계로, 병렬로 하고, 그 출력이 구축을 제약합니다.

솔직한 부분

"완료 전 검증"은 당연해 보이고 모두가 건너뛰는 단계입니다 — 지칠 때의 저 포함. 하지만 증거 없이 "완료"라는 에이전트는 자신 있는 추측일 뿐이고, 대량의 자신 있는 추측이 깨진 작업을 빠르게 배포하는 방법입니다. 규율은 화려하지 않습니다 — 브레인스토밍하고, 적고, 검증하고 — 그리고 그게 당신을 가속하는 에이전트와 그럴듯한 잔해를 생성하는 에이전트의 차이 전부입니다. 모델은 좋아졌고, 가치는 여전히 그 주변의 게이트에서 옵니다.

관련 글