best-practices

1# Best Practices — Prompt Transformer
2 
3> Transform prompts by adding what Claude needs to succeed.
4 
5## Start Here
6 
7Based on user's request:
8 
9**User provides a prompt to transform:**
10→ Ask using AskUserQuestion:
11  - **Question:** "How should I improve this prompt?"
12  - **Header:** "Mode"
13  - **Options:**
14    1. **Transform directly** — "I'll apply best practices and output an improved version"
15    2. **Build context first** — "I'll gather codebase context and intent analysis first"
16 
17**User asks to learn/understand:**
18→ Show the 5 Transformation Principles section
19 
20**User asks for examples:**
21→ Link to references/before-after-examples.md
22 
23**User asks to evaluate a prompt:**
24→ Use the Success Criteria eval rubric at the end of this document
25 
26---
27 
28## If "Transform directly"
29 
30Apply the 5 principles below and output the improved prompt immediately.
31 
32## If "Build context first"
33 
34Launch 3 parallel agents to gather context:
35 
36```
37Run these agents IN PARALLEL using the Task tool:
38 
39- Task task-intent-analyzer("[user's prompt]")
40- Task best-practices-referencer("[user's prompt]")
41- Task codebase-context-builder("[user's prompt]")
42```
43 
44### What Each Agent Returns
45 
46| Agent | Mission | Returns |
47|-------|---------|---------|
48| **task-intent-analyzer** | Understand what user is trying to do | Task type, gaps, edge cases, transformation guidance |
49| **best-practices-referencer** | Find relevant patterns from references/ | Matching examples, anti-patterns to avoid, transformation rules |
50…