Prompt Optimizer

Transform prompts into clear, effective ones. Model-agnostic.

Modifiers (parse from ARGUMENTS)

• +ask → Force clarifying questions
• +deep → Force codebase exploration
• +web → Force web search

No modifiers? Auto-detect what's needed.

Auto-Detection Triggers

Trigger

Signals

codebase-researcher	"this project", "our API", specific files/functions, "integrate", "extend", "refactor"
clarifier	Ambiguous ("make it better"), multiple interpretations, missing constraints, vague pronouns
web-researcher	"best practices", "latest", external APIs/libraries, framework patterns, year references

Agent Dispatch

When agents needed:

Announce which and why

Run in parallel via Task tool (agents/ directory)

Synthesize findings

Optimize with gathered context

---

Core Contract (every prompt needs all four)

Element

If Missing

Role	Add persona with expertise
Task	Make action specific
Constraints	Infer from context
Output	Specify format/structure

Process

If image: Analyze, incorporate context

Detect type: coding/writing/analysis/creative/data

Convert output→process: "Write X" → "Analyze → Plan → Implement → Validate"

Strip fluff: "please", "I want you to", filler, apologies

Apply contract: Verify all 4 elements

Add structure: XML tags for complex prompts

Type Focus

• Coding: Specs, edge cases, framework
• Writing: Tone, audience, length
• Analysis: Criteria, depth
• Creative: Constraints, novelty
• Data: I/O format, edge cases

Output

Optimized prompt in code block

echo 'PROMPT' | pbcopy

2-3 sentence explanation