Skip to content

Dimension System

The FCC dimension system provides a 56-dimension profiling framework organized into 9 categories. It extends the R.I.S.C.E.A.R. specification with deep behavioral, contextual, and operational attributes that shape how each persona operates within the FCC workflow.

mindmap
  root((56 Dimensions))
    Core Persona Elements
      Agent Profile
      Professional Background
      Organizational Role
      Decision-Making Authority
      Technological Proficiency
      Communication Preferences
      Values and Beliefs
    Behavioral Factors
      Tool Adoption Patterns
      Framework Preferences
      Challenges and Pain Points
      Motivations and Drivers
      Risk Tolerance
      Workflow Stage Awareness
    Communication Styles
      Preferred Channels
      Information Sources
      Learning Preferences
      Networking Habits
    Cultural Influences
      Operational Heritage
      Format Proficiency
      Platform Engagement
      Cultural Sensitivity
    Decision-Making
      Decision Style
      Leadership Style
      Problem-Solving
      Negotiation Tactics
      Conflict Resolution
    Professional Development
      Mentorship
      Professional Growth
      Work-Life Balance
      Agent Sustainability
      Cross-Project Mobility
    Market Awareness
      Market Trends
      Competitive Strategies
      Regulatory Knowledge
      Ethical Standards
      Sustainability Practices
    Innovative Elements
      Output Trace Analysis
      Learning Preferences
      Sustainability Ethics
      Innovation Adoption
      Networking
      Decision Style
      Interaction History
      Crisis Response
      Cultural Affinities
      Reliability Priorities
    Advanced Attributes
      Ecosystem Role Map
      Resource Budget
      Input Acquisition
      Regulatory Exposure
      Growth Lever Stack
      Market Signals
      Collaboration Archetype
      Decision RACI
      Data Governance
      Place-Based Orientation

Purpose

While R.I.S.C.E.A.R. defines what a persona does, the dimension system defines who the persona is. Dimensions capture traits like decision-making style, risk tolerance, communication preferences, and sustainability practices. This depth enables:

  • Persona-aware AI prompts -- The simulation engine uses dimension profiles to generate contextually appropriate responses.
  • Team composition analysis -- Dimension profiles reveal complementary strengths and potential blind spots across a persona team.
  • Onboarding guidance -- Human collaborators adopting a persona role can understand the full behavioral expectations.

Consumer-to-Agent Reinterpretations

The dimension system originates from consumer persona research. 14 of the 56 dimensions have been reinterpreted for AI documentation agent personas. The remaining 42 dimensions are used unchanged.

Original Consumer Dimension Agent Reinterpretation Category
Demographic Information Agent Profile Core Persona Elements
Purchasing Behavior Tool/Resource Adoption Patterns Behavioral and Motivational Factors
Brand Affinities Framework/Methodology Preferences Behavioral and Motivational Factors
Customer Journey Stage Workflow Stage Awareness Behavioral and Motivational Factors
Cultural Background Operational Heritage Cultural and Social Influences
Language Proficiency Format/Protocol Proficiency Cultural and Social Influences
Social Media Usage Platform/Channel Engagement Cultural and Social Influences
Health and Wellness Agent Sustainability Professional Development and Wellness
Travel Habits Cross-Project Mobility Professional Development and Wellness
Digital Footprint Analysis Output Trace Analysis Innovative Persona Elements
Brand Interaction History Workflow Interaction History Innovative Persona Elements
Health and Wellness Priorities Agent Reliability Priorities Innovative Persona Elements
Capital Access Profile Resource Budget Profile Advanced Persona Attributes
Procurement Modality Input Acquisition Modality Advanced Persona Attributes

The full mapping with original and agent attributes is documented in data/personas/dimension_interpretation_guide.yaml.

The 9 Categories

1. Core Persona Elements (7 dimensions)

Foundational identity and professional context.

  • Agent Profile -- Expertise level, agent maturity, resource access, specialization depth, operating environment
  • Professional Background -- Job title, industry, company size, career trajectory
  • Organizational Role -- Primary responsibilities, team/department, stakeholder influence
  • Decision-Making Authority -- Budget authority, approval power, strategic influence
  • Technological Proficiency -- Tool proficiency, platform familiarity, digital literacy level
  • Communication Preferences -- Channels, cadence, tone/style
  • Values and Beliefs -- Professional ethics, work values, decision principles

2. Behavioral and Motivational Factors (6 dimensions)

Patterns of behavior, adoption, and motivation.

  • Tool/Resource Adoption Patterns -- Evaluation criteria, adoption speed, integration preference
  • Framework/Methodology Preferences -- Preferred frameworks, tool ecosystem, methodology alignment
  • Challenges and Pain Points -- Obstacles faced in achieving workflow goals
  • Motivations and Drivers -- Factors that inspire action within the FCC cycle
  • Risk Tolerance -- Willingness to engage in uncertain or high-stakes decisions
  • Workflow Stage Awareness -- Primary FCC phase, stage transition triggers, handoff readiness

