TLDR Tech
AI Agents Writing Your Docs: The Control Question
Eighty-two merged pull requests. Forty-four hours median turnaround. Aspire's experiment with GitHub Agentic Workflows for cross-repository documentation is a genuinely useful data point, but the number that matters most isn't in the headline metrics.
It's the security architecture underneath.
The team gave their AI agents scoped permissions and kept human review in the loop. That might sound like table stakes, but in financial services it's the whole game. Any organisation running loan origination or credit decisioning infrastructure knows that the gap between "the AI did something useful" and "the AI did something auditable" is enormous. Regulators don't care how fast your documentation updated. They care who approved it and whether you can prove it.
What Aspire has actually demonstrated is a pattern worth studying:
- Agents operate within tightly bounded permissions, not open-ended access
- Output goes through human review before it merges
- The workflow produces an evidence trail by default
That last point is underappreciated. Documentation that updates automatically and leaves a commit history is more auditable than a Confluence page someone edited at 11pm before a deadline.
For UK consumer credit specifically, there's a practical application here that goes beyond developer productivity. FCA-regulated firms carry obligations around maintaining accurate records of system behaviour, particularly for AI-driven credit decisions under the Consumer Duty framework. Cross-repo documentation agents, built with proper permission scoping, could contribute to that compliance posture rather than undermine it.
The instinct in financial services is to treat AI automation as a risk to be managed. Sometimes that's right. But when the workflow is designed so that nothing merges without a human sign-off and every action is logged, you've built something that's arguably more controlled than your current manual process.
The question worth asking your engineering leads: if your documentation already lags your code by weeks, what's the actual risk reduction from keeping that process entirely human?
- agentic
- AI agents
- AI