ID: key_26_05_01_31_17_47_21_90600 Created date: Jan 31 2026 Saturday, 5th 17:47
연관 문서
핵심 원칙
-
맥락 → 목표 → 제약 → 산출물 순서로 전달하면 오해가 줄어듭니다.
-
AI가 코드를 쓰기 전에 설계/기획을 검증시키는 단계가 중요합니다.
-
“무엇을 만들지”뿐 아니라 “왜 그렇게 해야 하는지”를 알려주면 결과 품질이 크게 좋아집니다.
언어 선택 (한국어 vs 영어)
-
한국어 우선이 가장 좋습니다. 사고 흐름과 요구가 더 정확해집니다.
-
영어는 옵션: 기술 용어, 라이브러리 이름, API 스펙처럼 정확성이 필요한 부분만 영어로 적습니다.
-
혼합 방식 권장: 예) “인증은 OAuth 2.0, client credentials flow 사용”
설계 내용 상세함 수준
결론: 처음에는 “중간 이상”의 상세함으로 시작하고, AI가 질문하도록 유도하세요.
-
너무 간단하면: AI가 추측을 많이 함
-
너무 디테일하면: 방향 전환이 어렵고 과잉 설계 가능성
권장 최소 항목:
-
문제 정의 (왜 필요한가)
-
사용자/운영자 관점 시나리오
-
핵심 기능 목록 (우선순위 포함)
-
비기능 요구사항 (성능, 보안, 확장성)
-
제약 조건 (기술 스택, 일정, 예산)
Prompt 형식 (추천 템플릿)
아래 템플릿을 그대로 쓰면 안정적으로 고품질 산출물을 얻습니다.
[목표]
- 이 프로젝트의 목적은 무엇인가?
[사용자 시나리오]
- 누가, 어떤 상황에서, 무엇을 한다.
[핵심 기능]
- 기능 리스트 + 우선순위
- 꼭 있어야 하는 기능 vs 있으면 좋은 기능
[비기능 요구사항]
- 성능, 보안, 확장성, 유지보수성 등
[제약]
- 기술 스택, 일정, 기존 시스템 연동, 법적 규제 등
[산출물 요청]
- 설계 문서 / API 명세 / DB 스키마 / 사용자 흐름도 등
로직 흐름 표현 방법
AI에게 로직 흐름을 요청할 때는 다음 3가지 중 하나를 선택하세요:
- 텍스트 기반 플로우
- “로그인 → 토큰 발급 → 리소스 요청”
- 의사코드
- if user.isValid → createSession
- 상태 전이
- Idle → Pending → Success/Fail
추천: 텍스트 기반 플로우로 먼저 전달하고, AI에게 의사코드로 정리하도록 요청
앱 개발 방안 전달 방식
AI에게 “어떻게 개발할지” 지시할 때는 아래 항목을 명확히 하면 좋습니다:
-
아키텍처 방향: 모놀리식 vs 마이크로서비스, 서버리스 여부
-
데이터 저장 전략: RDB vs NoSQL, 캐시 사용 여부
-
배포 전략: CI/CD, 클라우드 플랫폼
-
테스트 기준: 최소한의 테스트 범위
실제 요청 예시 (한국어)
목표: 사내 팀이 계약서 작성, 검토, 결재를 자동화하기 위한 웹앱
사용자 시나리오:
- 영업팀이 계약서를 생성하고, 법무팀이 검토 후 결재함
핵심 기능:
- 계약서 생성/템플릿 관리
- 계약서 수정 이력 관리
- 결재 워크플로우
- PDF export
비기능:
- 접근 권한 기반 제어
- 1초 이내 응답
- 1만 건 데이터 기준 유지
제약:
- Next.js + PostgreSQL 사용
- 배포는 AWS
산출물 요청:
- 시스템 설계 문서와 핵심 API 명세
추가 팁 (실전)
- AI에게 먼저 질문하게 만들기:
“먼저 설계 상 모호한 부분이나 질문이 있으면 물어봐.”
- 업무 분리 요청:
“설계/문서 작성 단계와 구현 단계 분리해서 진행해줘.”
- 검증 기준 제시:
“누락된 기능이 있으면 체크리스트로 알려줘.”
연관 메일