Automating Cross-Repo Docs with GitHub Agentic Workflows
GitHub Blog AI/ML · rss · 2026-07-09
The Microsoft Aspire team shared their engineering practice of using GitHub Agentic Workflows to automate cross-repository documentation generation.
- Pain Point: Code and documentation reside in separate repositories. Traditionally, documentation lags significantly behind feature releases, requiring extensive manual reverse engineering to understand code changes.
- Solution: By authoring Markdown workflow files, AI agents are triggered post-merge to automatically read diffs and draft Pull Requests in the documentation repo according to established guidelines.
- Security & Permissions: Agents do not have direct write access. Instead, they output structured intents (JSON) executed by strictly restricted, safe handlers. This ensures agents operate with least privilege, meeting enterprise security audit requirements.
- Results: 82 documentation PRs were automatically created and merged within 30 days. Median merge time dropped to 44.8 hours, all without adding new personnel.
More from coding & agent
- A Reddit demo argues online stores should expose carts and pricing through MCP — gelembjuk · 2026-07-22
- Open-source AI SDK provider routes Vercel apps through a local Codex subscription — lgrammel · 2026-07-22
- Codex vs Claude Code: Which Is More Popular? — jxnlco · 2026-07-22
- CodeRabbit uses layers, diagrams and a chat agent to rethink code review — _jaydeepkarale · 2026-07-22
- Claude Managed Agents demo shared with Vercel in a new presentation — brada · 2026-07-22
- Solo founder turns complaints on screen into bug reports with a local MCP server — phdptsd · 2026-07-22