[AI 빌더 실전 #4]개발 전야 - AI에게 '실행의 전권'을 넘기는 표준 지침(Pre-set) 설계

AI 빌더 오케스트레이션 전략 4편: 표준 지침(Pre-set) 설계 및 하네스 구축 전략

여전히 API 스펙을 한 줄 한 줄 직접 적고 계신가요? 그건 오케스트레이션의 실패입니다. 빌더의 역할은 스펙을 적는 것이 아니라, AI가 결과물을 '제대로 뽑아낼 수밖에 없는 하네스(Harness)'를 설계하는 것입니다. 실행의 전권을 넘기기 전, 반드시 주입해야 할 4가지 프리셋(Pre-set)을 공개합니다.

---

1. 하네스 구축: '자율 주행'을 위한 제약 조건 설계

AI에게 자유도를 주면 도중에 길을 잃거나 '바이브의 취기'에 빠져 엉뚱한 코드를 짭니다.

이때 필요한 것이 하네스(Harness)입니다. 하네스는 AI가 정해진 궤도를 벗어나지 않게 잡아주는 '정교한 제약 장치'입니다.

• 통제의 역설: AI에게 무조건적인 자유를 주는 게 아니라, 정교한 지침(Pre-set)이라는 하네스를 채워야 비로소 자율 주행 개발이 가능해집니다.
• 스티어링(Steering): 하네스가 잘 설계되어 있다면, 빌더는 개발 과정에서 미세한 스티어링만으로도 프로젝트의 방향을 완벽하게 제어할 수 있습니다.

2. [기획 단계] 비즈니스 임팩트를 강제하는 '추론 프리셋'

개발자 출신 빌더들이 가장 많이 하는 실수는 기술적 답변부터 찾는 것입니다.

이를 방지하기 위해 '왜(Why)'를 먼저 증명하게 만드는 하네스가 필요합니다.

• Pre-set 예시: 
  "기능을 제안하기 전, 이 기능이 해결하는 사용자의 결핍(Pain Point)과 비즈니스 아웃풋(KPI)을 먼저 서술해 줘. 만약 ROI가 낮다고 판단되면 대안을 제시해."
  "모든 기능 제안 이전에 반드시 다음의 [비즈니스 필터]를 통과해야 함."
  
  • 이 기능이 구현되었을 때 기대되는 지표(KPI) 변화는?
  • 이 기능이 해결하는 핵심 결핍(Pain Point)은 무엇인가?
  • 대체 가능한 더 단순한 방법이 있다면 무엇인가? 위 3가지에 답하지 못하는 기능은 명세서에서 제외한다."

• 부가 설명: 이 프리셋은 AI가 단순 코딩 조수가 아니라 'PM 젬'으로서 사고하게 만듭니다.
  예를 들어 "결제 페이지를 만들어줘"라고 했을 때,
  AI가 "결제 이탈률을 낮추기 위한 원클릭 결제와 심리적 안심 장치를 먼저 설계하겠습니다"라고 답하게 만드는 장치입니다.

3. [설계 단계] 인터페이스 표준과 비개발자를 위한 조언

AI가 내놓는 결과물이 제각각인 이유는 준수해야 할 '표준'을 주지 않았기 때문입니다.

• 기술 제약 체크리스트: 프로젝트 시작 전, 다음 사항을 미리 AI에게 알려주세요
  
  • 기술 스택: (예: Next.js 15, App Router, Tailwind)
  • 인터페이스 정의: (예: RESTful API, JSON Snake Case 적용)
  • 컴포넌트 원칙: (예: Atomic Design Pattern, Shadcn/UI 기반)
• 비개발자 빌더를 위한 조언: 코드를 이해하려 하지 말고 '규칙'을 정하는 데 집중하세요.
  AI에게 "이 분야에서 가장 유지보수가 쉬운 업계 표준 스펙을 조사해서 먼저 제안해 줘"라고 시킨 뒤, 그 내용을 하네스로 채우면 됩니다.

4. [인계 단계] 모델 간 맥락 유지를 위한 Handover

제미나이(기획)에서 클로드(구현)로 넘어갈 때 발생하는 손실은 생각보다 큽니다.

이를 막기 위해 Handover 프로토콜이 필요합니다.

• Handover 지침: 설계 마지막 단계에서 "이 내용을 다음 단계의 코딩 에이전트(Claude CLI)가 읽을 '시스템 프롬프트' 형태로 요약해 줘"라고 요청하세요.
• 효과: 모델이 바뀌어도 핵심 맥락이 기계가 읽기 좋은 형태로 전달되어, 빌더가 수동으로 복사해서 설명하는 수고가 사라집니다.

5. [자산화 단계] 다음을 위한 결정 로그(ADR)

개발 중 내린 결정들을 기록하지 않으면 다음 프로젝트에서도 똑같은 시행착오를 반복하게 됩니다.

거창한 문서 대신 ADR(Architecture Decision Record)을 남기십시오.

• 5분 ADR 템플릿: "오늘 개발 중 가장 막혔던 지점은 무엇인가?", "AI가 제시한 여러 해결책 중 왜 이 방안을 선택했는가?"를 한 줄로 기록하십시오.
• 자산화: 이 기록은 단순한 메모가 아니라, 다음 프로젝트르 진행할 때 귀중한 가이드가 될 것입니다. 

6. 요약: 빌더를 위한 '프리셋 박스(Pre-set Box)'

각 단계에서 이 프리셋을 복사해서 AI에게 던지는 것만으로도 프로젝트의 밀도가 달라집니다.

단계	빌더의 액션	AI에게 던질 프리셋(Pre-set)
기획	아이디어 투척	비즈니스 가치 역추적 지침 적용
설계	범위 확정	인터페이스 표준 및 기술 스택 가이드 주입
구현	CLI 가동	Handover 프로토콜 및 프롬프트 캐싱 최적화 요약

---

다음 편 예고: 5편: 실전 구현과 검증 - 자율 주행 개발과 셀프 힐링 (테스트 자동화 및 토큰 경영)

---

이글에서 설명하는 개념을 실제로 보고 싶다면?

2026.04.21 - [AI 빌더] - 작동하는 AX를 설계합니다 — AX Studio by gtpmore 포트폴리오

작동하는 AX를 설계합니다 — AX Studio by gtpmore 포트폴리오