Post

❌ “Fix bug in login handler” ✅ “Login fails with 500 on incorrect passwords. Repro: call /api/auth with wrong creds. Check auth_service.py. Add test if possible.” Agents need context like humans do.

Include why, not just what. ❌ “Use events instead of direct method calls” ✅ “Reviewers flagged tight coupling in SettingsWebviewPanel.statusUpdate(). Let’s refactor to events to improve modularity.” Reasoning aligns the Agent with your intent.

Give references to code, tests, or docs. ❌ “Write tests for ImageProcessor” ✅ “Write tests for ImageProcessor.Follow structure in test_text_processor.py” The Agent learns better by example.