name	README
description	Claude Code 네이티브 오케스트레이션 primitive 7종 실습 예제 모음
date	2026.07.31

이게 뭔가요

Claude Code 는 외부 도구 없이 여러 AI 에이전트를 동시에 돌리고, 대화를 이어가고, 결과를 회수하는 기능을 이미 갖고 있습니다. 이 폴더는 그 기능 7가지를 하나씩, 5분 안에 체험하는 예제 모음입니다.

비유 한 줄

회사에 신입을 여러 명 뽑아 일을 시키는 상황이라고 생각하면 전부 이해됩니다.

폴더	primitive	회사 비유
01_background_agent	background Agent	신입에게 일 시키고 나는 내 일 계속
02_send_message	SendMessage	그 신입에게 "그건 어떻게 됐어?" 추가 지시
03_agent_teams	Agent Teams	신입 3명에게 역할 나눠 동시 진행
04_workflow	Workflow	일하는 순서를 매뉴얼로 못박기
05_task_notification	task-notification	신입이 "다 했습니다" 보고
06_agent_view	Agent View	사무실 전광판으로 전원 상태 보기
07_managed_agents_api	Managed Agents API	신입을 서버에 상주시켜 프로그램이 부리기

어떻게 쓰나요

1. 폴더 하나를 골라 그 안의 README.md 를 엽니다
2. 거기 적힌 "해보기" 문장을 Claude Code 에 그대로 붙여넣습니다
3. 끝

각 폴더는 완전히 독립입니다. 순서대로 안 봐도 되고, 관심 있는 것만 봐도 됩니다.

문서가 두 층입니다

폴더마다 문서가 2개 있습니다. 필요한 깊이만 보세요.

파일	대상	내용
README.md	처음 보는 사람	비유·그림·"해보기" 한 문장. 5분
{이름}.md	실제로 쓸 사람	옵션 전체표 + 예제 모음 + 실수 목록

두 문서는 서로 링크돼 있어 왔다 갔다 할 수 있습니다.

폴더	상세 문서
01	background_agent.md
02	send_message.md
03	agent_teams.md
04	workflow.md
05	task_notification.md
06	agent_view.md
07	managed_agents_api.md

언제 뭘 쓰나 (한 장 요약)

일을 시키고 싶다          → 01 background Agent
그 일에 말을 더 걸고 싶다  → 02 SendMessage
여러 일을 동시에          → 03 Agent Teams
순서를 정확히 지켜야 한다  → 04 Workflow
결과는 어떻게 받나        → 05 task-notification
전체를 눈으로 보고 싶다    → 06 Agent View
CLI 밖(서버)에서 쓰고 싶다 → 07 Managed Agents API

원본 정리 문서

이 예제 모음은 아래 문서를 바탕으로 만들었습니다. 개념 정의·판정 가이드·인접 생태계(MCP Agent Mail 등)까지 담은 정본입니다.

• ClaudeCode_native_primitives.md — Obsidian 볼트 3.Resource/_LLM/Claude/_Harness/ (작성자 로컬 전용 링크)

라이선스

이 저장소는 듀얼 라이선스입니다.

대상	라이선스
코드 — 스크립트·설정·workflow 예제 소스	MIT
문서 — *.md 본문·표·설명 콘텐츠	CC BY 4.0

Copyright (c) 2026 Finfra