부서마다 LLM 을 쓰기 시작하면 프롬프트가 담당자 PC 와 대화 기록에 흩어집니다. 쓰던 문장을 다시 찾지 못하고, 고치면 전 버전이 사라지고, 잘 썼는지 판단할 기준이 없습니다. 이 셋을 사내 시스템 한 곳으로 묶은 구축 건입니다. 기획·프런트엔드·백엔드·인프라를 단독 수행했습니다.

프롬프트를 DB 레코드로 올리고 버전과 품질 점수를 붙였습니다. 테이블 8개, 프롬프트 레이어 6개, 에이전트 기본 단계 5개. 에이전트를 만들면 다섯 단계가 같이 생겨 담당자가 빈 껍데기부터 채우는 일이 없습니다.

현업에서 실제로 나온 문제 넷입니다. 쓸 만한 프롬프트가 어디 있는지 모르고, 덮어쓰면 돌아갈 데가 없고, 품질을 볼 기준이 없고, 여러 단계를 사람이 복사해 이었습니다.

에이전트 생성에서 프롬프트 작성, 체인 설계, 목록 관리까지 네 화면으로 이어집니다. 점수와 버전, 채워진 레이어가 목록 한 줄에 다 보여서 담당자가 바뀌어도 인수인계가 됩니다.

프롬프트 작성 화면입니다. Role·Context·Task·Format·Constraint·Example 여섯 칸으로 나눠 쓰면 점수가 실시간으로 바뀌고, 모델에 실제로 가는 문장은 합쳐진 모양으로 미리 봅니다.

품질 기준을 사람 감이 아니라 점수로 고정했습니다. Role 20, Task 25(기본 10 + 길이 10 + 구체적 지시어 5), Format 20, Constraint 20, Example 15 로 100점. 수정이 들어오면 직전 내용을 버전 테이블에 복사하고 버전을 올려 감사 추적이 남습니다.

FastAPI 0.115 + SQLAlchemy 2.0 async + PostgreSQL 15 구성입니다. 응답은 전부 success·data·error·meta 로 감싸 사내 다른 시스템이 붙이기 쉽게 했고, 인증은 JWT HS256. 백엔드 기동 시 마이그레이션을 먼저 돌려 받는 쪽은 docker compose 한 줄이면 됩니다.

다단계 실행 설계 화면입니다. 단계 N 의 출력이 단계 N+1 의 입력 컨텍스트로 자동으로 들어가서, 사람이 창을 오가며 복사해 붙일 자리를 없앴습니다.

사용 기술과 남은 범위입니다. React 19, TypeScript 5.9, Vite 8, Zustand, TanStack Query, Tailwind 4.2 / FastAPI, SQLAlchemy async, Alembic, PostgreSQL 15, Docker Compose. 저장한 체인을 실제 모델에 던지는 실행 엔진과 스케줄러 연동은 다음 단계로 설계만 해 두었습니다.