Use ref attribute to reference agent defined in agents/ directory. readonly attribute indicates whether agent can modify files.
<best_practices> Use output_format for all agents that return structured results Include reflection_checkpoint at key workflow decision points Include prepare_phase for Serena initialization in commands Add self_evaluate_phase for agents producing reports or recommendations Use failure_handling phase in all workflows Use agent_ref syntax for consistent agent references in commands </best_practices>
<related_skills> Base templates for error escalation, decision criteria, enforcement Parallel execution and timeout configuration Serena MCP operations (memory, symbol search, code navigation) </related_skills>
<related_agents> Verify workflow consistency and checkpoint completeness </related_agents>