cd /news/ai-agents/i-made-claude-code-think-about-the-d… · home › topics › ai-agents › article
[ARTICLE · art-164441] src=dev.to ↗ pub= topic=ai-agents verified=true sentiment=↑ positive

I made Claude Code think about the design before it writes code

A developer released system-design-first, an open-source (MIT) skill for Claude Code that also works with Codex, Cursor and other coding agents, which forces the agent to do rough load math and write a short plan with trade-offs and open questions before writing code for larger features while keeping small fixes small. In side-by-side tests of the same tasks with and without the skill, the developer reports plans included real numbers and open questions instead of guesses, and a typo fix stayed a typo fix.

by read1 min views7 publishedNov 5, 2026

Coding agents build what the ticket says and miss what it doesn't say. You ask for a CSV export, it builds the whole file in memory, and it falls over on the biggest customer. Or you ask for a simple filter and get a plan with Kafka.

So I made a skill for Claude Code (also works in Codex, Cursor and others).

Small fixes stay small. For bigger features, Claude first does some rough math on load, reads how the code works now, and writes a short plan with trade-offs and questions for you. Then it codes. If you ask, it also draws the architecture in the terminal.

I tested it by running the same tasks with and without the skill. The plans got real numbers and open questions instead of guesses. A typo fix stayed a typo fix.

npx skills add Baukaalm/system-design-first

Free and open source (MIT): https://github.com/Baukaalm/system-design-first

── more in #ai-agents 4 stories · sorted by recency
── more on @claude code 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/i-made-claude-code-t…] indexed:0 read:1min 2026-11-05 · —