[deep-report] Add cost gate and pre-flight check to Documentation Unbloat (~$55/week at 50% success rate) #26238

Description

The Documentation Unbloat workflow has a ~50% success rate and costs approximately $55/week due to Claude engine usage on inconsistent runs. The Agent Performance Report identifies this as a high-cost, low-value pattern. No pre-flight check exists to skip the run when preconditions are unmet, leading to costly failures.

Expected Impact

Adding a pre-flight check that validates documentation structure before invoking the Claude agent could cut wasted spend by 50% ($27/week savings). At scale, this represents better ROI on Claude engine capacity.

Suggested Agent

Agentic Maintenance agent — add a pre-flight validation step to the Documentation Unbloat workflow that checks for the expected documentation structure before triggering the Claude agent. If preconditions fail, exit early with noop rather than incurring full agent cost.

Estimated Effort

Quick (< 1 hour) — add pre-flight step + compile

Data Source

• Agent Performance Report (Apr 14, 2026): Documentation Unbloat Quality 55/100, Effectiveness 50/100, ~$55/week cost
• DeepReport Intelligence Briefing analysis run: §24406524749

Generated by DeepReport - Intelligence Gathering Agent · ● 433.4K · ◷

• expires on Apr 16, 2026, 3:14 PM UTC