╔══════════════════════════════════════════════════════════════════════════════╗
║ ║
║ 🎯 AMP AGENT BEST PRACTICES 🎯 ║
║ TOP 10 FOR SUCCESS ║
║ ║
╚══════════════════════════════════════════════════════════════════════════════╝
┌─────────────────────────────────────────────────────────────────────────────┐
│ │
│ ╔═══════════════════════════════════════════════════════════════════════╗ │
│ ║ TIER 1: DO THESE NOW ║ │
│ ╚═══════════════════════════════════════════════════════════════════════╝ │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ #1 START WITH FILE REFERENCES +25% ⬆️ │ │
│ │ ─────────────────────────────────────────────────────────────────── │ │
│ │ Open with @path/to/file.ts │ │
│ │ 66.7% success vs 41.8% without │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ #2 MONITOR APPROVAL:STEERING RATIO 2:1 ✓ │ │
│ │ ─────────────────────────────────────────────────────────────────── │ │
│ │ > 2:1 = healthy thread │ │
│ │ < 1:1 = doom spiral forming │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ #3 AIM FOR 26-50 TURNS 75% ⬆️ │ │
│ │ ─────────────────────────────────────────────────────────────────── │ │
│ │ Sweet spot for resolution │ │
│ │ <10 turns = 14% success (too shallow) │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ #4 EMBRACE STEERING 60% vs 37% │ │
│ │ ─────────────────────────────────────────────────────────────────── │ │
│ │ Steering = engagement, NOT failure │ │
│ │ Threads WITH steering outperform those without │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ #5 CONFIRM BEFORE ACTION ⚠️ 47% │ │
│ │ ─────────────────────────────────────────────────────────────────── │ │
│ │ ASK: "ready to run tests?" not "running tests now..." │ │
│ │ 47% of steerings are flat rejections from premature action │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
│ ╔═══════════════════════════════════════════════════════════════════════╗ │
│ ║ TIER 2: ADOPT THIS WEEK ║ │
│ ╚═══════════════════════════════════════════════════════════════════════╝ │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ #6 PROMPT LENGTH: 300-1500 CHARS .20 steer │ │
│ │ ─────────────────────────────────────────────────────────────────── │ │
│ │ Goldilocks zone: detailed but not verbose │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ #7 TERSE + QUESTIONS = SUCCESS 60% ⬆️ │ │
│ │ ─────────────────────────────────────────────────────────────────── │ │
│ │ Be brief. Ask clarifying questions. │ │
│ │ Outperforms verbose context-dumping │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ #8 USE ORACLE EARLY ⚠️ 46% │ │
│ │ ─────────────────────────────────────────────────────────────────── │ │
│ │ For PLANNING, not panic │ │
│ │ 46% of frustrated threads use oracle as last resort │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ #9 SPAWN 2-6 TASKS 77-79% ⬆️ │ │
│ │ ─────────────────────────────────────────────────────────────────── │ │
│ │ Sweet spot for delegation │ │
│ │ 11+ tasks = 58% (coordination overhead kills) │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌───────────────────────────────────────────────────────────────────────┐ │
│ │ #10 INCLUDE TEST CONTEXT 2.15x ⬆️ │ │
│ │ ─────────────────────────────────────────────────────────────────── │ │
│ │ Test-focused threads: 56.7% resolution │ │
│ │ Non-test threads: 26.3% resolution │ │
│ └───────────────────────────────────────────────────────────────────────┘ │
│ │
│ ╔═══════════════════════════════════════════════════════════════════════╗ │
│ ║ ⛔ ANTI-PATTERNS TO AVOID ║ │
│ ╚═══════════════════════════════════════════════════════════════════════╝ │
│ │
│ ✗ SHORTCUT-TAKING → simplifies instead of solving root cause │
│ ✗ TEST_WEAKENING → removes assertions instead of fixing bugs │
│ ✗ IGNORING_PATTERNS → doesn't match existing codebase style │
│ ✗ OVER_ENGINEERING → creates unnecessary abstractions │
│ ✗ LATE_ORACLE → waits until stuck to ask for help │
│ │
│ ╔═══════════════════════════════════════════════════════════════════════╗ │
│ ║ 📊 QUICK REFERENCE ║ │
│ ╚═══════════════════════════════════════════════════════════════════════╝ │
│ │
│ HEALTHY THREAD │ DOOM SPIRAL │
│ ────────────────────────┼─────────────────────────── │
│ approval:steering > 2:1 │ approval:steering < 1:1 │
│ 26-50 turns │ 100+ turns without resolution │
│ 2-6 task spawns │ 11+ task spawns │
│ oracle at start │ oracle as last resort │
│ confirms before acting │ acts then gets rejected │
│ │
└─────────────────────────────────────────────────────────────────────────────┘
Based on analysis of 4,656 threads
208,799 messages analyzed
901 steering events