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

<https://github.blog/ai-and-ml/generative-ai/spec-driven-development-using-markdown-as-a-programming-language-when-building-with-ai/>

- Host: [github.blog](https://links.thingelstad.xyz/hosts/github.blog/)
- Saved: October 1, 2025 (2025-10-01T13:49:15Z)
- Record: https://links.thingelstad.xyz/links/5dcf6c0d0650/
- JSON: https://links.thingelstad.xyz/links/5dcf6c0d0650.json

## What Jamie wrote

This model is super interesting to me. I think there is a path where our project repositories all have a `/stories` directory that is filled with markdown files authored to describe the software. How about a `/concepts` directory that has visual assets used to explore it. With agents product tools we can move to a world where everyone, not just the coders, are "in the code" and able to have much more impact working alongside various specialized agents.

## Facts

- Kind: [Page](https://links.thingelstad.xyz/kinds/page/)

## Appears in

- [WT329: Weekly Thing 329 / Another Thing](https://weekly.thingelstad.com/archive/329/), Notable

## Same host

- [Git turns 20: A Q&A with Linus Torvalds - The GitHub Blog](https://links.thingelstad.xyz/links/235c822be937/) (github.blog, April 10, 2025)
- [From pair to peer programmer: Our vision for agentic workflows in GitHub Copilot - The GitHub Blog](https://links.thingelstad.xyz/links/f5f41015f5d1/) (github.blog, June 26, 2025)
- [How to build secure and scalable remote MCP servers - The GitHub Blog](https://links.thingelstad.xyz/links/e5815928b387/) (github.blog, July 26, 2025)
- [Building your first MCP server: How to extend AI tools with custom capabilities - The GitHub Blog](https://links.thingelstad.xyz/links/55ff715764a7/) (github.blog, August 24, 2025)
- [Pick your agent: Use Claude and Codex on Agent HQ - The GitHub Blog](https://links.thingelstad.xyz/links/b065ce914cd8/) (github.blog, February 5, 2026)

## Saved the same week

- [We Built Social Media for Agents and They Won't Stop Posting — 2389 Research, Inc](https://links.thingelstad.xyz/links/52730d04d901/) (2389.ai, October 1, 2025)
- [Building OpenAI with OpenAI | OpenAI](https://links.thingelstad.xyz/links/e16b260e1af8/) (openai.com, October 1, 2025)
- [sanix | How I Accidentally Created The Fastest Csv Parser Ever Made](https://links.thingelstad.xyz/links/1a9e18767130/) (sanixdk.xyz, October 1, 2025)
- [ai-agents-for-beginners: 12 Lessons to Get Started Building AI Agents](https://links.thingelstad.xyz/links/94985b3bfb1f/) (github.com, October 1, 2025)
- [Fundamental of Virtual Memory | Melatoni](https://links.thingelstad.xyz/links/642b56eaf1c9/) (nghiant3223.github.io, October 1, 2025)

## Elsewhere

- Wayback Machine: https://web.archive.org/web/*/https://github.blog/ai-and-ml/generative-ai/spec-driven-development-using-markdown-as-a-programming-language-when-building-with-ai/