[발표자료] 구미 상권 지도앱 — 말로 지시해서 집에서 만들기
코딩 한 줄 직접 짜지 않고, 4인의 AI 에이전트 팀에게 말로만 지시하여 20,797개의 구미시 상권 공공데이터를 지도 웹앱으로 완성하는 발표 및 데모 가이드입니다.
1. 오늘 만들 결과물 (Goal)
- 데이터: 소상공인시장진흥공단 구미시 상가 20,797개 데이터 (위치 좌표 포함)
- 주요 기능:
- 지도 위 상권 마커 시각화 및 클러스터링(밀집 지역 자동 묶음)
- 동네별(행정동 기준) 및 업종별(카페/음식/소매 등) 필터링
- PC와 모바일 스마트폰 모두 지원하는 반응형 웹 화면
- 화면 위치 및 선택 필터가 URL 주소에 유지되는 공유 기능
2. 내 컴퓨터 안의 4인 AI 팀 구성
혼자 코드를 짜는 AI가 아닌, 역할이 분리된 4명의 AI 팀원과 협업합니다.
| 역할 | 명칭 | 실제 담당 업무 | 비유 |
|---|---|---|---|
| 팀장 | Orchestrator | 전체 파이프라인 조율, 사용자 지시를 팀원에게 배분 및 진행 보고 | 팀장 |
| 기획자 | Planner | 요구사항 분석, 화면 레이아웃 및 데이터 명세서(설계서) 작성 | 기획자 |
| 시공사 | Worker | 실제 지도 웹페이지 제작, 필터 구현, 자동 점검 코드 작성 | 개발자 |
| 검수자 | Reviewer | 완성된 앱 실행 검증(화면 동작, 링크 등), 결함 발견 시 재작업 반려 | QA/검수자 |
3. 핵심 작업 흐름: "반려는 실패가 아닙니다"
기존의 개발은 에러가 나면 사람이 직접 원인을 찾고 코드를 수정해야 했습니다.
하지만 멀티에이전트 팀에서는 검수자가 반려하면 시공사가 알아서 고칩니다.
하지만 멀티에이전트 팀에서는 검수자가 반려하면 시공사가 알아서 고칩니다.
[사용자 지시] ──► [Planner 기획] ──► [Worker 구현] ──► [Reviewer 검수] ──► [완성 보고]
▲ │
└── [반려 및 수정] ─┘
사용자는 완성된 앱을 받아 확인만 하면 됩니다.
4. 실전! 말로 지시하는 프롬프트 예시
실제 개발 과정에서 사용자가 입력하는 것은 자연어 지시뿐입니다.
① 첫 시작 지시 (기본 기능 생성)
💬 "구미시 상가 20,797개 자료로 우리 동네 가게들을 지도에서 볼 수 있게 해줘."
- 진행: Planner가 지도 라이브러리와 동별 데이터 구조를 기획하고, Worker가 기본 지도 화면을 구현합니다.
② 기능 세분화 (필터 추가)
💬 "카페랑 식당만 색깔로 구분해서 골라 볼 수 있는 스위치를 달아줘."
- 진행: Worker가 업종별 색상 마커와 토글 UI를 추가하고, Reviewer가 동작을 재검증합니다.
③ 상태 공유 (URL 링크 연동)
💬 "지금 보고 있는 동네와 업종 선택 상태가 주소에 남아서, 링크를 친구에게 공유해도 똑같이 열리게 해줘."
- 진행: URL 쿼리 파라미터 기반 상태 복원 로직을 자동으로 추가합니다.
5. 문제가 생겼을 때 대처법 (Troubleshooting)
코드를 전혀 몰라도, 화면에 나타난 현상만 자연어로 말해주면 AI 팀이 알아서 해결합니다.
- 현상: 지도는 뜨는데 상가 위치에 점(마커)이 안 보일 때
- ➔ 💬 "지도는 뜨는데 점이 안 보입니다. 기본 점 위치 좌표와 데이터 로딩 설정을 확인해 주세요."
- 현상: 스마트폰 화면에서 라벨이나 텍스트가 겹칠 때
- ➔ 💬 "모바일 화면에서 글자가 겹쳐 보이니, 카드형 목록이나 표 형태로 깔끔하게 정돈해 주세요."
- 현상: 공유 주소로 들어왔는데 처음 화면으로 리셋될 때
- ➔ 💬 "선택한 동네와 업종이 URL 주소에서 다시 살아나도록 상태 복원 로직을 고쳐 주세요."
6. 마무리 및 핵심 요약
- 역할 분담의 중요성: 기획(Planner)과 구현(Worker), 검증(Reviewer)이 명확히 나뉘어 있어야 AI가 할루시네이션이나 엉뚱한 코드를 짜지 않고 안정적인 결과물을 냅니다.
- 지시의 3요소: 효과적인 지시는 [원하는 결과] + [대상 범위] + [구체적인 예시 1개] 세 가지만 갖추면 충분합니다.
- 누구나 만드는 시대: 복잡한 프로그래밍 언어를 배우지 않아도, 명확한 지시와 피드백만으로 나만의 데이터 지도앱을 완성할 수 있습니다.