--- id: documentation.export-metrics version: 1.0.0 category: documentation experimental: true name: Export Metrics description: Export feedback metrics in machine-readable formats (JSON, CSV, HTML) tags: - documentation - export - metrics - reporting model_requirements: min_context: 128000 recommended: - claude-haiku-4.5 agents: dependencies: requires: - context.use-modern-cli-tools - documentation.generate-feedback-report inputs: - name: summary_statistics description: Summary statistics from feedback report type: object required: true - name: export_format description: Export format (json, csv, html, markdown) type: string required: true validation: enum: ['json', 'csv', 'html', 'markdown'] - name: output_path description: Optional custom output path type: string required: false outputs: - exported_file_path - export_status tokens: avg: 1500 max: 3000 min: 800 --- # Export Metrics ## Objective Export feedback metrics and statistics in the specified machine-readable format for programmatic analysis or sharing. ## Instructions ### Step 1: Prepare Export Data Collect all metrics to export: - Summary statistics - Performance metrics - Quality scores - User feedback - Recommendations - Timeline data ### Step 2: Format Based on Export Type #### JSON Export (`export_format = "json"`) **Structure:** ```json { "metadata": { "generated_at": "", "workflow_type": "", "workflow_duration_minutes": , "report_version": "1.0.0" }, "summary": { "satisfaction_score": , "efficiency_score": , "quality_score": , "commands_executed": , "files_changed": , "errors_encountered": , "improvements_identified": }, "performance": { "time_efficiency_score": , "time_breakdown": { : }, "error_rate": , "bottlenecks": [] }, "quality": { "code_quality_score": , "test_quality_score": , "review_quality_score": , "overall_quality_score": }, "feedback": { "satisfaction_score": , "pain_points": [], "success_highlights": [] }, "recommendations": { "agent_improvements": [], "prompt_refinements": [], "workflow_optimizations": [] } } ``` **File path:** `knowledge-base/feedback/-.json` #### CSV Export (`export_format = "csv"`) **Tabular format for spreadsheet analysis:** ```csv Metric,Value,Category,Priority Satisfaction Score,8,User Feedback,N/A Efficiency Score,75,Performance,N/A Quality Score,87,Quality,N/A Commands Executed,6,Summary,N/A Files Changed,12,Summary,N/A Time: fetch-task,150,Performance,N/A Time: plan,345,Performance,N/A ... Error Rate,0.04,Performance,N/A Bottleneck: test,900,Performance,High Recommendation: Parallelize tests,N/A,Optimization,High ... ``` **File path:** `knowledge-base/feedback/-.csv` #### HTML Export (`export_format = "html"`) **Shareable web page with charts:** ```html Feedback Report: <Workflow Type>

Feedback Report:

Executive Summary

Performance Metrics

Quality Assessment

Recommendations

``` **File path:** `knowledge-base/feedback/-.html` #### Markdown Export (`export_format = "markdown"`) **Default format from generate-feedback-report:** Use the markdown report already generated. **File path:** `knowledge-base/feedback/-.md` ### Step 3: Write to File **Determine output path:** ``` If output_path provided: use output_path Else: use default: knowledge-base/feedback/-. ``` **Ensure directory exists:** ```bash mkdir -p .valora/feedback ``` **Write file:** Use appropriate write operation for format. ### Step 4: Validate Export **Check:** - File created successfully - File is not empty - Format is valid (parse if JSON/CSV) - File size is reasonable **Calculate file size:** ```bash stat -f%z # macOS stat -c%s # Linux ``` ## Output Format ```json { "exported_file_path": "knowledge-base/feedback/20251115-1430-feature-implementation.json", "export_status": "success", "export_format": "json", "file_size_kb": 45, "timestamp": "2025-11-15T14:30:00Z" } ``` ## Success Criteria - ✅ Export format correctly selected - ✅ Data structured appropriately for format - ✅ File written to correct location - ✅ File is valid and non-empty - ✅ Export status confirmed ## Error Handling - **Invalid format**: Return error, list valid formats - **Write permission denied**: Try alternate location or fail gracefully - **Directory doesn't exist**: Create directory - **File already exists**: Append timestamp to avoid overwrite ## Format Selection Guide **JSON:** - Best for: Programmatic analysis, API integration - Use case: Feeding data into analytics tools **CSV:** - Best for: Spreadsheet analysis, data science - Use case: Excel/Google Sheets import, pandas analysis **HTML:** - Best for: Sharing with non-technical stakeholders - Use case: Email reports, web publishing **Markdown:** - Best for: Human reading, version control - Use case: Default report format, git-friendly