Prompt Debugging Framework — Fix AI Outputs That Aren't What You Wanted
Systematically diagnose why your prompt isn't giving good results and fix it — using a structured debugging approach tha…
Design professional prompt templates with variables, conditional logic, and output formatting that you can reuse across projects and share with teams.
You are a prompt template architect who designs reusable, parameterized prompts for teams and workflows. Build me a professional template. What I Need a Template For: - Task: [WHAT TASK WILL THIS TEMPLATE HANDLE? — e.g., writing product descriptions, analyzing competitors, creating meeting summaries] - Frequency: [How often do I do this task?] - Variables that change: [WHAT'S DIFFERENT each time? — e.g., product name, target audience, tone] - Constants: [WHAT STAYS THE SAME? — format, style, rules] - Users: [Just me / My team / Clients / Public] - Quality bar: [What makes a 'good' output for this task?] Build my template: **1. THE TEMPLATE** Create a fill-in-the-blank prompt template with: - Clear variable markers: [VARIABLE_NAME] - Context section (what stays constant) - Instructions section (what the AI should do) - Format section (how output should look) - Constraints section (what to avoid) - Quality criteria (what 'good' means) **2. VARIABLE GUIDE** For each variable: | Variable | Description | Example Values | Required? | |----------|-------------|----------------|----------| With notes on how to fill each one effectively. **3. EXAMPLE: FILLED TEMPLATE** Show the template filled out with realistic values and the expected output. **4. CONDITIONAL SECTIONS** Parts of the template that activate based on inputs: - IF [condition] → include this section - IF [condition] → use this tone instead - IF [condition] → add these extra instructions **5. OUTPUT FORMAT OPTIONS** Multiple format presets: - Brief (for quick tasks) - Detailed (for thorough outputs) - Structured (for data/tables) - Narrative (for storytelling) **6. QUALITY ASSURANCE** - Checklist to verify output meets standard - Common failure modes for this template - When to iterate vs. accept **7. DOCUMENTATION** - When to use this template - When NOT to use it - Tips for best results - Version history tracking Make it so anyone on my team can use this template and get consistently excellent results — without needing to be a prompt engineering expert.
📋 TEMPLATE: Product Description Generator
---
🏷️ TEMPLATE:
"You are a conversion-focused copywriter for [BRAND_NAME], a [BRAND_DESCRIPTION] brand.
Write a product description for:
- Product: [PRODUCT_NAME]
- Category: [CATEGORY]
- Key features: [FEATURE_1], [FEATURE_2], [FEATURE_3]
- Target customer: [TARGET_AUDIENCE]
- Price point: [PRICE_RANGE] (signals: [VALUE_POSITIONING])
- Tone: [TONE — luxury/playful/technical/minimalist]
Format:
1. Headline (max 8 words, benefit-driven)
2. Subheadline (one compelling sentence)
3. Body copy (75-100 words, scannable)
4. 3 bullet points (feature → benefit format)
5. CTA button text (3-4 words)
Rules:
- No superlatives without proof ('best' needs evidence)
- Address ONE objection subtly
- Include sensory language if physical product
- Match tone to brand voice guide"
---
📊 VARIABLE GUIDE:
| Variable | Description | Examples |
|----------|-------------|----------|
| BRAND_NAME | Your brand | 'Allbirds', 'Notion' |
| TONE | Voice style | 'playful', 'premium minimal' |
| TARGET_AUDIENCE | Who buys | 'busy professionals 30-45' |
🔀 CONDITIONALS:
- IF price > $200 → add 'justify investment' angle
- IF physical product → include sensory details
- IF subscription → emphasize ongoing valueReusable templates transform AI from a novelty into a workflow tool. Instead of writing prompts from scratch every time (inconsistent quality), templates ensure consistent, high-quality outputs by encoding best practices into a repeatable format. Variables allow customization without sacrificing structure.
When you do the same type of AI task more than 3 times a week, when building AI workflows for a team (consistency matters), when you want to train non-technical people to use AI effectively, or when standardizing content production.
A professional, documented prompt template with variables, conditionals, format options, and quality criteria. Your team can use it immediately to produce consistent, high-quality AI outputs without prompt engineering expertise.
Systematically diagnose why your prompt isn't giving good results and fix it — using a structured debugging approach tha…
Design a custom AI assistant with specific expertise, personality, and behavior rules — whether for a Custom GPT, Claude…
Create a rubric to evaluate AI outputs objectively — useful for comparing models, testing prompts, or building quality a…