728x90 DESIGN.md2 AI 코딩 에이전트가 자꾸 엇나갈 때: 코딩 전 남길 3가지 문서 “알림 설정 하나 추가해 줘.” AI 코딩 에이전트는 곧바로 토글과 저장 버튼을 만들었다. 화면도 멀쩡했고 저장도 됐다. 그런데 일반 사용자에게는 보이면 안 되는 관리자 기능이었고, 저장 실패 때 값이 원래대로 돌아오지 않았으며, 모바일에서는 오류 문구가 버튼을 밀어냈다. 에이전트가 코드를 못 만든 것은 아니었다. 누가 쓰는지, 어디까지 만들지, 무엇을 확인해야 끝나는지가 코딩 전에 정해지지 않았던 게 문제였다. 프롬프트를 더 길게 쓰기보다 세 가지 결정을 짧은 문서로 나누자 재작업의 이유가 보이기 시작했다. 요구사항·작업계획·디자인 규칙을 먼저 맞추면 코딩 에이전트가 추측해야 할 빈칸이 줄어든다. 잘못된 코드는 대부분 코드 밖에서 시작됐다 사람끼리는 “우리 서비스답게”라는 말만.. 2026. 8. 7. AI 시대 개발팀 운영법: DESIGN.md·테스트·알림을 하나의 검증 흐름으로 AI가 코드를 빨리 만드는 팀일수록 “작성 속도”보다 “틀린 변경을 빨리 막는 구조”가 중요하다. 브랜드와 맞지 않는 UI, 테스트 없이 통과한 코드, 원인만 나열하는 알림은 모두 같은 문제에서 나온다. 에이전트에게 필요한 맥락과 완료 조건, 운영 신호가 한 흐름으로 연결되지 않은 것이다. 실전 상황 에이전트가 로그인 화면을 만들었다. 기능은 작동하지만 버튼 색과 간격이 제품과 다르고, 모바일 테스트가 빠졌으며, 배포 뒤 로그인 오류 알림에는 담당자와 확인 링크가 없다. 코드를 다시 생성하는 것보다 먼저 검증 흐름을 고쳐야 한다. 목차 AI 시대에 개발 하네스가 더 중요해진 이유 DESIGN.md에 무엇을 넣을 것인가 테스트와 미리보기를 완.. 2026. 7. 29. 이전 1 다음 728x90
