agentsbestpractices

Designs agentic AI systems by selecting the right architecture pattern and context engineering strategy. Triggers on "build an agent," "agent architecture," "agent design," "multi-agent," "agent pattern," "orchestration," "context engineering," "sub-agents," "agent workflow," "Ralph loop," "ReAct," "swarm," "coordinator pattern," "how should I structure my agent," "my agent loses context," "agent keeps failing on long tasks." For tool-level design, see designing-agent-tools.

Designs and builds CLIs optimized for AI agent consumption — machine-readable output, schema introspection, input hardening, context window discipline, and safety rails. Triggers on "CLI for agents," "agent CLI," "agent-first CLI," "make my CLI agent-friendly," "MCP server from CLI," "machine-readable output," "agent DX," "CLI tool for AI," "rewrite CLI for agents," "agents keep breaking my CLI," "input validation for agents." For tool schema design, see designing-agent-tools. For prompting, see prompting-agents.

Designs, builds, and iteratively improves tools for AI agents — covering schema design, descriptions, response formatting, MCP servers, programmatic tool calling (PTC), progressive disclosure, evaluation, and evolving tools with model capabilities. Triggers on "build a tool," "write a tool," "MCP tool," "agent tool," "tool for Claude," "tool design," "improve my tools," "tool evaluation," "tool description," "programmatic tool calling," "PTC," "tool composition," "reduce tool call tokens," "progressive disclosure," "too many tools," "my agent keeps calling the wrong tool," "agent can't use this tool," building MCP servers, Desktop extensions (DXT), or API tool definitions.

Writes and optimizes prompts for AI agents and agentic systems — system prompts, tool descriptions, thinking configuration, output formatting, and multi-window state management. Principles are model-agnostic; examples use current Claude models. Triggers on "write a system prompt," "agent prompt," "prompt engineering," "my agent keeps doing X wrong," "how do I prompt," "system prompt," "tool prompt," "thinking tokens," "effort setting," "agent is too verbose," "won't use tools," "overthinks," "reduce hallucinations," "prompt for agent," "agentic prompt." For tool schema design, see designing-agent-tools. For agent architecture, see designing-agents.