Skip to content

Commit e04538f

Browse files
testac974claude
andcommitted
Scaffold Part 1 Chapter 5: New Bottlenecks (P1-006)
Created chapter directory with 10 section files covering the new bottlenecks that emerge when coding accelerates 5-10x through agentic tools. Sections: 1. Introduction: The Acceleration Paradox 2. Understanding the 5-10x Multiplier 3. Bottleneck #1: Requirements and Business Vision 4. Bottleneck #2: Product Decision Making 5. Bottleneck #3: Architecture and Design Clarity 6. Bottleneck #4: Code Review at Scale 7. Bottleneck #5: Testing and Quality Assurance 8. Solutions and Mitigation Strategies 9. Summary 10. Further Reading Each section includes: - Proper YAML frontmatter with section-level metadata - Thoughtful placeholder guidance customized to the section topic - 7 Mermaid diagram placeholders for visualizing bottleneck shifts - Cross-references to existing Part 1 chapters only - Requirements traceability (REQ-C006) Chapter is ready for content drafting with the draft-section skill. Progress: 13/81 tasks complete (16%) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
1 parent 6bcfe5e commit e04538f

12 files changed

Lines changed: 1139 additions & 18 deletions

book/TABLE_OF_CONTENTS.md

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,19 @@
5454
- [Summary: The Unified Design Philosophy](./part1-foundations/04-digestible-interfaces/09-summary.md)
5555
- [Further Reading and Resources](./part1-foundations/04-digestible-interfaces/10-further-reading.md)
5656

