Leanpub Book LAUNCH 🚀 Writing Use Cases for AI: How to write use cases for stakeholders, engineers, and AI agents by Simon Martinelli

For forty years, use cases have been the best tool we have for describing what a system must do. Ivar Jacobson invented them, Alistair Cockburn taught a generation to write them well, and Use-Case 3.0 connected them to modern agile delivery. All of that work assumed one thing: the reade...

Welcome to the Leanpub Launch video for Writing Use Cases for AI: How to write use cases for stakeholders, engineers, and AI agents by Simon Martinelli!

Writing Use Cases for AI: How to write use cases for stakeholders, engineers, and AI agents
Writing Use Cases for AI: How to write use cases for stakeholders, engineers, and AI agents by Simon Martinelli — available as an ebook on Leanpub.

About the Book

Book cover image of Writing Use Cases for AI by Simon Martinelli
Writing Use Cases for AI: How to write use cases for stakeholders, engineers, and AI agents by Simon Martinelli

For forty years, use cases have been the best tool we have for describing what a system must do. Ivar Jacobson invented them, Alistair Cockburn taught a generation to write them well, and Use-Case 3.0 connected them to modern agile delivery. All of that work assumed one thing: the reader of a use case is a human being.

That assumption no longer holds. With AI code generation, a use case has a third reader: an AI agent that turns the specification directly into code and tests. Implementation has become cheap; expressing intent precisely is the new bottleneck. The specification is now the asset, and the code is its output.

This guide teaches you to write use cases that work for all three readers: the stakeholders who validate them, the engineers who review against them, and the AI agents that implement from them. You'll learn:

  • What actually changes when an AI reads your specification
  • The classical fundamentals that still carry the weight: actors, goals, scope, and complete behavioral stories
  • A practical specification template with a fully worked example
  • How to write main scenarios and alternative flows an AI cannot misread
  • Precision calibration: what to say, what to leave out, and how tests protect the gaps
  • How to slice use cases for iteration, and how to handle change requests, bugs, and brownfield systems
  • Checklists and common mistakes to keep open in a split pane while you write

Part of the AI Unified Process, and a companion to Spec-Driven Development: From Specs to Code with AI Agents (Apress, 2026). Written for requirements engineers, business analysts, and software engineers who know use cases from Cockburn or Use-Case 3.0 and want the delta, not a rehash.

About the Author

Picture of Simon Martinelli, Author of Writing Use Cases for AI: How to write use cases for stakeholders, engineers, and AI agents
Simon Martinelli, Author of Writing Use Cases for AI: How to write use cases for stakeholders, engineers, and AI agents

Simon Martinelli is a Java Champion, Vaadin Champion, and Oracle ACE Pro with over three decades of experience as a software architect, developer, consultant, and trainer. He is the creator of the AI Unified Process (AIUP) and a strong advocate of Spec-Driven Development.

As the owner of Martinelli LLC, he coaches teams to get up to speed with AI-driven development. He regularly shares his insights through international conferences, articles, and his blog, Keep IT Simple (https://martinelli.ch), where he writes about AI, architecture, and modern Java development.

He is also a lecturer at three universities in Switzerland, where he teaches AI-driven software engineering, software architecture, persistence, DevOps, and cloud-native development.

Follow the author here!

Watch Clips From The Video


Leanpub
Publish Early, Publish Often