fcc-agent-team-ext 0.2.0__py3-none-any.whl

fcc/__init__.py

@@ -0,0 +1,3 @@
+"""FCC (Find → Create → Critique) Agent Team Framework."""
+
+__version__ = "0.2.0"

fcc/_resources.py

@@ -0,0 +1,51 @@
+"""Centralized resource path resolution for FCC package data."""
+
+from __future__ import annotations
+
+import importlib.resources
+from pathlib import Path
+
+
+def _package_root() -> Path:
+    """Return the root directory of the fcc package."""
+    return Path(str(importlib.resources.files("fcc")))
+
+
+def get_data_dir() -> Path:
+    """Return the path to the package data directory."""
+    return _package_root() / "data"
+
+
+def get_personas_dir() -> Path:
+    """Return the path to the personas data directory."""
+    return get_data_dir() / "personas"
+
+
+def get_schemas_dir() -> Path:
+    """Return the path to the JSON schemas directory."""
+    return get_data_dir() / "schemas"
+
+
+def get_workflows_dir() -> Path:
+    """Return the path to the workflow definitions directory."""
+    return get_data_dir() / "workflows"
+
+
+def get_scenarios_dir() -> Path:
+    """Return the path to the scenarios directory."""
+    return get_data_dir() / "scenarios"
+
+
+def get_governance_dir() -> Path:
+    """Return the path to the governance data directory."""
+    return get_data_dir() / "governance"
+
+
+def get_docs_data_dir() -> Path:
+    """Return the path to the docs data directory (topics, templates)."""
+    return get_data_dir() / "docs"
+
+
+def get_templates_dir() -> Path:
+    """Return the path to the Jinja2 templates directory."""
+    return _package_root() / "templates"

fcc/data/docs/constitution_template.yaml

@@ -0,0 +1,37 @@
+constitution:
+  hard_stop:
+    description: "Rules that must never be violated. Violations require immediate halt and review."
+    default_rules:
+      - "Never fabricate data or sources"
+      - "Never bypass quality gates without explicit authorization"
+      - "Never modify production artifacts without audit trail"
+
+  mandatory:
+    description: "Rules that must be followed in all circumstances. Exceptions require documented justification."
+    default_rules:
+      - "All deliverables must pass quality gate checks"
+      - "All artifacts must be version-controlled"
+      - "Cross-references must be validated before handoff"
+      - "Collaboration links must be documented"
+
+  preferred:
+    description: "Best practices that should be followed when possible. Deviations acceptable with rationale."
+    default_rules:
+      - "Use structured formats over prose where applicable"
+      - "Include examples in all documentation"
+      - "Tag artifacts with capability identifiers"
+      - "Document assumptions and limitations"
+
+  workflows:
+    - name: scaffold
+      description: "Generate new artifact from scratch"
+    - name: refactor
+      description: "Improve existing artifact structure and quality"
+    - name: debug
+      description: "Fix issues and errors in artifacts"
+    - name: test
+      description: "Validate artifact against standards"
+    - name: compare
+      description: "Evaluate multiple approaches or versions"
+    - name: document
+      description: "Generate documentation summary"

fcc/data/docs/prompt_topics.yaml

