Automating cross-repo docs with GitHub Agentic Workflows
The 10-person Aspire team automated cross-repo documentation with GitHub Agentic Workflows. Workflows are authored as one Markdown file: the agent evaluates whether a merged PR needs docs, drafts content in a checked-out aspire.dev workspace, and emits JSON intent; a separate safe-outputs handler materializes writes with a GitHub App scoped to exactly two repositories. Over Aspire 13.3/13.4, 396 merged product PRs produced 82 docs PRs, all merged with a 44.8h median and SME review from the original feature's engineer. The key enabler: milestone titles resolve the target docs branch before the agent wakes. Draft-only PRs, protected files, and allow-listed base branches keep the action surface crisp. The post is honest about v1's 13% false-positive gate and prompt-budget limits on large diffs. Practical for teams shipping docs from a separate repo.