Beginner Use Cases¶

This diagram maps a first-time learner to the FCC subsystems they touch when exploring the framework. The beginner persona enters through docs/for-beginners/ and uses mock AI providers so no API keys are required. Core touchpoints are the PersonaRegistry, the SimulationEngine, the WorkflowGraph, and the EventBus. The goal of every beginner task is a short, visible success: run something, see a trace, and understand why.

The diagram below traces the beginner audience-to-subsystem mapping.

graph LR
    A((Beginner))
    UC1[/"Hello FCC"/]
    UC2[/"Visual tour"/]
    UC3[/"Glossary lookup"/]
    UC4[/"FAQ troubleshooting"/]
    UC5[/"First simulation"/]
    UC6[/"Avoid common mistakes"/]
    S1[PersonaRegistry]
    S2[SimulationEngine]
    S3[WorkflowGraph]
    S4[EventBus]
    S5[Mock AI provider]
    A --> UC1
    A --> UC2
    A --> UC3
    A --> UC4
    A --> UC5
    A --> UC6
    UC1 --> S1
    UC1 --> S5
    UC2 --> S3
    UC5 --> S2
    UC5 --> S3
    UC5 --> S4
    UC5 --> S5
    UC6 --> S4

Hello FCC is the smallest possible success: load a packaged persona, run a one-node workflow, and print a mock response. From there the Visual Tour introduces the frontend and Streamlit apps to build an intuition for what a multi-persona run looks like. The Glossary and FAQ are reference surfaces, not runtime paths.

First Simulation is the graduation task. The learner instantiates a full SimulationEngine, steps through a Find-Create-Critique scenario, and watches step events scroll past. The Common Mistakes guide closes the loop by cataloguing the handful of config errors that trip up every new user.

Use-case detail¶

Use case 1 - Hello FCC: User builds a first persona-based agent in five minutes; hits PersonaRegistry.load and the mock provider; guided by docs/for-beginners/hello-fcc.md.
Use case 2 - Visual tour: User opens the frontend and Streamlit apps to browse personas and workflows; guided by docs/for-beginners/visual-tour.md.
Use case 3 - Glossary lookup: User resolves unfamiliar terms across the 30 essential concepts; docs/for-beginners/glossary-essentials.md.
Use case 4 - FAQ troubleshooting: User diagnoses a broken install or missing key; docs/for-beginners/faq.md.
Use case 5 - First simulation: User runs an end-to-end Find-Create-Critique scenario; hits SimulationEngine.run, a WorkflowGraph, and the EventBus; guided by docs/for-beginners/quickstart-first-simulation.md.
Use case 6 - Avoid common mistakes: User learns to inspect events and traces for early warning; docs/for-beginners/common-mistakes.md.

Beginner Use Cases¶

Use-case detail¶

See also¶