Home/Foundations/New Bottlenecks

Section 1.5.10

Further Reading

New Bottlenecks

Further Reading

This chapter introduced the five new bottlenecks that emerge when coding accelerates through AI agents. The concepts here connect to foundations laid in earlier chapters and preview practical solutions coming in Parts 2 and 3. This section provides a curated roadmap for deeper exploration.

Related Chapters in This Book

Foundational Concepts (Part 1)

These earlier chapters establish the conceptual foundation for understanding why bottlenecks shift when development accelerates:

The Renaissance Developer Why generalist skills help you sidestep coordination bottlenecks. Understanding how being "good enough at everything" creates velocity advantages when you don't need to coordinate across specialized roles.

What is Agentic Coding Comprehensive overview of the tools and approaches that create 5-10x acceleration. Understanding where speed gains come from helps you predict where new constraints will emerge.

Architecture Principles for Agentic Development First principles for designing systems that scale with AI velocity. Directly addresses the architecture bottleneck through digestible decomposition and clear boundaries.

Digestible Interfaces Making your architecture both human-understandable and AI-friendly. The digestibility principle applies to specifications, interfaces, and component boundaries—all critical for avoiding bottlenecks.

The Playbook: Solutions to These Bottlenecks (Part 2)

Part 2 provides the complete 6-week workflow that addresses each bottleneck through systematic practices:

Overview of the 6-Week Journey (Chapter 1) The complete workflow from idea to production, optimized for agentic development. Shows how specification-driven development, outcome-based product management, and testing strategies fit together.

Idea to Brainstorm (Chapter 2) Clarifying requirements early through structured exploration. Addresses the requirements bottleneck by investing time upfront to eliminate ambiguity.

Brainstorm to Brief (Chapter 3) Defining product vision clearly with outcome-based thinking. Addresses the product decision bottleneck by establishing principles and success metrics that guide autonomous implementation.

Brief to Requirements (Chapter 4) Writing specifications with EARS notation. The core tool for addressing the requirements bottleneck through formal, unambiguous requirement statements that AI can implement correctly.

Requirements to Design (Chapter 5) Architecture-first approach that addresses the design clarity bottleneck. Documents system structure before building features to prevent architectural drift.

Design to Implementation (Chapter 6) Breaking down architecture into implementation tasks. Shows how clear specifications enable confident AI-assisted implementation.

Testing Strategies (Chapter 7) Validation at velocity. Directly addresses the testing bottleneck through test strategy-first workflows and acceptance criteria derived from requirements.

Deployment Pipeline (Chapter 8) CI/CD optimized for rapid iteration. Automates validation to match implementation velocity.

Managing AI Agents (Chapter 10) Working effectively with AI implementation partners. Practical patterns for prompting, reviewing, and iterating with Claude and other AI coding tools.

Deep Dive Patterns and Tools (Part 3)

Part 3 chapters provide detailed patterns, tools, and techniques referenced throughout this chapter:

EARS Notation (Specifications) Complete reference for writing requirements using the Easy Approach to Requirements Syntax. Includes all five forms with examples and anti-patterns.

OpenAPI for REST APIs (Specifications) API specification before implementation. Shows how to define every endpoint, parameter, and response before writing code, eliminating ambiguity.

AsyncAPI for Events (Specifications) Event-driven system specification. Documents pub/sub patterns, message formats, and async behaviors formally.

JSON Schema Validation (Specifications) Data model specification with types, constraints, and validation rules. Makes data contracts explicit before implementation.

Component Decomposition (Architecture) Architectural clarity through bounded contexts and clear interfaces. Practical patterns for decomposing systems digestibly.

Testing AI-Generated Code (Testing) Validation strategies specific to AI-generated implementations. Covers test strategy development, risk-based prioritization, and automation.

Code Review Patterns (Toolchain) Review at scale. Patterns for outcome-focused review, AI-assisted review, and async review processes.

External Resources

On Requirements and Specifications

Mavin, Alistair and Wilkinson, Philip. "EARS (Easy Approach to Requirements Syntax)" The original paper introducing EARS notation. Essential reading for understanding why formal requirements matter in agentic development.

Wiegers, Karl and Beatty, Joy. "Software Requirements, 3rd Edition" Comprehensive requirements engineering textbook. Covers elicitation, specification, validation, and management. Provides broader context for why requirements become critical bottlenecks.

