/

📌 답변 먼저 보기

AI 검색 에이전트 전환은 새 구독보다 문장 형태를 바꾸는 일입니다. “이게 뭐야?”는 검색이고, “이 경로에서 이 기준이 되면 멈춰”는 에이전트 지시입니다. 이 글은 질문을 작업 단위로 쪼개고, 성공 기준을 적고, 실패 시 고치는 순서만 다룹니다.

가격·특정 모델 순위는 없습니다. 어느 채팅/에이전트 창이든 같은 뼈대를 씁니다.

질문을 작업으로 바꾸려면?

한 줄 답: 주제 단어를 목표 동사로 바꾸고, 대상·금지·산출물을 한 덩어리로 적습니다.

검색 문장은 명사가 중심에 있습니다. “OAuth 리프레시 토큰”, “피벗 테이블”, “이번 분기 실적.” 에이전트 문장은 동사가 중심에 있습니다. “재현하고 최소 패치”, “열을 정규화하고 피벗 초안”, “숫자 출처를 표로.”

전환 체크입니다.

  1. 목표 한 문장: 끝나면 무엇이 달라져 있나. “flaky login 테스트가 로컬에서 안정적으로 통과한다.”
  2. 범위: 읽거나 고쳐도 되는 경로. 그 밖은 금지.
  3. 입력: 로그, 이슈 번호, 재현 명령, 금지 파일.
  4. 산출물: diff, 표, 슬라이드 목차, PR 초안 중 무엇을 보여줄지.
  5. 하지 말 것: 포맷터 전체 실행, 의존성 업그레이드, 원격 푸시, 추측으로 비밀 채우기.

검색: “React Query 캐시가 왜 안 비워져?” 작업: “src/queries만 읽고, 로그아웃 시 캐시가 남는 경로를 재현한 뒤, 테스트 한 개와 최소 패치를 제안한다. src/auth 공개 API는 바꾸지 않는다.”

한 창에 조사와 수정을 섞지 않습니다. 먼저 읽기 전용으로 후보를 받고, 합의한 뒤에만 쓰기 세션을 엽니다. ADE를 쓰면 조사와 패치를 worktree로 갈라 같은 습관을 디스크에 고정할 수 있습니다.

성공 기준은?

한 줄 답: 사람이 창을 보지 않고도 통과/실패를 말할 수 있는 관찰 가능한 조건입니다.

나쁜 기준: “더 깔끔하게”, “프로답게”, “버그 없게.” 나은 기준: 명령 출력, 파일 목록, 숫자 대조, 체크리스트.

예시입니다.

  • 코드: 지정 테스트가 통과하고, diff가 합의 경로 밖을 건드리지 않는다.
  • 문서: 제목 3개와 각 3불릿, 출처 URL이 본문에 남아 있다.
  • 데이터: 행 수가 원본과 같고, 수식 열은 샘플 3행이 손계산과 맞는다.
  • 커뮤니케이션: 수신자·목적·기한이 초안 첫 줄에 있고, 추측 숫자는 [확인 필요]로 표시한다.

기준은 지시 안에 적습니다. 끝난 뒤에 “내가 원했던 건 이게 아닌데”는 검색창 습관입니다. 에이전트에게 “끝났으면 기준 대비 표로 자술하라”고 하면 검수가 빨라집니다. 자술이 틀릴 수 있으니 표는 힌트이고, 근거는 테스트와 diff입니다.

시간 예산도 기준입니다. “30분 안에 재현만. 패치는 제안만.”처럼 멈추는 선을 주면, 에이전트가 리팩터로 미끄러지는 경우가 줄어듭니다.

실패 시 어떻게 고치나?

한 줄 답: 같은 목표를 유지한 채 범위를 줄이거나 입력을 보강하고, 추측으로 권한을 넓히지 않습니다.

실패는 대개 세 종류입니다.

  • 범위 과다: 반 레포를 열었습니다. 경로를 한 패키지로 줄이고, 읽기 전용으로 다시 조사합니다.
  • 입력 부족: 재현이 안 됩니다. 로그·명령·화면을 붙이고 “추측하지 말고 재현 실패를 보고”라고 적습니다.
  • 기준 모호: 문장은 유려하고 검증이 없습니다. 기준을 명령이나 표 항목으로 바꿉니다.

고칠 때 피합니다.

  • 실패한 세션에 비밀·sudo를 바로 추가하기.
  • “그냥 다 고쳐”로 목표를 갈아엎기.
  • 출력을 안 읽고 새 창에서 같은 질문을 다시 던지기.

짧은 복구 루프입니다. (1) 마지막 출력에서 실제 막힌 한 줄을 고른다. (2) 그 줄만 목표로 다시 쓴다. (3) 통과하면 원래 기준의 다음 항목으로 간다. 패치가 반복해서 어긋나면 재현만 에이전트에 두고 패치는 사람이 씁니다.

전환이 된 느낌은 새 도구를 켰을 때가 아닙니다. 검색 문장을 쓰기 전에 목표·범위·기준이 먼저 적힐 때입니다. 그다음 슬라이드·시트처럼 산출물이 다른 일로 옮기면 됩니다.

출처

  • 시리즈 S03 역할 분담(검색 / 에이전트 / 사람)을 지시 문장으로 옮긴 실습입니다.
  • 실행 환경이 Orca라면 worktree 격리는 Worktrees를 참고합니다.

+ Recent posts