← Back to Projects

spek

Python

Agentic spec-to-code builder: turn a SPEC.md into an installable, tested package.

Related Posts (1)

May 6, 2026

Here is how I built a simple coding agent

spek is a side project: a small LLM-powered coding agent that takes a plain-language description of a program and produces a working, tested Python package. You write a markdown file describing what you want, point spek at it, and a few minutes later there's an installable package on disk that builds and passes its own tests.

This post walks through one example end-to-end, then digs into the design questions I had to answer along the way and what I picked for each.

The full source is at github.com/mkarots/spek.

[... 3,582 words]