홈
3주차클로드 워크플로 전략주말요일

AI에 최적화된 워크플로

AI가 잘 작동하려면 좋은 프롬프트가 필요하다는 것은 이제 상식입니다. 그런데 AI가 잘 작동하려면 단순히 좋은 프롬프트 이상이 필요합니다. AI에 최적화된 개발 환경과 워크플로 자체를 설계해야 합니다.

컨텍스트 엔지니어링

"프롬프트 엔지니어링"이라는 말은 이미 낡았습니다. 핵심은 AI에게 좋은 컨텍스트 환경을 만들어주는 것입니다. 좋은 컨텍스트 = 좋은 결과.

컨텍스트의 4가지 레이어

  • CLAUDE.md: 항상 적용되는 프로젝트 규칙과 배경 지식
  • 대화 히스토리: 현재 세션에서 쌓인 맥락
  • @파일 참조: 특정 작업에 필요한 코드나 문서
  • MCP 데이터: 실시간으로 가져오는 외부 데이터 (DB, API, 이슈)

각 레이어를 의도적으로 관리하면 AI의 출력 품질이 크게 높아집니다.

코드베이스를 AI 친화적으로 만들기

작은 함수, 명확한 이름

AI는 함수가 하나의 명확한 역할만 할 때 더 잘 이해하고 수정합니다. 500줄짜리 함수 하나보다 30줄짜리 함수 20개가 AI와 협업하기 훨씬 쉽습니다. 이는 인간 개발자에게도 좋은 코드이기도 합니다.

타입 정보의 중요성

TypeScript, Python 타입 힌트 같은 타입 정보는 AI가 코드를 이해하는 데 결정적인 역할을 합니다. "이 변수가 뭔지" 추론하지 않아도 되기 때문에 더 정확한 제안을 합니다. AI와 협업을 많이 할수록 타입을 엄격하게 쓰는 게 투자입니다.

테스트가 있는 코드베이스

테스트 코드는 AI에게 "이 코드가 어떻게 동작해야 하는지"를 알려주는 가장 정확한 명세입니다. 잘 작성된 테스트 스위트가 있으면 AI가 리팩토링 후 올바르게 동작하는지 스스로 검증할 수 있습니다.

AI 친화적 워크플로 설계

작업 단위를 작게 만들기

"전체 인증 시스템을 새로 만들어줘"보다 "JWT 토큰 생성 함수를 만들어줘", "토큰 검증 미들웨어를 만들어줘", "로그인 API 엔드포인트를 만들어줘"처럼 작은 단위로 나눠서 요청하면:

  • 각 단계에서 결과를 검토하고 방향을 조정할 수 있습니다
  • 잘못됐을 때 되돌리기 쉽습니다
  • 컨텍스트 윈도우를 효율적으로 사용합니다

git을 촘촘하게 사용하기

AI와 작업할 때는 평소보다 더 자주 커밋하는 것이 좋습니다. AI가 한 번에 많은 파일을 수정할 수 있기 때문에, 롤백 포인트를 자주 만들어두면 안전합니다.

# 작업 시작 전
git stash   # 혹은 새 브랜치 생성

# 한 단계 완료될 때마다
git add -p  # 변경 사항을 하나씩 검토하며 스테이징
git commit -m "feat: ..."

검토 문화 만들기

AI가 생성한 코드를 맹목적으로 신뢰하면 안 됩니다. AI는 그럴듯하지만 잘못된 코드를 자신있게 작성할 수 있습니다(할루시네이션). 특히:

  • 보안 관련 코드 (인증, 암호화, 권한 관리)
  • 데이터 마이그레이션 스크립트
  • 비즈니스 핵심 로직

이런 부분은 AI가 제안해도 반드시 직접 검토하세요.

팀 전체의 AI 워크플로

CLAUDE.md를 팀 계약서처럼

팀 전체가 동일한 프롬프트 패턴과 코딩 규칙을 사용하면 AI가 생성한 코드의 일관성이 높아집니다. CLAUDE.md는 "AI 온보딩 문서"이자 팀 코딩 계약서입니다:

# .claude/CLAUDE.md — 팀 공유
## 코딩 컨벤션
- 에러 처리는 항상 명시적으로
- 비즈니스 로직에는 주석 필수
- 새 기능은 반드시 테스트 포함

## AI 작업 규칙
- DB 스키마 변경은 반드시 마이그레이션 파일 생성
- 프로덕션 DB 직접 접근 금지
- 보안 관련 코드 변경 시 팀장 리뷰 요청

커스텀 명령어 팀 공유

.claude/commands/ 폴더를 git에 커밋해서 팀 전체가 동일한 워크플로를 사용하세요:

git add .claude/commands/ .claude/CLAUDE.md
git commit -m "feat: 팀 공유 AI 워크플로 설정 추가"

효과적인 패턴 공유

팀원이 발견한 효과적인 프롬프트나 워크플로는 팀 위키나 CLAUDE.md에 기록해서 공유하세요. "이 패턴으로 요청하면 훨씬 잘 됩니다"라는 발견이 쌓이면 팀 전체의 AI 활용 역량이 빠르게 성장합니다.

AI 협업의 현실적 한계

AI가 맥락을 잃을 때

대화가 길어지면 AI는 초반에 정한 규칙이나 결정을 "잊어버리는" 것처럼 보입니다. 이는 컨텍스트 압축 때문입니다. 중요한 결정은 반드시 CLAUDE.md나 파일에 기록하세요:

> 우리가 지금까지 결정한 것들을 CLAUDE.md에 추가해줘.
  다음 세션에서도 이 결정들이 유지되어야 해.

AI가 틀렸을 때 바로잡기

> 아니야, 그 방향이 아니야. 우리 프로젝트는 [제약사항]이 있어.
  다시 처음부터 생각해줘.

AI의 잘못된 방향은 빠르게 교정하세요. 잘못된 방향으로 계속 진행하면 나중에 되돌리기 어렵습니다. Ctrl+C로 즉시 중단하는 것을 두려워하지 마세요.

4주차 예고

마지막 주에는 클로드 코드 자체를 더 강력하게 커스터마이징하는 방법을 배웁니다. 나만의 슬래시 명령어 만들기, Hooks로 자동화하기, 그리고 여러 AI가 협력하는 멀티에이전트 시스템까지 다룹니다.

내 메모
📝내 메모