🚨 단 하나의 프롬프트로 AI에게 전체 프로젝트를 구축해달라고 요청하는 것을 멈추세요.

이렇게 하지 마세요:

"SaaS 웹사이트를 만들어줘."

그렇게 하면 스파게티 코드 (Spaghetti code), 환각 (Hallucinations), 그리고 끝없는 재작성(Rewrites)을 겪게 됩니다.

일관되게 더 나은 결과를 만들어내는 워크플로우 (Workflow)는 다음과 같습니다:

1단계 — 먼저 브레인스토밍 (Brainstorm) 하기

코드 한 줄을 쓰기 전에 Context7 MCP를 사용하세요.

다음 항목들을 생성합니다:

→ PRD.md (제품 요구 사항 문서)
→ Design.md (디자인 문서)

대부분의 사람들은 Design.md를 오해합니다.

이것은 단순히 다음을 의미하는 것이 아닙니다:

→ 색상 (Colors)
→ 타이포그래피 (Typography)
→ 레이아웃 (Layout)

이를 구현 청사진 (Implementation blueprint)으로 취급하세요.

다음과 같은 항목들을 포함해야 합니다:

→ UX 흐름 (UX flows)
→ 컴포넌트 동작 (Component behavior)
→ 상태 관리 전략 (State management strategy)
→ 엣지 케이스 (Edge cases)
→ 사용자 여정 (User journeys)
→ 접근성 요구 사항 (Accessibility requirements)
→ 반응형 동작 (Responsive behavior)
→ 상호작용 패턴 (Interaction patterns)
→ 에러 핸들링 (Error handling)
→ 디자인 제약 사항 (Design constraints)

Design.md에 더 많은 컨텍스트 (Context)가 포함될수록...

AI가 환각 (Hallucinate)을 일으킬 여지는 줄어듭니다.

---

2단계 — 구축 계획 세우기

코드를 생성하기 전에...

AI에게 프로젝트를 개발 단계 (Development phases)로 나누어 달라고 요청하세요.

예시:

1단계 → 프로젝트 설정 (Project setup)
2단계 → 데이터베이스 및 인증 (Database & Auth)
3단계 → API
4단계 → 비즈니스 로직 (Business logic)
5단계 → 프론트엔드 (Frontend)
6단계 → 테스트 (Testing)
7단계 → 배포 (Deployment)

---

3단계 — 소프트웨어 엔지니어링 원칙 적용하기

AI에게 적절한 개발 원칙을 따르도록 지시하세요.

그 결과는 보통 다음과 같습니다:

✅ 클린 아키텍처 (Clean Architecture)
✅ 클린 코드 (Clean Code)
✅ 최소한의 데드 코드 (Minimal dead code)
✅ 불필요한 추상화 없음 (No redundant abstractions)
✅ 더 나은 유지보수성 (Better maintainability)
✅ 더 나은 성능 (Better performance)

---

4단계 — 절대 한꺼번에 모든 것을 구축하지 마세요

프로젝트에 다음이 포함되어 있다면:

프론트엔드 (Frontend) + 백엔드 (Backend)

AI에게 두 가지를 동시에 생성해달라고 요청하지 마세요.

하나를 만드세요.
테스트하세요.
문서화하세요.
그다음에야 다음 레이어 (Layer)로 넘어가세요.

개인적으로 저는 항상 다음과 같이 합니다:

백엔드 (Backend)
↓
테스트 (Testing)
↓
문서화 (Documentation)
↓
프론트엔드 (Frontend)
↓
통합 (Integration)

AI의 실수를 수정하는 데 쓰는 시간은 줄어들고...

...제품을 출시(Shipping)하는 데 더 많은 시간을 쓰게 될 것입니다. 🚀