Claude Code를 여러 AI 에이전트가 협력해 개발하는 'Han' 워크플로우 공개

'Han'은 Claude Code로 코딩할 때 여러 AI 에이전트가 팀처럼 나뉘어 함께 일하도록 설계된 워크플로우입니다. 먼저 기획서(스펙)를 작성하고, 에이전트들이 그 스펙을 근거 삼아 코드를 만들어 나갑니다. 혼자 개발할 때 AI를 더 체계적으로 활용하고 싶은 사람에게 유용합니다.

보통 Claude Code를 쓸 때는 한 명의 AI에게 작업을 맡기는 방식이 일반적입니다. Han은 여기서 한 발 더 나아가 '에이전트 스웜(여러 AI가 동시에 분업)' 방식을 도입했습니다. 먼저 개발하려는 기능을 명확히 문서로 정리(스펙 작성)한 뒤, 각 에이전트가 그 문서를 근거로 코드를 짜거나 검토하는 역할을 맡습니다.

'증거 기반(Evidence-Based)'이라는 말은 에이전트가 임의로 코드를 만들지 않고, 미리 작성된 스펙과 실제 결과를 비교하며 작업한다는 뜻입니다. 이 방식은 1인 개발자가 복잡한 기능을 AI와 함께 체계적으로 만들 때 실수를 줄이고 일관성을 높이는 데 도움이 됩니다. 직접 써본 경험을 공유한 커뮤니티 게시물로, 공식 Anthropic 발표가 아닌 사용자 워크플로우입니다.

핵심 포인트

  • 기능 개발 전에 스펙(기획 문서)을 먼저 작성하고 AI가 그것을 기준으로 코드를 생성한다
  • 여러 Claude 에이전트가 분업(스웜)해 코드 작성·검토 등 역할을 나눈다
  • '증거 기반' 접근으로 에이전트가 추측이 아닌 문서 근거를 따르게 한다
  • 1인 개발자가 Claude Code를 더 체계적으로 쓰기 위한 실용 워크플로우
  • 공식 도구가 아닌 커뮤니티 공유 방법론이므로 직접 적용·조정이 필요하다

용어 한 줄 설명

코딩
컴퓨터가 이해할 수 있는 언어로 명령을 작성하여 프로그램을 만드는 일입니다.
AI 에이전트
사람 대신 정보를 찾거나 작업을 처리하도록 만든 AI 프로그램입니다.
워크플로우
사람의 도움 없이 복잡한 작업을 끝내기 위해 AI가 거치는 자동화된 단계들.
워크플로
여러 작업을 순서대로 연결한 일 처리 흐름을 말합니다.
개발
컴퓨터 프로그램을 만드는 모든 과정입니다.
에이전트 스웜
여러 AI 에이전트가 각자 역할을 나눠 동시에 작업하는 방식.
증거 기반(Evidence-Based)
추측이 아니라 미리 정해진 문서나 데이터를 근거로 판단하는 방식.
IDE
코드 편집, 실행, 오류 확인 기능을 한데 모은 개발용 소프트웨어 도구입니다.
원문 보기