@@ -0,0 +1,78 @@
+levels:
+  beginner:
+    - id: beginner_01
+      title_template: "Basic {primary_action} Prompt"
+      description_template: "A starter prompt for {persona_name} to perform basic {primary_action}"
+    - id: beginner_02
+      title_template: "Output Formatting Prompt"
+      description_template: "Prompt {persona_name} to format {primary_output} clearly"
+    - id: beginner_03
+      title_template: "Quality Check Prompt"
+      description_template: "Prompt {persona_name} to perform basic quality verification"
+    - id: beginner_04
+      title_template: "Collaboration Handoff Prompt"
+      description_template: "Prompt {persona_name} to prepare a handoff package"
+    - id: beginner_05
+      title_template: "Status Summary Prompt"
+      description_template: "Prompt {persona_name} to generate a status summary"
+    - id: beginner_06
+      title_template: "Feedback Request Prompt"
+      description_template: "Prompt {persona_name} to request feedback from collaborators"
+    - id: beginner_07
+      title_template: "Deliverable Review Prompt"
+      description_template: "Prompt {persona_name} to review its deliverables"
+
+  intermediate:
+    - id: intermediate_01
+      title_template: "Multi-Source {primary_action} Prompt"
+      description_template: "Prompt {persona_name} to synthesize from multiple sources"
+    - id: intermediate_02
+      title_template: "Cross-Reference Validation Prompt"
+      description_template: "Prompt {persona_name} to validate cross-references"
+    - id: intermediate_03
+      title_template: "Custom Template Prompt"
+      description_template: "Prompt {persona_name} using a customized template"
+    - id: intermediate_04
+      title_template: "Feedback Loop Prompt"
+      description_template: "Prompt {persona_name} to process feedback and iterate"
+    - id: intermediate_05
+      title_template: "Quality Gate Assessment Prompt"
+      description_template: "Prompt {persona_name} to assess quality gate compliance"
+    - id: intermediate_06
+      title_template: "Scenario Analysis Prompt"
+      description_template: "Prompt {persona_name} to analyze a specific scenario"
+    - id: intermediate_07
+      title_template: "Comparative Analysis Prompt"
+      description_template: "Prompt {persona_name} to compare approaches or outputs"
+
+  advanced:
+    - id: advanced_01
+      title_template: "Pipeline-Integrated {primary_action} Prompt"
+      description_template: "Prompt {persona_name} for CI/CD pipeline integration"
+    - id: advanced_02
+      title_template: "Enterprise-Scale Prompt"
+      description_template: "Prompt {persona_name} for enterprise deployment context"
+    - id: advanced_03
+      title_template: "Custom Persona Extension Prompt"
+      description_template: "Prompt {persona_name} to define a custom extension"
+    - id: advanced_04
+      title_template: "AI Simulation Prompt"
+      description_template: "Prompt {persona_name} for AI-powered simulation execution"
+    - id: advanced_05
+      title_template: "Governance Automation Prompt"
+      description_template: "Prompt {persona_name} for automated governance checking"
+    - id: advanced_06
+      title_template: "Cross-Project Orchestration Prompt"
+      description_template: "Prompt {persona_name} for multi-project coordination"
+    - id: advanced_07
+      title_template: "Production Readiness Prompt"
+      description_template: "Prompt {persona_name} for production readiness assessment"
+    - id: advanced_08
+      title_template: "Cross-Reference Query Prompt"
+      description_template: "Prompt {persona_name} to query upstream dependencies from the cross-reference matrix"
+    - id: advanced_09
+      title_template: "Governance Chain Analysis Prompt"
+      description_template: "Prompt {persona_name} to trace the governance oversight chain"
+    - id: advanced_10
+      title_template: "Champion Orchestration Mapping Prompt"
+      description_template: "Prompt {persona_name} to map orchestration team relationships"

fcc/data/docs/tutorial_topics.yaml

