에피소드 3. 주니어 개발자를 위한 실전 에이전틱 코딩 가이드

# 1. Claude Code 설치 확인
claude --version

# 2. Agent Teams 활성화
# ~/.claude/settings.json에 추가
{
  "agentTeams": {
    "enabled": true,
    "mode": "in-process",
    "teamSize": 3
  }
}

# 3. Opus 4.6 선택
claude --model opus-4-6

# 새 프로젝트 디렉토리
mkdir todo-app
cd todo-app

# Claude Code 실행
claude

> 간단한 TODO 앱을 만들어 줘.
> 기능: 추가, 삭제, 완료 표시
> 기술: React + TypeScript + Vite

> 전체 코드베이스를 분석해서 리팩토링 제안해 줘.
> 이 프로젝트의 구조와 개선점을 정리해 줘.

# Team Lead에게 작업 요청
> 이 REST API를 구현해야 해.
> /users, /posts, /comments 엔드포인트 필요해.
> Agent Teams로 병렬로 처리해 줘.

# Team Lead가 자동으로 작업 분배
# Teammate 1: /users
# Teammate 2: /posts
# Teammate 3: /comments

# 1. 전체 요구사항 설명
> 블로그 백엔드 API를 개발해야 해.
> - 사용자 인증 (JWT)
> - 게시글 CRUD
> - 댓글 시스템
> - 태그 및 검색
> - 기술 스택: Node.js + Express + PostgreSQL + Prisma

# 2. Opus 4.6으로 전체 아키텍처 설계
> 전체 프로젝트 구조를 설계해 줘.
> DB 스키마, API 라우트, 미들웨어 전부 포함해서.

# 3. Agent Teams로 병렬 개발
> Agent Teams로 각 기능을 병렬로 개발해 줘.

# 좋은 시작
> 간단한 계산기 앱을 만들어 줘.

# 너무 복잡한 시작 (비추천)
> 마이크로서비스 아키텍처의 대규모 이커머스 플랫폼을 만들어 줘.

# 나쁜 질문
> 코드 짜줘.

# 좋은 질문
> React와 TypeScript로 TODO 앱을 만들고 싶어.
> 기능은 추가, 삭제, 완료 표시가 필요해.
> Vite로 시작하고, 컴포넌트 구조도 잡아 줘.

> 이 코드가 어떻게 작동하는지 설명해 줘.
> 왜 이렇게 구현했어?
> 다른 방법은 없어?

> 이 기능에 대한 테스트 코드도 작성해 줘.
> 단위 테스트와 통합 테스트 모두 부탁해.

# 1. 요구사항 정리
> [프로젝트 설명]

# 2. 기술 스택 결정
> 이 요구사항에 맞는 기술 스택 추천해 줘.
> 장단점도 비교해 줘.

# 3. 프로젝트 구조 설계
> 프로젝트 구조를 잡아 줘.
> 폴더 구조와 파일 구성까지.

# 4. 초기 코드 생성
> 기본 코드를 생성해 줘.
> 설정 파일, 기본 컴포넌트 등.

# 5. Agent Teams로 개발
> 이제 Agent Teams로 각 기능을 개발해 줘.

# 1. 전체 코드베이스 분석
> 이 프로젝트의 구조를 분석해 줘.
> 핵심 파일과 의존성을 정리해 줘.

# 2. 기능 추가 위치 파악
> 이 새 기능은 어디에 추가하면 돼?
> 기존 코드와 어떻게 통합하면 돼?

# 3. 구현
> 이 기능을 구현해 줘.
> 기존 스타일을 따라서.

# 4. 테스트
> 이 기능에 대한 테스트도 추가해 줘.

# 1. 버그 재현
> 이 버그가 왜 생기는지 분석해 줘.
> [에러 로그]

# 2. 원인 파악
> 근본 원인이 뭐야?
> 어디를 고치면 돼?

# 3. 수정 방법 제안
> 수정 방안을 여러 개 제시해 줘.
> 각각의 장단점도 비교해 줘.

# 4. 수정 및 테스트
> 이 방법으로 수정해 줘.
> 회귀 테스트도 추가해 줘.

# Week 1: 간단한 코드 생성
> 이 함수를 작성해 줘.

# Week 2: 파일 단위 작업
> 이 파일을 리팩토링해 줘.

# Week 3: 기능 단위 작업
> 이 기능을 구현해 줘.

# Week 4: Agent Teams 활용
> Agent Teams로 이 프로젝트를 개발해 줘.

# 항상 이런 질문을 하세요
> 이 코드에 보안 문제는 없어?
> 성능 최적화는 어떻게 하면 돼?
> 테스트는 충분해?

> 왜 이렇게 구현했어?
> 이 패턴의 이름은 뭐야?
> 더 나은 방법은 없어?
> 이걸 설명하는 문서 추천해 줘.

# 나쁜 예
모든 걸 AI한테 맡기고 이해하지 않음

# 좋은 예
AI가 코드를 짜도 내가 이해하고 검증함

# 나쁜 예
AI 코드를 그대로 배포

# 좋은 예
테스트, 리뷰, 검증 후 배포

# 나쁜 예
> 버그 고쳐줘.

# 좋은 예
> 사용자가 로그인할 때 500 에러가 떠.
> 에러 로그는 이렇고, 관련 코드는 이 파일이야.