I replaced chaotic solo Claude coding with a simple 3-agent team (Architect + Builder + Reviewer) — it's stupidly effective and token-efficient

Who Should Read

Developers utilizing the Claude API to automate coding tasks or design AI agent workflows. It is particularly useful for those who have experienced quality degradation or token waste when handling complex tasks with a single LLM call.

Core Mechanics

• Access to the original article is blocked, so we can only summarize based on the title.
• The 3-agent structure separates Claude into three roles: Architect (design), Builder (implementation), and Reviewer (review).
• It claims to solve the problem of tangled context and token waste that occurs when entrusting all tasks to a single Claude session.
• The logic is that focusing each agent on its assigned role reduces the context window for each call, increasing token efficiency.
• The structure overcomes the limitations of self-review by having the Reviewer agent separately review the Builder's output.

Evidence

• "(No comment information)"

How to Apply

• When developing a new feature, assign only the Architect role to the first Claude call and have it perform only 'requirement analysis → component separation → interface design', and then pass the results to the prompt of the next call to have the Builder write the actual code, configuring a pipeline.
• Instead of using the code generated by the Builder as is, automate the review stage by creating a third Claude call with a separate Reviewer role prompt ('Find bugs, security vulnerabilities, and performance issues in this code').
• Design prompts to minimize unnecessary token usage by passing only minimal context between agents (e.g., Architect → Builder only the design document, Builder → Reviewer only the code).

Code Example

# handoff/brief.md 예시 (Architect → Builder)

## Task Brief
**Goal:** 사용자 프로필 수정 API 엔드포인트 추가

**Scope (이것만 구현):**
- `PATCH /api/users/:id` 엔드포인트
- 수정 가능 필드: name, bio (email 제외)
- 입력 유효성 검사 포함

**Out of Scope (절대 추가 금지):**
- 인증 미들웨어 변경
- 다른 엔드포인트 수정
- 리팩토링

**완료 기준:**
- 위 두 필드만 업데이트됨
- 잘못된 입력 시 400 반환
- 기존 테스트 통과

---
# Builder 시스템 프롬프트 예시
"brief.md에 명시된 것만 구현하라.
범위 밖 기능 추가, 리팩토링, 스타일 변경 금지.
완료 후 handoff/review-request.md에 변경 파일 목록 작성."

Terminology

Related Papers

• Show HN: ctx – Search the coding agent history already on your machine

  Claude Code, Cursor, Codex 등 코딩 에이전트가 이전 세션의 논의·결정·실패 시도를 잊지 않도록 SQLite로 인덱싱해 재사용할 수 있게 해주는 오픈소스 CLI 도구다.

• Micro-Agent: Beat Frontier Models with Collaboration Inside Model API

  vLLM 팀이 단일 모델 API 호출 뒤에서 여러 모델이 협업하는 'Micro-Agent' 개념을 공개했습니다. 별도의 에이전트 코드 없이 라우터 레이어에서 모델 조합을 실행해 GPT-4급 결과를 더 저렴하게 낼 수 있다는 아이디어입니다.

• Ornith-1.0: self-improving open-source models for agentic coding

  Gemma 4와 Qwen 3.5를 기반으로 파인튜닝한 코딩 특화 오픈소스 모델로, RL(강화학습)을 통해 스캐폴드(에이전트 실행 구조)까지 함께 최적화하는 방식을 주장하지만, 커뮤니티에서는 벤치마크 과최적화에 불과하다는 의심을 받고 있다.

• Entity Binding Failures in Tool-Augmented Agents

  AI 에이전트가 올바른 도구를 선택해도 잘못된 대상에 실행하는 'Entity Binding 실패' 문제를 정의하고, 이를 막는 실행 정책을 평가한 논문.

• Herdr: Agent multiplexer that lives in your terminal

  여러 AI 코딩 에이전트(Claude, Codex 등)를 하나의 터미널에서 동시에 실행·관리할 수 있는 Rust 기반 오픈소스 툴로, tmux처럼 세션이 유지되고 SSH로 원격 접속도 가능해 멀티 에이전트 워크플로우를 크게 단순화해준다.

• Ornith-1.0: Self-scaffolding LLMs for agentic coding

  모델이 문제 풀이 전략(scaffold)을 직접 생성하고 개선하는 자기강화 학습 프레임워크를 적용한 오픈소스 코딩 특화 LLM으로, 9B 소형 모델부터 397B 대형 모델까지 라인업을 갖추고 SWE-Bench 등 주요 벤치마크에서 Claude Opus 4.7을 능가하는 성능을 보여줬다.

Related Resources

• https://www.reddit.com/r/ClaudeAI/comments/1sa7ju4/i_replaced_chaotic_solo_claude_coding_with_a/