Skip to content

Commit d0bb830

Browse files
committed
Shorten Spec Kit section
1 parent 46830cc commit d0bb830

1 file changed

Lines changed: 3 additions & 19 deletions

File tree

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

Lines changed: 3 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -39,27 +39,11 @@ Weak specs still produce weak outcomes. LLMs do not remove ambiguity. They often
3939

4040
## 2. The industry is experimenting with spec tools
4141

42-
![Tool-card image showing SpecKit, spec-driven development, structured prompts, and prompt to plan to build pipelines](/assets/article_images/2026-05-13-executable-markdown-specs-agentic-coding/section-2-spec-first-convergence.svg)
42+
A good example is GitHub's [Spec Kit](https://github.com/github/spec-kit): an open-source toolkit for spec-driven development. It installs a `specify` CLI, sets up agent workflows, and gives agents structured commands like `/speckit.specify`, `/speckit.plan`, `/speckit.tasks`, and `/speckit.implement`.
4343

44-
The industry is already experimenting with spec tools.
44+
That is useful. It makes the path from product scenario → spec → plan → tasks → implementation more explicit.
4545

46-
You can see it in SpecKit-style workflows, spec-driven development tools, and structured prompt → plan → build pipelines.
47-
48-
These approaches work best for:
49-
50-
* greenfield setup
51-
* initial decomposition of features
52-
* turning a rough idea into a first plan
53-
54-
But they still struggle with the harder part of software development:
55-
56-
* iterative development
57-
* evolving systems
58-
* ongoing spec maintenance
59-
60-
Generating a plan from a spec is useful. Keeping the spec correct as the system changes is the real problem.
61-
62-
That problem remains unsolved at scale.
46+
But it still points at the same hard problem: generating a plan from a spec is useful; keeping the spec correct as the system changes is the long-term problem.
6347

6448
## 3. A proven practice already exists
6549

0 commit comments

Comments
 (0)