Skip to content

Commit 2c6057f

Browse files
committed
Update agentic development flow image
1 parent 147545c commit 2c6057f

3 files changed

Lines changed: 62 additions & 51 deletions

File tree

_posts/2026-05-13-executable-markdown-specs-agentic-coding.md

Lines changed: 13 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,22 @@
11
---
22
published: true
33
layout: post
4-
image: /assets/article_images/2026-05-13-executable-markdown-specs-agentic-coding/section-5-bdd-ai-loop.svg
4+
image: /assets/article_images/2026-05-13-executable-markdown-specs-agentic-coding/agentic-development-flow.svg
55
image_width: 1400
66
image_height: 788
77
title: BDD for Spec-driven Agentic Development
88
context: Lightning Talk
99
---
1010

11+
![Flow diagram showing Spec as prompt to Agent Plan to Agent Build to Run Automated Tests](/assets/article_images/2026-05-13-executable-markdown-specs-agentic-coding/agentic-development-flow.svg)
12+
1113
Agentic software is changing how we build.
1214

1315
As agentic coding becomes more common, **how good your prompts specify the behaviour you want is a key to good agent dev outcomes**. The goal is longer autonomous execution loops: give an agent intent, let it plan, let it build, let it run checks, and keep going.
1416

1517
The workflow many of us are moving toward is:
1618

17-
> **Spec as prompt → Plan → Build → Automated tests**
19+
> **Spec as prompt → Agent Plan → Agent Build → Run Automated Tests**
1820
1921
Weak specs lead to unreliable autonomy. Strong, executable specs make autonomy safer.
2022

@@ -29,11 +31,11 @@ But the key constraint remains intent.
2931
The emerging workflow is simple:
3032

3133
1. **Spec as prompt**
32-
2. **Plan**
33-
3. **Build**
34-
4. **Automated tests**
34+
2. **Agent Plan**
35+
3. **Agent Build**
36+
4. **Run Automated Tests**
3537

36-
That fourth step matters. Without automated tests, the loop depends too much on human review. With tests, the agent has a feedback signal it can use while working.
38+
BDD plays at both ends of this loop: examples help specify the behaviour in step 1, and automated tests provide the feedback in step 4. That feedback loop is what makes it durable and valuable over a long period.
3739

3840
Weak specs still produce weak outcomes. LLMs do not remove ambiguity. They often scale it.
3941

@@ -109,18 +111,18 @@ That loud failure is the point. It tells humans and agents that either the imple
109111

110112
## 5. BDD + AI = spec-driven development loop
111113

112-
![Loop diagram showing Spec as prompt to Plan to Build to Automated tests](/assets/article_images/2026-05-13-executable-markdown-specs-agentic-coding/section-5-bdd-ai-loop.svg)
114+
![Flow diagram showing Spec as prompt to Agent Plan to Agent Build to Run Automated Tests](/assets/article_images/2026-05-13-executable-markdown-specs-agentic-coding/agentic-development-flow.svg)
113115

114116
Put together, the practical workflow becomes:
115117

116118
1. **Spec as prompt**
117-
2. **Plan**
118-
3. **Build**
119-
4. **Automated tests**
119+
2. **Agent Plan**
120+
3. **Agent Build**
121+
4. **Run Automated Tests**
120122

121123
This is where BDD and AI fit together naturally.
122124

123-
The spec gives the agent intent. The plan gives it structure. The build changes the system. Automated tests validate the behaviour contract over time.
125+
BDD is doing work at step 1 and step 4: it turns behaviour into examples up front, then turns those examples into tests that keep the loop honest. The spec gives the agent intent. The agent plan gives it structure. The agent build changes the system. Running automated tests closes the feedback loop. That is what makes the specification durable over time.
124126

125127
Gauge fits this model well:
126128

Lines changed: 49 additions & 0 deletions
Loading

assets/article_images/2026-05-13-executable-markdown-specs-agentic-coding/section-5-bdd-ai-loop.svg

Lines changed: 0 additions & 40 deletions
This file was deleted.

0 commit comments

Comments
 (0)