Skip to content

2-Day Intensive Workshop

A condensed, hands-on workshop format for teaching the FCC Agent Team Framework to professionals, graduate students, or teams adopting FCC for the first time.

Workshop Overview

  • Duration: 2 days (8 hours per day, 16 hours total)
  • Format: Lectures (30%), hands-on labs (50%), discussion (20%)
  • Audience: Software engineers, data scientists, technical leads
  • Prerequisites: Python 3.10+, basic Git, laptop with FCC installed
  • Max participants: 25 (for effective lab support)

Pre-Workshop Preparation

Participants should complete before attending:

  1. Install FCC following GETTING_STARTED.md
  2. Run make test to verify installation
  3. Read Guidebook Ch. 1: Introduction (15 min)
  4. Complete Notebook 01_fcc_fundamentals.ipynb (30 min)

Day 1: Foundations and Core Concepts

Session 1: Welcome and FCC Overview (9:00 - 10:30)

Lecture (45 min): - What is FCC and why it matters - The Find-Create-Critique cycle - Architecture overview (refer to ARCHITECTURE_VISUAL_GUIDE.md) - Live demo of the web frontend

Lab (45 min): - Verify installations - Run first persona query - Run mock simulation - Explore the React frontend

Break (10:30 - 10:45)

Session 2: Personas and R.I.S.C.E.A.R. (10:45 - 12:15)

Lecture (30 min): - 10-component R.I.S.C.E.A.R. specification - 102 personas across 20 categories - Champion architecture and orchestration

Lab (60 min): - Work through Notebook 03_persona_exploration.ipynb - Query personas by category - Inspect R.I.S.C.E.A.R. specs for 5 personas - Use Streamlit persona_explorer.py

Lunch (12:15 - 13:15)

Session 3: Workflows and Actions (13:15 - 14:45)

Lecture (30 min): - 7 workflow graph variants - 6 action types and 312 action definitions - Action engine execution model

Lab (60 min): - Work through Notebook 07_action_engine.ipynb - Visualize workflow graphs - Execute workflow actions - Design a simple custom workflow

Break (14:45 - 15:00)

Session 4: Event Bus and Observability (15:00 - 16:30)

Lecture (30 min): - Event bus architecture (81 event types) - Pub/sub patterns, filtering, serialization - Observability: tracing and metrics

Lab (60 min): - Work through Notebook 05_event_bus_observability.ipynb - Subscribe to simulation events - Set up tracing with console exporter - Record and query metrics

Session 5: Day 1 Wrap-Up and Discussion (16:30 - 17:00)

  • Q&A session
  • Preview of Day 2 topics
  • Optional: Start Notebook 06_collaboration_engine.ipynb

Day 2: Advanced Topics and Integration

Session 6: Collaboration and Governance (9:00 - 10:30)

Lecture (30 min): - Collaboration engine: sessions, turns, gates - Governance: constitutions, quality gates, tags - 3-tier constitution system

Lab (60 min): - Work through Notebook 06_collaboration_engine.ipynb - Create a collaboration session with scoring - Set up approval gates - Review constitution entries

Break (10:30 - 10:45)

Session 7: Plugin System (10:45 - 12:00)

Lecture (20 min): - 10 plugin types - Plugin lifecycle and dependency resolution - Event subscriber plugins

Lab (55 min): - Work through Notebook 04_plugin_system.ipynb - Build a custom scorer plugin - Register and activate the plugin - Integrate with the event bus

Lunch (12:00 - 13:00)

Session 8: Knowledge Graphs and Search (13:00 - 14:30)

Lecture (30 min): - Knowledge graph structure (9 node types, 9 edge types) - Semantic search and embedding providers - RAG pipeline with 6 chunking strategies

Lab (60 min): - Work through Notebook 16_knowledge_graphs.ipynb - Build a knowledge graph from the persona registry - Query the graph - Set up a basic RAG pipeline

Break (14:30 - 14:45)

Session 9: Integration Challenge (14:45 - 16:15)

Mini-project (90 min): Participants work in teams of 2-3 to build a small FCC deployment:

  1. Define 2 custom personas with R.I.S.C.E.A.R. specs
  2. Create a 6-node workflow graph
  3. Run a simulation using the custom personas
  4. Subscribe to events and record metrics
  5. Build a knowledge graph from the results

Teams present their results in 5-minute lightning talks.

Session 10: Workshop Wrap-Up (16:15 - 17:00)

  • Team presentations (lightning talks)
  • Full Q&A session
  • Resources for continued learning
  • Feedback survey

Materials Provided

Material Format When
Workshop slides PDF Pre-workshop
FCC installation guide Markdown Pre-workshop
Lab exercise sheets Markdown Each session
Code templates for Day 2 project Python Session 9
Certificate of completion PDF Post-workshop

After the workshop, participants should:

  1. Complete remaining notebooks (08-18) at their own pace
  2. Work through the FCC Guidebook for deeper understanding
  3. Read Book 2: Building with FCC for production patterns
  4. Try the 12-week curriculum labs they did not cover