{
  "schemaVersion": "1.0",
  "item": {
    "slug": "data-evolution-analysis",
    "name": "Data Evolution Analysis",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/datadrivenconstruction/data-evolution-analysis",
    "canonicalUrl": "https://clawhub.ai/datadrivenconstruction/data-evolution-analysis",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/data-evolution-analysis",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=data-evolution-analysis",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "claw.json",
      "instructions.md",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "data-evolution-analysis",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T08:18:32.726Z",
      "expiresAt": "2026-05-09T08:18:32.726Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=data-evolution-analysis",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=data-evolution-analysis",
        "contentDisposition": "attachment; filename=\"data-evolution-analysis-2.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "data-evolution-analysis"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/data-evolution-analysis"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/data-evolution-analysis",
    "agentPageUrl": "https://openagent3.xyz/skills/data-evolution-analysis/agent",
    "manifestUrl": "https://openagent3.xyz/skills/data-evolution-analysis/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/data-evolution-analysis/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Overview",
        "body": "Based on DDC methodology (Chapter 1.1), this skill analyzes data evolution patterns in construction organizations, assessing digital maturity levels from paper-based workflows to fully data-driven operations.\n\nBook Reference: \"Эволюция использования данных в строительной отрасли\" / \"Evolution of Data Usage in Construction\""
      },
      {
        "title": "Quick Start",
        "body": "from dataclasses import dataclass, field\nfrom enum import Enum\nfrom typing import List, Dict, Optional\nfrom datetime import datetime\nimport json\n\nclass MaturityLevel(Enum):\n    \"\"\"Digital maturity levels based on DDC methodology\"\"\"\n    LEVEL_0_PAPER = 0      # Paper-based, no digital tools\n    LEVEL_1_BASIC = 1      # Basic digital (spreadsheets, email)\n    LEVEL_2_STRUCTURED = 2  # Structured databases, some integration\n    LEVEL_3_INTEGRATED = 3  # ERP/BIM integration, workflows\n    LEVEL_4_AUTOMATED = 4   # Automated processes, ML/AI\n    LEVEL_5_PREDICTIVE = 5  # Predictive analytics, digital twins\n\nclass DataCategory(Enum):\n    \"\"\"Categories of construction data\"\"\"\n    DESIGN = \"design\"\n    COST = \"cost\"\n    SCHEDULE = \"schedule\"\n    QUALITY = \"quality\"\n    SAFETY = \"safety\"\n    PROCUREMENT = \"procurement\"\n    DOCUMENT = \"document\"\n    COMMUNICATION = \"communication\"\n\n@dataclass\nclass DataFlowAssessment:\n    \"\"\"Assessment of data flow in an organization\"\"\"\n    category: DataCategory\n    source_systems: List[str]\n    storage_format: str\n    integration_level: float  # 0-1\n    automation_level: float   # 0-1\n    data_quality_score: float # 0-1\n    issues: List[str] = field(default_factory=list)\n\n@dataclass\nclass MaturityAssessment:\n    \"\"\"Complete digital maturity assessment\"\"\"\n    organization_name: str\n    assessment_date: datetime\n    overall_level: MaturityLevel\n    category_scores: Dict[DataCategory, float]\n    data_flows: List[DataFlowAssessment]\n    strengths: List[str]\n    weaknesses: List[str]\n    recommendations: List[str]\n    roadmap: Dict[str, List[str]]\n\n\nclass DataEvolutionAnalyzer:\n    \"\"\"\n    Analyze data evolution and digital maturity in construction organizations.\n    Based on DDC methodology Chapter 1.1.\n    \"\"\"\n\n    def __init__(self):\n        self.assessment_criteria = self._load_criteria()\n        self.evolution_stages = self._define_evolution_stages()\n\n    def _load_criteria(self) -> Dict[DataCategory, Dict]:\n        \"\"\"Load assessment criteria for each category\"\"\"\n        return {\n            DataCategory.DESIGN: {\n                \"tools\": [\"CAD\", \"BIM\", \"Collaboration Platform\"],\n                \"metrics\": [\"model_usage\", \"clash_detection\", \"design_reviews\"],\n                \"weight\": 0.20\n            },\n            DataCategory.COST: {\n                \"tools\": [\"Spreadsheets\", \"Estimating Software\", \"ERP\"],\n                \"metrics\": [\"automation_level\", \"historical_data\", \"benchmarking\"],\n                \"weight\": 0.15\n            },\n            DataCategory.SCHEDULE: {\n                \"tools\": [\"Gantt Charts\", \"CPM Software\", \"4D BIM\"],\n                \"metrics\": [\"resource_loading\", \"progress_tracking\", \"forecasting\"],\n                \"weight\": 0.15\n            },\n            DataCategory.QUALITY: {\n                \"tools\": [\"Checklists\", \"QC Software\", \"Defect Tracking\"],\n                \"metrics\": [\"inspection_digitization\", \"defect_analytics\", \"compliance\"],\n                \"weight\": 0.12\n            },\n            DataCategory.SAFETY: {\n                \"tools\": [\"Incident Reports\", \"Safety Software\", \"IoT Sensors\"],\n                \"metrics\": [\"incident_tracking\", \"predictive_safety\", \"training\"],\n                \"weight\": 0.12\n            },\n            DataCategory.PROCUREMENT: {\n                \"tools\": [\"RFQ Manual\", \"e-Procurement\", \"Supply Chain\"],\n                \"metrics\": [\"vendor_management\", \"material_tracking\", \"integration\"],\n                \"weight\": 0.10\n            },\n            DataCategory.DOCUMENT: {\n                \"tools\": [\"File Shares\", \"DMS\", \"CDE\"],\n                \"metrics\": [\"version_control\", \"access_control\", \"searchability\"],\n                \"weight\": 0.08\n            },\n            DataCategory.COMMUNICATION: {\n                \"tools\": [\"Email\", \"Collaboration\", \"Unified Platform\"],\n                \"metrics\": [\"response_time\", \"transparency\", \"audit_trail\"],\n                \"weight\": 0.08\n            }\n        }\n\n    def _define_evolution_stages(self) -> Dict[MaturityLevel, Dict]:\n        \"\"\"Define characteristics of each evolution stage\"\"\"\n        return {\n            MaturityLevel.LEVEL_0_PAPER: {\n                \"name\": \"Paper-Based\",\n                \"description\": \"Manual, paper-based processes\",\n                \"characteristics\": [\n                    \"Physical document storage\",\n                    \"Manual data entry\",\n                    \"Limited data sharing\",\n                    \"No real-time visibility\"\n                ],\n                \"typical_tools\": [\"Paper forms\", \"Physical filing\"]\n            },\n            MaturityLevel.LEVEL_1_BASIC: {\n                \"name\": \"Basic Digital\",\n                \"description\": \"Basic digitization with standalone tools\",\n                \"characteristics\": [\n                    \"Spreadsheets for calculations\",\n                    \"Email for communication\",\n                    \"File shares for storage\",\n                    \"Manual data transfer between systems\"\n                ],\n                \"typical_tools\": [\"Excel\", \"Word\", \"Email\", \"File shares\"]\n            },\n            MaturityLevel.LEVEL_2_STRUCTURED: {\n                \"name\": \"Structured Data\",\n                \"description\": \"Structured databases and specialized software\",\n                \"characteristics\": [\n                    \"Department-specific software\",\n                    \"Structured databases\",\n                    \"Basic reporting\",\n                    \"Some standardization\"\n                ],\n                \"typical_tools\": [\"CAD\", \"Estimating software\", \"Project software\"]\n            },\n            MaturityLevel.LEVEL_3_INTEGRATED: {\n                \"name\": \"Integrated Systems\",\n                \"description\": \"Connected systems with data flow\",\n                \"characteristics\": [\n                    \"ERP integration\",\n                    \"BIM adoption\",\n                    \"Automated workflows\",\n                    \"Cross-department data sharing\"\n                ],\n                \"typical_tools\": [\"BIM\", \"ERP\", \"CDE\", \"BI dashboards\"]\n            },\n            MaturityLevel.LEVEL_4_AUTOMATED: {\n                \"name\": \"Automated & Analytics\",\n                \"description\": \"Automation and advanced analytics\",\n                \"characteristics\": [\n                    \"Automated data collection\",\n                    \"Machine learning models\",\n                    \"Predictive analytics\",\n                    \"Real-time dashboards\"\n                ],\n                \"typical_tools\": [\"ML platforms\", \"IoT\", \"Advanced analytics\"]\n            },\n            MaturityLevel.LEVEL_5_PREDICTIVE: {\n                \"name\": \"Predictive & Autonomous\",\n                \"description\": \"AI-driven, predictive operations\",\n                \"characteristics\": [\n                    \"Digital twins\",\n                    \"Autonomous decision support\",\n                    \"Continuous optimization\",\n                    \"Predictive maintenance\"\n                ],\n                \"typical_tools\": [\"Digital twins\", \"AI/ML\", \"Autonomous systems\"]\n            }\n        }\n\n    def assess_organization(\n        self,\n        organization_name: str,\n        survey_responses: Dict[str, any],\n        system_inventory: List[Dict],\n        process_documentation: Optional[Dict] = None\n    ) -> MaturityAssessment:\n        \"\"\"\n        Perform comprehensive digital maturity assessment.\n\n        Args:\n            organization_name: Name of the organization\n            survey_responses: Responses from maturity survey\n            system_inventory: List of systems/tools in use\n            process_documentation: Optional process documentation\n\n        Returns:\n            Complete maturity assessment\n        \"\"\"\n        # Analyze data flows\n        data_flows = self._analyze_data_flows(system_inventory, survey_responses)\n\n        # Calculate category scores\n        category_scores = self._calculate_category_scores(\n            data_flows, survey_responses\n        )\n\n        # Determine overall maturity level\n        overall_score = sum(\n            score * self.assessment_criteria[cat][\"weight\"]\n            for cat, score in category_scores.items()\n        )\n        overall_level = self._score_to_level(overall_score)\n\n        # Identify strengths and weaknesses\n        strengths, weaknesses = self._identify_gaps(category_scores)\n\n        # Generate recommendations\n        recommendations = self._generate_recommendations(\n            overall_level, weaknesses, data_flows\n        )\n\n        # Create roadmap\n        roadmap = self._create_roadmap(overall_level, recommendations)\n\n        return MaturityAssessment(\n            organization_name=organization_name,\n            assessment_date=datetime.now(),\n            overall_level=overall_level,\n            category_scores=category_scores,\n            data_flows=data_flows,\n            strengths=strengths,\n            weaknesses=weaknesses,\n            recommendations=recommendations,\n            roadmap=roadmap\n        )\n\n    def _analyze_data_flows(\n        self,\n        system_inventory: List[Dict],\n        survey_responses: Dict\n    ) -> List[DataFlowAssessment]:\n        \"\"\"Analyze data flows between systems\"\"\"\n        flows = []\n\n        for category in DataCategory:\n            # Find systems for this category\n            category_systems = [\n                s for s in system_inventory\n                if s.get(\"category\") == category.value\n            ]\n\n            if not category_systems:\n                flows.append(DataFlowAssessment(\n                    category=category,\n                    source_systems=[],\n                    storage_format=\"none\",\n                    integration_level=0.0,\n                    automation_level=0.0,\n                    data_quality_score=0.0,\n                    issues=[\"No systems identified for this category\"]\n                ))\n                continue\n\n            # Analyze integration and automation\n            integration = self._calculate_integration_score(category_systems)\n            automation = self._calculate_automation_score(\n                category_systems, survey_responses\n            )\n            quality = survey_responses.get(\n                f\"{category.value}_data_quality\", 0.5\n            )\n\n            # Identify issues\n            issues = self._identify_flow_issues(\n                category_systems, integration, automation\n            )\n\n            flows.append(DataFlowAssessment(\n                category=category,\n                source_systems=[s[\"name\"] for s in category_systems],\n                storage_format=category_systems[0].get(\"format\", \"unknown\"),\n                integration_level=integration,\n                automation_level=automation,\n                data_quality_score=quality,\n                issues=issues\n            ))\n\n        return flows\n\n    def _calculate_integration_score(\n        self, systems: List[Dict]\n    ) -> float:\n        \"\"\"Calculate integration score for systems\"\"\"\n        if not systems:\n            return 0.0\n\n        total_integrations = sum(\n            len(s.get(\"integrations\", [])) for s in systems\n        )\n        max_integrations = len(systems) * 3  # Assume max 3 integrations per system\n\n        return min(1.0, total_integrations / max_integrations)\n\n    def _calculate_automation_score(\n        self,\n        systems: List[Dict],\n        survey: Dict\n    ) -> float:\n        \"\"\"Calculate automation score\"\"\"\n        scores = []\n\n        for system in systems:\n            system_score = 0.0\n            if system.get(\"has_api\"):\n                system_score += 0.3\n            if system.get(\"automated_imports\"):\n                system_score += 0.3\n            if system.get(\"automated_exports\"):\n                system_score += 0.2\n            if system.get(\"workflow_automation\"):\n                system_score += 0.2\n            scores.append(system_score)\n\n        return sum(scores) / len(scores) if scores else 0.0\n\n    def _calculate_category_scores(\n        self,\n        data_flows: List[DataFlowAssessment],\n        survey: Dict\n    ) -> Dict[DataCategory, float]:\n        \"\"\"Calculate maturity score for each category\"\"\"\n        scores = {}\n\n        for flow in data_flows:\n            # Combine different aspects\n            tool_score = survey.get(f\"{flow.category.value}_tool_maturity\", 0.5)\n            process_score = survey.get(f\"{flow.category.value}_process_maturity\", 0.5)\n\n            category_score = (\n                tool_score * 0.3 +\n                process_score * 0.2 +\n                flow.integration_level * 0.2 +\n                flow.automation_level * 0.2 +\n                flow.data_quality_score * 0.1\n            )\n\n            scores[flow.category] = category_score\n\n        return scores\n\n    def _score_to_level(self, score: float) -> MaturityLevel:\n        \"\"\"Convert numeric score to maturity level\"\"\"\n        if score < 0.1:\n            return MaturityLevel.LEVEL_0_PAPER\n        elif score < 0.25:\n            return MaturityLevel.LEVEL_1_BASIC\n        elif score < 0.45:\n            return MaturityLevel.LEVEL_2_STRUCTURED\n        elif score < 0.65:\n            return MaturityLevel.LEVEL_3_INTEGRATED\n        elif score < 0.85:\n            return MaturityLevel.LEVEL_4_AUTOMATED\n        else:\n            return MaturityLevel.LEVEL_5_PREDICTIVE\n\n    def _identify_gaps(\n        self,\n        scores: Dict[DataCategory, float]\n    ) -> tuple[List[str], List[str]]:\n        \"\"\"Identify strengths and weaknesses\"\"\"\n        avg_score = sum(scores.values()) / len(scores)\n\n        strengths = [\n            f\"{cat.value}: {score:.0%}\"\n            for cat, score in scores.items()\n            if score > avg_score + 0.1\n        ]\n\n        weaknesses = [\n            f\"{cat.value}: {score:.0%}\"\n            for cat, score in scores.items()\n            if score < avg_score - 0.1\n        ]\n\n        return strengths, weaknesses\n\n    def _identify_flow_issues(\n        self,\n        systems: List[Dict],\n        integration: float,\n        automation: float\n    ) -> List[str]:\n        \"\"\"Identify issues in data flow\"\"\"\n        issues = []\n\n        if integration < 0.3:\n            issues.append(\"Low system integration - data silos likely\")\n        if automation < 0.3:\n            issues.append(\"Manual data transfer required\")\n        if len(systems) > 3:\n            issues.append(\"Multiple overlapping systems\")\n\n        return issues\n\n    def _generate_recommendations(\n        self,\n        level: MaturityLevel,\n        weaknesses: List[str],\n        flows: List[DataFlowAssessment]\n    ) -> List[str]:\n        \"\"\"Generate improvement recommendations\"\"\"\n        recommendations = []\n\n        # Level-specific recommendations\n        level_recs = {\n            MaturityLevel.LEVEL_0_PAPER: [\n                \"Implement basic digital tools (spreadsheets, file sharing)\",\n                \"Digitize critical paper-based processes\",\n                \"Train staff on basic digital skills\"\n            ],\n            MaturityLevel.LEVEL_1_BASIC: [\n                \"Adopt specialized construction software\",\n                \"Implement structured data storage\",\n                \"Standardize data formats and naming conventions\"\n            ],\n            MaturityLevel.LEVEL_2_STRUCTURED: [\n                \"Integrate key systems (ERP, PM, BIM)\",\n                \"Implement Common Data Environment (CDE)\",\n                \"Develop automated workflows\"\n            ],\n            MaturityLevel.LEVEL_3_INTEGRATED: [\n                \"Implement advanced analytics and dashboards\",\n                \"Explore IoT for automated data collection\",\n                \"Develop machine learning models for prediction\"\n            ],\n            MaturityLevel.LEVEL_4_AUTOMATED: [\n                \"Implement digital twin technology\",\n                \"Deploy AI-driven decision support\",\n                \"Enable predictive maintenance and operations\"\n            ],\n            MaturityLevel.LEVEL_5_PREDICTIVE: [\n                \"Continuous optimization of AI models\",\n                \"Expand autonomous decision-making\",\n                \"Industry leadership and knowledge sharing\"\n            ]\n        }\n\n        recommendations.extend(level_recs.get(level, []))\n\n        # Address specific weaknesses\n        for flow in flows:\n            if flow.integration_level < 0.3:\n                recommendations.append(\n                    f\"Improve {flow.category.value} system integrations\"\n                )\n            if flow.data_quality_score < 0.5:\n                recommendations.append(\n                    f\"Implement data quality controls for {flow.category.value}\"\n                )\n\n        return recommendations[:10]  # Top 10 recommendations\n\n    def _create_roadmap(\n        self,\n        current_level: MaturityLevel,\n        recommendations: List[str]\n    ) -> Dict[str, List[str]]:\n        \"\"\"Create phased improvement roadmap\"\"\"\n        return {\n            \"Phase 1 (0-6 months)\": recommendations[:3],\n            \"Phase 2 (6-12 months)\": recommendations[3:6],\n            \"Phase 3 (12-24 months)\": recommendations[6:],\n            \"Target Level\": [\n                f\"Move from {current_level.name} to \"\n                f\"{MaturityLevel(min(current_level.value + 1, 5)).name}\"\n            ]\n        }\n\n    def compare_assessments(\n        self,\n        assessments: List[MaturityAssessment]\n    ) -> Dict:\n        \"\"\"Compare multiple assessments over time or across organizations\"\"\"\n        comparison = {\n            \"assessments\": len(assessments),\n            \"levels\": [a.overall_level.name for a in assessments],\n            \"trends\": {},\n            \"best_practices\": []\n        }\n\n        # Track category trends\n        for category in DataCategory:\n            scores = [a.category_scores[category] for a in assessments]\n            comparison[\"trends\"][category.value] = {\n                \"scores\": scores,\n                \"improvement\": scores[-1] - scores[0] if len(scores) > 1 else 0\n            }\n\n        return comparison\n\n    def generate_report(\n        self,\n        assessment: MaturityAssessment\n    ) -> str:\n        \"\"\"Generate executive summary report\"\"\"\n        stage_info = self.evolution_stages[assessment.overall_level]\n\n        report = f\"\"\"\n# Digital Maturity Assessment Report\n## {assessment.organization_name}\n\n**Assessment Date:** {assessment.assessment_date.strftime('%Y-%m-%d')}\n**Overall Maturity Level:** {assessment.overall_level.name} - {stage_info['name']}\n\n### Executive Summary\n{stage_info['description']}\n\n### Category Scores\n\"\"\"\n        for cat, score in assessment.category_scores.items():\n            bar = \"█\" * int(score * 10) + \"░\" * (10 - int(score * 10))\n            report += f\"- {cat.value.title()}: {bar} {score:.0%}\\n\"\n\n        report += \"\\n### Strengths\\n\"\n        for strength in assessment.strengths:\n            report += f\"- {strength}\\n\"\n\n        report += \"\\n### Areas for Improvement\\n\"\n        for weakness in assessment.weaknesses:\n            report += f\"- {weakness}\\n\"\n\n        report += \"\\n### Recommendations\\n\"\n        for i, rec in enumerate(assessment.recommendations, 1):\n            report += f\"{i}. {rec}\\n\"\n\n        report += \"\\n### Roadmap\\n\"\n        for phase, items in assessment.roadmap.items():\n            report += f\"\\n**{phase}**\\n\"\n            for item in items:\n                report += f\"- {item}\\n\"\n\n        return report\n\n\nclass DataEvolutionTracker:\n    \"\"\"Track data evolution over time\"\"\"\n\n    def __init__(self, organization_name: str):\n        self.organization = organization_name\n        self.history: List[MaturityAssessment] = []\n        self.milestones: List[Dict] = []\n\n    def add_assessment(self, assessment: MaturityAssessment):\n        \"\"\"Add new assessment to history\"\"\"\n        self.history.append(assessment)\n        self._check_milestones(assessment)\n\n    def _check_milestones(self, assessment: MaturityAssessment):\n        \"\"\"Check if any milestones were reached\"\"\"\n        if len(self.history) > 1:\n            prev = self.history[-2]\n\n            # Level improvement\n            if assessment.overall_level.value > prev.overall_level.value:\n                self.milestones.append({\n                    \"date\": assessment.assessment_date,\n                    \"type\": \"level_up\",\n                    \"description\": f\"Advanced from {prev.overall_level.name} \"\n                                   f\"to {assessment.overall_level.name}\"\n                })\n\n            # Category improvements\n            for cat in DataCategory:\n                if assessment.category_scores[cat] - prev.category_scores[cat] > 0.2:\n                    self.milestones.append({\n                        \"date\": assessment.assessment_date,\n                        \"type\": \"category_improvement\",\n                        \"description\": f\"Significant improvement in {cat.value}\"\n                    })\n\n    def get_evolution_summary(self) -> Dict:\n        \"\"\"Get summary of evolution over time\"\"\"\n        if not self.history:\n            return {\"error\": \"No assessments recorded\"}\n\n        return {\n            \"organization\": self.organization,\n            \"first_assessment\": self.history[0].assessment_date,\n            \"latest_assessment\": self.history[-1].assessment_date,\n            \"starting_level\": self.history[0].overall_level.name,\n            \"current_level\": self.history[-1].overall_level.name,\n            \"total_assessments\": len(self.history),\n            \"milestones\": self.milestones,\n            \"level_progression\": [a.overall_level.value for a in self.history]\n        }"
      },
      {
        "title": "Assess Current Digital Maturity",
        "body": "analyzer = DataEvolutionAnalyzer()\n\n# Define systems in use\nsystems = [\n    {\"name\": \"AutoCAD\", \"category\": \"design\", \"has_api\": False},\n    {\"name\": \"Revit\", \"category\": \"design\", \"has_api\": True, \"integrations\": [\"Navisworks\"]},\n    {\"name\": \"Excel\", \"category\": \"cost\", \"has_api\": False},\n    {\"name\": \"MS Project\", \"category\": \"schedule\", \"has_api\": False},\n    {\"name\": \"Email\", \"category\": \"communication\", \"has_api\": False}\n]\n\n# Survey responses (from questionnaire)\nsurvey = {\n    \"design_tool_maturity\": 0.6,\n    \"design_process_maturity\": 0.5,\n    \"design_data_quality\": 0.7,\n    \"cost_tool_maturity\": 0.3,\n    \"cost_process_maturity\": 0.4,\n    \"cost_data_quality\": 0.5,\n    \"schedule_tool_maturity\": 0.4,\n    \"schedule_process_maturity\": 0.3,\n    \"schedule_data_quality\": 0.4\n}\n\nassessment = analyzer.assess_organization(\n    organization_name=\"Construction Co\",\n    survey_responses=survey,\n    system_inventory=systems\n)\n\nprint(f\"Maturity Level: {assessment.overall_level.name}\")\nprint(f\"Recommendations: {assessment.recommendations[:3]}\")"
      },
      {
        "title": "Track Evolution Over Time",
        "body": "tracker = DataEvolutionTracker(\"Construction Co\")\n\n# Add quarterly assessments\ntracker.add_assessment(q1_assessment)\ntracker.add_assessment(q2_assessment)\ntracker.add_assessment(q3_assessment)\n\nsummary = tracker.get_evolution_summary()\nprint(f\"Progress: {summary['starting_level']} → {summary['current_level']}\")\nprint(f\"Milestones: {len(summary['milestones'])}\")"
      },
      {
        "title": "Generate Executive Report",
        "body": "report = analyzer.generate_report(assessment)\nprint(report)\n\n# Save to file\nwith open(\"maturity_report.md\", \"w\") as f:\n    f.write(report)"
      },
      {
        "title": "Quick Reference",
        "body": "ComponentPurposeDataEvolutionAnalyzerMain assessment engineMaturityLevel6 levels from paper to predictiveDataCategory8 categories (design, cost, schedule, etc.)DataFlowAssessmentAnalyze data flows per categoryMaturityAssessmentComplete assessment resultsDataEvolutionTrackerTrack progress over time"
      },
      {
        "title": "Resources",
        "body": "Book: \"Data-Driven Construction\" by Artem Boiko, Chapter 1.1\nWebsite: https://datadrivenconstruction.io"
      },
      {
        "title": "Next Steps",
        "body": "Use data-silo-detection to identify integration gaps\nUse erp-integration-analysis for system integration\nUse digital-maturity-assessment for detailed assessments"
      }
    ],
    "body": "Data Evolution Analysis\nOverview\n\nBased on DDC methodology (Chapter 1.1), this skill analyzes data evolution patterns in construction organizations, assessing digital maturity levels from paper-based workflows to fully data-driven operations.\n\nBook Reference: \"Эволюция использования данных в строительной отрасли\" / \"Evolution of Data Usage in Construction\"\n\nQuick Start\nfrom dataclasses import dataclass, field\nfrom enum import Enum\nfrom typing import List, Dict, Optional\nfrom datetime import datetime\nimport json\n\nclass MaturityLevel(Enum):\n    \"\"\"Digital maturity levels based on DDC methodology\"\"\"\n    LEVEL_0_PAPER = 0      # Paper-based, no digital tools\n    LEVEL_1_BASIC = 1      # Basic digital (spreadsheets, email)\n    LEVEL_2_STRUCTURED = 2  # Structured databases, some integration\n    LEVEL_3_INTEGRATED = 3  # ERP/BIM integration, workflows\n    LEVEL_4_AUTOMATED = 4   # Automated processes, ML/AI\n    LEVEL_5_PREDICTIVE = 5  # Predictive analytics, digital twins\n\nclass DataCategory(Enum):\n    \"\"\"Categories of construction data\"\"\"\n    DESIGN = \"design\"\n    COST = \"cost\"\n    SCHEDULE = \"schedule\"\n    QUALITY = \"quality\"\n    SAFETY = \"safety\"\n    PROCUREMENT = \"procurement\"\n    DOCUMENT = \"document\"\n    COMMUNICATION = \"communication\"\n\n@dataclass\nclass DataFlowAssessment:\n    \"\"\"Assessment of data flow in an organization\"\"\"\n    category: DataCategory\n    source_systems: List[str]\n    storage_format: str\n    integration_level: float  # 0-1\n    automation_level: float   # 0-1\n    data_quality_score: float # 0-1\n    issues: List[str] = field(default_factory=list)\n\n@dataclass\nclass MaturityAssessment:\n    \"\"\"Complete digital maturity assessment\"\"\"\n    organization_name: str\n    assessment_date: datetime\n    overall_level: MaturityLevel\n    category_scores: Dict[DataCategory, float]\n    data_flows: List[DataFlowAssessment]\n    strengths: List[str]\n    weaknesses: List[str]\n    recommendations: List[str]\n    roadmap: Dict[str, List[str]]\n\n\nclass DataEvolutionAnalyzer:\n    \"\"\"\n    Analyze data evolution and digital maturity in construction organizations.\n    Based on DDC methodology Chapter 1.1.\n    \"\"\"\n\n    def __init__(self):\n        self.assessment_criteria = self._load_criteria()\n        self.evolution_stages = self._define_evolution_stages()\n\n    def _load_criteria(self) -> Dict[DataCategory, Dict]:\n        \"\"\"Load assessment criteria for each category\"\"\"\n        return {\n            DataCategory.DESIGN: {\n                \"tools\": [\"CAD\", \"BIM\", \"Collaboration Platform\"],\n                \"metrics\": [\"model_usage\", \"clash_detection\", \"design_reviews\"],\n                \"weight\": 0.20\n            },\n            DataCategory.COST: {\n                \"tools\": [\"Spreadsheets\", \"Estimating Software\", \"ERP\"],\n                \"metrics\": [\"automation_level\", \"historical_data\", \"benchmarking\"],\n                \"weight\": 0.15\n            },\n            DataCategory.SCHEDULE: {\n                \"tools\": [\"Gantt Charts\", \"CPM Software\", \"4D BIM\"],\n                \"metrics\": [\"resource_loading\", \"progress_tracking\", \"forecasting\"],\n                \"weight\": 0.15\n            },\n            DataCategory.QUALITY: {\n                \"tools\": [\"Checklists\", \"QC Software\", \"Defect Tracking\"],\n                \"metrics\": [\"inspection_digitization\", \"defect_analytics\", \"compliance\"],\n                \"weight\": 0.12\n            },\n            DataCategory.SAFETY: {\n                \"tools\": [\"Incident Reports\", \"Safety Software\", \"IoT Sensors\"],\n                \"metrics\": [\"incident_tracking\", \"predictive_safety\", \"training\"],\n                \"weight\": 0.12\n            },\n            DataCategory.PROCUREMENT: {\n                \"tools\": [\"RFQ Manual\", \"e-Procurement\", \"Supply Chain\"],\n                \"metrics\": [\"vendor_management\", \"material_tracking\", \"integration\"],\n                \"weight\": 0.10\n            },\n            DataCategory.DOCUMENT: {\n                \"tools\": [\"File Shares\", \"DMS\", \"CDE\"],\n                \"metrics\": [\"version_control\", \"access_control\", \"searchability\"],\n                \"weight\": 0.08\n            },\n            DataCategory.COMMUNICATION: {\n                \"tools\": [\"Email\", \"Collaboration\", \"Unified Platform\"],\n                \"metrics\": [\"response_time\", \"transparency\", \"audit_trail\"],\n                \"weight\": 0.08\n            }\n        }\n\n    def _define_evolution_stages(self) -> Dict[MaturityLevel, Dict]:\n        \"\"\"Define characteristics of each evolution stage\"\"\"\n        return {\n            MaturityLevel.LEVEL_0_PAPER: {\n                \"name\": \"Paper-Based\",\n                \"description\": \"Manual, paper-based processes\",\n                \"characteristics\": [\n                    \"Physical document storage\",\n                    \"Manual data entry\",\n                    \"Limited data sharing\",\n                    \"No real-time visibility\"\n                ],\n                \"typical_tools\": [\"Paper forms\", \"Physical filing\"]\n            },\n            MaturityLevel.LEVEL_1_BASIC: {\n                \"name\": \"Basic Digital\",\n                \"description\": \"Basic digitization with standalone tools\",\n                \"characteristics\": [\n                    \"Spreadsheets for calculations\",\n                    \"Email for communication\",\n                    \"File shares for storage\",\n                    \"Manual data transfer between systems\"\n                ],\n                \"typical_tools\": [\"Excel\", \"Word\", \"Email\", \"File shares\"]\n            },\n            MaturityLevel.LEVEL_2_STRUCTURED: {\n                \"name\": \"Structured Data\",\n                \"description\": \"Structured databases and specialized software\",\n                \"characteristics\": [\n                    \"Department-specific software\",\n                    \"Structured databases\",\n                    \"Basic reporting\",\n                    \"Some standardization\"\n                ],\n                \"typical_tools\": [\"CAD\", \"Estimating software\", \"Project software\"]\n            },\n            MaturityLevel.LEVEL_3_INTEGRATED: {\n                \"name\": \"Integrated Systems\",\n                \"description\": \"Connected systems with data flow\",\n                \"characteristics\": [\n                    \"ERP integration\",\n                    \"BIM adoption\",\n                    \"Automated workflows\",\n                    \"Cross-department data sharing\"\n                ],\n                \"typical_tools\": [\"BIM\", \"ERP\", \"CDE\", \"BI dashboards\"]\n            },\n            MaturityLevel.LEVEL_4_AUTOMATED: {\n                \"name\": \"Automated & Analytics\",\n                \"description\": \"Automation and advanced analytics\",\n                \"characteristics\": [\n                    \"Automated data collection\",\n                    \"Machine learning models\",\n                    \"Predictive analytics\",\n                    \"Real-time dashboards\"\n                ],\n                \"typical_tools\": [\"ML platforms\", \"IoT\", \"Advanced analytics\"]\n            },\n            MaturityLevel.LEVEL_5_PREDICTIVE: {\n                \"name\": \"Predictive & Autonomous\",\n                \"description\": \"AI-driven, predictive operations\",\n                \"characteristics\": [\n                    \"Digital twins\",\n                    \"Autonomous decision support\",\n                    \"Continuous optimization\",\n                    \"Predictive maintenance\"\n                ],\n                \"typical_tools\": [\"Digital twins\", \"AI/ML\", \"Autonomous systems\"]\n            }\n        }\n\n    def assess_organization(\n        self,\n        organization_name: str,\n        survey_responses: Dict[str, any],\n        system_inventory: List[Dict],\n        process_documentation: Optional[Dict] = None\n    ) -> MaturityAssessment:\n        \"\"\"\n        Perform comprehensive digital maturity assessment.\n\n        Args:\n            organization_name: Name of the organization\n            survey_responses: Responses from maturity survey\n            system_inventory: List of systems/tools in use\n            process_documentation: Optional process documentation\n\n        Returns:\n            Complete maturity assessment\n        \"\"\"\n        # Analyze data flows\n        data_flows = self._analyze_data_flows(system_inventory, survey_responses)\n\n        # Calculate category scores\n        category_scores = self._calculate_category_scores(\n            data_flows, survey_responses\n        )\n\n        # Determine overall maturity level\n        overall_score = sum(\n            score * self.assessment_criteria[cat][\"weight\"]\n            for cat, score in category_scores.items()\n        )\n        overall_level = self._score_to_level(overall_score)\n\n        # Identify strengths and weaknesses\n        strengths, weaknesses = self._identify_gaps(category_scores)\n\n        # Generate recommendations\n        recommendations = self._generate_recommendations(\n            overall_level, weaknesses, data_flows\n        )\n\n        # Create roadmap\n        roadmap = self._create_roadmap(overall_level, recommendations)\n\n        return MaturityAssessment(\n            organization_name=organization_name,\n            assessment_date=datetime.now(),\n            overall_level=overall_level,\n            category_scores=category_scores,\n            data_flows=data_flows,\n            strengths=strengths,\n            weaknesses=weaknesses,\n            recommendations=recommendations,\n            roadmap=roadmap\n        )\n\n    def _analyze_data_flows(\n        self,\n        system_inventory: List[Dict],\n        survey_responses: Dict\n    ) -> List[DataFlowAssessment]:\n        \"\"\"Analyze data flows between systems\"\"\"\n        flows = []\n\n        for category in DataCategory:\n            # Find systems for this category\n            category_systems = [\n                s for s in system_inventory\n                if s.get(\"category\") == category.value\n            ]\n\n            if not category_systems:\n                flows.append(DataFlowAssessment(\n                    category=category,\n                    source_systems=[],\n                    storage_format=\"none\",\n                    integration_level=0.0,\n                    automation_level=0.0,\n                    data_quality_score=0.0,\n                    issues=[\"No systems identified for this category\"]\n                ))\n                continue\n\n            # Analyze integration and automation\n            integration = self._calculate_integration_score(category_systems)\n            automation = self._calculate_automation_score(\n                category_systems, survey_responses\n            )\n            quality = survey_responses.get(\n                f\"{category.value}_data_quality\", 0.5\n            )\n\n            # Identify issues\n            issues = self._identify_flow_issues(\n                category_systems, integration, automation\n            )\n\n            flows.append(DataFlowAssessment(\n                category=category,\n                source_systems=[s[\"name\"] for s in category_systems],\n                storage_format=category_systems[0].get(\"format\", \"unknown\"),\n                integration_level=integration,\n                automation_level=automation,\n                data_quality_score=quality,\n                issues=issues\n            ))\n\n        return flows\n\n    def _calculate_integration_score(\n        self, systems: List[Dict]\n    ) -> float:\n        \"\"\"Calculate integration score for systems\"\"\"\n        if not systems:\n            return 0.0\n\n        total_integrations = sum(\n            len(s.get(\"integrations\", [])) for s in systems\n        )\n        max_integrations = len(systems) * 3  # Assume max 3 integrations per system\n\n        return min(1.0, total_integrations / max_integrations)\n\n    def _calculate_automation_score(\n        self,\n        systems: List[Dict],\n        survey: Dict\n    ) -> float:\n        \"\"\"Calculate automation score\"\"\"\n        scores = []\n\n        for system in systems:\n            system_score = 0.0\n            if system.get(\"has_api\"):\n                system_score += 0.3\n            if system.get(\"automated_imports\"):\n                system_score += 0.3\n            if system.get(\"automated_exports\"):\n                system_score += 0.2\n            if system.get(\"workflow_automation\"):\n                system_score += 0.2\n            scores.append(system_score)\n\n        return sum(scores) / len(scores) if scores else 0.0\n\n    def _calculate_category_scores(\n        self,\n        data_flows: List[DataFlowAssessment],\n        survey: Dict\n    ) -> Dict[DataCategory, float]:\n        \"\"\"Calculate maturity score for each category\"\"\"\n        scores = {}\n\n        for flow in data_flows:\n            # Combine different aspects\n            tool_score = survey.get(f\"{flow.category.value}_tool_maturity\", 0.5)\n            process_score = survey.get(f\"{flow.category.value}_process_maturity\", 0.5)\n\n            category_score = (\n                tool_score * 0.3 +\n                process_score * 0.2 +\n                flow.integration_level * 0.2 +\n                flow.automation_level * 0.2 +\n                flow.data_quality_score * 0.1\n            )\n\n            scores[flow.category] = category_score\n\n        return scores\n\n    def _score_to_level(self, score: float) -> MaturityLevel:\n        \"\"\"Convert numeric score to maturity level\"\"\"\n        if score < 0.1:\n            return MaturityLevel.LEVEL_0_PAPER\n        elif score < 0.25:\n            return MaturityLevel.LEVEL_1_BASIC\n        elif score < 0.45:\n            return MaturityLevel.LEVEL_2_STRUCTURED\n        elif score < 0.65:\n            return MaturityLevel.LEVEL_3_INTEGRATED\n        elif score < 0.85:\n            return MaturityLevel.LEVEL_4_AUTOMATED\n        else:\n            return MaturityLevel.LEVEL_5_PREDICTIVE\n\n    def _identify_gaps(\n        self,\n        scores: Dict[DataCategory, float]\n    ) -> tuple[List[str], List[str]]:\n        \"\"\"Identify strengths and weaknesses\"\"\"\n        avg_score = sum(scores.values()) / len(scores)\n\n        strengths = [\n            f\"{cat.value}: {score:.0%}\"\n            for cat, score in scores.items()\n            if score > avg_score + 0.1\n        ]\n\n        weaknesses = [\n            f\"{cat.value}: {score:.0%}\"\n            for cat, score in scores.items()\n            if score < avg_score - 0.1\n        ]\n\n        return strengths, weaknesses\n\n    def _identify_flow_issues(\n        self,\n        systems: List[Dict],\n        integration: float,\n        automation: float\n    ) -> List[str]:\n        \"\"\"Identify issues in data flow\"\"\"\n        issues = []\n\n        if integration < 0.3:\n            issues.append(\"Low system integration - data silos likely\")\n        if automation < 0.3:\n            issues.append(\"Manual data transfer required\")\n        if len(systems) > 3:\n            issues.append(\"Multiple overlapping systems\")\n\n        return issues\n\n    def _generate_recommendations(\n        self,\n        level: MaturityLevel,\n        weaknesses: List[str],\n        flows: List[DataFlowAssessment]\n    ) -> List[str]:\n        \"\"\"Generate improvement recommendations\"\"\"\n        recommendations = []\n\n        # Level-specific recommendations\n        level_recs = {\n            MaturityLevel.LEVEL_0_PAPER: [\n                \"Implement basic digital tools (spreadsheets, file sharing)\",\n                \"Digitize critical paper-based processes\",\n                \"Train staff on basic digital skills\"\n            ],\n            MaturityLevel.LEVEL_1_BASIC: [\n                \"Adopt specialized construction software\",\n                \"Implement structured data storage\",\n                \"Standardize data formats and naming conventions\"\n            ],\n            MaturityLevel.LEVEL_2_STRUCTURED: [\n                \"Integrate key systems (ERP, PM, BIM)\",\n                \"Implement Common Data Environment (CDE)\",\n                \"Develop automated workflows\"\n            ],\n            MaturityLevel.LEVEL_3_INTEGRATED: [\n                \"Implement advanced analytics and dashboards\",\n                \"Explore IoT for automated data collection\",\n                \"Develop machine learning models for prediction\"\n            ],\n            MaturityLevel.LEVEL_4_AUTOMATED: [\n                \"Implement digital twin technology\",\n                \"Deploy AI-driven decision support\",\n                \"Enable predictive maintenance and operations\"\n            ],\n            MaturityLevel.LEVEL_5_PREDICTIVE: [\n                \"Continuous optimization of AI models\",\n                \"Expand autonomous decision-making\",\n                \"Industry leadership and knowledge sharing\"\n            ]\n        }\n\n        recommendations.extend(level_recs.get(level, []))\n\n        # Address specific weaknesses\n        for flow in flows:\n            if flow.integration_level < 0.3:\n                recommendations.append(\n                    f\"Improve {flow.category.value} system integrations\"\n                )\n            if flow.data_quality_score < 0.5:\n                recommendations.append(\n                    f\"Implement data quality controls for {flow.category.value}\"\n                )\n\n        return recommendations[:10]  # Top 10 recommendations\n\n    def _create_roadmap(\n        self,\n        current_level: MaturityLevel,\n        recommendations: List[str]\n    ) -> Dict[str, List[str]]:\n        \"\"\"Create phased improvement roadmap\"\"\"\n        return {\n            \"Phase 1 (0-6 months)\": recommendations[:3],\n            \"Phase 2 (6-12 months)\": recommendations[3:6],\n            \"Phase 3 (12-24 months)\": recommendations[6:],\n            \"Target Level\": [\n                f\"Move from {current_level.name} to \"\n                f\"{MaturityLevel(min(current_level.value + 1, 5)).name}\"\n            ]\n        }\n\n    def compare_assessments(\n        self,\n        assessments: List[MaturityAssessment]\n    ) -> Dict:\n        \"\"\"Compare multiple assessments over time or across organizations\"\"\"\n        comparison = {\n            \"assessments\": len(assessments),\n            \"levels\": [a.overall_level.name for a in assessments],\n            \"trends\": {},\n            \"best_practices\": []\n        }\n\n        # Track category trends\n        for category in DataCategory:\n            scores = [a.category_scores[category] for a in assessments]\n            comparison[\"trends\"][category.value] = {\n                \"scores\": scores,\n                \"improvement\": scores[-1] - scores[0] if len(scores) > 1 else 0\n            }\n\n        return comparison\n\n    def generate_report(\n        self,\n        assessment: MaturityAssessment\n    ) -> str:\n        \"\"\"Generate executive summary report\"\"\"\n        stage_info = self.evolution_stages[assessment.overall_level]\n\n        report = f\"\"\"\n# Digital Maturity Assessment Report\n## {assessment.organization_name}\n\n**Assessment Date:** {assessment.assessment_date.strftime('%Y-%m-%d')}\n**Overall Maturity Level:** {assessment.overall_level.name} - {stage_info['name']}\n\n### Executive Summary\n{stage_info['description']}\n\n### Category Scores\n\"\"\"\n        for cat, score in assessment.category_scores.items():\n            bar = \"█\" * int(score * 10) + \"░\" * (10 - int(score * 10))\n            report += f\"- {cat.value.title()}: {bar} {score:.0%}\\n\"\n\n        report += \"\\n### Strengths\\n\"\n        for strength in assessment.strengths:\n            report += f\"- {strength}\\n\"\n\n        report += \"\\n### Areas for Improvement\\n\"\n        for weakness in assessment.weaknesses:\n            report += f\"- {weakness}\\n\"\n\n        report += \"\\n### Recommendations\\n\"\n        for i, rec in enumerate(assessment.recommendations, 1):\n            report += f\"{i}. {rec}\\n\"\n\n        report += \"\\n### Roadmap\\n\"\n        for phase, items in assessment.roadmap.items():\n            report += f\"\\n**{phase}**\\n\"\n            for item in items:\n                report += f\"- {item}\\n\"\n\n        return report\n\n\nclass DataEvolutionTracker:\n    \"\"\"Track data evolution over time\"\"\"\n\n    def __init__(self, organization_name: str):\n        self.organization = organization_name\n        self.history: List[MaturityAssessment] = []\n        self.milestones: List[Dict] = []\n\n    def add_assessment(self, assessment: MaturityAssessment):\n        \"\"\"Add new assessment to history\"\"\"\n        self.history.append(assessment)\n        self._check_milestones(assessment)\n\n    def _check_milestones(self, assessment: MaturityAssessment):\n        \"\"\"Check if any milestones were reached\"\"\"\n        if len(self.history) > 1:\n            prev = self.history[-2]\n\n            # Level improvement\n            if assessment.overall_level.value > prev.overall_level.value:\n                self.milestones.append({\n                    \"date\": assessment.assessment_date,\n                    \"type\": \"level_up\",\n                    \"description\": f\"Advanced from {prev.overall_level.name} \"\n                                   f\"to {assessment.overall_level.name}\"\n                })\n\n            # Category improvements\n            for cat in DataCategory:\n                if assessment.category_scores[cat] - prev.category_scores[cat] > 0.2:\n                    self.milestones.append({\n                        \"date\": assessment.assessment_date,\n                        \"type\": \"category_improvement\",\n                        \"description\": f\"Significant improvement in {cat.value}\"\n                    })\n\n    def get_evolution_summary(self) -> Dict:\n        \"\"\"Get summary of evolution over time\"\"\"\n        if not self.history:\n            return {\"error\": \"No assessments recorded\"}\n\n        return {\n            \"organization\": self.organization,\n            \"first_assessment\": self.history[0].assessment_date,\n            \"latest_assessment\": self.history[-1].assessment_date,\n            \"starting_level\": self.history[0].overall_level.name,\n            \"current_level\": self.history[-1].overall_level.name,\n            \"total_assessments\": len(self.history),\n            \"milestones\": self.milestones,\n            \"level_progression\": [a.overall_level.value for a in self.history]\n        }\n\nCommon Use Cases\nAssess Current Digital Maturity\nanalyzer = DataEvolutionAnalyzer()\n\n# Define systems in use\nsystems = [\n    {\"name\": \"AutoCAD\", \"category\": \"design\", \"has_api\": False},\n    {\"name\": \"Revit\", \"category\": \"design\", \"has_api\": True, \"integrations\": [\"Navisworks\"]},\n    {\"name\": \"Excel\", \"category\": \"cost\", \"has_api\": False},\n    {\"name\": \"MS Project\", \"category\": \"schedule\", \"has_api\": False},\n    {\"name\": \"Email\", \"category\": \"communication\", \"has_api\": False}\n]\n\n# Survey responses (from questionnaire)\nsurvey = {\n    \"design_tool_maturity\": 0.6,\n    \"design_process_maturity\": 0.5,\n    \"design_data_quality\": 0.7,\n    \"cost_tool_maturity\": 0.3,\n    \"cost_process_maturity\": 0.4,\n    \"cost_data_quality\": 0.5,\n    \"schedule_tool_maturity\": 0.4,\n    \"schedule_process_maturity\": 0.3,\n    \"schedule_data_quality\": 0.4\n}\n\nassessment = analyzer.assess_organization(\n    organization_name=\"Construction Co\",\n    survey_responses=survey,\n    system_inventory=systems\n)\n\nprint(f\"Maturity Level: {assessment.overall_level.name}\")\nprint(f\"Recommendations: {assessment.recommendations[:3]}\")\n\nTrack Evolution Over Time\ntracker = DataEvolutionTracker(\"Construction Co\")\n\n# Add quarterly assessments\ntracker.add_assessment(q1_assessment)\ntracker.add_assessment(q2_assessment)\ntracker.add_assessment(q3_assessment)\n\nsummary = tracker.get_evolution_summary()\nprint(f\"Progress: {summary['starting_level']} → {summary['current_level']}\")\nprint(f\"Milestones: {len(summary['milestones'])}\")\n\nGenerate Executive Report\nreport = analyzer.generate_report(assessment)\nprint(report)\n\n# Save to file\nwith open(\"maturity_report.md\", \"w\") as f:\n    f.write(report)\n\nQuick Reference\nComponent\tPurpose\nDataEvolutionAnalyzer\tMain assessment engine\nMaturityLevel\t6 levels from paper to predictive\nDataCategory\t8 categories (design, cost, schedule, etc.)\nDataFlowAssessment\tAnalyze data flows per category\nMaturityAssessment\tComplete assessment results\nDataEvolutionTracker\tTrack progress over time\nResources\nBook: \"Data-Driven Construction\" by Artem Boiko, Chapter 1.1\nWebsite: https://datadrivenconstruction.io\nNext Steps\nUse data-silo-detection to identify integration gaps\nUse erp-integration-analysis for system integration\nUse digital-maturity-assessment for detailed assessments"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/datadrivenconstruction/data-evolution-analysis",
    "publisherUrl": "https://clawhub.ai/datadrivenconstruction/data-evolution-analysis",
    "owner": "datadrivenconstruction",
    "version": "2.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/data-evolution-analysis",
    "downloadUrl": "https://openagent3.xyz/downloads/data-evolution-analysis",
    "agentUrl": "https://openagent3.xyz/skills/data-evolution-analysis/agent",
    "manifestUrl": "https://openagent3.xyz/skills/data-evolution-analysis/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/data-evolution-analysis/agent.md"
  }
}