새로운 프로젝트 시작 시 모든 AI 에이전트에게 부여하는 7가지 규칙 (비전공자들의 실제 앱 출시를 도우며 배운 점)
7 rules I give every AI agent at the start of a new project (learned from helping non-coders ship real apps)
핵심 요약
비전공자가 AI로 앱을 개발할 때 실패를 방지하기 위해 프로젝트 시작 단계에서 설정해야 할 7가지 필수 규칙을 공유함.
- 프로젝트 가이드라인 — 비전공자가 AI 에이전트와 협업할 때 발생할 수 있는 실패 모드를 방지하기 위한 7가지 핵심 규칙을 제시함.
- 검증 및 제약 — 코드 수정 전 계획 공유, 수정 범위 제한, 실패 시 대응 방안 등을 통해 AI의 무분별한 수정을 방지함.
- 유지보수 전략 — README 업데이트 및 기술 스택 고정을 통해 프로젝트가 장기적으로 안정성을 유지하도록 함.
- 실제 사례 기반 — 비전공자들의 앱 출시를 도우며 얻은 경험을 바탕으로 실질적인 실패 방지책을 제안함.
저는 지난 1년 동안 비전공자들이 AI로 개발하는 것을 도와왔습니다. 제가 반복해서 보는 패턴이 있는데, 프로젝트가 실패하는 이유는 AI 때문이 아닙니다. 사용자가 첫날에 AI에게 뭐라고 말했느냐 때문에 실패하는 것이죠.
제가 모든 프로젝트의 상단에 상시 지침으로 넣어두는 7가지 규칙은 다음과 같습니다:
-
"저는 비전공자입니다. 코드를 읽고 당신의 작업을 검증할 수 없습니다. 어떤 변경이든 완료한 후에는 브라우저에서 실행해 볼 수 있는 3단계 수동 테스트를 제공하세요."
-
"이 앱의 유일한 목적은 [X]입니다. 만약 제안된 변경 사항이 X를 더 느리게, 덜 안정적으로, 혹은 더 혼란스럽게 만든다면, 제가 요청했더라도 멈추고 이를 알리세요."
-
"파일을 수정하기 전에 수정할 모든 파일의 목록을 나열하세요. 목록이 5개를 넘으면 멈추고 작업을 분할할 것을 제안하세요."
-
"연속으로 3번의 수정 시도가 실패하면 멈추세요. (a) 되돌리기, (b) 우리가 아는 것과 모르는 것, (c) 다른 접근 방식 중 하나를 제안하세요."
-
"이 프로젝트는 [스택 목록]만 사용합니다. 저에게 먼저 묻지 않고 새로운 라이브러리, 프레임워크, 서비스를 도입하지 마세요."
-
"중요한 변경 사항에 대해 코드를 작성하기 전에, 당신이 이해한 목표와 계획된 접근 방식을 평이한 언어로 설명하세요. 제가 '진행해'라고 할 때까지 기다리세요."
-
"각 기능 구현 후에는 README.md를 업데이트하세요. 3개월 뒤에 모든 것을 잊어버린 사람이 읽을 것을 가정하고 작성하세요."
규칙 3, 4, 5번은 앱이 사용자 10명을 확보한 뒤 붕괴해버리는 특정 실패 모드를 방지해 줍니다.
여기 계신 분들이 어떤 규칙을 추가하거나 반대할지 궁금하네요. 제가 놓치고 있는 게 뭘까요?
