euleragent 패턴 튜토리얼 시리즈

이 시리즈는 euleragent의 패턴(Pattern) 시스템을 처음 접하는 개발자부터 고급 사용자까지 단계적으로 안내합니다. 각 튜토리얼은 독립적으로 읽을 수 있지만, 순서대로 진행하면 가장 효과적입니다.

사전 조건

이 시리즈를 시작하기 전에 다음이 완료되어 있어야 합니다.

필수: docs/tutorials/basic/01_getting_started.md 완료
euleragent 설치 및 euleragent doctor 통과
기본 에이전트 생성 경험 (euleragent init, euleragent agent new)
YAML 기본 문법 이해

빠른 환경 확인:

euleragent --version
euleragent doctor
euleragent pattern list

튜토리얼 목록

번호	파일	제목	난이도	소요 시간
01	01_concepts.md	패턴이란 무엇인가? — 개념과 아키텍처	입문	30분
02	02_builtin_patterns.md	내장 패턴 실행 플레이북 — 4가지 패턴 완전 가이드	초급	60분
03	03_simple_linear.md	첫 번째 커스텀 패턴 — 단순 선형 파이프라인	초급	45분
04	04_judge_and_loop.md	Judge 노드와 품질 루프 — 만족스러울 때까지 반복하기	중급	60분
05	05_web_research.md	웹 리서치 통합 — force_tool과 HITL 게이팅	중급	60분
06	06_human_gate.md	명시적 인간 검토 게이트 — 반드시 사람이 확인하는 노드	중급	45분
07	07_multi_route.md	다중 경로 Judge — 3개 이상의 루트 처리	고급	60분
08	08_airgap_and_ops.md	에어갭 패턴과 Ops 설계 — 웹 차단 + 정책 준수	고급	60분
09	09_advanced_patterns.md	고급 패턴 — 이중 Judge, 복합 토폴로지, 배포	고급	90분
10	10_reference.md	완전 레퍼런스 — 필드, 에러 코드, 설계 체크리스트	참고서	상시 참조

권장 학습 경로

초보자 경로 (처음 패턴을 접하는 경우)

01_concepts → 02_builtin_patterns → 03_simple_linear

개념을 먼저 이해하고, 내장 패턴을 직접 실행해본 뒤, 첫 번째 커스텀 패턴을 만들어보는 흐름입니다.

중급자 경로 (기본 패턴 경험 후)

03_simple_linear → 04_judge_and_loop → 05_web_research → 06_human_gate

커스텀 패턴에서 출발해 품질 루프, 웹 검색, 인간 검토 게이트를 순서대로 추가하는 흐름입니다.

고급자 경로 (복잡한 워크플로우 설계)

07_multi_route → 08_airgap_and_ops → 09_advanced_patterns → 10_reference

복잡한 라우팅과 보안 요구사항을 갖춘 엔터프라이즈 수준의 패턴을 설계하는 흐름입니다.

레퍼런스 활용

10_reference.md는 튜토리얼이 아닌 참고서입니다. 에러 코드가 발생하거나, 특정 필드의 의미가 궁금할 때 언제든 펼쳐보세요.

각 튜토리얼 구성

모든 튜토리얼은 다음 구조를 따릅니다.

학습 목표: 이 튜토리얼을 마치면 무엇을 할 수 있는가
사전 준비: 필요한 환경, 파일, 선행 튜토리얼
단계별 실습: 복사-붙여넣기로 따라할 수 있는 단계
예상 출력: 각 명령어의 실제 출력 예시
주요 개념 설명: 해당 튜토리얼의 핵심 이론
흔한 오류와 해결법: 자주 발생하는 문제와 해결 방법
실습 과제: 스스로 도전해볼 확장 과제

내장 패턴 빠른 참조

# 내장 패턴 목록 확인
euleragent pattern list

# 특정 패턴 구조 확인
euleragent pattern show report.evidence
euleragent pattern show code.tdd
euleragent pattern show ops.triage
euleragent pattern show research.broad_to_narrow

# 패턴 검증
euleragent pattern validate report.evidence

# 패턴 컴파일 (IR JSON 출력)
euleragent pattern compile report.evidence

패턴 ID	카테고리	설명
`report.evidence`	research	증거 기반 보고서 작성 (웹 검색 → 초안 → 평가)
`code.tdd`	code	테스트 주도 개발 (설계 → 테스트 작성 → 구현 → 검증)
`ops.triage`	ops	운영 티켓 분류 및 해결책 초안
`research.broad_to_narrow`	research	광범위 조사에서 심층 분석으로 좁혀가는 연구

도움이 필요할 때

# 에러 코드 확인 (10_reference.md 참조)
euleragent pattern validate my_pattern.yaml --format json

# 패턴 구조 덤프
euleragent pattern show my_pattern.yaml

# IR 분석
euleragent pattern compile my_pattern.yaml

# 전체 CLI 도움말
euleragent pattern --help
euleragent pattern run --help
euleragent pattern resume --help

문제가 해결되지 않으면 10_reference.md의 에러 코드 테이블을 확인하거나, euleragent doctor로 환경을 다시 진단하세요.