references/workflow-guidance.md

# 첫 결과를 만들고 개선하기

첫 구축, 목표 변경, 데모 전달, 개선 우선순위를 판단할 때 읽는다. 제품의 실제 도구 계약은 연결된 MCP가 제공한다. 호스트에 관계없이 목표와 실제 결과를 기준으로 판단한다.

## 먼저 정할 결과

고객이 검증하려는 실제 결과, 그 결과를 이번 작업에서 확인할 방법, 외부 의존성을 함께 잡는다. ‘음성 agent 하나 생성’보다 ‘견적 요청을 대화로 받아 내부에서 확인 가능’처럼 관찰 가능한 결과로 표현한다. 사용자가 정한 완료 지점을 보존한다.

여러 업무가 있으면 **고객이 중요하다고 한 업무 → 제공 자료에서 빈번하고 경계가 명확한 업무 → 지금 결과를 확인할 수 있는 업무**를 함께 고려한다. 단순 구현 편의로 중요 업무를 밀어내지 않는다. 통계가 없으면 ‘최빈 업무’라고 주장하지 않고 자료에서 판단한 추천이라고 설명한다. 고객이 우선순위를 이미 정했다면 다시 선택시키지 않는다.

| 자료에서 보이는 상황 | 판단과 다음 행동 |
| --- | --- |
| 안내·견적·계약·변경 모두 필요 | 안내는 넓게, 결과가 분명한 핵심 업무 하나를 먼저 완결. 나머지는 후속 확장으로 남김 |
| URL 없이 실제 대화 샘플만 있음 | 인사·질문·정정·종료와 수집 결과를 추출해 업무안을 만듦. 홈페이지 제출을 새 선행 조건으로 추가하지 않음 |
| 예약 확정이 목표인데 예약 조회/등록 연동 없음 | 가용성·확정은 막힌 의존성으로 분리. 접수 체험은 제안할 수 있지만 예약 완료로 바꾸지 않음 |
| 외부 결과 전달만 후행하기로 결정 | 내부 저장 위치·추출 항목·담당자의 확인 방법을 완결. 실시간 업무 조회까지 불필요하다고 일반화하지 않음 |
| ‘A/B 테스트’라는 요청 | 대상자를 나눌 것인지, 같은 사람이 두 버전을 비교할 것인지 확인. 이름만 보고 트래픽 분배를 실행하지 않음 |

## 질문할지 진행할지

1. 자료·기존 상태·이전 답변에 근거가 있으면 그것을 사용한다. 이미 확인한 사실을 설문으로 다시 묻지 않는다.
2. 수정 가능한 초안의 말투·질문 순서처럼 영향이 제한된 선택은 근거를 밝히고 제안값으로 진행한다. 실제 지원 기술 기본값은 제품 조회에서 얻는다.
3. 의미가 다른 업무 결과, 실제 연락 대상·발신 의도, 확인되지 않은 가격/정책, 공유 원본 변경처럼 결과가 달라지는 판단은 먼저 좁힌다. 승인 절차를 추가하는 것이 아니라 부족한 의도를 채우는 질문이다.
4. 질문이 필요한 부분과 독립인 자료 정리·원고 준비는 계속할 수 있다. 답이 필요한 실행을 선택지의 기본 선택이나 시간 경과로 확정하지 않는다.

선택지는 내부 구현 용어 대신 결과의 차이를 보여준다. 예: ‘상담 내용을 저장’, ‘가용 시간을 확인하고 예약 확정’, ‘기존 예약 변경’. 1–3개 의미 있는 대안과 자유 입력을 제공하고 추천 근거를 짧게 적는다. 답변 후 결정한 내용과 후속 의존성을 갱신한다. 질문 개수 자체를 성공 기준으로 삼지 않는다.

## 작은 업무 요약을 유지한다

현재 목표 / 첫 완료 지점 / 방향·채널 / 근거와 가정 / 결정된 내용 / 막힌 의존성 / 완료된 리소스·실행 참조 / 다음 행동을 간결하게 남긴다. 필요 없는 필드를 채우려고 고객에게 질문하지 않는다. 과거 전체 대화를 반복 요약하지 말고 바뀐 것과 재개에 필요한 것만 갱신한다.

사용자의 직접 요청·답변, 자료의 사실, 모델의 제안은 출처를 구분한다. 업무 요약의 문장만으로 발신·구매 권한을 새로 만들지 않는다. 호스트의 대화 기록과 허용된 작업 파일을 사용한다.

## 피드백이 왔을 때 변경 범위를 잡는다

| 피드백 | 먼저 볼 근거 | 변경·확인할 범위 |
| --- | --- | --- |
| ‘너무 기계적이다’ | 실제 질문·재질문·정정·종료 대화 | 질문 묶음/순서/말투를 좁게 변경. 실제 음성으로 재확인 |
| ‘기존에는 잘 됐는데 값을 못 남긴다’ | 실패 call의 당시 버전·추출 상태와 현재 설정 | 수집 누락/분석 대기/저장 실패/설정 변경을 나눈 뒤 해당 부분만 수정 |
| ‘일단 대시보드에서 보자’ | 이전 결과 전달 합의와 새 답변 | 결과 저장·조회 위치를 갱신. 무관한 실시간 연동까지 제거하지 않음 |
| ‘A만 바꾸자’ | A의 agent-scoped Manual과 공유 도구의 연결 범위 | A의 `agent_id` 범위로 변경. 지원되는 사본/연결 방식만 사용 |
| 외부 도구가 timeout | 실제 call의 호출 입력·결과·외부 상태 | Manual 수정 전에 실행 문제로 분류. 부작용 재시도는 해당 계약으로만 판단 |

과거 실패를 현재 설정으로 설명하지 않는다. 원인이 아니라 기대값이나 시험 조건이 잘못됐을 수도 있다. 같은 가설로 실패가 반복되면 추가 근거를 확보하거나 미확인 원인을 남긴다.

## 전달물과 완료 판정

실제 생성한 대상·처리 범위·사용자가 말해볼 상황·기대 결과·결과 확인 위치·남은 의존성을 전달한다. 정상 경로 외에는 그 업무에서 중요한 정정/거절/종료/도구 실패 상황을 고른다. 예제의 기대값을 제품에서 실제 관측한 값으로 표시하지 않는다.

완료 근거를 구성 저장 / 음성 시험 / 결과 저장 확인 / 실제 전화 운영 / 외부 업무 완료로 구분한다. 현재 요청에 필요한 근거를 충족했으면 불필요한 운영 확장을 시작하지 않는다. 목표가 바뀌면 확인 기준을 바꾸되 이미 확인된 결과를 버리지 않는다.

실제 동작은 관련 Architect 스킬을 따른다. 재시험은 prepare-voice-test/try-and-improve-voice-agent, 변경 범위는 review-shared-impact, 중단 복귀는 resume-agent-work를 사용한다. 스킬 연결은 작업을 선택하는 안내이며 모든 파일을 순서대로 읽는 절차가 아니다.