Urgent.News

What's breaking now, across thousands of outlets.

AI

What Works and What Doesn't in CLAUDE.md

Writing "Write clean code" in CLAUDE.md changes nothing. During the process of building 10 personal apps in three months, I rewrote CLAUDE.md many times. Since it became clear what worked and what didn't, I will outline that distinction. What Doesn't Work Giving instructions with adjectives - Write clean code - Design for maintainability - Handle errors appropriately - Consider performance None…

Writing clean code in CLAUDE.md changes nothing. During the process of building personal apps, I rewrote CLAUDE.md many times. Clear instructions that can be verified, such as not using pure black or white colors, do not use gradient backgrounds, and limit to three types of motion per screen. These rules can be checked with grep.

Verifying that code is clean is difficult, so it does not work well. Limiting permissions by explicitly stating what cannot be done is more effective than suggesting what should be done. Providing an exit, such as "stop implementation and report it," helps the model retreat when it hits constraints. Writing exceptions in advance avoids inconsistent judgments. Keeping the file short and focusing on verifiable rules works best.

Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.

Read the original at dev.to →

More in AI

Stop Building AI Agents. Start Building AI Systems.

There's a phrase I keep seeing everywhere in AI development: "We need an AI agent." Need to analyze documents? Build an agent. Need to automate a workflow? Build an agent. Need to interact with APIs?

  • Focus should shift from AI agents to AI systems.
  • Real applications require system architecture, not just agent capabilities.

More from Friday 4 September →