FCC Guidebook¶
Welcome to the FCC (Find, Create, Critique) Agent Team Framework Guidebook -- the definitive learning resource for understanding, using, and extending the FCC framework.
Audience¶
This guidebook is written for:
- Software engineers who want to integrate FCC into their AI-agent workflows.
- Architects evaluating persona-driven orchestration patterns.
- Contributors looking to extend the framework with plugins, personas, or custom workflows.
Prior familiarity with Python 3.10+, dataclasses, and basic YAML/JSON is assumed. No prior knowledge of the FCC framework is required; the beginner chapters build understanding from first principles.
Prerequisites¶
| Requirement | Version |
|---|---|
| Python | >= 3.10 |
| pip | latest |
| FCC package | pip install -e . from repo root |
| Optional: OpenTelemetry | pip install opentelemetry-api opentelemetry-sdk |
Chapter Listing¶
Beginner (Chapters 1--4)¶
These chapters introduce the core concepts. Read them in order if you are new to FCC.
| # | Chapter | Time |
|---|---|---|
| 1 | Introduction to the FCC Framework | 15 min |
| 2 | Object Model Patterns | 25 min |
| 3 | The R.I.S.C.E.A.R. Specification | 25 min |
| 4 | Persona Dimensions | 20 min |
Intermediate (Chapters 5--9)¶
These chapters cover the runtime machinery: workflows, plugins, events, collaboration, and governance.
| # | Chapter | Time |
|---|---|---|
| 5 | The Workflow System | 30 min |
| 6 | Plugin Architecture | 25 min |
| 7 | Event Bus and Observability | 25 min |
| 8 | The Collaboration Engine | 30 min |
| 9 | Governance | 25 min |
Advanced (Chapters 10--14)¶
These chapters address production concerns: cross-project integration, case studies, hands-on labs, assessments, and reference appendices.
| # | Chapter | Time |
|---|---|---|
| 10 | Cross-Project Integration | 30 min |
| 11 | Case Studies | 25 min |
| 12 | Hands-On Labs | 120 min |
| 13 | Assessments | 60 min |
| 14 | Appendices | 15 min |
Expert (Chapters 15--24)¶
These chapters cover protocol integration, governance frameworks, knowledge systems, compliance, and the unified object model.
| # | Chapter | Time |
|---|---|---|
| 15 | Protocol Integration | 30 min |
| 16 | JV Governance & Open Science | 30 min |
| 17 | Knowledge Federation | 25 min |
| 18 | Documentation Intelligence | 25 min |
| 19 | Evaluation & Benchmarking | 30 min |
| 20 | Compliance Automation | 30 min |
| 21 | Unified Object Model | 25 min |
| 22 | Ecosystem Orchestration | 25 min |
| 23 | Advanced Messaging | 25 min |
| 24 | Building on FCC | 20 min |
Difficulty Legend¶
- Beginner -- Core concepts and data models. No runtime code required.
- Intermediate -- Runtime systems, plugin mechanics, and event-driven patterns.
- Advanced -- Production integration, cross-plugin orchestration, and ecosystem scaling.
How to Use This Guidebook¶
- Sequential reading. Chapters 1--4 build on each other. Start there.
- Reference jumping. Each chapter lists prerequisites. If you already know the basics, skip ahead to the chapter you need and follow prerequisite links backward as necessary.
- Hands-on notebooks. Many chapters reference companion Jupyter notebooks in
notebooks/. Run them alongside the text for an interactive experience. - Code-first exploration. All models discussed are importable from
fcc.*. Open a REPL and experiment.
Interactive Resources¶
- Jupyter Notebooks --
notebooks/directory. Start with Notebook 01: FCC Fundamentals. - Streamlit Apps --
apps/directory (when available). Visual dashboards for persona browsing and workflow exploration. - CLI Dashboards --
fcc dashboard ecosystem,fcc dashboard personas,fcc dashboard quality,fcc dashboard collab.
Chapter Metadata¶
All chapter metadata (prerequisites, learning outcomes, estimated times) is machine-readable in src/fcc/data/docs/guidebook_chapters.yaml. Tooling can use this file to generate progress trackers, prerequisite graphs, and personalised reading paths.
FCC Guidebook -- INFORMATION COLLECTIVE, LLC -- MIT License