프롬프트(Prompt)를 쓰는 사람은 AI에게 일을 의뢰합니다.

에이전트(Agent) 개발자는 AI에게 역할을 부여합니다.

그래프 아키텍트(Graph Architect)는 여러 에이전트가 협업하는 메커니즘을 설계합니다.

지난번에는 Graph Engineering의 실천 패턴으로서 다음 내용을 해설했습니다.

• Node Contract
• Edge Contract
• Failure Isolation
• Adversarial Verification
• Judge Pattern
• Loop until Dry
• Model Tiering
• Topology Design
• Observability

이번에는 이러한 사고방식을 Claude Code에서 어떻게 구현하는지 해설합니다.

Claude Code에서는 다음 기능들을 조합함으로써 재사용 가능한 AI 워크플로우(Workflow)를 구축할 수 있습니다.

• Subagents
• Skills
• Hooks
• CLAUDE.md
• MCP
• Agent SDK
• GitHub Actions

먼저 용어를 정리하겠습니다.

「Dynamic Workflows」는 복잡한 태스크(Task)에 따라 AI가 처리를 분해하고, 여러 에이전트나 도구를 조합하여 실행하는 사고방식으로 사용됩니다.

예를 들어, 코드 감사를 수행하는 경우 다음과 같은 처리를 생각할 수 있습니다.

감사 대상을 특정한다
↓
파일별로 조사한다
...

이를 그래프(Graph)로 나타내면 다음과 같습니다.

본질은 Claude Code의 기능을 조합하여 다음을 실현하는 것입니다.

역할을 나눈다
처리를 재사용한다
필요한 처리를 자동 실행한다
...

Claude Code는 Anthropic이 제공하는 에이전트(Agent)형 개발 도구입니다.

단순히 코드를 생성하는 것만이 아닙니다.

Claude Code는 프로젝트 내의 파일을 읽고, 코드를 편집하며, 명령어를 실행하고, 테스트나 Git 등의 개발 도구와 연동할 수 있습니다.

사용자의 지시
↓
코드베이스를 조사
...

즉, Claude Code 자체가 이미 기본적인 에이전트 루프(Agent Loop)를 가지고 있습니다.

모든 것을 Claude의 대화만으로 처리하는 것은 아닙니다.

AI의 판단과 일반적인 코드에 의한 제어를 조합하는 것이 중요합니다.

Subagent는 특정 업무를 담당하는 전용 에이전트(Agent)입니다.

메인 Claude와는 별도의 컨텍스트(Context)에서 동작하며, 지정된 역할, 도구, 모델, 지시에 기반하여 처리합니다.

예를 들어, 다음과 같은 Subagent를 만들 수 있습니다.

security-reviewer
test-runner
researcher
...

메인 에이전트 (Main Agent)
│
├── Security Agent
...

.claude/
└── agents/
├── security-reviewer.md
...

---
name: security-reviewer
description: 소스 코드의 보안 문제를 조사한다
...

Skill은 재사용 가능한 절차나 전문 지식을 Claude Code에 추가하는 메커니즘입니다.

Subagent
＝누가 담당할 것인가
Skill
...

.claude/
└── skills/
└── security-audit/
...

---
name: security-audit
description: Web 애플리케이션의 루트를 대상으로 인증·인가 누락을 감사한다
...

CLAUDE.md는 프로젝트 전체에 공통되는 지시 사항을 작성하는 파일입니다.

# Project Instructions
## Architecture
- 프론트엔드는 Next.js
...

Hooks는 Claude Code의 특정 타이밍에 명령어 나 처리를 확실하게 실행하는 메커니즘입니다.

파일 편집
↓
Hook 발화
...

{
"hooks": {
"PostToolUse": [
...

MCP는 Claude Code와 외부 도구 또는 데이터 소스를 연결하기 위한 메커니즘입니다.

if (classification.severity === "high") {
await runFullSecurityAudit();
} else {
...

AI의 역할은 리스크를 판단하는 것입니다.

코드의 역할은 정해진 경로를 확실하게 실행하는 것입니다.

const results = await Promise.all(
routes.map((route) => auditRoute(route))
);

Agent A ─┐
Agent B ─┼→ 전체 완료 대기 → 통합
Agent C ─┘

File A: 조사 → 검증 → 저장
File B: 조사 → 검증 → 저장
File C: 조사 → 검증 → 저장

async function safeRun(task) {
try {
return await task();
...

Agent A → Worktree A → Branch A
Agent B → Worktree B → Branch B
Agent C → Worktree C → Branch C

Claude Agent SDK를 사용하면, Claude Code의 Agent 기능을 프로그램으로부터 이용할 수 있습니다.

type Finding = {
file: string;
line: number;
...

type WorkflowState = {
workflowId: string;
phase:
...

.claude/
├── agents/
│ ├── security-reviewer.md
...

• 문제 이해

• 태스크 분해

• 가설 생성

• 설계 판단

• 리뷰

• 반증

• 최종적인 문서화

• 병렬 실행 제어

• 조건 분기

• 중복 제거

• 타입 검증

• Retry 횟수

• Timeout

• 비용 상한

• 상태 저장

• 로그

• 권한 제어

Claude Code에서 Graph Engineering을 실천하기 위한 핵심 기능은 다음과 같습니다.

• Subagents
• Skills
• CLAUDE.md
• Hooks
• MCP
• Agent SDK
• GitHub Actions

Claude Code의 가치는 코드를 빠르게 작성할 수 있다는 점에만 있지 않습니다.

AI Agent를 부품으로서 조합하여, 재사용 가능한 개발 조직을 코드베이스 안에 구축할 수 있다는 점

에 있습니다.

다음 회차에서는 주요 Agent 개발 기반을 비교합니다.

• 제1회: Prompt Engineering에서 Agent Engineering으로
• 제2회: Graph Engineering 입문
• 제3회: Graph Engineering 실전
  제4회: Claude Code로 실천하는 Dynamic Workflows (이 기사)
• 제5회: OpenAI Agents SDK · LangGraph · Google ADK 비교