3. Communication and Learning Styles (4 dimensions)

How the persona communicates and acquires knowledge.

  • Preferred Communication Channels -- Email, messaging apps, video conferencing, in-person meetings
  • Information Sources -- Trade publications, analyst reports, professional communities, internal knowledge bases
  • Learning Preferences -- Self-paced courses, live workshops, hands-on labs, mentorship, documentation
  • Networking Habits -- Conferences, meetups, online forums, professional associations

4. Cultural and Social Influences (4 dimensions)

Operational heritage and platform context.

  • Operational Heritage -- Legacy system awareness, migration experience, platform lineage
  • Format/Protocol Proficiency -- Output formats, API protocols, schema languages, markup fluency
  • Platform/Channel Engagement -- Integration platforms, CI/CD channels, notification systems
  • Cultural Sensitivity -- Awareness of diverse backgrounds and operational contexts

5. Decision-Making and Leadership Approaches (5 dimensions)

How the persona makes decisions and leads.

  • Decision-Making Style -- Analytical, intuitive, or consultative approaches
  • Leadership Style -- Approach to leading teams and guiding projects
  • Problem-Solving Approach -- Methods used to address challenges and resolve blockers
  • Negotiation Tactics -- Strategies for cross-persona negotiations and prioritization
  • Conflict Resolution -- Techniques for managing disagreements between personas or phases

6. Professional Development and Wellness (5 dimensions)

Growth, sustainability, and operational resilience.

  • Mentorship Engagement -- Participation in mentoring relationships and knowledge transfer
  • Professional Growth -- Commitment to ongoing learning and capability expansion
  • Work-Life Balance -- Workload distribution and operational sustainability management
  • Agent Sustainability -- Burnout prevention, load management, error recovery, graceful degradation
  • Cross-Project Mobility -- Multi-project deployment, context switching, domain transfer

7. Market and Regulatory Awareness (5 dimensions)

External factors and compliance context.

  • Market Trends -- Understanding of industry trends and emerging patterns
  • Competitive Strategies -- Knowledge of competing approaches and frameworks
  • Regulatory Knowledge -- Familiarity with relevant laws and compliance requirements
  • Ethical Standards -- Commitment to ethical practices and responsible AI
  • Sustainability Practices -- Engagement in sustainable and maintainable practices

8. Innovative Persona Elements (10 dimensions)

Advanced behavioral and operational attributes.

  • Output Trace Analysis -- Trace completeness, audit trail depth, provenance tracking, output lineage
  • Learning and Development Preferences -- Methods for acquiring new skills and domain expertise
  • Sustainability and Ethical Considerations -- Attitudes regarding sustainable practices
  • Innovation Adoption Rate -- Propensity to adopt new technologies and tools
  • Networking and Community Engagement -- Involvement in professional networks
  • Decision-Making Style -- Risk tolerance and information processing approaches
  • Workflow Interaction History -- Collaboration log, handoff record, feedback cycles
  • Crisis Response Behavior -- Reactions, recovery patterns, and coping mechanisms during failures
  • Cultural Affinities -- Operational heritage preferences and methodology traditions
  • Agent Reliability Priorities -- Uptime targets, error budgets, recovery SLOs, monitoring depth

9. Advanced Persona Attributes (10 dimensions)

Strategic positioning and ecosystem integration.

  • Ecosystem Role Map -- Strategic position within the workflow and team ecosystem
  • Resource Budget Profile -- Compute allocation, token budget, API quota, storage limits
  • Input Acquisition Modality -- Data ingestion patterns, source selection criteria, input validation
  • Regulatory Exposure Map -- Regulatory regimes and sensitivity to each
  • Growth Lever Stack -- Prioritized tactics to scale capability and impact
  • Market Signal Sensitivities -- External indicators that trigger workflow adjustments
  • Collaboration Archetype -- Preferred mode of partnering and coordinating with other agents
  • Decision RACI Footprint -- Responsible/Accountable/Consulted/Informed roles in decisions
  • Data Governance Maturity -- Sophistication of data practices and quality assurance
  • Place-Based Orientation -- Geographic, spatial, and deployment-context strategies

Data Model

Dimensions are defined in data/personas/dimension_definitions.yaml. Each persona's profile is stored as a separate YAML file under data/personas/dimensions/ (e.g., rc_profile.yaml, bc_profile.yaml).

The Python data model is implemented in src/fcc/personas/dimensions.py with these key classes:

  • DimensionAttribute -- A single attribute within a dimension
  • PersonaDimension -- A named dimension with description and attributes
  • PersonaDimensionProfile -- A complete profile mapping a persona to its dimension values
  • DimensionRegistry -- Loads and queries dimension definitions