에이전틱 엔지니어링 패턴

2 hours ago 1

Claude Code, OpenAI Codex와 같은 코딩 에이전트를 활용해 최적의 결과를 얻기 위한 패턴 모음집
코드 작성의 효율성을 높이는 원칙(Principles), 테스트 및 품질 보증(Testing and QA), 코드 이해(Understanding code), 주석형 프롬프트(Annotated prompts) 등으로 구성
‘코드 작성은 이제 저렴하다’, ‘할 수 있는 일을 축적하라’, ‘피해야 할 안티패턴’ 등 실무 중심의 지침을 포함
테스트 주도 개발(TDD)과 테스트 실행 우선 접근법을 강조하며, 코드 이해를 돕는 선형적 검토와 대화형 설명 기법을 제시
개발자가 에이전트 기반 코딩 환경을 체계적으로 설계하고 품질을 유지하기 위한 실질적 참고 자료로 구성

개요

이 문서는 에이전트 기반 코딩(Agentic Engineering) 을 위한 실무 패턴을 정리한 가이드
- Claude Code, OpenAI Codex 등 코딩 에이전트를 활용할 때의 모범 사례를 제시
- 관련 서문은 별도의 소개 글로 연결됨

1. 원칙 (Principles)

코드 작성은 저렴하다(Writing code is cheap now)
- 코드 생성 비용이 낮아진 환경에서 효율적 활용 방안을 다룸
할 수 있는 일을 축적하라(Hoard things you know how to do)
- 반복 가능한 작업과 지식을 체계적으로 저장하는 접근
안티패턴(Anti-patterns: things to avoid)
- 피해야 할 비효율적 접근법을 명시

2. 테스트와 품질 보증 (Testing and QA)

레드/그린 TDD(Red/green TDD)
- 테스트 주도 개발의 기본 절차를 적용하는 패턴
먼저 테스트를 실행하라(First run the tests)
- 코드 작성 전 테스트 실행을 통해 품질 확보

3. 코드 이해 (Understanding code)

선형적 검토(Linear walkthroughs)
- 코드 흐름을 순차적으로 따라가며 이해하는 방식
대화형 설명(Interactive explanations)
- 에이전트를 활용해 코드 동작을 상호작용적으로 해석

4. 주석형 프롬프트 (Annotated prompts)

WebAssembly와 Gifsicle을 이용한 GIF 최적화 도구 예시 포함
- 실제 구현 사례를 통해 프롬프트 설계 방식을 보여줌

5. 부록 (Appendix)

사용 중인 프롬프트 모음(Prompts I use)
- 저자가 활용하는 프롬프트 예시를 정리

기타

사이트 내 연도별 아카이브 및 공개 정보 링크 제공
후원사로 Augment Code가 명시되어 있으며, “Agent Orchestration”과 “Living Specs”를 강조

Read Entire Article