인트로
에이전틱 엔지니어링편 개요
에이전틱 엔지니어링편의 목표
- 에이전트가 다루기 좋은 코드베이스, 오래 가는 서비스를 위한 코드베이스가 어떤 모습인지 알아봅니다.
- 코드가 운영 환경으로 넘어가기 전에 GitHub Actions로 자동 검증합니다.
- CLAUDE.md, Rules, Hooks로 에이전트가 매번 같은 기준으로 움직이게 만듭니다.
- 티켓 하나가 브랜치, 구현, 검증, PR까지 자동으로 이어지는 흐름을 처음부터 끝까지 경험해 봅니다.
에이전틱 엔지니어링편 진행 흐름
| 챕터 | 하는 일 | 주요 키워드 |
|---|---|---|
| 코드베이스 리팩토링하기 | 지속가능하게 제품을 개발하기 위한 좋은 코드를 이해하고 적용합니다. | 리팩토링, 코드 구조, 코드 리뷰 |
| GitHub Actions를 활용한 검증환경 개선하기 | PR마다 같은 검증이 자동으로 돌게 만듭니다. | GitHub Actions, CI, 코드 리뷰/보안 점검 |
| 하네스 엔지니어링 | 프로젝트 규칙과 반복 작업 방식을 에이전트가 계속 참고하게 만듭니다. | CLAUDE.md, Rules, Hooks, Skills |
| 태스크 자동화하기 | 티켓 하나를 브랜치, 구현, 검증, PR까지 태워봅니다. | 이슈 자동화, Worktree, PR |
리팩토링이 맨 앞에 오는 데는 이유가 있습니다. 코드가 지저분한 채로 하네스나 CI부터 얹으면, 에이전트는 여전히 같은 자리에서 헤맵니다. 구조부터 정리해야 그 위에 놓는 규칙과 자동화가 실제로 힘을 받습니다.
실전편과 뭐가 다른가요
실전편에서 이미 Agentic Workflow, 그러니까 계획하고 구현하고 검증하고 개선하는 루프를 다뤄봤습니다. "그거 또 하는 거 아닌가" 싶을 수 있는데, 이 파트가 보는 지점은 다릅니다.
- 실전편은 그 루프를 사람이 직접 운전하는 법을 익히는 자리였습니다.
- 이 파트는 그 루프가 내가 매번 붙어있지 않아도 같은 기준으로 돌아가게 만드는 자리입니다.
같은 루프를 한 번 더 배우는 게 아니라, 그 루프가 코드베이스와 하네스, CI, 티켓 처리 방식 안에 자리 잡아 저절로 반복되도록 정비하는 쪽에 가깝습니다.
마무리
다음 챕터는 코드베이스 리팩토링하기입니다. 에이전트가 더 큰 작업을 맡아도 어디를 고쳤고 무엇이 깨졌는지 바로 확인할 수 있는 구조부터 만들어야, 그 위에 얹을 하네스와 자동화가 비로소 의미를 가집니다.