Skip to content

Commit 075458e

Browse files
committed
Tighten final BDD loop section
1 parent 12fd620 commit 075458e

1 file changed

Lines changed: 4 additions & 8 deletions

File tree

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

Lines changed: 4 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ That problem remains unsolved at scale.
6767

6868
The proven pattern already exists: **behaviour-driven, example-based specifications**.
6969

70-
This is the core idea behind BDD and Specification by Example:
70+
This is the core idea behind BDD and the [Specification by Example](https://gojko.net/books/specification-by-example/) book:
7171

7272
* define behaviour as concrete examples
7373
* express scenarios of system behaviour
@@ -98,15 +98,11 @@ Put together, the practical workflow becomes:
9898
3. **Agent Builds**
9999
4. **Agent Runs Tests**
100100

101-
This is where BDD and AI fit together naturally.
101+
This is where BDD and AI fit together naturally: BDD gives the agent concrete examples up front, then executable tests keep the loop honest after the build.
102102

103-
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.
103+
With AI, this matters more because LLMs amplify spec quality. Strong specs make autonomous execution more reliable. Weak specs create scalable incorrect behaviour.
104104

105-
With AI, this matters more because LLMs amplify spec quality. Strong specs make autonomous execution more reliable. Weak specs create scalable incorrect behaviour. Ambiguity gets amplified, not resolved.
106-
107-
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 plans the work, builds the change, and runs tests to close the feedback loop. That is what makes the specification durable over time.
108-
109-
Gauge fits this model well:
105+
[Gauge](https://gauge.org/) fits this model well:
110106

111107
* specs are Markdown-based
112108
* scenarios are human-readable and LLM-readable

0 commit comments

Comments
 (0)