단계별 Agent 계층화 및 파라미터 템플릿을 통한 OpenSpec 워크플로우 효율 최적화

Optimizing OpenSpec Phase Efficiency with Different Agents: HagiCode Practice Summary

Hagicode2026년 5월 8일7분intermediate

AI 요약

Context

단일 Generic Prompt 사용으로 인한 Explore 단계의 컨텍스트 이탈 및 Artifact 생성 품질 불안정 문제 발생. 개발 단계별로 상이한 목표와 제약 사항을 단일 프롬프트로 처리함에 따른 책임 경계 모호성 및 유연성 부족이라는 구조적 한계 직면.

PromptScenario Enum 도입을 통한 단계별(Explore, New, FF, Apply, Archive) Agent 역할 분리 설계
Handlebars(.hbs) 기반의 템플릿 시스템과 JSON 메타데이터를 결합한 파라미터화된 프롬프트 구조 구축
FilePromptProvider 클래스를 통한 런타임 시점의 동적 파라미터 주입 및 시나리오별 템플릿 로딩 메커니즘 구현
ProposalPlanningDirections 클래스 내 독립적 ID와 프롬프트 Fragment를 정의하여 사용자 선택 기반의 동적 Planning Direction 제어
다국어(CN/EN) 대응을 위한 로케일별 템플릿 동기화 및 일관된 구조 유지 전략 채택

실천 포인트

1. 복잡한 AI 워크플로우 설계 시 단일 프롬프트 대신 단계별 책임 경계가 명확한 Agent 레이어링 적용 여부 검토

2. 정적 프롬프트를 탈피하여 템플릿 엔진(Handlebars 등)을 통한 동적 파라미터 주입 구조 도입

3. 사용자 선택에 따라 프롬프트 조각(Fragment)을 조합하는 전략적 구성 방식 적용

4. 템플릿 렌더링 성능이 마이크로초(μs) 단위로 유지되는지 확인하여 전체 파이프라인 병목 방지

태그