OpenAPI Specification https://swagger.io/specification/ The de facto standard for REST API specification. Essential reference for specification-driven API development.

AsyncAPI Specification https://www.asyncapi.com/ Specification standard for event-driven and asynchronous APIs. Complements OpenAPI for systems using message queues, WebSockets, or pub/sub patterns.

On Testing and Quality

Fowler, Martin. "Testing Strategies in a Microservice Architecture" https://martinfowler.com/articles/microservice-testing/ Explores testing strategies at multiple levels. Particularly relevant for understanding integration testing challenges in distributed systems.

Vocke, Ham. "The Practical Test Pyramid" https://martinfowler.com/articles/practical-test-pyramid.html Modern interpretation of the test pyramid with practical guidance on test distribution. Directly applicable to testing AI-generated code.

Marick, Brian. "Testing Foundations" http://www.exampler.com/testing-com/ Fundamental testing concepts and strategies. Provides the conceptual foundation for test strategy development.

On Architecture and Design

Vernon, Vaughn. "Domain-Driven Design Distilled" Concise introduction to DDD concepts including bounded contexts, aggregates, and ubiquitous language. Essential for understanding how to decompose systems with clear boundaries.

Ford, Neal et al. "Building Evolutionary Architectures" Designing for change and managing technical debt. Particularly relevant for maintaining architectural coherence while moving fast with AI assistance.

Martin, Robert C. "Clean Architecture" Interface design, dependency management, and architectural boundaries. Foundational concepts for creating digestible system structures.

On Product Management and Decision-Making

Cagan, Marty. "Inspired: How to Create Tech Products Customers Love" Product vision, decision-making frameworks, and empowered teams. Provides context for outcome-based product management approaches.

Ries, Eric. "The Lean Startup" MVP thinking, rapid iteration, and validated learning. Foundational concepts for shipping quickly while managing risk.

Olsen, Dan. "The Lean Product Playbook" Outcome-based product development with hypothesis-driven iteration. Practical framework for product work that matches agentic velocity.

On Velocity and Bottlenecks

Goldratt, Eliyahu M. "The Goal" Theory of Constraints applied to manufacturing. The core concepts of identifying and managing bottlenecks apply directly to software development. Essential reading for understanding how bottlenecks determine system throughput.

Kim, Gene et al. "The DevOps Handbook" Flow, feedback, and continuous improvement in software delivery. Provides the operational context for maintaining velocity through deployment and production.

Forsgren, Nicole et al. "Accelerate" Research-based guidance on measuring and improving software delivery performance. Data-driven insights into what practices actually improve velocity.

On AI-Assisted Development

Note: Resources on agentic coding are rapidly evolving as the field matures. The most current guidance lives in tool documentation and community practice rather than books. Check this book's website for curated, up-to-date resources.

Claude Documentation https://docs.anthropic.com/ Official documentation for Claude including API reference, prompting guides, and best practices. Essential for effective use of Claude Code.

GitHub Copilot Research https://github.blog/ Research and case studies on AI pair programming. Provides empirical data on productivity impacts and usage patterns.

Anthropic Research Blog https://www.anthropic.com/research Cutting-edge research on language models, AI safety, and capability advances. Helps understand the trajectory of AI coding tools.

Community and Discussion

Book Resources

GitHub Repository Source repository for this book (URL to be added). Submit issues for corrections, suggestions, or questions. Contributions welcome under CC BY 4.0 license.

GitHub Discussions Community forum for readers to share experiences, ask questions, and discuss patterns. Active discussions on applying these concepts to real projects.

Broader Community

AI Engineering Communities Online communities focused on building with AI tools are emerging rapidly. Search for Discord servers, Slack workspaces, and forums focused on "AI engineering" or "agentic coding" for current community hubs.

Author's Resources Check the book's website for blog posts, video walkthroughs, and updated resources as the field evolves. Supplementary materials that couldn't fit in the book will be published there.

Next Steps

Having completed Part 1, you now understand:

  • The Renaissance Developer mindset and why generalist skills matter
  • What agentic coding is and where 5-10x speed gains come from
  • Architectural principles for systems that scale with AI velocity
  • Why digestible interfaces benefit both humans and AI
  • The five new bottlenecks and how to address them

You're ready for Part 2: The Playbook, which transforms these concepts into systematic workflows for shipping products in 6 weeks using agentic coding. The next chapter begins the journey from idea to production with a complete workflow optimized for the new bottlenecks.

Let's build something.