Crafting Clear Instructions › Common Pitfalls to Avoid

Michael BrenndoerferJune 11, 20251 min read
AI Agent HandbookAll chapters
Part 3 of 15Prompting - Communicating with Your AI
Chapter 7Crafting Clear Instructions › Common Pitfalls to Avoid
Reading section 7 of 11 · Common Pitfalls to Avoid · 1 minSection 7 of 11 · 1 min

Book contents

Section 7 of 11 · 1 min read

Crafting Clear Instructions › Common Pitfalls to AvoidOne section · Sections in this chapter7 / 11 ↓

As you practice prompt writing, watch out for these common mistakes:

Assuming the Model Knows Context: The model doesn't know what you're working on, what you discussed earlier (unless you include it in the conversation history), or what your goals are. Include the context it needs.

Being Too Vague: "Make it better" or "fix this" don't give the model actionable direction. Be specific about what "better" means.

Overcomplicating: You don't need to write a novel. Sometimes a simple, direct prompt works best. Start simple and add detail only if needed.

Forgetting to Specify Constraints: If you have requirements (length, format, style, what to avoid), include them upfront rather than hoping the model will guess.