Skip to content

Chapter 8: Where to Go Next

Learning Objectives

By the end of this chapter you will be able to:

  1. Choose a learning path based on your role and goals.
  2. Identify which Book 2 and Book 3 chapters are most relevant to your needs.
  3. Find additional resources: notebooks, guidebook labs, Streamlit apps, and community materials.
  4. Understand the FCC roadmap and how to contribute.

The mindmap below groups suggested next-step reading paths by role, so readers can jump directly to the Book 2 and Book 3 chapters most relevant to their goals.

mindmap
  root((Learning Paths))
    The Evaluator
      Book 1 Complete
      Run Mock Simulation
      Book 2 Ch 1 and Ch 8
    The Builder
      Book 2 Full Sequence
      Notebooks 01-12
      Guidebook Labs
    The Architect
      Book 2 Ch 5, 6, 8
      Book 3 Full Sequence
      Federation & Protocols
    Data Scientist / ML Engineer
      Book 2 Ch 1-4
      Book 3 Ch 1, 3, 7
      Notebooks 08-10
    The Contributor
      All of Book 1
      Book 2 Ch 2, 3, 5
      Guidebook + ADRs

Readers unsure which branch applies can default to the Builder path, which covers the broadest ground and is the path the rest of Book 2 assumes as baseline.

Learning Paths by Role

Not everyone needs to read every chapter of every book. Here are recommended paths based on common roles:

Path A: The Evaluator

You are assessing whether FCC is right for your project.

You have just finished Book 1. Before committing further, try these:

  1. Run a simulation using the mock engine (Chapter 7 of this book).
  2. Browse the persona catalog to see if the built-in personas match your domain.
  3. Read Book 2, Chapter 1 (Project Setup) to understand the developer experience.
  4. Read Book 2, Chapter 8 (Production Deployment) to understand the operational model.

If the framework fits, proceed to the full Book 2 sequence.

Path B: The Builder

You want to build applications on top of FCC.

This is the most common path. Read Book 2 from start to finish:

  1. Book 2, Chapter 1: Project Setup -- fcc init, configuration, directory layout.
  2. Book 2, Chapter 2: Custom Personas -- designing and validating R.I.S.C.E.A.R. YAML.
  3. Book 2, Chapter 3: Workflow Design -- constructing custom workflow graphs.
  4. Book 2, Chapter 4: Simulation and Traces -- mock vs. AI engines, budget management.
  5. Book 2, Chapter 5: Plugin Development -- extending FCC with custom plugins.
  6. Book 2, Chapter 6: Event Bus and Observability -- monitoring and metrics.
  7. Book 2, Chapter 7: Collaboration Sessions -- human-in-the-loop workflows.
  8. Book 2, Chapter 8: Production Deployment -- CI/CD, quality gates, monitoring.

Supplement with the corresponding Jupyter notebooks (01--12) as you go.

Path C: The Architect

You need to integrate FCC into a larger system or across multiple projects.

Start with Book 2 (especially Chapters 5, 6, and 8), then move to Book 3:

  1. Book 3, Chapter 1: Semantic Search -- embedding providers and search indices.
  2. Book 3, Chapter 2: Knowledge Graphs -- OWL/RDF/SKOS ontology construction.
  3. Book 3, Chapter 4: Federated Knowledge -- cross-project knowledge graph federation.
  4. Book 3, Chapter 5: Protocol Integration -- A2A, MCP, AGENTS.md at scale.
  5. Book 3, Chapter 6: Cross-Project Orchestration -- AOME, CONSTEL, CTO coordination.
  6. Book 3, Chapter 8: Scaling to Enterprise -- multi-tenant deployment, verticals.

Path D: The Data Scientist / ML Engineer

You want to use FCC for ML lifecycle orchestration.

Focus on the data and ML aspects:

  1. Book 2, Chapters 1--4: Core setup, personas, workflows, simulation.
  2. Book 3, Chapter 1: Semantic Search -- for embedding-based retrieval.
  3. Book 3, Chapter 3: RAG Pipelines -- chunking, retrieval, generation.
  4. Book 3, Chapter 7: Docs from Code -- API documentation generation.
  5. Notebooks 08--10: ML lifecycle, model evaluation, and data engineering notebooks.

Path E: The Contributor

You want to contribute to the FCC framework itself.

  1. Read all of Book 1 (you just did).
  2. Read Book 2, Chapters 2, 3, and 5 (personas, workflows, plugins) to understand extension points.
  3. Read the FCC Guidebook for the full technical reference.
  4. Review the Architecture Decision Records in docs/decisions/ for design rationale.
  5. Run make lint and make test to ensure your environment is set up for contribution.

Notebook Catalog

The 12 companion notebooks provide hands-on practice:

# Notebook Companion To
01 Getting Started Book 1, Chapter 7
02 Persona Explorer Book 1, Chapter 2
03 Workflow Explorer Book 1, Chapter 3
04 Action Engine Book 2, Chapter 3
05 Governance Explorer Book 1, Chapter 4
06 Simulation Deep Dive Book 2, Chapter 4
07 Collaboration Sessions Book 2, Chapter 7
08 Plugin Development Book 2, Chapter 5
09 Event Bus and Observability Book 2, Chapter 6
10 Cross-Reference Matrix Book 1, Chapter 2
11 Object Model Patterns Book 3, Chapter 6
12 Docs-as-Code Generator Book 3, Chapter 7

Guidebook Labs and Assessments

The FCC Guidebook includes 10 lab exercises and assessments that provide structured practice:

  • Labs 1--4: Build a complete FCC workflow from scratch.
  • Labs 5--7: Extend the framework with custom plugins and governance rules.
  • Labs 8--10: Integrate with AOME, CONSTEL, and CTO.
  • Capstone Project: Design and deploy a multi-project FCC orchestration.

Streamlit Apps

Ten interactive Streamlit applications provide visual exploration:

App Purpose
Persona Explorer Browse and filter the persona catalog
Workflow Visualizer Interactive graph rendering
Simulation Runner Execute simulations with visual output
Governance Dashboard Quality gate and constitution status
Collaboration Monitor Live session tracking
5 Production Apps Domain-specific tools for common use cases

The FCC Roadmap

The framework follows a phased development roadmap:

Phase Version Focus
1--10 v0.1.0--v0.5.0 Core framework extraction and stabilization
11 v0.6.0 Object model, notebooks, Streamlit, guidebook
12 v0.7.0 Protocol integration (A2A, MCP, AGENTS.md)
13 v0.8.0 Knowledge federation, semantic search, docs intelligence
14 v0.9.0 Evaluation, compliance, benchmarking
15 v1.0.0--v1.0.1 (current) Platform maturation, multi-tenant, stable API

See STRATEGIC_ARCHITECTURE_REVIEW.md for the full roadmap with deliverables and milestones.

Contributing

The project welcomes contributions. To get started:

  1. Fork the repository on GitHub.
  2. Create a feature branch from main.
  3. Make your changes, ensuring all tests pass (make test) and lint is clean (make lint).
  4. Submit a pull request with a clear description of the change and its motivation.

The project maintains 99%+ test coverage. New code must include tests that maintain this threshold.

Key Takeaways

  • Choose a learning path based on your role: evaluator, builder, architect, data scientist, or contributor.
  • The notebook catalog (12 notebooks) provides hands-on companions to every major topic.
  • The guidebook offers structured labs and assessments for deeper practice.
  • Streamlit apps provide visual alternatives to the CLI.
  • The roadmap has reached v1.0.1, with each phase having added major capabilities.

Cross-References

← Chapter 7: Getting Started | Back to Book 1 Index | Next: Book 2 -- Building with FCC →