들어가며
지난 글에서 말했듯, 회사에서 사용하는 AI 도구를 GitHub Copilot으로 전환했고
요 몇 달간 VS Code Agent Extension, GitHub Copilot CLI, Code review 등등 다양한 도구들을 사용해보고 있다.
마침, 내년 결혼준비를 앞두고 신혼집과 결혼식에 대해 부쩍 관심을 가지기 시작했는데
비개발자인 애인도 함께 사용할 수 있는 맞춤형 AI Agent를 만들어보면 좋을 것 같아서 글을 작성해 본다.
프로젝트는 개발 지식이 있는 사람이라면 따라 할 수 있을 정도로, AI에게 개발을 요청하는 바이브 코딩 중심으로 진행했다.
최종 서비스는 비개발자도 사용할 수 있을 정도로 쉽게 만드는 것을 목표로 만들어 보자.
글에 들어가기 앞서, 프로젝트를 시작하게된 계기인 Agent-Worker패턴과 Multi-Agent패턴에 대해 알고있으면 좋다.
AGENT 개념 정리 : 2026.05.11 - [개발] - AI Agent 개념정리 - LLM · Worker-Agent 패턴 · Multi-Agent 패턴
AI Agent 개념정리 - LLM · Worker-Agent 패턴 · Multi-Agent 패턴
들어가며회사에서 사용하는 AI를 GPT에서 Github Copilot으로 변경하고 약 한 달이 지났다.VsCode, Cursor, Antigravity에 이르기 까지 AI IDE가 빠르게 발전하면서 AI Agent의 설정과 사용이 매우 쉬워졌다. 오늘
prejudice.tistory.com
서비스 구상
아이디어 컨셉
애인과 나는 둘 다 전세경험도 없고, 세대주 분리도 안되고 부모님 집에 함께 사는 중으로
결혼과 부동산에 대한 지식이 정말 백지상태라고 말할 수 있다.
며칠간 웨딩 관련 용어들을 검색해 보고 알아보며 1년 동안 준비하며 돌파해 나가는 장기간 프로젝트라는 것을 알았고,
OneNote나 Notion을 이용한 기록 보다, 우리만의 결혼정보에 최적화된 Agent가 있으면 좋을 것 같았다.
- 맞춤정보 (토요일 or 일요일 · 하객 인원수 · 지역 · 우선순위 등)를 데이터로 사용.
- 일정과 예산을 정리하고 파일로 저장할 수 있음.
- 모르는 용어나 과정을 검색할 수 있음.
프롬프트를 계속 업데이트해가며 사용해도 되고, 내가 만들려는 서비스의 최종 결과가 Cloud Agent와 비슷한 것 같다.
하지만 이미 GitHub Copilot 계정을 사용 중이고 여자친구도 쉽게 쓸 수 있도록 직접 만들어 보기로 했다.
Prototype Service Architecture 구성
아키텍처를 구상하면서 가장 고민한 부분은 파일 입출력이었다.
예를 들어 한번 선택해 기록한 파일이 있다면, 다음 질문에선 그 정보를 바탕으로 응답하는 맞춤형 AI를 원했다.
따라서 Copilot CLI를 설치하고 웹 서버와 연결하는 방식을 떠올렸다.
프로젝트의 역할은 크게 두 가지로 각각의 Agent를 두어 관리해 보려 한다.
- Wedding Planner Agent: 결혼 준비에 관련된 정보, 일정관리, 준비목록, 체크리스트를 관리하는 역할.
- APT Manager Agent: 신혼집에 관련된 청약 공고 분석, 일정관리, 자산 및 대출비용 계산 업무를 담당하는 역할.
너무 간단해서 아키텍처라 불러도 되나 부끄럽지만, 바이브코딩으로 개발을 진행하며 수정을 해나가려 했다.
서비스 개발
Workspace 생성
프로젝트명이 마땅히 떠오르지 않아 WeddingElder 워크스페이스를 만들었다.
나는 IDE로 VS Code를 주로 사용하기 때문에 VS Code로 워크스페이스를 열어준다.
AI 바이브 코딩을 위해 GitHub Copilot Chat Extension 을 설치하면 개발 준비가 끝난다.
AI Agent 생성
VS Code에서는 AI 대화창을 이용해 쉽게 Agent 프롬프트를 만들 수 있다.
/create-agent 명령으로 대략적인 프롬프트를 생성하고, 추후에 나의 상황에 맞게 프롬프트를 수정하면 된다.
나는 간단하게 "wedding-planner"라는 이름과 역할정도만 주고 생성했다.
WeddingElder\.github\agents\ 경로에 wedding-planner.agent.md 파일이 생성된 것을 확인할 수 있다.
이 폴더구조는 VS Code의 GitHub Copilot의 전용 규칙으로 특정 Agent를 호출할 때 해당 프롬프트를 사용한다.
추후 부동산을 관리하는 APT Manager Agent를 추가할 예정이기 때문에
모든 Agent들이 공통으로 사용하는 AGENTS.md 파일을 추가했다.
*AGENTS.md 파일 또한 Copilot이 인식하는 파일로, root폴더(WeddingElder) 또는 .github 폴더 등 어디에 두든 상관없다.
📦WeddingElder
┣ 📜 AGENTS.md # Workspace 총괄 가이드
┗ 📂.github
┗ 📂agents
┗ 📜wedding-planner.agent.md # 결혼식 관리 AgentWeddingElder\AGENTS.md
# 웨딩플래너 워크스페이스 가이드
## 목적
- 이 워크스페이스는 내년 10월 중반 토요일 예식을 목표로 한 결혼 준비를 위한 공간이다.
- 일반적인 소프트웨어 구현보다 일정표, 체크리스트, 예산안, 업체 비교표, 진행 메모, 의사결정 기록 같은 준비 산출물을 우선해서 돕는다.
## 작업 방식
- 추천은 실용적이고, 시점이 분명하며, 바로 실행 항목으로 옮길 수 있게 정리한다.
- 세부 정보가 비어 있으면 목표 예식 시점을 기준으로 잡고, 어떤 가정을 두었는지 명확히 적는다.
- 결과물은 메모, 스프레드시트, 작업 관리 도구에 옮기기 쉬운 구조로 제시한다.
## 선호 출력 형식
- 큰 준비 업무는 월 단위로 나누고, 필요하면 주간 다음 행동까지 이어서 정리한다.
- 업체나 선택지를 비교할 때는 비용, 가능 일정, 적합도, 리스크, 추가 확인 질문 같은 동일한 기준을 사용한다.
- 지역, 예산, 하객 수, 가족 선호에 따라 달라지는 항목은 분명하게 표시한다.
## 문서 언어
- 이 워크스페이스에서 작성하거나 수정하는 Markdown 문서는 기본적으로 한글로 작성한다.
- 외부 서비스명, 브랜드명, 계약 용어처럼 원문 유지가 필요한 표현만 예외로 둔다.
## 에이전트 사용
- 결혼 준비 일정, 예산 정리, 업체 비교 기준, 준비 체크리스트 작성은 전용 웨딩플래너 agent를 우선 사용한다.
## 파일 생성
- 파일을 생성하거나 관리할때는 /files 폴더를 사용한다.
- 엑셀을 만들때나 일회용으로 쓰는 임시파일 같은 경우는 /temp 폴더를 사용한다.WeddingElder\.github\agents\wedding-planner.agent.md
---
name: 웨딩쀼
description: "결혼 준비를 계획하거나, 일정표를 만들거나, 예산을 정리하거나, 웨딩홀 및 업체를 비교하거나, 체크리스트를 구성하거나, 27년 10월 중반 토요일 예식을 목표로 준비할 때 사용한다."
tools: [read, edit, search, execute, todo, web]
user-invocable: true
---
이 워크스페이스 전용 웨딩 준비 전문 agent다.
역할은 사용자가 27년 10월 중반 토요일 예식을 목표로 결혼을 준비할 수 있도록, 현실적인 계획과 바로 실행 가능한 정리를 제공하는 것이다.
## 핵심 역할
- 현실적인 결혼 준비 타임라인을 만들고 유지한다.
- 막연한 목표를 구체적인 다음 행동으로 바꾼다.
- 예산, 예식장, 협력업체, 하객 수, 복장, 식순, 행정 준비를 구조적으로 정리한다.
- 선택지 비교 시 기준과 트레이드오프를 명확하게 드러낸다.
## 기본 가정
- 정확한 날짜가 아직 확정되지 않았다면, 27년 10월 중반 토요일을 목표 날짜로 가정한다.
- 지역, 예산, 하객 수는 사용자가 지정하기 전까지 미정 변수로 둔다.
- 워크스페이스 문맥이 한국어이므로, 사용자가 따로 말하지 않으면 한국 기준의 결혼 준비 관행을 우선 반영한다.
## 제약
- 실시간 가격, 실시간 예약 가능 여부, 법률 자문을 알고 있는 것처럼 답하지 않는다.
- 확정되지 않은 예약, 계약, 마감일을 사실처럼 만들지 않는다.
- 사용자가 결정이나 계획을 원할 때 막연한 아이디어 나열로 끝내지 않는다.
## 진행 방식
1. 무엇을 결정해야 하는지, 얼마나 급한지, 어떤 조건이 비어 있는지 먼저 파악한다.
2. 답변에 큰 영향을 주는 가정이 있으면 먼저 밝힌다.
3. 사용자가 파일, 표, 템플릿, 비교표, 체크리스트를 원하면 워크스페이스에서 직접 만들거나 수정한다.
4. 필요하면 마지막에 가장 작은 다음 행동이나 확인 질문을 덧붙인다.
## 출력 선호
- 일정표는 월별 또는 의사결정 단계별로 묶는다.
- 예산안은 항목, 예상 범위, 비용 리스크 메모를 함께 적는다.
- 비교 요청은 기준, 장점, 단점, 추가 확인 질문이 있는 표 형태를 우선한다.
- 체크리스트는 필수 항목과 선택 업그레이드를 구분한다.
- Markdown으로 답할 때는 기본적으로 한글로 작성한다.
## 기본 계획 영역
- 예식장과 날짜 선택
- 예산 배분과 우선순위 조정
- 스튜디오, 드레스, 메이크업, 촬영 준비
- 하객 명단과 청첩장 시점 조율
- 예식 및 피로연 진행 순서
- 신혼여행 일정 의존성 정리
- 행정 및 계약 관련 준비
## 성공 기준
모든 답변은 사용자의 불확실성을 줄이거나, 우선순위를 분명히 하거나, 27년 10월 중반 예식을 향한 구체적인 다음 단계 하나 이상을 제공해야 한다.
도구가 허용된 경우에는 필요한 검색, 파일 편집, 문서 생성, 표 정리, 셸 실행을 직접 수행해 결과물을 남긴다.Copilot-CLI 설치와 WebServer 구현
PC에 원격으로 접근해서 VS Code의 Copilot 대화창을 이용해 AI를 사용해도 된다.
하지만 사용자가 쉽게 접근할 수 있도록 WebServer로 대화창을 제공해 보려 한다.
먼저 VS Code IDE 없이도 AI를 호출할 수 있도록 Copilot CLI 를 설치했다.
Copilot CLI는 GitHub 홈페이지에서 설치할 수 있으며, 정상적으로 설치 후 CMD 창에서 Copilot 명령으로 실행할 수 있다.
이제 VS Code IDE로 돌아가서 이 명령을 수행할 수 있도록 연결하는 웹서버를 만들어 보자.
다음과 같이 명령 후, 몇 가지 체크를 하고 권한을 주면 뚝딱뚝딱 만들기 시작한다.
AI에게 webserver 폴더에 만들라고 지정했기 때문에 폴더가 지저분해지는 것을 피하고, 나름 깔끔하게 구조를 유지할 수 있었다.
📦WeddingElder
┣ 📜 AGENTS.md # Workspace 총괄 가이드
┣ 📂.github
┃ ┗ 📂agents
┃ ┗ 📜wedding-planner.agent.md # 결혼식 관리 Agent
┣ 📂webserver # python으로 개발된 웹 서버
┃ ┗ 📜[webserver Files]
┣ 📂temp # 임시 생성될 파일 경로
┗ 📂files # 파일저장 경로나의 경우 PC에 Python을 설치해 두지 않았다.
때문에 AI가 파이썬 가상환경인 venv를 설치했고, Workspace에도 따로 적진 않았지만 .venv폴더를 만들어졌다.
webserver 폴더에 들어가 python으로 웹서버 프로그램을 실행하고, 인터넷으로 접속해 Copilot CLI에 접근할 수 있었다.
(.venv) PS C:\..\WeddingElder\webserver> python.exe .\app.py
Agent Tool 설치 - Excel 파일 만들기
Agent의 강력한 기능은 명령 수행 시 사용할 수 있는 도구를 함께 전송해서 명령을 수행할 수 있다는 점이다.
Workspace에서 Copilot에게 엑셀파일을 만들 수 있도록 도구를 설치하라고 명령했다.
Python가상환경에 Excel파일을 만드는 라이브러리인 openpyxl을 설치했고,
wedding-planner.agent.md 파일에 tools를 추가했다.
그다음, Copilot에게 엑셀 파일로 정리해 달라고 하면 다음과 같은 과정을 통해 파일을 생성한다.
웹소켓으로 서버로 전송→Coiplot CLI(AGENTS.md)
→Excel 생성용 python코드 작성→python실행(.xlsx)
계획대로라면 임시파일은 \temp폴더를 사용하고 최종 결과 파일은 \files 폴더를 사용해야 하지만,
어째서인지 AGENT가 WeddingElder\temp 폴더에 만든 것을 확인할 수 있다.
*하지만 Excel 파일 생성은 확인할 수 있었다.
해당 문제는 파일을 관리하는 Agent를 따로 만들어서 복사를 하거나, AGENTS.md파일을 수정하여 해결할 수 있을 것 같다.
회고
코드를 한 줄도 보지 않고 개발을 한건 처음이었는데,
Agent를 커스터마이징하고 도구를 연결하는 모든 과정을 자연어로 개발하는 과정 자체에서 재미를 느낄 수 있었다.
그에반해 결과물 측면에서는 Copilot CLI의 작업 속도가 느렸고,
웹세션을 이용한 UI 부분도 기대했던 것에 비해 밤티나서 아쉬움이 남는다.
사실상 이번 프로토타입 프로젝트에서는 Copilot CLI를 오케스트레이터처럼 사용했다.
또한 LLM Model을 코드를 잘 작성하는 Calude Sonnet 4.6으로 사용했는데, Model선정에 있어서도 성능차이가 클 것이다.
추후 구조개선과 UI개선을 통해 프로젝트 완성도를 높일 수 있었으면 좋겠다.
서비스 완성도를 높이기 위해 시도해 볼 만한 것들
- Orchestrator-Worker 구조로 작업 분리
- 파일관리 Agent 추가 : 폴더구조 관리
- APT Manager Agent 추가 : 신혼집(부동산) 관련 Agent
- MD 파일 수정 기능: Agent를 웹에서 커스터마이징 가능하도록 UI 제공
- 보안 : 인증/접근제어
- 온라인 개시 : 도메인 연결 (TOOL: ngrok, pyngrok)
직접 공부해서 다음 글로 정리해 보려고 합니다.
프로젝트 코드 공개 (GitHub)
https://github.com/BlueBird-0/WeddingElder
GitHub - BlueBird-0/WeddingElder: AI Agent Project for management of wedding.
AI Agent Project for management of wedding. Contribute to BlueBird-0/WeddingElder development by creating an account on GitHub.
github.com
'개발' 카테고리의 다른 글
| AI Agent 개념정리 - LLM · Worker-Agent 패턴 · Multi-Agent 패턴 (0) | 2026.05.11 |
|---|---|
| ROS2를 처음 분석하며 정리한 핵심 개념 - DDS, QoS, ROS Architecture (0) | 2026.04.29 |
| C++ Preemptive Task Scheduler 구현 및 성능 비교 (Windows · Linux · Linux PREEMPT_RT) (0) | 2026.04.18 |
| Linux PREEMPT_RT 실시간성(Jitter) 측정 및 성능 비교 - RTOS (0) | 2026.04.06 |
| Windows 한글 계정명에서 발생하는 CMake 빌드 에러 원인과 해결 방법 (0) | 2026.03.31 |