Skip to content

Adoption Roadmap

FCC is designed for phased adoption. The framework's modular architecture allows organizations to start with a small pilot, validate results, and expand incrementally. This roadmap defines three stages, each with clear scope, success criteria, and progression triggers.

Phase 1: Pilot

Scope: 5 core personas, base workflow graph (5 nodes)

Duration: 2--4 weeks

Objective: Validate the FCC workflow on a bounded documentation target. Confirm that the Find-Create-Critique cycle produces acceptable output quality with minimal configuration.

What You Deploy

  • Personas: Research Crafter (RC), Blueprint Crafter (BC), Documentation Evangelist (DE), Runbook Crafter (RB), User Guide Crafter (UG)
  • Workflow: Base sequence -- 5 nodes with handoff and feedback edges
  • Simulation mode: Mock (deterministic) for workflow validation, then AI-powered for content generation
  • Quality gates: 6 core gates (Research Inventory Completeness, Blueprint Completeness, Documentation Quality, Runbook Readiness, User Guide Accessibility, R.I.S.C.E.A.R. Extended Completeness)

Success Criteria

Criterion Target
Installation and setup Complete within 1 hour
Mock simulation completes All 5 nodes traversed without errors
AI simulation produces output All 5 personas generate content
Core quality gates pass At least 4 of 6 gates at threshold
Team can modify a persona spec YAML change reflected in output
Documentation generated At least 56 files (1 persona's full set)

Progression Trigger

Proceed to Phase 2 when: core simulations run reliably, the team is comfortable modifying persona YAML and workflow JSON, and at least one documentation target has been completed end-to-end through the FCC cycle.

Phase 2: Team

Scope: 20 personas (core + integration + governance), extended workflow graph (20 nodes)

Duration: 4--8 weeks

Objective: Scale from a single workflow to a documentation program with cross-cutting capabilities. Add integration personas for taxonomy, traceability, and validation. Add governance personas for compliance, privacy, and anti-hallucination controls.

What You Add

  • Integration personas (7): Catalog Indexer Architect, UI Mockup Crafter, Semantic Taxonomy Engineer, Traceability Specialist, Blueprint Validator, Research Inventory Crafter, Governance Compliance Auditor
  • Governance personas (3): Data Governance Specialist, Privacy Taxonomy Engineer, Anti-fact Mitigation Specialist
  • Stakeholder personas (5): Collaboration Orchestrator, SAFe Metrics Crafter, Executive Communicator, Roadmap Synchronizer, Stakeholder Content Publisher
  • Workflow: Extended sequence -- 20 nodes with full edge typing
  • Quality gates: 20 additional gates covering integration, governance, and stakeholder outputs
  • Capability tags: 30 structured metadata labels for discovery and traceability

Success Criteria

Criterion Target
Extended workflow completes All 20 nodes traversed
Integration gates pass At least 5 of 7 at threshold
Governance gates pass All 3 at 100% threshold
Cross-reference matrix populated All persona interactions mapped
Documentation generated 1,000+ files across multiple personas
Stakeholder reporting functional Executive summaries and metrics dashboards produced

Progression Trigger

Proceed to Phase 3 when: the extended workflow runs reliably, governance gates pass consistently, cross-references are accurate, and the team has established operational procedures for scenario management and trace review.

Phase 3: Enterprise

Scope: 24 personas (all categories including champions), complete workflow graph (24 nodes)

Duration: Ongoing

Objective: Operate FCC as a full documentation program with champion orchestration, unified output packages, and continuous quality monitoring.

What You Add

  • Champion personas (4): Research Crafter Champion (RCHM), Blueprint Crafter Champion (BCHM), User Guide Crafter Champion (UGCH), Runbook Crafter Champion (RBCH)
  • Workflow: Complete 24-node graph with champion coordination edges
  • Quality gates: 4 champion orchestration gates requiring unified packages, cross-artifact consistency, and readiness assessments
  • Dimension profiles: Full 56-dimension profiles for behavioral profiling and team composition analysis

Success Criteria

Criterion Target
Complete workflow executes All 24 nodes traversed
Champion gates pass All 4 at 100% threshold
Unified packages produced Each champion delivers a consolidated output
Full documentation generation 1,348 files generated and validated
Discernment Matrix populated At least core personas fully profiled
Custom personas integrated Team-specific personas merged with standard 24
CI/CD integration Simulations run as part of the build pipeline

Ongoing Operations

At enterprise scale, FCC operates as infrastructure:

  • Scenario library management: Curate and version scenarios for different documentation targets.
  • Trace analysis: Review simulation traces for performance trends, quality gate trends, and cost optimization.
  • Persona tuning: Adjust R.I.S.C.E.A.R. specifications based on output quality feedback.
  • Workflow evolution: Define new workflow graphs for specialized documentation programs.
  • Registry extension: Add custom personas via PersonaRegistry.merge() without modifying the standard 24.

Next Steps