cd /news/ai-agents/specification-files-for-agents · home topics ai-agents article
[ARTICLE · art-137431] src=dotnetperls.com ↗ pub= topic=ai-agents verified=true sentiment=· neutral

Specification Files for Agents

A developer reports that writing detailed Markdown specification files and having an LLM generate code from them produces reliable output, using the Qwen 3.8 27B model (Bonsai Ternary 2) for functions such as parse_settings and parse_prompt that return a known struct type. The developer notes code generation takes about half an hour even for short 150-line outputs, that specifications can be reused across models including frontier cloud models, and that an LLM can debug a specification to resolve inconsistencies. The approach shifts maintenance from the actual code to the specifications themselves.

read1 min views1 publishedSep 22, 2026

Something about AI-based code generation seems lazy or sloppy. After all, "vibe-coding" is often used to convey poor quality. And giving an AI agent short, poorly-reasoned prompts tends to give at best inconsistent results.

Recently I started experimenting with writing detailed specification files (in Markdown) and having an LLM generate the required code. I have found using a single function, like parse_settings or parse_prompt, along with a known struct type that is returned is a good strategy.

Some notes:

• I can get reliable output from Qwen 3.8 27B (actually Bonsai Ternary 2).

• Code generation takes about half an hour even for short 150-line outputs.

• I can switch models (for example, using a frontier model in the cloud) and the specifications can be reused.

• I can just maintain the specifications instead of the actual code, which could be simpler.

• It is possible to use an LLM to "debug" a specification and resolve any inconsistencies, which is an important step in this approach.

── more in #ai-agents 4 stories · sorted by recency
── more on @qwen 3.8 27b 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
Live at https://your-agent.zahid.host
Get free account → Pricing
from €0/mo · no card required
LIVE [news/specification-files-…] indexed:0 read:1min 2026-09-22 ·