[docs] Self-healing documentation fixes from issue analysis - 2026-04-04

[github-actions]

Self-Healing Documentation Fixes

This PR was automatically created by the Daily Documentation Healer workflow.

Gaps Fixed

• agent-factory-status.mdx stale workflow entries — Removed 4 rows from the Agent Factory status table that pointed to workflow files deleted in PR chore: remove token usage analyzers, optimizers, and shared deps #24448 (chore: remove token usage analyzers, optimizers, and shared deps). The deleted files were:

  • claude-token-optimizer.md / .lock.yml
  • claude-token-usage-analyzer.md / .lock.yml
  • copilot-token-optimizer.md / .lock.yml
  • copilot-token-usage-analyzer.md / .lock.yml

  Each row contained a dead source-file link and a broken status-badge image pointing to non-existent workflows.

Root Cause

DDUw's Step 2 heuristic scans for "Features Removed" in merged PRs, but commit #24448 was prefixed chore: — not feat:, fix:, or docs: — and removed only workflow definition files (.github/workflows/), not source code. DDUw's PR scanner does not scan chore: prefixed commits for documentation side-effects in docs/src/. Additionally, the removal PR landed at 06:52 UTC, just after DDUw's 06:00 UTC scan window closed, so even a broader heuristic would have missed it on this cycle.

💡 DDUw Improvement Suggestions

DDUw Improvement Suggestions

Pattern: PRs that delete .github/workflows/*.md files leave stale rows in agent-factory-status.mdx, which is a manually maintained index of all workflow files. DDUw's current Step 2 analysis does not cross-reference deletions in .github/workflows/ against the status page.

Suggested new Step 2 sub-check: After listing merged commits, run:

git diff --name-only --diff-filter=D HEAD~1 HEAD -- '.github/workflows/*.md'

For each deleted .github/workflows/<name>.md file, search docs/src/content/docs/agent-factory-status.mdx for a row referencing that file. If found, remove the row in the same PR. This is a mechanical, high-confidence fix requiring no judgment.

Why DDUw missed this: chore: prefix commits are not currently flagged for documentation side-effect review. Adding a file-deletion cross-reference check would catch this class of gap regardless of commit prefix.

Related Issues

No open issue tracked this gap; it was identified by cross-referencing today's chore: removal commit against the documentation status page.

References:

• §23979668846

Note

🔒 Integrity filter blocked 1 item

The following item were blocked because they don't meet the GitHub integrity level.

• #20207 search_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".

To allow these resources, lower min-integrity in your GitHub frontmatter:

tools:
  github:
    min-integrity: approved  # merged | approved | unapproved | none

Generated by Daily Documentation Healer · ● 360.3K · ◷

• expires on Apr 7, 2026, 1:26 PM UTC

[Copilot]

Pull request overview

Removes stale entries from the Agent Factory status documentation that referenced workflows deleted in PR #24448, eliminating dead source links and broken status badges.

Changes:

• Removed 4 workflow rows from the Agent Factory status table that pointed to deleted workflow docs and lock files.
• Eliminated dead GitHub Actions badge URLs associated with the removed workflows.

Show a summary per file

File	Description
docs/src/content/docs/agent-factory-status.mdx	Prunes removed workflow rows so the status table no longer links to non-existent workflow docs/badges.

Copilot's findings

Tip

Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

• Files reviewed: 1/1 changed files
• Comments generated: 0