Tutorial Overview

Welcome to the goflow tutorial! This tutorial teaches you goflow features progressively, building on concepts from previous sections.

---

Learning Path

Each tutorial builds on the previous one:

#	Tutorial	What You'll Learn
1	Adding Inputs	Make workflows configurable with runtime parameters
2	Multi-Step Pipelines	Chain steps and pass data between them
3	Parallel Execution	Run multiple steps simultaneously
4	Conditional Logic	Branch based on step outputs
5	Agent Files	Organize agents in reusable .agent.md files

---

Prerequisites

Before starting this tutorial, you should:

• [x] Have goflow installed (Installation)
• [x] Understand the basic workflow structure (Your First Workflow)
• [x] Know how to run workflows with goflow run

---

Tutorial Style

Each tutorial follows this pattern:

1. Goal — What we're building
2. Code — Complete working examples
3. Explanation — Line-by-line breakdown
4. Try It — Commands to run
5. What You Learned — Key takeaways
6. Next Steps — What to explore next

All examples are designed to work in both mock mode and real mode, so you can follow along without needing Copilot CLI.

---

Quick Reference

As you learn, these reference pages will be helpful:

• Workflow YAML Schema — Complete field reference
• Template Variables — {{inputs.X}} and {{steps.Y.output}} syntax
• CLI Reference — All command-line options

---

Getting Help

If you get stuck:

1. Check the error message — goflow provides detailed validation errors
2. Use --verbose — See tool calls and session lifecycle
3. Use --stream — See LLM output as it generates
4. Check the audit trail — .workflow-runs/ contains the exact prompts and outputs
5. Visit Troubleshooting — Common issues and solutions

---

Let's Begin!

Start with the first tutorial: Adding Inputs