@@ -0,0 +1,129 @@
+levels:
+  beginner:
+    - id: beginner_01
+      title_template: "Getting Started with {persona_name}"
+      outcome_template: "Set up and configure {persona_name} for first use"
+      duration: "15 minutes"
+      sections: ["Prerequisites", "Installation", "First Configuration", "Verification"]
+
+    - id: beginner_02
+      title_template: "Your First {primary_action} with {persona_name}"
+      outcome_template: "Complete your first {primary_action} task"
+      duration: "20 minutes"
+      sections: ["Understanding the Task", "Step-by-Step Walkthrough", "Expected Output", "Troubleshooting"]
+
+    - id: beginner_03
+      title_template: "Reading {persona_name} Output"
+      outcome_template: "Interpret and use {primary_output} effectively"
+      duration: "15 minutes"
+      sections: ["Output Format", "Key Sections", "Quality Indicators", "Next Steps"]
+
+    - id: beginner_04
+      title_template: "Quality Gates for {persona_name}"
+      outcome_template: "Understand and apply quality gates to {persona_name} deliverables"
+      duration: "20 minutes"
+      sections: ["Gate Definitions", "Threshold Configuration", "Running Gate Checks", "Interpreting Results"]
+
+    - id: beginner_05
+      title_template: "{persona_name} CLI Interaction"
+      outcome_template: "Use FCC CLI commands for {persona_name} workflows"
+      duration: "15 minutes"
+      sections: ["Available Commands", "Basic Usage", "Common Options", "Output Formats"]
+
+    - id: beginner_06
+      title_template: "{persona_name} Collaboration Links"
+      outcome_template: "Understand how {persona_name} collaborates with other personas"
+      duration: "15 minutes"
+      sections: ["Upstream Dependencies", "Downstream Handoffs", "Peer Interactions", "Feedback Loops"]
+
+    - id: beginner_07
+      title_template: "First Simulation with {persona_name}"
+      outcome_template: "Run a basic mock simulation including {persona_name}"
+      duration: "20 minutes"
+      sections: ["Simulation Setup", "Running the Simulation", "Reading Traces", "Validation"]
+
+  intermediate:
+    - id: intermediate_01
+      title_template: "Multi-Persona Workflow with {persona_name}"
+      outcome_template: "Integrate {persona_name} into a multi-persona FCC workflow"
+      duration: "30 minutes"
+      sections: ["Workflow Design", "Persona Integration", "Handoff Configuration", "End-to-End Testing"]
+
+    - id: intermediate_02
+      title_template: "Custom Configuration for {persona_name}"
+      outcome_template: "Customize {persona_name} behavior through configuration"
+      duration: "25 minutes"
+      sections: ["Configuration Options", "YAML Customization", "Override Patterns", "Validation"]
+
+    - id: intermediate_03
+      title_template: "Template Customization for {persona_name}"
+      outcome_template: "Modify and extend templates used by {persona_name}"
+      duration: "30 minutes"
+      sections: ["Template Architecture", "Jinja2 Basics", "Custom Variables", "Testing Templates"]
+
+    - id: intermediate_04
+      title_template: "Feedback Loops with {persona_name}"
+      outcome_template: "Configure and optimize feedback loops involving {persona_name}"
+      duration: "25 minutes"
+      sections: ["Feedback Loop Design", "Configuration", "Loop Optimization", "Monitoring"]
+
+    - id: intermediate_05
+      title_template: "Quality Gate Tuning for {persona_name}"
+      outcome_template: "Fine-tune quality gate thresholds for {persona_name}"
+      duration: "25 minutes"
+      sections: ["Threshold Analysis", "Custom Gate Rules", "Performance Impact", "Best Practices"]
+
+    - id: intermediate_06
+      title_template: "Cross-Reference Validation with {persona_name}"
+      outcome_template: "Validate cross-references involving {persona_name}"
+      duration: "30 minutes"
+      sections: ["Cross-Reference Matrix", "Validation Rules", "Automated Checking", "Reporting"]
+
+    - id: intermediate_07
+      title_template: "Scenario Testing with {persona_name}"
+      outcome_template: "Design and run test scenarios for {persona_name}"
+      duration: "30 minutes"
+      sections: ["Scenario Design", "Test Data Preparation", "Execution", "Results Analysis"]
+
+  advanced:
+    - id: advanced_01
+      title_template: "Pipeline Integration for {persona_name}"
+      outcome_template: "Integrate {persona_name} into CI/CD pipelines"
+      duration: "45 minutes"
+      sections: ["Pipeline Architecture", "CI/CD Configuration", "Automated Validation", "Deployment"]
+
+    - id: advanced_02
+      title_template: "Enterprise Deployment of {persona_name}"
+      outcome_template: "Deploy {persona_name} at enterprise scale"
+      duration: "45 minutes"
+      sections: ["Architecture Considerations", "Scaling Strategies", "Monitoring", "Maintenance"]
+
+    - id: advanced_03
+      title_template: "Custom Persona Extension from {persona_name}"
+      outcome_template: "Create a custom persona extending {persona_name} patterns"
+      duration: "40 minutes"
+      sections: ["Extension Points", "R.I.S.C.E.A.R. Design", "Registration", "Testing"]
+
+    - id: advanced_04
+      title_template: "AI-Powered Simulation with {persona_name}"
+      outcome_template: "Run AI-powered simulations with {persona_name}"
+      duration: "45 minutes"
+      sections: ["AI Client Setup", "Prompt Engineering", "Simulation Execution", "Output Analysis"]
+
+    - id: advanced_05
+      title_template: "Governance Automation for {persona_name}"
+      outcome_template: "Automate governance checks for {persona_name} deliverables"
+      duration: "40 minutes"
+      sections: ["Governance Rules", "Automation Setup", "Compliance Reporting", "Remediation"]
+
+    - id: advanced_06
+      title_template: "Cross-Project Orchestration with {persona_name}"
+      outcome_template: "Orchestrate {persona_name} across multiple projects"
+      duration: "45 minutes"
+      sections: ["Multi-Project Architecture", "Shared Configuration", "Synchronization", "Conflict Resolution"]
+
+    - id: advanced_07
+      title_template: "Scaling {persona_name} to Production"
+      outcome_template: "Production-ready {persona_name} deployment and monitoring"
+      duration: "45 minutes"
+      sections: ["Production Checklist", "Performance Tuning", "Observability", "Incident Response"]

