에이전트 또는 BYOK 경로 정하기

목적

이 lesson은 개발자·운영자가 Open Design에서 다음 판단을 안전하게 하기 위한 절차입니다.

언제 쓰나

에이전트 또는 BYOK 경로 정하기가 현재 목표일 때 사용합니다. 다른 목표라면 Workflow Map에서 다른 흐름을 먼저 선택하세요.

준비물

• Repo 문서 또는 설치 경로를 볼 수 있어야 합니다.
• 필요한 경우 Docker, Node 24, pnpm 10.33.x, agent CLI 또는 API 키를 준비합니다.
• 이 패키지는 live 실행을 하지 않았으므로 현장 값은 실제 환경에서 다시 읽습니다.

단계별 확인

1. 1 설치된 CLI 감지: daemon이 PATH와 config-dir로 agent 후보를 찾습니다.
   docs/agent-adapters.md detection strategy 확인
2. 2 실행 방식 선택: CLI가 있으면 adapter가 spawn하고, 없으면 BYOK proxy/fallback을 씁니다.
   README.md BYOK fallback 및 agent catalog 확인
3. 3 agent run 시작: skill context와 design-system context가 cwd와 함께 전달됩니다.
   docs/architecture.md agent adapter pool 확인
4. 4 파일 저장 확인: 결과는 메모리 이벤트가 아니라 artifact store에 남아야 합니다.
   docs/architecture.md artifact store layout 확인

구체 증거

흔한 실수

• agent CLI 인증이 없으면 생성 실패를 UI 문제가 아니라 실행 엔진 준비 문제로 봅니다.
• agent CLI 인증/PATH 문제를 디자인 품질 문제로 보지 않습니다. 먼저 감지 결과와 실행 mode를 확인합니다.

검증 / readback

다음 질문에 답할 수 있으면 이 lesson의 기본 이해는 통과입니다.

• 이 흐름의 첫 입력은 무엇인가?
• 성공을 어떤 파일, 화면, 명령 결과, 문서 근거로 확인하는가?
• 다음 단계로 가기 전에 멈춰야 하는 조건은 무엇인가?

근거

• docs/agent-adapters.md detection strategy 확인
• README.md BYOK fallback 및 agent catalog 확인
• docs/architecture.md agent adapter pool 확인
• docs/architecture.md artifact store layout 확인

다음 판단

agent 또는 BYOK 경로가 준비되면 생성 흐름으로 이동하고, 실패하면 adapter/인증 상태를 다시 봅니다.

검증 경계

이 lesson은 repo/docs와 포함된 screenshot 근거의 정적 매뉴얼입니다. 실제 서버 실행, 현재 UI label, agent 인증 성공, 생성 품질은 현장 검증이 필요합니다.