Agentic Workflow에 대해서 알아보기

Brendan O'Neill 블로그 에서는 7명의 개발팀을 이끄는 저자가 agentic 코딩을 사용하며 정한 내부 룰을 소개하고 있다. 내용을 번역해서 정리하려고 한다.

• AI Slop을 피하기 위한 내부 룰. 과하게 복잡하고, 퀄리티가 낮고, 리뷰하기 힘든 코드가 생성되는 것.

1. Think Before You Generate

작업을 시작하기 전, 10~15분 동안 충분히 생각을 할 것.

프롬프트가 가장 간단한 단위의 작업을 수행하도록 할 것:

• 이 프롬프트가 어떤 커밋을 생성하게 될 것인가?
• 여러 단계로 나뉜 작업을 진행할 때 어떤 순서대로 진행할 것인가?
• 어떤 파일을 생성하게 할 것인가?
• 프롬프트에 어떤 레퍼런스 파일이나 코드를 첨부할 것인가?

그리고 워크스페이스에 밑준비를 한다:

• 새 파일을 생성하려 한다면 빈 파일을 직접 생성한다.
• 레퍼런스 파일이나 스니펫을 따로 정리해 놓는다.

명확한 셋업과 설계가 중요하다.

2. 일찍 그리고 자주 커밋할 것(가장 중요!)

ai가 잘못된 결과를 내놓았을 경우, git reset --hard로 곧바로 롤백해야 함. 만약 하기 망설여진 다면, 하나 이상의 작업을 커밋한 것임.

최대한 자주 커밋을 진행해 ai가 생성한 코드를 곧바로 되돌릴 수 있도록 할 것.,

리뷰 시에도 마찬가지.

• 작업자가 최소한의 단위를 프롬프팅하였는지?
• 하나의 커밋이 하나의 명확한 목적을 가지는지?
• 프롬프트에 의도에 맞게 생성되었는지?
• 하나 이상의 프롬프팅이 커밋에 반영되었는지?

3. 한 번에 한 파일만 작성할 것

4. 오버프롬프팅을 피할 것.

한 번에 두 가지 작업을 시키지 말 것.

이런 패턴이 발견될 경우:

1. 프롬프트 작성
2. 코드 리뷰
3. 리젝트
4. 표현을 바꿔서 다시 프롬프팅.

이 경우 ai가 실패했다면, 다시 프롬프트하지 말고 수동으로 처리해야 함. 이전 코드가 도움이 되지 않는다면 git reset --hard 한 뒤 원하는 작업을 수동으로 처리할 것.

5. 자기자신을 믿을 것

ai가 준 코드가 마음에 들지 않는다면, 직접 쓸 것.

ai의 코드가 이해되지 않는다면, 커밋하지 말 것.

6. Work in Private Mode

AI를 사용할 때 로컬에서 작업할 것.

7. Stay In-Sync With the Team (Model and Settings Consistency)

모든 팀원이 하나의 통일된 모델을 사용할 것.

AI 툴을 사용하는 경우 공통화된 룰을 공유할 것.

이 규칙들은 '팀 단위에서 어떻게 Shared한 코드 베이스를 최대한 문제 없이 처리하는지?'에 대한 나름의 해결책이 될 거라고 생각한다.