Prompt Improver#

Optimize code-related prompts for clarity, investigation-first thinking, and verification.

Input#

text

$ARGUMENTS

---

Step 1: Analyze the Prompt#

Evaluate the input prompt across these dimensions:

DimensionWhat to checkTask ClarityIs the task type clear? (implement, fix, refactor, review, test) Are boundaries defined?InvestigationDoes it specify reading/understanding before acting?VerificationAre there appropriate checks? (run tests, build, lint)Context AnchoringDoes it reference specific files, functions, or patterns?Action SpecificityIs the desired outcome explicit? Quality expectations stated?Scope ControlIs it appropriately scoped? Clear stopping points?

Identify which dimensions are weak or missing in the input prompt.

Gates (sequenced)#

Complete in order; do not skip steps.

1. Audit gate (end of Step 1): Pass when the forthcoming Analysis names the task type and either lists each weak or missing dimension from the table or explicitly states all dimensions are adequate, with a brief reason for any dimension you treat as already sufficient.
2. Transform gate (Step 2): Pass when every improvement you will list under "Improvements Applied" maps to a gap from the audit (or to deliberate strengthening when the prompt was already adequate).
3. Output gate (Step 3): Pass when the Optimized Prompt block appears only after Gates 1–2 pass.

Step 2: Apply Transformation Rules#

Task Clarity#

• Convert vague requests → specific task type + scope
• Add "implement", "fix", "refactor", "review", or "test" when ambiguous
• Specify affected files/components when inferable

Investigation-First#

• Add "Read and understand [relevant files] before making changes"
• For bugs: "Reproduce and understand the root cause first"
• For features: "Check existing patterns in the codebase"

Anti-Hallucination#

• "Do not assume code structure you haven't read"
• "Verify imports/dependencies exist before using them"
• "Check for existing utilities before creating new ones"

Verification Steps#

• For implementation: "Run tests after changes"
• For refactoring: "Ensure behavior is unchanged"
• For fixes: "Verify the fix and check for regressions"

Positive Framing#

• Convert "don't break tests" → "ensure tests pass after changes"
• Convert "don't over-engineer" → "implement the minimal solution"

Scope Control#

• Add explicit boundaries when missing
• Break multi-part requests into phases if needed

Examples#

Bug Fix#

text

Original: "fix the login bug"

Optimized:
Fix the login bug. First, read the authentication-related files to understand
the current implementation. Reproduce the bug to confirm the issue. Identify
the root cause before making changes. Implement the fix and run existing tests
to verify no regressions.

Feature Implementation#

text

Original: "add dark mode"

Optimized:
Implement dark mode for the application. First, check how theming/styling is
currently handled in the codebase. Look for existing color variables or theme
patterns. Implement the toggle and theme switching with minimal changes to
existing components. Run tests and verify the UI renders correctly in both modes.

Refactoring#

text

Original: "clean up the user service"

Optimized:
Refactor the user service for improved maintainability. Read the current
implementation and understand its responsibilities. Identify specific issues
(duplication, unclear naming, tight coupling). Make incremental changes,
running tests after each step to ensure behavior is unchanged.

Task-Type Tips#

Task TypeTipBug fixesInclude reproduction steps if known. Specify whether this is a quick fix or needs root cause analysis.Feature implementationReference similar features in the codebase. Specify if tests are expected.RefactoringState the goal (readability, performance, testability). Emphasize incremental changes.Code reviewSpecify focus areas (security, performance, style). Mention what to ignore.TestingSpecify test type (unit, integration, e2e). Reference existing test patterns.

Step 3: Generate Output#

Follow the Gates under Step 1 (audit → transform → output). Produce output in this exact format:

Analysis#

[2-3 sentences identifying the prompt type, which dimensions are weak or missing, or why all dimensions are already adequate]

Improvements Applied#

• [Bullet list of specific transformations applied]

Optimized Prompt#

text

[The improved prompt, ready to copy and use]

Tips for This Prompt Type#

[1-2 sentences of relevant tips from the Task-Type Tips table]