🔥 AI코딩 10원칙

Agent/💻 코딩에이전트/images/ai코딩-10원칙-diagram.svg

🎣 “AI 시대 진짜 실력은 코드를 잘 짜는 게 아니라, 코드를 짜지 않고도 문제를 해결하는 판을 설계하는 것이다.”

---

🧑‍💻 Peter Steinberger는 누구?

• OpenClaw (구 Clawdbot/Moltbot) 창시자
• 13년간 70명 규모 회사 운영 후 매각
• 4년 휴식 후 2023년 4월 복귀
• GitHub 역대 최고 속도 스타 달성

그의 시작은 단순했다:

“AI를 가지고 놀아보자. 외출 중에도 WhatsApp으로 집 컴퓨터와 대화하고 싶었다.”

---

⚡ 결정적 “아하 모멘트”

여행 중 에이전트에게 음성 메시지를 보냈다. 음성 지원 기능을 코딩한 적이 없는데…

에이전트가 스스로:

1. Opus 파일 형식을 파악
2. ffmpeg를 찾아 변환
3. API 키를 찾아 번역
4. 답을 보냄

이 순간 그는 에이전트가 **“영리하고 수완 좋은 야수”**임을 깨달았다.

---

📋 AI 코딩 10가지 원칙

1️⃣ 완벽주의를 버려야 AI와 일할 수 있다

• 70명 팀을 이끌며 “내 스타일대로 안 나와도 받아들이는 법” 학습
• 코드가 내 취향과 100% 일치하지 않아도 동작하면 OK
• 이 훈련이 에이전트 협업에서 가장 큰 자산

💡 Lesson: 완벽한 코드보다 작동하는 코드. 스타일 강박을 버려라.

---

2️⃣ 에이전트가 스스로 검증할 수 있게 설계하라

Peter는 이걸 **“루프를 닫는다(Close the loop)“**라고 표현.

• 컴파일 → 린트 → 실행 → 검증까지 에이전트가 직접 수행
• 사람이 중간에 확인하는 구조 = 병목

💡 Lesson: 피드백 루프를 자동화하라. Ralph Pattern이 바로 이것.

---

3️⃣ Pull Request는 죽었다. Prompt Request 시대

• 코드 자체보다 그 코드를 만든 프롬프트가 더 중요
• 외부 PR은 거의 거절, 핵심 아이디어만 추출해서 프롬프트로 재활용

💡 Lesson: 코드를 공유하지 말고, 프롬프트를 공유하라.

---

4️⃣ 코드 리뷰 대신 아키텍처 토론만 하라

• Discord에서도 핵심 팀원과 코드 이야기는 안 함
• 대신 시스템 구조, 큰 결정, 방향성만 논의
• 구현 디테일 = 에이전트 몫

💡 Lesson: 개발자는 설계자가 되어야 한다. 코드 한 줄보다 아키텍처 한 장.

---

5️⃣ 5~10개 에이전트를 동시에 돌려라

• 하나의 작업에 오래 매달리지 않음
• 계획 → 에이전트에게 맡김 → 바로 다음 에이전트로 이동
• 이렇게 해야 “몰입 상태(Flow state)” 유지 가능

💡 Lesson: 멀티태스킹이 아니라 멀티-에이전트. 병렬 처리가 핵심.

---

6️⃣ 계획 단계에 놀라울 정도로 긴 시간을 써라

• 에이전트와 충분히 핑퐁하며 계획을 다듬음
• 도전하고, 수정하고, 반박하고, 만족스러울 때까지 반복

Codex 선호 이유: Claude Code는 실행 중 확인 질문을 해서 흐름이 끊김

• 계획이 탄탄하면 실행 단계에서 개입할 필요 없음

💡 Lesson: 급하게 코딩 시작하지 마라. 80%는 계획, 20%는 실행.

---

7️⃣ 일부러 모호하게 지시하라

• 너무 구체적으로 지시하면 AI가 그 범위 안에서만 움직임
• 의도적으로 여지를 남겨서 예상 못한 방향을 발견

💡 Lesson: AI에게 자유를 줘라. 가끔 놀라운 해결책이 나온다.

---

8️⃣ 원격 CI 10분 기다리지 말고 로컬에서 바로 테스트하라

• 원격 CI 파이프라인 대기 시간 10분이 아깝다
• 에이전트가 로컬에서 직접 테스트하도록 설계
• 피드백 루프를 최대한 짧게

💡 Lesson: 빠른 피드백 = 빠른 개선. 로컬 테스트를 자동화하라.

---

9️⃣ 대부분의 코드는 지루한 데이터 변환일 뿐

• 앱 코드 대부분 = “데이터를 이 형태에서 저 형태로 바꾸는 것”
• 이런 작업에 집착할 필요 없이 에이전트에게 위임
• 에너지는 시스템 설계에 집중

💡 Lesson: CRUD 코드에 시간 쓰지 마라. AI가 더 잘한다.

---

🔟 제품 출시를 좋아하는 사람이 AI 적응에 유리하다

• 알고리즘 퍼즐 푸는 걸 좋아하는 개발자가 오히려 AI 전환에 힘들어함
• 구현 디테일보다 결과물과 출시에 관심 있는 사람이 빨리 적응

💡 Lesson: 코드 덕후보다 제품 덕후가 유리. 결과물에 집중하라.

---

🔮 Peter의 미래 전망

“수많은 앱이 사라지고 API만 남을 것이다”

예시:

• MyFitnessPal 열어서 입력할 필요 없음
• 에이전트에게 음식 사진만 보내면
• 알아서 칼로리 계산하고 건강 목표 수정

앱의 미래 = API + 에이전트

---

📝 핵심 요약

10가지 원칙이 말하는 한 가지:

완벽주의를 버리고
코드 리뷰 대신 아키텍처를 논하고
에이전트가 스스로 검증하게 만들고
여러 에이전트를 동시에 돌리는 것

= "개발자가 직접 코드를 짜지 않아도 되는 환경을 만든다"

---

🎯 액션 아이템

원칙	바로 적용할 수 있는 것
#1 완벽주의 버리기	AI가 짠 코드 “일단” 받아들이기
#2 루프 닫기	빌드/테스트 자동화 설정
#3 Prompt Request	좋은 프롬프트 저장/공유하기
#5 병렬 에이전트	터미널 여러 개 열고 동시 작업
#6 계획에 시간 쓰기	PROMPT.md 작성 습관화
#8 로컬 테스트	CI 대기 대신 로컬 스크립트

---

🔗 참고 자료

• Peter Steinberger 인터뷰 (YouTube)
• 추가 인터뷰 영상
• 원본 LinkedIn 포스트 by Jeongmin Lee

---

📚 관련 문서

• Ralph Wiggum Pattern - 원칙 #2 “루프 닫기”의 실제 구현
• Agent Skills - 에이전트 역량 확장
• 2025-2026 AI 코딩 에이전트 트렌드