Skip to content

Capability Overview

This page provides a structured summary of what the FCC Agent Team Framework can do, organized by component.

Persona Ecosystem

FCC includes 24 specialized personas across five categories.

Category Count Purpose Example Personas
Core 5 Fundamental Find-Create-Critique cycle Research Crafter, Blueprint Crafter, Documentation Evangelist, Runbook Crafter, User Guide Crafter
Integration 7 Cross-cutting capabilities Catalog Indexer Architect, UI Mockup Crafter, Semantic Taxonomy Engineer, Traceability Specialist, Blueprint Validator, Research Inventory Crafter, Governance Compliance Auditor
Governance 3 Compliance and risk controls Data Governance Specialist, Privacy Taxonomy Engineer, Anti-fact Mitigation Specialist
Stakeholder 5 Communication and coordination Collaboration Orchestrator, SAFe Metrics Crafter, Executive Communicator, Roadmap Synchronizer, Stakeholder Content Publisher
Champion 4 Team orchestration Research Crafter Champion, Blueprint Crafter Champion, User Guide Crafter Champion, Runbook Crafter Champion

Every persona is defined by a 10-component R.I.S.C.E.A.R. specification and can be further profiled with a 56-dimension profile, a 6-trait Discernment Matrix, and 6 Design Target Factors.

Workflow Graphs

FCC provides three pre-built workflow graphs of increasing complexity.

Graph Nodes Edges Use Case
Base Sequence 5 Core handoffs and feedback Pilot deployments, testing, minimal workflows
Extended Sequence 20 Handoffs, feedback, coordination, governance Team-scale documentation programs
Complete (24-node) 24 All relationship types including champion orchestration Enterprise deployments with full governance

Workflow graphs are stored as JSON and loaded by the WorkflowGraph class. Graphs support topological ordering, BFS traversal, and adjacency queries. Custom graphs can be created without modifying framework code.

Simulation Engine

The simulation engine traverses workflow graphs and invokes personas at each node.

Mode API Keys Required Use Case
Deterministic (Mock) No Testing, CI/CD, workflow validation, trace analysis
AI-Powered (Anthropic) Yes Production documentation generation with Claude
AI-Powered (OpenAI) Yes Production documentation generation with GPT

Each simulation run produces structured JSON traces recording every step: the acting persona, its input, its output, token usage, latency, and the edge that triggered it. Traces are suitable for auditing, performance analysis, and debugging.

Governance Layer

FCC's governance layer provides compliance, quality, and traceability controls.

Component Count Purpose
Quality Gates 25 Enforce minimum output standards per persona
Capability Tags 30 Structured metadata for discovery and traceability
Quality Gate Checks 83 Individual verification items across all gates

Quality gates are configurable with thresholds from 0.0 to 1.0. Capability tags use a three-level hierarchy: capability, category, and supercategory. Both are defined in YAML and can be extended without code changes.

Docs-as-Code Generation

The documentation generator produces structured output from persona specifications.

Output Type Files per Persona Total (24 Personas)
Tutorials 21 504
Prompts 21 504
Workflows 6 144
Cross-references -- 196
Total 56 (approx.) 1,348

Generation uses Jinja2 templates (15 templates in src/fcc/templates/docs/), supports filtering by persona or category, and includes sitemap generation for navigation.

Cross-Reference Matrix

The Cross-Reference Matrix maps all persona-to-persona interactions.

Query Type Description
upstream(id) Who sends work to this persona
downstream(id) Who this persona sends work to
peers(id) Who this persona coordinates with
by_type(type) All interactions of a given type (handoff, feedback, coordination, governance, champion-of)
between(a, b) Direct interactions between two specific personas

The matrix can be auto-generated from persona collaboration links or loaded from a curated YAML file.

CLI Commands

The fcc CLI provides the primary interface.

Command Purpose
fcc init Initialize a new FCC project
fcc add-persona Add a persona to an existing project
fcc validate Validate project structure
fcc simulate Run a workflow simulation
fcc generate-docs Generate documentation from persona specs
fcc validate-docs Validate generated documentation
fcc sitemap Generate a navigation sitemap

Next Steps