동적 워크플로우 —
에이전트를 규모로 돌리기

계획을 코드로 옮기는 것

B-4에서 서브에이전트로 조사를 위임해봤습니다. 그런데 파일 300개를 같은 기준으로 훑어야 한다면, 누구에게 무엇을 시킬지 매 턴 Claude가 정하는 방식으로는 감당이 안 됩니다. 결과가 쌓이면서 문맥이 먼저 찹니다.

동적 워크플로우는 그 계획을 자바스크립트 스크립트로 옮긴 것입니다. 스크립트는 Claude가 써 주고, 실행은 별도 런타임이 백그라운드에서 맡습니다. 도는 동안 내 세션은 그대로 쓸 수 있습니다.

규모만 늘리는 장치는 아닙니다. 계획이 코드라서 품질 패턴을 반복해서 걸 수 있습니다 — 찾은 것을 다른 에이전트가 반박해 보게 한 뒤 살아남은 것만 보고하거나, 계획을 여러 각도로 초안내고 서로 견주게 하는 식입니다.

서브에이전트 · 스킬 · 팀과 무엇이 다른가

넷 다 여러 단계를 돌릴 수 있습니다. 갈리는 지점은 하나입니다 — 다음에 무엇을 돌릴지 누가 정하는가.

스킬은 이 표에서 서브에이전트와 같은 칸입니다 — 계획을 쥔 쪽이 여전히 Claude이고 결과도 같은 문맥에 쌓입니다. 다른 것은 재사용되는 것이 일꾼 정의가 아니라 지시문이라는 점뿐입니다.

기본 제공 워크플로우 돌려보기

제일 빠른 체험은 기본 탑재된 /deep-research입니다. 여러 각도로 웹 검색을 펼치고, 찾은 출처를 서로 교차 검증한 뒤, 인용이 붙은 보고서 하나로 돌려줍니다.

/deep-research 사내 규정상 문서 보관 기간을 3년에서 5년으로 늘리면 무엇이 달라지나

진행 화면에서 쓰는 키

내 일을 워크플로우로 돌리기

세션 설정을 바꾸지 않고 이번 요청만 워크플로우로 돌리려면 프롬프트에 ultracode를 넣습니다. "워크플로우로 해줘"처럼 우리말로 부탁해도 같습니다.

ultracode: src/routes/ 아래 모든 라우트 핸들러에서 인증 검사가 빠진 곳을 감사하고, 보고하기 전에 각 지적을 다른 에이전트가 반박해 보게 해줘

자주 쓰는 모양은 이렇습니다. 스크립트는 내가 쓰지 않습니다 — 무엇을 어떻게 나눌지만 말합니다.

세션 전체를 맡기려면

매번 키워드를 넣는 대신, 세션의 노력 수준을 올려두면 Claude가 알아서 판단합니다.

/effort ultracode

켜 두면 요청 하나가 여러 워크플로우로 이어지기도 합니다 — 코드를 파악하는 것 하나, 고치는 것 하나, 검증하는 것 하나. 그만큼 토큰과 시간을 더 씁니다. 일상 작업으로 돌아올 때는 /effort high로 내립니다. 세션을 새로 열면 자동으로 풀립니다.

잘 돈 실행을 명령으로 남기기

브랜치마다 도는 리뷰처럼 반복할 절차라면, 잘 돈 실행의 스크립트를 명령으로 저장합니다. /workflows에서 그 실행을 고르고 s를 누릅니다.

저장하면 다음 세션부터 /이름으로 부를 수 있고, / 자동완성에도 뜹니다. 같은 이름이 양쪽에 있으면 프로젝트 쪽이 이깁니다.

입력을 받는 워크플로우

저장한 워크플로우는 호출할 때 값을 받을 수 있습니다. 스크립트 안에서 args라는 이름으로 읽힙니다.

/triage-issues 1024, 1025, 1030번 이슈로 돌려줘

저장된 스크립트는 이렇게 생겼습니다

손으로 고칠 일은 거의 없지만, Claude가 뭘 짰는지 읽을 수는 있어야 합니다.

export const meta = {
  name: 'audit-routes',
  description: 'Audit every route handler for missing auth checks',
}

const found = await agent('List every .ts file under src/routes/.', {
  schema: { type: 'object', required: ['files'],
            properties: { files: { type: 'array', items: { type: 'string' } } } },
})

const audits = await pipeline(found.files, file =>
  agent(`Audit ${file} for missing authentication checks.`, { label: file }),
)

return audits.filter(Boolean)

먼저 알고 시작할 것

런타임이 걸어 둔 제약이 있습니다. 이걸 모르면 왜 안 되지에서 시간을 씁니다.

비용 — 한 번에 크게 돌리지 않습니다

에이전트를 많이 띄우니 같은 일을 대화로 하는 것보다 토큰을 훨씬 많이 씁니다. 전체 저장소 대신 디렉터리 하나로, 넓은 질문 대신 좁은 질문으로 먼저 재보세요. /workflows에서 에이전트별 토큰이 실시간으로 보이고, 거기서 언제든 멈출 수 있습니다.

규모를 미리 정해두기

Claude가 스크립트를 쓸 때 몇 개를 목표로 할지 알려줄 수 있습니다. 상한이 아니라 조언이라, 프롬프트가 다른 규모를 요구하면 그쪽을 따릅니다.

/config workflowSizeGuideline=small

멈췄다 이어받을 때

중지한 실행은 이어받을 수 있지만, 규칙이 조금 얄궂습니다.

• 멈출 때 돌고 있던 에이전트는 저장되지 않아 처음부터 다시 돕니다
• 재생은 시작한 순서를 따릅니다 — 못 끝낸 에이전트 뒤에 시작한 것은 다 다시 돕니다
• 그래서 긴 에이전트 하나보다 작은 에이전트 여럿이 진척을 더 많이 지킵니다
• 이어받기는 같은 세션 안에서만 됩니다. Claude Code를 끄면 다음 세션은 처음부터입니다

끄기

안 쓸 거면 세 가지 방법이 있습니다. 끄면 기본 워크플로우 명령이 사라지고 ultracode 키워드도 동작하지 않습니다.

# 1) 설정 화면에서 — Dynamic workflows 끄기
/config

# 2) ~/.claude/settings.json
{ "disableWorkflows": true }

# 3) 환경변수 (시작할 때 읽습니다)
CLAUDE_CODE_DISABLE_WORKFLOWS=1

• /deep-research를 한 번 돌려 보고서를 받아봤다
• /workflows에서 단계와 에이전트를 열어봤다
• 내 일에 ultracode를 붙여 워크플로우로 돌려봤다
• 잘 돈 실행을 s로 저장해 /이름으로 다시 불러봤다
• 대화·서브에이전트로 충분한 일과 워크플로우가 필요한 일을 구분할 수 있다