@adaptic/maestro 1.1.7 → 1.4.1

package/workflows/weekly/engineering-health.yaml

@@ -0,0 +1,154 @@
+# Weekly Engineering Health Check
+# Runs every Wednesday at 10:00 GST — before the weekly execution review
+# Uses ccxray and code-review-graph for data-driven engineering insights
+
+name: engineering-health
+schedule: "0 10 * * 3" # Wednesday 10:00
+timezone: Asia/Dubai
+description: >
+  Weekly engineering health assessment. Audits token spend across agent sessions,
+  scans codebase architecture for structural drift, and produces an engineering
+  health dashboard update. Feeds into the weekly strategic memo.
+
+steps:
+  # ── Token budget audit via ccxray ──
+  - id: token-budget-audit
+    skill: ccxray-diagnostics
+    action: weekly-token-audit
+    description: >
+      Analyse the past week's Claude API token consumption across all agent
+      sessions. Identify expensive sessions, cost trends, and optimisation
+      opportunities. Uses ccxray historical logs.
+    timeout: 300
+    inputs:
+      time_range: 7d
+      log_dir: ~/.ccxray/logs/
+      breakdown_by: [agent, workflow, day]
+      compare_to: previous_week
+    outputs:
+      file: outputs/engineering/weekly/{date}/token-audit.md
+      summary:
+        total_tokens: 0
+        total_cost: 0
+        most_expensive_agent: ""
+        week_over_week_delta: ""
+        optimisation_recommendations: []
+
+  # ── Codebase architecture scan via code-review-graph ──
+  - id: architecture-scan
+    skill: code-review-graph
+    action: architecture-overview
+    description: >
+      Run tree-sitter structural analysis across key repositories. Detect
+      circular dependencies, orphaned exports, and architectural drift from
+      the intended design. Compares against previous week's baseline.
+    timeout: 600
+    parallel_with: token-budget-audit
+    inputs:
+      repos:
+        - path: ~/adapticai/engine
+          name: adaptic-engine
+        - path: ~/adapticai/backend
+          name: adaptic-backend
+        - path: ~/maestro
+          name: maestro
+      checks:
+        - circular_dependencies
+        - orphaned_exports
+        - module_coupling_score
+        - public_api_surface_changes
+      baseline: outputs/engineering/weekly/latest/architecture-baseline.json
+    outputs:
+      file: outputs/engineering/weekly/{date}/architecture-scan.md
+      baseline_update: outputs/engineering/weekly/{date}/architecture-baseline.json
+      summary:
+        repos_scanned: 0
+        circular_deps_found: 0
+        orphaned_exports: 0
+        api_surface_changes: []
+
+  # ── Agent performance profile via agents-observe ──
+  - id: agent-performance-review
+    skill: agents-observe
+    action: weekly-performance-profile
+    description: >
+      Review agent execution patterns from the past week. Identify slowest
+      agents, most-used tools, failure patterns, and efficiency trends.
+      Uses agents-observe SQLite historical data.
+    timeout: 300
+    parallel_with: token-budget-audit
+    inputs:
+      time_range: 7d
+      metrics:
+        - agent_duration_distribution
+        - tool_call_frequency
+        - failure_rate_by_agent
+        - bottleneck_tools
+      compare_to: previous_week
+    outputs:
+      file: outputs/engineering/weekly/{date}/agent-performance.md
+      summary:
+        total_sessions: 0
+        avg_session_duration: ""
+        failure_rate: ""
+        slowest_agent: ""
+        most_used_tool: ""
+
+  # ── Quota trend analysis via claude-pace ──
+  - id: quota-trend
+    skill: claude-pace
+    action: weekly-quota-trend
+    description: >
+      Analyse quota utilisation patterns over the past week. Identify peak
+      usage periods, quota constraint frequency, and capacity planning
+      recommendations.
+    timeout: 120
+    parallel_with: token-budget-audit
+    inputs:
+      source: logs/workflows/ # Extract quota data from backlog executor logs
+      time_range: 7d
+      metrics:
+        - daily_peak_usage
+        - red_zone_incidents
+        - deferred_items_count
+    outputs:
+      file: outputs/engineering/weekly/{date}/quota-trend.md
+
+  # ── Synthesise engineering health report ──
+  - id: synthesise-health-report
+    agent: engineering-oversight
+    action: produce-engineering-health-report
+    description: >
+      Synthesise token audit, architecture scan, agent performance, and quota
+      trends into a unified engineering health dashboard update and narrative.
+    timeout: 300
+    depends_on:
+      [token-budget-audit, architecture-scan, agent-performance-review, quota-trend]
+    inputs:
+      components:
+        - outputs/engineering/weekly/{date}/token-audit.md
+        - outputs/engineering/weekly/{date}/architecture-scan.md
+        - outputs/engineering/weekly/{date}/agent-performance.md
+        - outputs/engineering/weekly/{date}/quota-trend.md
+      dashboard: state/dashboards/engineering-health.yaml
+    outputs:
+      file: outputs/engineering/weekly/{date}/engineering-health-report.md
+      dashboard_update: state/dashboards/engineering-health.yaml
+
+  # ── Notify ──
+  - id: notify-ready
+    action: notify
+    description: Signal engineering health report is ready for the execution review
+    depends_on: [synthesise-health-report]
+    inputs:
+      channel: slack
+      target: "#engineering"
+      message: "Weekly engineering health report ready — feeding into execution review."
+
+on_failure:
+  action: log-and-notify
+  message: "Engineering health check failed at step {failed_step}"
+  notify: sophie-chief-of-staff
+  severity: medium
+
+final_output: outputs/engineering/weekly/{date}/engineering-health-report.md