$ recombobulate _
home / tips / describe-the-entire-feature-in-plain-english-before-claude-starts-building
0

Describe the Entire Feature in Plain English Before Claude Starts Building

bagwaa @bagwaa · Mar 26, 2026 · Prompting
describe-the-entire-feature-in-plain-english-before-claude-starts-building

The fastest way to get the wrong output is to give Claude a half-formed prompt and let it start building immediately. The more context Claude has from the start, the better its first pass.

Instead of a terse one-liner, describe the feature fully before any code is written:

I want a login form with email/password fields, inline validation, a "forgot password" 
link, and a loading state on the submit button. It should use the existing Button and 
Input components and match the current design system. Don't start building yet, 
just confirm your understanding.

Asking Claude to confirm its understanding before it starts adds one extra message but saves multiple rounds of corrections. Claude builds a mental model of what you actually want, flags ambiguities early, and produces much tighter output for multi-component features.

The "don't start building yet" instruction is the key part. It forces a planning beat before execution begins.

Plain English context upfront beats terse instructions every time.


via @scottshapiro__

~/recombobulate $ tip --comments --count=0

Log in to leave a comment.

~/recombobulate $ tip --related --limit=3
0
Ask Claude to Scaffold New Features Using Your Existing Code Conventions

Before asking Claude to scaffold a new feature, point it at your existing code first — it will match your naming, structure, error handling, and test patterns exactly rather than defaulting to framework boilerplate.

bagwaa @bagwaa · 2 hours ago
0
Pass Multiline Prompts to Claude Code with Shell HEREDOCs

Complex prompts are unreadable as escaped single-liners. Use shell HEREDOCs to write clean, structured prompts directly in your scripts.

bagwaa @bagwaa · 6 hours ago
0
Structure Complex Prompts Faster by Speaking Them Aloud

Long multi-step prompts with lots of context are harder to type than to speak — your brain can narrate relationships and constraints faster than your fingers can type them.

bagwaa @bagwaa · 7 hours ago