fcc/data/governance/quality_gates.yaml

@@ -0,0 +1,263 @@
+quality_gates:
+  # Core personas
+  - id: QG-RC-001
+    name: Research Inventory Completeness
+    persona_id: RC
+    threshold: 1.0
+    checks:
+      - capability_matrix
+      - annotated_references
+      - traceability_matrix
+      - capability_tags
+
+  - id: QG-BC-001
+    name: Blueprint Completeness
+    persona_id: BC
+    threshold: 0.75
+    checks:
+      - architecture_diagrams
+      - api_specifications
+      - data_models
+      - workflow_definitions
+
+  - id: QG-DE-001
+    name: Documentation Quality
+    persona_id: DE
+    threshold: 1.0
+    checks:
+      - style_guide_compliance
+      - version_controlled
+      - review_report
+
+  - id: QG-RB-001
+    name: Runbook Readiness
+    persona_id: RB
+    threshold: 1.0
+    checks:
+      - step_by_step_procedures
+      - automation_scripts
+      - troubleshooting_guide
+
+  - id: QG-UG-001
+    name: User Guide Accessibility
+    persona_id: UG
+    threshold: 1.0
+    checks:
+      - quick_start_guide
+      - detailed_steps
+      - troubleshooting_section
+
+  - id: QG-RISCEAR-001
+    name: R.I.S.C.E.A.R. Extended Completeness
+    persona_id: ALL
+    threshold: 1.0
+    checks:
+      - role_skills_defined
+      - role_collaborators_defined
+      - adoption_checklist_defined
+
+  # Integration personas
+  - id: QG-CIA-001
+    name: Catalog Index Completeness
+    persona_id: CIA
+    threshold: 1.0
+    checks:
+      - index_schema_defined
+      - api_connectors_tested
+      - coverage_report_generated
+
+  - id: QG-UMC-001
+    name: UI Mockup Quality
+    persona_id: UMC
+    threshold: 0.75
+    checks:
+      - mockups_annotated
+      - accessibility_verified
+      - brand_compliance_checked
+      - responsive_layouts
+
+  - id: QG-STE-001
+    name: Taxonomy Consistency
+    persona_id: STE
+    threshold: 1.0
+    checks:
+      - taxonomy_schema_complete
+      - triplet_logic_validated
+      - consistency_report_generated
+
+  - id: QG-TS-001
+    name: Traceability Coverage
+    persona_id: TS
+    threshold: 1.0
+    checks:
+      - bidirectional_links_verified
+      - impact_analysis_complete
+      - coverage_report_generated
+
+  - id: QG-BV-001
+    name: Blueprint Validation Thoroughness
+    persona_id: BV
+    threshold: 1.0
+    checks:
+      - validation_report_complete
+      - quality_scores_calculated
+      - remediation_recommendations
+
+  - id: QG-RIC-001
+    name: Research Inventory Automation
+    persona_id: RIC
+    threshold: 1.0
+    checks:
+      - capability_matrices_populated
+      - machine_parseable_format
+      - source_attribution_verified
+
+  - id: QG-GCA-001
+    name: Governance Compliance Audit
+    persona_id: GCA
+    threshold: 1.0
+    checks:
+      - audit_report_complete
+      - evidence_logs_maintained
+      - remediation_timelines_set
+
+  # Governance personas
+  - id: QG-DGS-001
+    name: Data Governance Integration
+    persona_id: DGS
+    threshold: 1.0
+    checks:
+      - api_contracts_documented
+      - data_flows_compliant
+      - service_configs_versioned
+
+  - id: QG-PTE-001
+    name: Privacy Classification Coverage
+    persona_id: PTE
+    threshold: 1.0
+    checks:
+      - data_types_classified
+      - privacy_regulations_mapped
+      - handling_guidelines_documented
+
+  - id: QG-AMS-001
+    name: Anti-fact Mitigation Rigor
+    persona_id: AMS
+    threshold: 1.0
+    checks:
+      - confidence_thresholds_applied
+      - source_verification_complete
+      - audit_trail_maintained
+
+  # Stakeholder personas
+  - id: QG-CO-001
+    name: Coordination Completeness
+    persona_id: CO
+    threshold: 1.0
+    checks:
+      - handoff_reports_documented
+      - dependency_matrix_current
+      - blocker_dashboard_operational
+
+  - id: QG-SMC-001
+    name: Metrics Dashboard Accuracy
+    persona_id: SMC
+    threshold: 0.75
+    checks:
+      - velocity_metrics_current
+      - quality_metrics_tracked
+      - flow_metrics_visualized
+
+  - id: QG-EC-001
+    name: Executive Communication Quality
+    persona_id: EC
+    threshold: 1.0
+    checks:
+      - executive_summary_complete
+      - insights_extracted
+      - audience_appropriate_tone
+
+  - id: QG-RS-001
+    name: Roadmap Synchronization
+    persona_id: RS
+    threshold: 1.0
+    checks:
+      - sources_synchronized
+      - dependencies_mapped
+      - conflicts_resolved
+
+  - id: QG-SCP-001
+    name: Content Distribution Coverage
+    persona_id: SCP
+    threshold: 1.0
+    checks:
+      - channels_configured
+      - access_controls_enforced
+      - version_history_maintained
+
+  # Champion personas
+  - id: QG-RCHM-001
+    name: Research Orchestration Completeness
+    persona_id: RCHM
+    threshold: 1.0
+    checks:
+      - unified_research_package
+      - cross_artifact_consistency
+      - research_readiness_assessment
+
+  - id: QG-BCHM-001
+    name: Blueprint Orchestration Completeness
+    persona_id: BCHM
+    threshold: 1.0
+    checks:
+      - orchestrated_blueprint_package
+      - cross_reference_index
+      - quality_validation_summary
+
+  - id: QG-UGCH-001
+    name: User Experience Orchestration Completeness
+    persona_id: UGCH
+    threshold: 1.0
+    checks:
+      - multi_channel_package
+      - content_strategy_report
+      - channel_coordination_report
+
+  - id: QG-RBCH-001
+    name: Operations Orchestration Completeness
+    persona_id: RBCH
+    threshold: 1.0
+    checks:
+      - validated_operational_package
+      - governance_clearance_report
+      - operational_readiness_assessment
+
+  # Cross-reference integrity gates
+  - id: QG-XREF-001
+    name: Cross-Reference Coverage
+    persona_id: ALL
+    threshold: 1.0
+    checks:
+      - all_24_personas_represented
+      - every_persona_has_downstream_or_is_terminal
+      - every_persona_has_upstream_or_is_champion
+
+  - id: QG-XREF-002
+    name: Cross-Reference Type Completeness
+    persona_id: ALL
+    threshold: 1.0
+    checks:
+      - handoff_type_used
+      - feedback_type_used
+      - coordination_type_used
+      - governance_type_used
+      - champion_of_type_used
+
+  - id: QG-XREF-003
+    name: Workflow-CrossReference Alignment
+    persona_id: ALL
+    threshold: 1.0
+    checks:
+      - all_58_workflow_edges_have_entries
+      - edge_types_consistent_with_workflow
+      - no_orphan_persona_ids