57+
### Chapter 5: New Bottlenecks
58+
59+
- [Introduction: The Acceleration Paradox](./part1-foundations/05-new-bottlenecks/01-introduction.md)
60+
- [Understanding the 5-10x Multiplier](./part1-foundations/05-new-bottlenecks/02-understanding-the-5-10x-multiplier.md)
61+
- [Bottleneck #1: Requirements and Business Vision](./part1-foundations/05-new-bottlenecks/03-bottleneck-1-requirements-and-business-vision.md)
62+
- [Bottleneck #2: Product Decision Making](./part1-foundations/05-new-bottlenecks/04-bottleneck-2-product-decision-making.md)
63+
- [Bottleneck #3: Architecture and Design Clarity](./part1-foundations/05-new-bottlenecks/05-bottleneck-3-architecture-and-design-clarity.md)
64+
- [Bottleneck #4: Code Review at Scale](./part1-foundations/05-new-bottlenecks/06-bottleneck-4-code-review-at-scale.md)
65+
- [Bottleneck #5: Testing and Quality Assurance](./part1-foundations/05-new-bottlenecks/07-bottleneck-5-testing-and-quality-assurance.md)
66+
- [Solutions and Mitigation Strategies](./part1-foundations/05-new-bottlenecks/08-solutions-and-mitigation-strategies.md)
67+
- [Summary](./part1-foundations/05-new-bottlenecks/09-summary.md)
68+
- [Further Reading](./part1-foundations/05-new-bottlenecks/10-further-reading.md)
69+
5770
## Part 2
5871

5972
### Chapter 3: From Brainstorm to Product Brief
Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,47 @@
1+
---
2+
title: "Introduction: The Acceleration Paradox"
3+
chapter_title: "New Bottlenecks"
4+
part: 1
5+
chapter: 5
6+
section: 1
7+
version: "0.1"
8+
date: "2026-02-05"
9+
status: "draft"
10+
author: "Brian Childress"
11+
tags: ["bottlenecks", "workflow", "foundations", "velocity", "constraints"]
12+
related:
13+
- part1-foundations/02-what-is-agentic-coding/02-defining-agentic-coding.md
14+
requirements:
15+
- REQ-C006
16+
abstract: |
17+
[Placeholder: Introduces the acceleration paradox - when coding speed increases 5-10x,
18+
new bottlenecks emerge that shift from implementation to upstream decisions and downstream
19+
validation. 1-2 sentences for search and navigation.]
20+
---
21+
22+
# Introduction: The Acceleration Paradox
23+
24+
[Placeholder: Hook the reader with a relatable scenario showing the paradox.
25+
26+
Example opening: "Your AI agent just generated 500 lines of perfectly functional code in 3 minutes.
27+
You're elated—until you realize you're not sure if it's building the right thing. You spend the next
28+
2 hours rewriting requirements and explaining what you actually meant. Welcome to the acceleration paradox."
29+
30+
Establish the central insight: When coding becomes radically faster through AI agents, the bottlenecks
31+
don't disappear—they shift. What was once the slow part (implementation) becomes fast, exposing
32+
everything upstream and downstream as the new constraints.
33+
34+
3-5 paragraphs introducing:
35+
36+
- The promise: 5-10x coding acceleration with AI agents
37+
- The surprise: New bottlenecks emerge in unexpected places
38+
- The challenge: Adapting your workflow to these new constraints
39+
- The opportunity: Mastering these bottlenecks unlocks sustainable velocity]
40+
41+
**In this chapter, we'll explore**:
42+
43+
- How agentic coding fundamentally changes where time is spent
44+
- The five major bottlenecks that emerge when implementation accelerates
45+
- Why traditional development practices break down at this velocity
46+
- Practical strategies for identifying and addressing these new constraints
47+
- How to maintain momentum throughout the entire product lifecycle
Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
---
2+
title: "Understanding the 5-10x Multiplier"
3+
chapter_title: "New Bottlenecks"
4+
part: 1
5+
chapter: 5
6+
section: 2
7+
version: "0.1"
8+
date: "2026-02-05"
9+
status: "draft"
10+
author: "Brian Childress"
11+
tags: ["velocity", "acceleration", "foundations", "metrics"]
12+
related:
13+
- part1-foundations/02-what-is-agentic-coding/03-the-spectrum-of-agentic-coding.md
14+
requirements:
15+
- REQ-C006
16+
abstract: |
17+
[Placeholder: Quantifies the 5-10x acceleration claim with concrete examples and
18+
explains where the speed gains come from when using AI agents for implementation.]
19+
---
20+
21+
# Understanding the 5-10x Multiplier
22+
23+
[Placeholder: Establish the credibility of the 5-10x claim with data and examples.
24+
25+
**What gets faster**:
26+
27+
- Boilerplate code generation: 10-20x faster (near-instant)
28+
- CRUD implementations: 5-8x faster
29+
- API endpoint creation: 6-10x faster
30+
- Test scaffolding: 8-12x faster
31+
- Configuration setup: 5-10x faster
32+
33+
**Real-world examples**:
34+
Show concrete before/after comparisons:
35+
36+
- A REST API endpoint: 2 hours manually → 15 minutes with AI
37+
- A React component: 1 hour manually → 8 minutes with AI
38+
- Database migrations: 45 minutes manually → 5 minutes with AI
39+
- Test suite for a module: 3 hours manually → 25 minutes with AI
40+
41+
**What this means in aggregate**:
42+
43+
- A 2-week implementation sprint → 2-4 days with AI
44+
- A 6-month MVP → 6-8 weeks with AI
45+
- Day-to-day feature work: What took a day now takes 1-2 hours
46+
47+
**The caveat**: This acceleration applies to implementation, not to the entire software development
48+
lifecycle. The multiplier doesn't apply to requirements gathering, architecture design, product
49+
decisions, code review, testing strategy, or deployment planning.
50+
51+
Use a diagram showing:
52+
53+
- Traditional time breakdown: 20% planning, 60% coding, 20% testing/deployment
54+
- Agentic time breakdown: 30% planning, 20% coding, 50% testing/deployment/iteration
55+
56+
The paradox: Coding becomes so fast it's no longer the bottleneck.]
57+
58+
```mermaid
59+
graph LR
60+
A[Traditional Development] --> B[Planning: 20%]
61+
A --> C[Coding: 60%]
62+
A --> D[Testing/Deploy: 20%]
63+
64+
E[Agentic Development] --> F[Planning: 30%]
65+
E --> G[Coding: 20%]
66+
E --> H[Testing/Deploy/Iteration: 50%]
67+
```
68+
69+
**Figure 5.1:** Time allocation shift in agentic vs traditional development
Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
---
2+
title: "Bottleneck #1: Requirements and Business Vision"
3+
chapter_title: "New Bottlenecks"
4+
part: 1
5+
chapter: 5
6+
section: 3
7+
version: "0.1"
8+
date: "2026-02-05"
9+
status: "draft"
10+
author: "Brian Childress"
11+
tags: ["requirements", "bottlenecks", "specifications", "business-vision"]
12+
related:
13+
requirements:
14+
- REQ-C006
15+
- REQ-C009
16+
abstract: |
17+
[Placeholder: Explains how unclear requirements become the primary bottleneck when
18+
implementation is fast, and why business vision clarity becomes critical.]
19+
---
20+
21+
# Bottleneck #1: Requirements and Business Vision
22+
23+
[Placeholder: Deep dive into the first and most critical bottleneck.
24+
25+
**The Problem**:
26+
When AI can implement features in hours instead of weeks, the cost of unclear requirements skyrockets.
27+
In traditional development, you might spend 2 days clarifying requirements for a 2-week implementation—
28+
a 10% overhead. With agentic coding, spending 2 days clarifying for a 2-day implementation is 50% overhead.
29+
30+
**Why it emerges**:
31+
32+
- Implementation no longer gives you time to think through requirements
33+
- Ambiguities that would surface during coding now result in complete rework
34+
- AI agents are literal executors—they build exactly what you specify, not what you meant
35+
- The feedback loop from "build wrong thing" to "realize it's wrong" tightens dramatically
36+
37+
**Real-world scenario**:
38+
Tell a story of a developer who asked Claude to "add user authentication" without specifying:
39+
40+
- OAuth vs username/password vs magic links
41+
- Session management approach
42+
- Password reset flow
43+
- Multi-factor authentication requirements
44+
- User profile data model
45+
46+
Claude generates a complete OAuth implementation with Google/GitHub integration. Beautiful code,
47+
perfect tests, but completely wrong for a B2B SaaS that needs username/password with MFA.
48+
Result: 3 hours of AI work needs to be completely rewritten because of 10 minutes of unclear requirements.
49+
50+
**Symptoms you're hitting this bottleneck**:
51+
52+
- Frequently asking AI to regenerate large chunks of code
53+
- Discovering midway through implementation that requirements conflict
54+
- Stakeholders saying "that's not what I meant" after seeing working code
55+
- Spending more time correcting AI output than reviewing human-written code would take
56+
57+
**Why this is THE bottleneck**:
58+
In traditional development, coding is slow enough that requirements evolve during implementation.
59+
Developers ask clarifying questions, make assumptions, and surface ambiguities naturally.
60+
AI agents don't do this—they execute precisely based on what you specified, exposing every ambiguity instantly.
61+
62+
**The solution preview**:
63+
(Link to Part 2 chapters on requirements writing, EARS notation, and spec-driven development)
64+
65+
- Write specifications BEFORE implementation
66+
- Use formal notation (EARS, OpenAPI) that forces precision
67+
- Invest in requirements upfront—it now has the highest ROI
68+
- Treat requirements as the primary artifact, code as secondary]
69+
70+
```mermaid
71+
graph TD
72+
A[Unclear Requirement] --> B[AI Implements Literally]
73+
B --> C[Wrong Feature Built]
74+
C --> D[Discovery + Rework]
75+
D --> E[2-3x Time Waste]
76+
77+
F[Clear Requirement] --> G[AI Implements Correctly]
78+
G --> H[Right Feature First Time]
79+
H --> I[Minimal Iteration]
80+
```
81+
82+
**Figure 5.2:** Impact of requirements clarity on agentic development cycles
Lines changed: 109 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,109 @@
1+
---
2+
title: "Bottleneck #2: Product Decision Making"
3+
chapter_title: "New Bottlenecks"
4+
part: 1
5+
chapter: 5
6+
section: 4
7+
version: "0.1"
8+
date: "2026-02-05"
9+
status: "draft"
10+
author: "Brian Childress"
11+
tags: ["product-management", "bottlenecks", "decisions", "prioritization"]
12+
related:
13+
- part1-foundations/01-renaissance-developer/02-the-renaissance-developer-model.md
14+
requirements:
15+
- REQ-C006
16+
- REQ-C011
17+
- REQ-C012
18+
abstract: |
19+
[Placeholder: Explores how product decision velocity becomes critical when implementation
20+
speed increases, and why product managers become potential bottlenecks.]
21+
---
22+
23+
# Bottleneck #2: Product Decision Making
24+
25+
[Placeholder: Examine the second major bottleneck—product decisions.
26+
27+
**The Problem**:
28+
Product decisions (what to build, how it should work, which features to prioritize) traditionally
29+
happened at the pace of implementation. You could spend a week debating a feature because implementation
30+
would take 3 weeks anyway. When implementation takes 3 days, week-long debates become unacceptable overhead.
31+
32+
**Why it emerges**:
33+
34+
- Traditional product cycle: decide → build → test → learn → decide (each step takes weeks)
35+
- Agentic product cycle: decide → build → test → learn → decide (each step takes days)
36+
- The cadence of "decide" must match the cadence of "build" or you bottleneck
37+
- Product managers accustomed to monthly decision cycles struggle with daily decision velocity
38+
39+
**Real-world scenario**:
40+
A startup founder working with an AI agent:
41+
42+
- Monday: Decides to build a feature, AI implements it by Tuesday morning
43+
- Tuesday: Realizes feature needs adjustment, explains changes, AI updates by Tuesday afternoon
44+
- Tuesday evening: Stakeholder feedback suggests different approach entirely
45+
- Wednesday: Needs to decide new direction, but founder is in meetings all day
46+
- Thursday: Finally makes decision, AI implements by Thursday afternoon
47+
- Friday: Discovers feature conflicts with other product decisions made last month
48+
49+
The implementation (3 half-days of AI work) took 3 hours total. The decision-making (meetings,
50+
debates, stakeholder alignment, thinking time) took 4 days. Implementation is 40x faster than
51+
decision-making.
52+
53+
**Symptoms you're hitting this bottleneck**:
54+
55+
- AI agents waiting idle because you haven't decided what to build next
56+
- Implementing features that get immediately deprioritized
57+
- Analysis paralysis because you CAN build so many things quickly
58+
- Stakeholder alignment meetings becoming the critical path
59+
- Building features that contradict each other because decisions weren't coordinated
60+
61+
**The multiplication effect**:
62+
With 5-10x implementation speed, you can potentially ship 5-10x more features in the same time.
63+
But can your organization DECIDE on 5-10x more features? Can you maintain product coherence
64+
with 10x more decision throughput?
65+
66+
**Why product management changes**:
67+
68+
- From quarterly roadmaps → weekly/daily roadmaps
69+
- From feature specs → outcome specs (let AI figure out HOW)
70+
- From detailed mockups → design principles (let AI generate variations)
71+
- From reviewing code → reviewing outcomes and user experience
72+
73+
**The Renaissance Developer advantage**:
74+
Solo developers with product sense don't have this bottleneck—they ARE the product decision maker.
75+
This is why individual Renaissance Developers can outpace larger teams: no decision coordination overhead.
76+
77+
**The solution preview**:
78+
(Link to Part 2 chapters on MVP prioritization, brief writing, iterative development)
79+
80+
- Establish clear product principles upfront
81+
- Define MVP scope aggressively—focus increases decision speed
82+
- Use outcome-based specs instead of feature-based specs
83+
- Build decision-making velocity into your process
84+
- Accept that product vision, not implementation, is now the rate limiter]
85+
86+
```mermaid
87+
sequenceDiagram
88+
participant PM as Product Manager
89+
participant Dev as Developer + AI
90+
participant Stakeholder as Stakeholders
91+
92+
Note over PM,Stakeholder: Traditional Cycle (Weeks)
93+
PM->>Stakeholder: Gather feedback
94+
Stakeholder-->>PM: Feedback (3-5 days)
95+
PM->>PM: Make decision (2-3 days)
96+
PM->>Dev: Implement (2-3 weeks)
97+
Dev-->>PM: Feature ready
98+
99+
Note over PM,Stakeholder: Agentic Cycle (Days)
100+
PM->>Stakeholder: Gather feedback
101+
Stakeholder-->>PM: Feedback (3-5 days)
102+
PM->>PM: Make decision (BOTTLENECK)
103+
PM->>Dev: Implement (2-3 days)
104+
Dev-->>PM: Feature ready
105+
106+
Note over PM,Dev: Decision-making becomes the constraint
107+
```
108+
109+
**Figure 5.3:** Product decision-making as the new critical path

0 commit comments

Comments
 (0)