Prompt를 First-class Object로 추상화한 Model-Agnostic 설계 전략

Context

Prompt를 f-string으로 하드코딩하여 Application Logic과 Prompt Template, Execution Model이 강하게 결합된 구조적 한계 직면. 이로 인해 모델 변경 시 코드 수정이 불가피하며, Prompt의 버전 관리 및 독립적 테스트가 불가능한 Technical Debt 발생.

Technical Solution

• SQL의 Prepared Statement 개념을 응용하여 Prompt Template과 Runtime Data를 분리한 Parameterized 구조 설계
• Prompt, Model 설정을 포함한 Skill 객체를 도입하여 Business Logic과 LLM 실행 환경의 결합도 제거
• YAML 기반의 Serialization을 통해 Prompt를 코드 외부의 Artifact로 관리함으로써 배포 없이 Prompt 수정 가능 구조 구현
• API Key를 Serialization 대상에서 제외하고 Runtime에 주입하는 설계를 통해 보안성과 이식성 동시 확보
• Model 객체를 Skill의 의존성으로 주입하여 동일 Prompt에 대해 다양한 LLM Provider를 즉시 교체 가능한 인터페이스 구축