euleragent Pattern Tutorial Series

This series provides a step-by-step guide for developers ranging from beginners to advanced users of euleragent's Pattern system. Each tutorial can be read independently, but following them in order is most effective.

Prerequisites

Before starting this series, you should have the following completed.

Required: Completion of docs/tutorials/basic/01_getting_started.md
euleragent installed and euleragent doctor passing
Experience creating a basic agent (euleragent init, euleragent agent new)
Understanding of basic YAML syntax

Quick environment check:

euleragent --version
euleragent doctor
euleragent pattern list

Tutorial List

No.	File	Title	Level	Duration
01	01_concepts.md	What is a Pattern? — Concepts and Architecture	Intro	30 min
02	02_builtin_patterns.md	Built-in Pattern Execution Playbook — Complete Guide to 4 Patterns	Beginner	60 min
03	03_simple_linear.md	Your First Custom Pattern — Simple Linear Pipeline	Beginner	45 min
04	04_judge_and_loop.md	Judge Node and Quality Loop — Iterate Until Satisfied	Intermediate	60 min
05	05_web_research.md	Web Research Integration — force_tool and HITL Gating	Intermediate	60 min
06	06_human_gate.md	Explicit Human Review Gate — A Node That Requires Human Verification	Intermediate	45 min
07	07_multi_route.md	Multi-Route Judge — Handling 3 or More Routes	Advanced	60 min
08	08_airgap_and_ops.md	Airgap Patterns and Ops Design — Web Blocking + Policy Compliance	Advanced	60 min
09	09_advanced_patterns.md	Advanced Patterns — Dual Judge, Complex Topology, Deployment	Advanced	90 min
10	10_reference.md	Complete Reference — Fields, Error Codes, Design Checklist	Reference	Ongoing

Recommended Learning Paths

Beginner Path (First time with patterns)

01_concepts → 02_builtin_patterns → 03_simple_linear

A flow that starts with understanding concepts, then running built-in patterns hands-on, and finally creating your first custom pattern.

Intermediate Path (After basic pattern experience)

03_simple_linear → 04_judge_and_loop → 05_web_research → 06_human_gate

A flow that starts from custom patterns and progressively adds quality loops, web search, and human review gates.

Advanced Path (Complex workflow design)

07_multi_route → 08_airgap_and_ops → 09_advanced_patterns → 10_reference

A flow for designing enterprise-level patterns with complex routing and security requirements.

Using the Reference

10_reference.md is not a tutorial but a reference guide. Open it anytime you encounter an error code or want to know the meaning of a specific field.

Tutorial Structure

All tutorials follow this structure.

Learning Objectives: What you will be able to do after completing this tutorial
Prerequisites: Required environment, files, and prior tutorials
Step-by-Step Hands-on: Steps you can follow by copy-pasting
Expected Output: Actual output examples for each command
Key Concept Explanations: Core theory for the tutorial
Common Errors and Solutions: Frequently occurring issues and how to resolve them
Practice Exercises: Extension exercises to try on your own

Built-in Pattern Quick Reference

# Check built-in pattern list
euleragent pattern list

# Check specific pattern structure
euleragent pattern show report.evidence
euleragent pattern show code.tdd
euleragent pattern show ops.triage
euleragent pattern show research.broad_to_narrow

# Validate a pattern
euleragent pattern validate report.evidence

# Compile a pattern (IR JSON output)
euleragent pattern compile report.evidence

Pattern ID	Category	Description
`report.evidence`	research	Evidence-based report writing (web search -> draft -> evaluation)
`code.tdd`	code	Test-driven development (design -> write tests -> implement -> verify)
`ops.triage`	ops	Operations ticket triage and resolution draft
`research.broad_to_narrow`	research	Research that narrows from broad investigation to deep analysis

When You Need Help

# Check error codes (see 10_reference.md)
euleragent pattern validate my_pattern.yaml --format json

# Dump pattern structure
euleragent pattern show my_pattern.yaml

# IR analysis
euleragent pattern compile my_pattern.yaml

# Full CLI help
euleragent pattern --help
euleragent pattern run --help
euleragent pattern resume --help

If the issue is not resolved, check the error code table in 10_reference.md, or re-diagnose your environment with euleragent doctor.