---
title: "Spec-driven development: Using Markdown as a programming language when building with AI"
url: https://daily.dev/posts/spec-driven-development-using-markdown-as-a-programming-language-when-building-with-ai-xthmztklw
source_url: https://github.blog/ai-and-ml/generative-ai/spec-driven-development-using-markdown-as-a-programming-language-when-building-with-ai/
type: article
source: "GitHub Blog"
published: 2025-09-30T19:08:08.660Z
updated: 2025-09-30T19:08:32.198Z
tags: ["github", "architecture", "golang", "markdown", "ai-assisted-development"]
reading_time: 9
upvotes: 67
comments: 10
language: en
---

> ## Documentation Index
> Fetch the complete documentation index at: https://daily.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Spec-driven development: Using Markdown as a programming language when building with AI

**[GitHub Blog](https://daily.dev/sources/ghblog)** · 9 min read · 67 upvotes · 10 comments

## Summary

A developer shares an experimental approach to building applications by writing specifications entirely in Markdown and using GitHub Copilot to compile them into actual code. The workflow involves maintaining app logic in markdown files, using AI to generate Go code, and keeping documentation synchronized with implementation. This spec-driven development method aims to solve context loss issues with AI coding agents while enabling faster iteration and cleaner specifications.

## Full article

daily.dev links to this article rather than hosting it. Read it at the original source: <https://github.blog/ai-and-ml/generative-ai/spec-driven-development-using-markdown-as-a-programming-language-when-building-with-ai/>

## Community discussion

Top comments from developers on daily.dev.

**@ombratteng** · 8 upvotes

> > Markdown as a programming language
>
> ![triggered](https://emoji.slack-edge.com/T0141MGU324/thomas_the_triggered_engine/b56dbd2aaf9f5958.gif)

**@vikyw** · 4 upvotes

> turing complete ~markdown~
>
> how far have we come,
> from machine code -> assembly -> compiled language -> interpreted language -> markdown

**@marvinbrouwer** · 1 upvotes

> I had a similar idea recently, maybe this can be built out to have more dedicated markdowns.
> Like:
>
> - `Goal.md`
> - `Conventions.md`
> - `Feature.n.md`
>
> And have a ralph loop work on it, maybe have a chat input layer like claude code
> Have it understand ADR files, docs that are already there and let it cook.

**@kaelmorgan** · 1 upvotes

> if you have time to create this markdown then you better off code yourself, i tried it, it takes a consierable amount of time, instead just code yourself, increase self skills

**@tekn0wledg** · 0 upvotes

> This seems similar to this: https://github.com/letta-ai/agent-file

## Similar posts on daily.dev

- [Spec-Driven Development with Markdown for AI Workflows](https://daily.dev/posts/spec-driven-development-with-markdown-for-ai-workflows-leciulo00) · Syncfusion · 0 upvotes · 0 comments

---

Tags: [#github](https://daily.dev/tags/github), [#architecture](https://daily.dev/tags/architecture), [#golang](https://daily.dev/tags/golang), [#markdown](https://daily.dev/tags/markdown), [#ai-assisted-development](https://daily.dev/tags/ai-assisted-development)

[View this post on daily.dev](https://daily.dev/posts/spec-driven-development-using-markdown-as-a-programming-language-when-building-with-ai-xthmztklw)