fcc/data/governance/tag_registry.yaml

@@ -0,0 +1,126 @@
+tags:
+  # Core personas
+  - capability: persona-research-crafter
+    category: knowledge-sharing
+    supercategory: strategy-alignment
+
+  - capability: persona-blueprint-crafter
+    category: knowledge-sharing
+    supercategory: strategy-alignment
+
+  - capability: persona-documentation-evangelist
+    category: knowledge-sharing
+    supercategory: strategy-alignment
+
+  - capability: persona-runbook-crafter
+    category: knowledge-sharing
+    supercategory: strategy-alignment
+
+  - capability: persona-user-guide-crafter
+    category: knowledge-sharing
+    supercategory: strategy-alignment
+
+  # Integration personas
+  - capability: persona-catalog-indexer-architect
+    category: integration-automation
+    supercategory: operational-excellence
+
+  - capability: persona-ui-mockup-crafter
+    category: integration-automation
+    supercategory: operational-excellence
+
+  - capability: persona-semantic-taxonomy-engineer
+    category: integration-automation
+    supercategory: strategy-alignment
+
+  - capability: persona-traceability-specialist
+    category: integration-automation
+    supercategory: operational-excellence
+
+  - capability: persona-blueprint-validator
+    category: integration-automation
+    supercategory: operational-excellence
+
+  - capability: persona-research-inventory-crafter
+    category: integration-automation
+    supercategory: strategy-alignment
+
+  - capability: persona-governance-compliance-auditor
+    category: governance-compliance
+    supercategory: strategy-alignment
+
+  # Governance personas
+  - capability: persona-data-governance-specialist
+    category: governance-compliance
+    supercategory: strategy-alignment
+
+  - capability: persona-privacy-taxonomy-engineer
+    category: governance-compliance
+    supercategory: strategy-alignment
+
+  - capability: persona-anti-fact-mitigation-specialist
+    category: governance-compliance
+    supercategory: strategy-alignment
+
+  # Stakeholder personas
+  - capability: persona-collaboration-orchestrator
+    category: stakeholder-engagement
+    supercategory: strategy-alignment
+
+  - capability: persona-safe-metrics-crafter
+    category: stakeholder-engagement
+    supercategory: operational-excellence
+
+  - capability: persona-executive-communicator
+    category: stakeholder-engagement
+    supercategory: strategy-alignment
+
+  - capability: persona-roadmap-synchronizer
+    category: stakeholder-engagement
+    supercategory: strategy-alignment
+
+  - capability: persona-stakeholder-content-publisher
+    category: stakeholder-engagement
+    supercategory: operational-excellence
+
+  # Champion personas
+  - capability: persona-research-crafter-champion
+    category: champion-orchestration
+    supercategory: strategy-alignment
+
+  - capability: persona-blueprint-crafter-champion
+    category: champion-orchestration
+    supercategory: strategy-alignment
+
+  - capability: persona-user-guide-crafter-champion
+    category: champion-orchestration
+    supercategory: strategy-alignment
+
+  - capability: persona-runbook-crafter-champion
+    category: champion-orchestration
+    supercategory: strategy-alignment
+
+  # Workflow and simulation tags
+  - capability: workflow-fcc-base-sequence
+    category: workflow-automation
+    supercategory: operational-excellence
+
+  - capability: workflow-fcc-extended-sequence
+    category: workflow-automation
+    supercategory: operational-excellence
+
+  - capability: simulation-deterministic
+    category: testing-validation
+    supercategory: operational-excellence
+
+  - capability: simulation-ai-powered
+    category: testing-validation
+    supercategory: operational-excellence
+
+  - capability: governance-quality-gates
+    category: governance-compliance
+    supercategory: strategy-alignment
+
+  - capability: governance-capability-tags
+    category: governance-compliance
+    supercategory: strategy-alignment