📌 답변 먼저 보기
AI 검색 에이전트 전환은 새 구독보다 문장 형태를 바꾸는 일입니다. “이게 뭐야?”는 검색이고, “이 경로에서 이 기준이 되면 멈춰”는 에이전트 지시입니다. 이 글은 질문을 작업 단위로 쪼개고, 성공 기준을 적고, 실패 시 고치는 순서만 다룹니다.
가격·특정 모델 순위는 없습니다. 어느 채팅/에이전트 창이든 같은 뼈대를 씁니다.
질문을 작업으로 바꾸려면?
한 줄 답: 주제 단어를 목표 동사로 바꾸고, 대상·금지·산출물을 한 덩어리로 적습니다.
검색 문장은 명사가 중심에 있습니다. “OAuth 리프레시 토큰”, “피벗 테이블”, “이번 분기 실적.” 에이전트 문장은 동사가 중심에 있습니다. “재현하고 최소 패치”, “열을 정규화하고 피벗 초안”, “숫자 출처를 표로.”
전환 체크입니다.
- 목표 한 문장: 끝나면 무엇이 달라져 있나. “flaky login 테스트가 로컬에서 안정적으로 통과한다.”
- 범위: 읽거나 고쳐도 되는 경로. 그 밖은 금지.
- 입력: 로그, 이슈 번호, 재현 명령, 금지 파일.
- 산출물: diff, 표, 슬라이드 목차, PR 초안 중 무엇을 보여줄지.
- 하지 말 것: 포맷터 전체 실행, 의존성 업그레이드, 원격 푸시, 추측으로 비밀 채우기.
검색: “React Query 캐시가 왜 안 비워져?” 작업: “src/queries만 읽고, 로그아웃 시 캐시가 남는 경로를 재현한 뒤, 테스트 한 개와 최소 패치를 제안한다. src/auth 공개 API는 바꾸지 않는다.”
한 창에 조사와 수정을 섞지 않습니다. 먼저 읽기 전용으로 후보를 받고, 합의한 뒤에만 쓰기 세션을 엽니다. ADE를 쓰면 조사와 패치를 worktree로 갈라 같은 습관을 디스크에 고정할 수 있습니다.
성공 기준은?
한 줄 답: 사람이 창을 보지 않고도 통과/실패를 말할 수 있는 관찰 가능한 조건입니다.
나쁜 기준: “더 깔끔하게”, “프로답게”, “버그 없게.” 나은 기준: 명령 출력, 파일 목록, 숫자 대조, 체크리스트.
예시입니다.
- 코드: 지정 테스트가 통과하고, diff가 합의 경로 밖을 건드리지 않는다.
- 문서: 제목 3개와 각 3불릿, 출처 URL이 본문에 남아 있다.
- 데이터: 행 수가 원본과 같고, 수식 열은 샘플 3행이 손계산과 맞는다.
- 커뮤니케이션: 수신자·목적·기한이 초안 첫 줄에 있고, 추측 숫자는
[확인 필요]로 표시한다.
기준은 지시 안에 적습니다. 끝난 뒤에 “내가 원했던 건 이게 아닌데”는 검색창 습관입니다. 에이전트에게 “끝났으면 기준 대비 표로 자술하라”고 하면 검수가 빨라집니다. 자술이 틀릴 수 있으니 표는 힌트이고, 근거는 테스트와 diff입니다.
시간 예산도 기준입니다. “30분 안에 재현만. 패치는 제안만.”처럼 멈추는 선을 주면, 에이전트가 리팩터로 미끄러지는 경우가 줄어듭니다.
실패 시 어떻게 고치나?
한 줄 답: 같은 목표를 유지한 채 범위를 줄이거나 입력을 보강하고, 추측으로 권한을 넓히지 않습니다.
실패는 대개 세 종류입니다.
- 범위 과다: 반 레포를 열었습니다. 경로를 한 패키지로 줄이고, 읽기 전용으로 다시 조사합니다.
- 입력 부족: 재현이 안 됩니다. 로그·명령·화면을 붙이고 “추측하지 말고 재현 실패를 보고”라고 적습니다.
- 기준 모호: 문장은 유려하고 검증이 없습니다. 기준을 명령이나 표 항목으로 바꿉니다.
고칠 때 피합니다.
- 실패한 세션에 비밀·sudo를 바로 추가하기.
- “그냥 다 고쳐”로 목표를 갈아엎기.
- 출력을 안 읽고 새 창에서 같은 질문을 다시 던지기.
짧은 복구 루프입니다. (1) 마지막 출력에서 실제 막힌 한 줄을 고른다. (2) 그 줄만 목표로 다시 쓴다. (3) 통과하면 원래 기준의 다음 항목으로 간다. 패치가 반복해서 어긋나면 재현만 에이전트에 두고 패치는 사람이 씁니다.
전환이 된 느낌은 새 도구를 켰을 때가 아닙니다. 검색 문장을 쓰기 전에 목표·범위·기준이 먼저 적힐 때입니다. 그다음 슬라이드·시트처럼 산출물이 다른 일로 옮기면 됩니다.
출처
- 시리즈 S03 역할 분담(검색 / 에이전트 / 사람)을 지시 문장으로 옮긴 실습입니다.
- 실행 환경이 Orca라면 worktree 격리는 Worktrees를 참고합니다.
📌 Short answer first
Moving from AI search to agents is a change in sentence shape, not a new subscription. “What is this?” is search. “In these paths, stop when this check passes” is an agent instruction. This note only covers splitting a question into a work unit, writing a success check, and repairing a failed run.
No prices or model rankings. The same skeleton works in any chat or agent window.
How do you turn a question into a job?
One-line answer: Replace the topic noun with a goal verb, then pack target, bans, and artifact into one block.
Search sentences center a noun: “OAuth refresh tokens,” “pivot tables,” “this quarter’s results.” Agent sentences center a verb: “reproduce and minimal-patch,” “normalize columns and draft a pivot,” “table the number sources.”
Conversion checks:
- One-sentence goal: what is different when you stop. “The flaky login test passes locally and stays stable.”
- Scope: paths it may read or edit. Everything else is banned.
- Inputs: logs, issue id, repro command, files not to touch.
- Artifact: which of diff, table, slide outline, or PR draft it must show.
- Bans: repo-wide formatter, dependency upgrades, remote push, filling secrets from a guess.
Search: “Why doesn’t the React Query cache clear?” Job: “Read only src/queries, reproduce leftover cache on logout, then propose one test and a minimal patch. Do not change the public API in src/auth.”
Do not mix research and edits in one window. Take candidates in a read-only pass; open a write session only after you agree. In an ADE you can pin that habit to disk by splitting research and patch across worktrees.
What counts as success?
One-line answer: An observable condition a person can call pass or fail without watching the window.
Weak: “cleaner,” “more professional,” “no bugs.” Better: a command’s output, a file list, a number check, a checklist.
Examples:
- Code: named tests pass; the diff stays inside agreed paths.
- Docs: three headings, three bullets each, source URLs still in the body.
- Data: row count matches the source; a formula column matches a hand calc on three sample rows.
- Comms: recipient, purpose, and deadline sit on the first line; guessed numbers are marked
[needs check].
Write the check inside the instruction. Discovering “that wasn’t what I wanted” after the fact is the search habit. Ask the agent to self-report against the check in a table; treat the table as a hint and the tests and diff as evidence.
A time box is also a check. “Reproduce only in 30 minutes. Patch is a proposal.” stops the slide into an unsolicited refactor.
How do you repair a failed run?
One-line answer: Keep the same goal, shrink scope or add inputs, and do not widen permission from a guess.
Failures usually come in three kinds:
- Scope too wide: it opened half the repo. Cut to one package and re-investigate read-only.
- Missing input: it cannot reproduce. Attach the log, command, or screenshot and say “do not guess; report a failed repro.”
- Vague check: fluent prose, no verification. Rewrite the check as a command or table row.
Avoid:
- Adding secrets or sudo to a session that just failed.
- Replacing the goal with “just fix everything.”
- Opening a new window with the same question without reading the output.
A short repair loop: (1) pick the one line in the last output that actually blocked, (2) rewrite that line as the goal, (3) when it passes, take the next item on the original check. If patches keep missing, leave only the repro with the agent and write the patch yourself.
The conversion has stuck when goal, scope, and check are written before the search sentence. Then you can move the same skeleton onto slides, sheets, and other artifacts.
Sources
- Practice version of the S03 role split (search / agent / human) as instruction text.
- If the runtime is Orca, worktree isolation: Worktrees
'AI 에이전트 관련' 카테고리의 다른 글
| GPT-6 Astra란 무엇인가 — 컴퓨터 사용 에이전트와 Critical 사이버 등급 (0) | 2026.09.27 |
|---|---|
| Claude Opus 5.5란 무엇인가 — 에이전트 코딩에서 Opus 5와 뭐가 다른가 (0) | 2026.09.26 |
| Cursor MCP 연결 실패, 서버가 안 보일 때 무엇을 보나 (0) | 2026.09.23 |
| Orca CLI로 worktree·에이전트 병렬 돌리기 (0) | 2026.09.23 |
| 에이전트를 실무에 어떻게 쓸까, 개요 (0) | 2026.09.23 |
