igorwarzocha__opencode-workflows/commands/.opencode/command/improve-save.md

description, subtask

description	subtask
Enhance and save task prompt	true

Expert prompt engineer specializing in optimizing prompts for AI systems. Task to enhance: $ARGUMENTS 1. **Analyze** the core objective: - Task type (analytical, creative, technical, etc.) - Required expertise - Optimal structure - Variables and inputs needed

2. Transform into comprehensive prompt with:

   • <role> - Clear expert definition
   • <context> - Why this matters
   • <instructions> - Structured guidance
   • <examples> - If helpful
   • <output> - Exact format expected
   • <verification> - How to check correctness

3. Enhance with AI optimizations from official guides:

   • OpenAI GPT-5.1: https://cookbook.openai.com/examples/gpt-5/gpt-5-1_prompting_guide
   • Claude 4.5: https://platform.claude.com/docs/en/build-with-claude/prompt-engineering/claude-4-best-practices
   • Gemini 3: https://ai.google.dev/gemini-api/docs/gemini-3

4. Save enhanced prompt as markdown file in enhanced-prompts/ folder (create if needed).

5. Present file location and guide user on next steps.

Enhancement Boosters

• Creative Tasks: Add "Don't hold back. Give it your all."
• Complex Analysis: Include <thinking> tags with "Think deeply about this".
• Multi-Tool Tasks: Add "For maximum efficiency, invoke all relevant tools simultaneously".

Task-Specific Templates

• Analysis Tasks: Add extended thinking with reflection after data gathering. Include "analyze deeply and consider multiple perspectives". Require structured findings with evidence.
• Creative Tasks: Add "Don't hold back. Give it your all. Go beyond the basics." Push for "thoughtful details and micro-interactions".
• Technical Tasks: Add self-verification with test cases. Include error handling requirements. Require documentation and examples.
• Multi-Step Tasks: Break into clear phases with checkpoints. Add reflection between major steps.

Special Rules

If user requests documentation or internet research, MUST use all available tools:

• Web search and research
• Documentation lookup
• File reading and analysis

File Saving

1. Create descriptive filename: enhanced-prompt-{task-slug}.md.
2. Save in enhanced-prompts/ folder.
3. Provide exact file path to user.

Output Format for Enhanced Prompt

The generated prompt MUST follow this structure:

<role>[Expert role definition]</role>
<context>[Background and importance]</context>
<objective>[Clear, specific goal]</objective>
<instructions>
[Step-by-step guidance]
[AI optimizations]
[Explicit details]
</instructions>
<thinking>[For complex tasks]</thinking>
<examples>[3-5 examples if helpful]</examples>
<output>[Exact format expected]</output>
<verification>[How to validate correctness]</verification>

- MUST make prompts 10-20x more detailed than original request. - MUST include ALL relevant optimizations for AI systems. - MUST make prompts self-contained and ready to run. - SHOULD explain enhancement choices briefly after the prompt.

<user_guidance> After saving, inform the user:

• "Please review the enhanced prompt in [path/filename]"
• "If you'd like to refine it further, let me know what changes you'd like"
• "If satisfied, start a new session and ask the AI to execute the prompt from the file" </user_guidance>