Skip to content

FCC Tutorials

Learn the FCC Agent Team Framework through progressive, hands-on tutorials organized into three tracks. Each track builds on the previous one, taking you from foundational concepts through production-ready customization.

Track 1: Fundamentals

Start here. These five tutorials cover everything you need to understand FCC and run your first simulation.

# Tutorial Duration What You Learn
1 What is FCC? 30 min Problem statement, solution approach, the three phases
2 Understanding Personas 45 min PersonaSpec, R.I.S.C.E.A.R., 5 categories, reading YAML
3 The FCC Cycle 45 min Find/Create/Critique in depth, feedback edges, quality gates
4 Your First Simulation 30 min Install, load registry, run GEN-001, examine traces
5 Reading Results 30 min Trace JSON structure, message history, coverage analysis

Prerequisites: Python 3.10+, basic command-line familiarity.

Track 2: Building Workflows

Once you understand the fundamentals, these six tutorials teach you to design and operate multi-persona workflows.

# Tutorial Duration What You Learn
6 Your First Workflow 30 min Load base graph, understand nodes/edges, BFS traversal
7 Multi-Persona Pipelines 45 min Extended 20-node graph, integration/governance/stakeholders
8 Champion Orchestration 30 min Champion personas, orchestration edges, team coordination
9 Feedback Loops 30 min Critique-to-Find/Create feedback, loop termination, thresholds
10 Persona Interactions 45 min Cross-reference matrix, 5 relationship types, querying interactions
11 Governance & Champion Patterns 45 min Governance pipeline, champion-of vs handoff, cross-champion workflow

Prerequisites: Completed Track 1 or equivalent understanding.

Track 3: Customization

These six tutorials cover extending FCC to match your specific project needs.

# Tutorial Duration What You Learn
12 Custom Personas 45 min Write YAML, register, validate, add to workflow
13 Custom Templates 30 min Jinja2 template system, variables, DocGenerator integration
14 Custom Quality Gates 30 min Gate YAML format, severity levels, custom validation rules
15 Custom Scenarios 30 min Scenario JSON format, validation rules, running scenarios
16 Interaction Cookbook 45 min 12 recipes for cross-reference patterns
17 Cross-Reference Validation 30 min Quality gates, scenario validation, CI automation

Prerequisites: Completed Track 2 or equivalent understanding.

Suggested Learning Paths

"I need to evaluate FCC" (2 hours)

Complete tutorials 1-3 from Track 1 to understand the framework's value proposition and architecture.

"I need to run FCC" (4 hours)

Complete all of Track 1 plus tutorial 6 from Track 2. This gives you enough to run simulations and interpret results.

"I need to customize FCC" (7 hours)

Complete all three tracks in order. By the end, you can create custom personas, templates, quality gates, and scenarios.