![]() |
VOOZH | about |
We’re so glad you’re here. You can expect all the best TNS content to arrive Monday through Friday to keep you on top of the news and at the top of your game.
Check your inbox for a confirmation email where you can adjust your preferences and even join additional groups.
Follow TNS on your favorite social media networks.
Become a TNS follower on LinkedIn.
Check out the latest featured and trending stories while you wait for your first TNS newsletter.
Whether you love it or hate it, by now most software developers have tried out some version of AI-coding tools. However, once we look beyond the vanity metrics of daily or weekly AI-tools usage, the adoption in enterprise is all over the place.
There are developers who swear by it and report 10x productivity (except when they run out of token usage), and there are those skeptical of whether this even adds any value or just increases the tech debt.
The truth is, both of these behaviors can be experienced at the same company.
There are a few problems with the current approach of AI adoption in enterprises:
Recently, I talked about the rise of AI-coding environments that code autonomously. These coding agents can take instructions from the developers and execute them with little hand-holding. This means that, unlike the coding agents tied to your IDE, these can scale exponentially, performing hundreds of parallel operations, only limited by the amount of work that can be assigned to them, and of course, the LLM budgets of your organization.
However, this is just the infrastructure side of the equation. The problems of the lack of context, lost tribal knowledge and varying levels of engineers’ familiarity with AI remain.
Ultimately, the engineers who know how to work well with the IDE-based agents would get value out of this, but remote agents themselves don’t solve the real enterprise problem: lack of developer-AI collaboration.
Spec-driven development represents perhaps the most significant paradigm shift from traditional “vibe coding” to structured, specification-first AI development. This approach treats specifications as “super prompts”: Version-controlled, human-readable documents that serve as comprehensive context for AI agents. Think of these documents as detailed product specs that act as a contract between humans and AI agents that cover business context, edge cases with clear guidance of how to navigate the code.
With that in mind, specs become more critical and binding than the code. If that’s the case, it’s time we treat these specs as first-class citizens.
I also wrote about the value of code reviews. More than finding bugs, code reviews help with knowledge sharing. This is how tribal knowledge gets pushed out from one person to another. I’m also a big fan of occasional pair programming as an alternative that helps align ideas quickly. However, if we look at our patterns of AI-coding, we do everything the opposite way:
We work on the prompts in our IDEs, provide feedback to the coding agents back and forth, generate the code, submit the code for review and then throw away the prompts.
These prompts are the context, these prompts are the tribal knowledge. It’s time we start preserving these prompts.
This is where the concept of runbooks comes in. Runbooks for agentic AI are a way to save the context, collaborate on prompts, share execution workflows and maintain audit trails and pre-configured remote agentic environments.
The real power of runbooks shows when more than one engineer is involved. Building software with AI agents isn’t a solo sport, especially when projects touch multiple repos, services and prompt engineering knowledge.
Runbooks let teams switch from single-player to multiplayer mode to:
These runbooks bridge the gap between product specs and the code:
Reusable Runbooks capture the team’s AI prompting knowledge and execution patterns that evolve. If these are living, breathing documents, it’s important to maintain versioning.
There are several benefits:
Specs are the new code. Once we learn to collaborate on the specs the way we have learned to collaborate on the code in the last few decades, we will be able to fully use the power of AI agentic tools. Try Runbooks and turn AI coding from individual experiments into team-wide engineering projects.