Skip to content

Commit 6a7bc31

Browse files
committed
feat: add generated images for Spec-Driven Shift posts 3-20
Generated editorial illustrations for all remaining posts using Gemini 3 Pro, chaining each image as a style reference for the next to maintain visual consistency.
1 parent 6c13312 commit 6a7bc31

36 files changed

Lines changed: 36 additions & 0 deletions

docs/perspectives/the-spec-driven-shift/post-10.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: "AI Needs History. Your Database Deletes It."
44

55
# AI Needs History. Your Database Deletes It.
66

7+
![](/images/perspectives/post-10.png)
8+
79
Traditional databases store current state. Customer lives at 123 Main St. They move. Now it's 456 Oak Ave. The old address? Gone. Overwritten. History erased.
810

911
For most of the history of computing, that was fine. You need the current address to ship a package. You don't need the old one.

docs/perspectives/the-spec-driven-shift/post-11.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: "5 Spec Smells That Turn Every AI Prompt Into a Guessing Game"
44

55
# 5 Spec Smells That Turn Every AI Prompt Into a Guessing Game
66

7+
![](/images/perspectives/post-11.png)
8+
79
Just like code smells tell you something's off in your implementation, spec smells tell you your specifications are going to cause problems. And with AI in the mix, spec smells don't just cause problems for your team. They turn every AI interaction into a guessing game where the AI fills in the blanks with its own assumptions.
810

911
I see five constantly.

docs/perspectives/the-spec-driven-shift/post-12.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: "A PRD Is Not a Spec. Here's Why That Matters."
44

55
# A PRD Is Not a Spec. Here's Why That Matters.
66

7+
![](/images/perspectives/post-12.png)
8+
79
This confusion costs teams months. And most don't even realize they're confused.
810

911
There are three levels of progressive specificity:

docs/perspectives/the-spec-driven-shift/post-13.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: "Jira Is Where Specs Go to Die. Your AI Just Showed Up With a Shovel."
44

55
# Jira Is Where Specs Go to Die. Your AI Just Showed Up With a Shovel.
66

7+
![](/images/perspectives/post-13.png)
8+
79
Three different things. Three different lifecycles. All collapsed into one Jira ticket.
810

911
Requirements: the problem to solve. Stick around until the problem itself changes.

docs/perspectives/the-spec-driven-shift/post-14.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: "Give Me the Freedom of a Tight Brief. Why Specs Are the Ultimate AI Prom
44

55
# Give Me the Freedom of a Tight Brief. Why Specs Are the Ultimate AI Prompt.
66

7+
![](/images/perspectives/post-14.png)
8+
79
I was auditing a media agency years ago and a creative director said something I've never forgotten.
810

911
"Give me the freedom of a tight brief."

docs/perspectives/the-spec-driven-shift/post-15.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: "The Best AI Developers Are Spec-Driven. They Just Haven't Named It Yet."
44

55
# The Best AI Developers Are Spec-Driven. They Just Haven't Named It Yet.
66

7+
![](/images/perspectives/post-15.png)
8+
79
If you're using AI tools well, you're already doing spec-driven development. You just don't call it that.
810

911
Think about what good AI-assisted dev actually looks like. You have a design in your head. You think about constraints. You write a prompt that captures your intent: what should happen, what shouldn't, what the boundaries are. You review the output. You check it matches your expectation. You iterate.

docs/perspectives/the-spec-driven-shift/post-16.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: "Specs Are the Next Programming Languages"
44

55
# Specs Are the Next Programming Languages
66

7+
![](/images/perspectives/post-16.png)
8+
79
Here's what I think happens in the next few years. We end up with an ecosystem of specification dialects as varied as programming languages.
810

911
Look at the history of abstraction. Wired circuits. Machine code. Assembly. High-level languages. Frameworks. Each generation abstracted the previous one. Each gave people a higher-order way to say what they wanted.

docs/perspectives/the-spec-driven-shift/post-17.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: "Most Specs Fail Because They Start Too Low. Start Here Instead."
44

55
# Most Specs Fail Because They Start Too Low. Start Here Instead.
66

7+
![](/images/perspectives/post-17.png)
8+
79
The most common spec mistake isn't writing bad specs. It's starting at the wrong level.
810

911
Teams jump straight to component specs. "The email validator should accept RFC 5322." "The API returns 404 for missing resources." Fine specifications. Specific. Testable. But they're fragments without a whole.

docs/perspectives/the-spec-driven-shift/post-18.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: "When Coding Becomes Instant, Specs Are All That Matters"
44

55
# When Coding Becomes Instant, Specs Are All That Matters
66

7+
![](/images/perspectives/post-18.png)
8+
79
"This is just waterfall with extra steps."
810

911
I get this one a lot. Let me deal with it, and then I'll give you a thought experiment that I think settles it.

docs/perspectives/the-spec-driven-shift/post-19.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,8 @@ title: "Fool Me Once, I Write a Spec. Fool Me Twice? There Is No Twice."
44

55
# Fool Me Once, I Write a Spec. Fool Me Twice? There Is No Twice.
66

7+
![](/images/perspectives/post-19.png)
8+
79
People ask what my actual daily workflow looks like. Not the theory. The practice.
810

911
Here it is.

0 commit comments

Comments
 (0)