AI 코딩 망치는 5가지 힘, 처방전 나왔다

AI 에이전트와 함께하는 개발 프로젝트가 왜 무너지는지를 다섯 가지 힘으로 정리하고, 각각에 대응 규율을 붙인 프레임워크 '파워 코딩(Power Coding)'이 공개됐다. 개발자 아난드 파리크(Anand Pareek)가 만든 오픈소스로, 항공우주 산업과 도요타 생산방식, 평가 중심 머신러닝 관행에서 빌려온 규율을 LLM 에이전트용으로 번역했다는 점이 눈에 띈다.

무슨 일인가

제작자가 꼽는 다섯 가지 파괴력은 이렇다. 첫째 모호함 — 에이전트가 자신만만하게 엉뚱한 것을 만든다. 둘째 기억상실 — 세션마다 맥락이 초기화된다. 셋째 표류 — 증거 없이 '완료'가 선언된다. 넷째 불투명 — 무엇이 만들어졌고 시간이 어디에 쓰였는지 보이지 않는다. 다섯째 엔트로피 — 조용한 실패가 쌓이다 프로덕션에서 터진다. AI 코딩을 몇 주만 해본 사람이라면 다섯 개 모두 낯익을 것이다.

핵심 짚어보기

대응책은 전부 에이전트가 매 세션 다시 읽는 평범한 마크다운 파일로 설치된다. 데몬도 훅도 없고 특정 도구에 묶이지 않아 클로드 코드(Claude Code)·코덱스(Codex)·제미나이(Gemini) CLI 어디서든 쓸 수 있다. 모호함에는 한 장짜리 요구사항 문서(PRD.md)와 코드 작성 전 아키텍처 승인, 조용히 뒤집히지 않는 결정 로그로 맞선다. 기억상실에는 세션을 잇는 인수인계 파일과 버그마다 '왜'를 다섯 번 물어 근본원인을 남기는 학습 기록, 그리고 위험한 변경 전마다 만드는 git 체크포인트를 처방한다. 표류에는 변경 때마다 실제로 실행되는 평가 루프를 두고, 3회 연속 통과한 평가만 정식 자동 테스트로 승격시킨다. 유료 API를 쓰는 평가 세트는 사용자 승인 없이는 돌지 않게 했다. 불투명에는 상자 하나가 한 단계인 머메이드(Mermaid) 흐름도와 작업 시간이 기능·지원·재작업 중 어디에 쓰였는지 보여주는 리포트를, 엔트로피에는 변경분을 요구사항과 대조해 위험도를 매기는 스캔을 붙였다.

1인기업 실전 적용 포인트

• 가장 싸게 시작하는 방법은 요구사항 문서 한 장이다. 만들 것·안 만들 것·성공 기준을 한 페이지로 적고 에이전트가 매번 읽게 하면, '자신만만한 오답'에 쓰는 비용이 눈에 띄게 줄어든다.
• 세션 인수인계 문서는 오늘부터 쓸 수 있다. 작업을 끝내기 전 에이전트에게 현재 상태·결정·다음 할 일을 파일로 남기게 하고, 새 세션은 그 파일을 읽고 시작하게 하면 맥락 복원에 쓰던 시간이 사라진다.
• 버그를 고칠 때마다 근본원인 기록을 한 줄씩 남기게 하자. 같은 실수를 반복하는 에이전트 특유의 패턴이 끊긴다.
• '작동하는 상태마다 git 커밋'을 규칙으로 만들면, 디버깅 수렁에 빠지는 대신 롤백이라는 탈출구가 항상 열려 있다.

전망 / 주의점

이런 프레임워크의 약점은 도입이 아니라 유지다. 마크다운 규율은 강제력이 없어 바쁘면 건너뛰게 되고, 문서가 늘수록 에이전트의 컨텍스트도 잡아먹는다. 전부 도입하기보다 지금 가장 아픈 힘 하나를 골라 해당 처방만 이식하는 편이 현실적이다. 그래도 흩어져 있던 AI 코딩 모범사례를 '다섯 힘'이라는 한 장의 지도로 묶어준 것만으로 참고 가치는 충분하다.

출처: GitHub (https://github.com/APareek89/power-coding)