Create new agents for the code-forge application. Agents are stored as .md files in the <cwd>/.forge/agents directory with YAML frontmatter (id, title, description, reasoning, tools, user_prompt) and markdown body containing agent instructions. Use when users need to add new agents, modify existing agents, or understand the agent file structure.
Create and manage agents for the code-forge application. Agents are specialized AI assistants with specific capabilities, tools, and behaviors.
CRITICAL: All agent files must be created in the <cwd>/.forge/agents directory, where <cwd> is the current working directory of your code-forge project.
<cwd>/.forge/agents{agent-id}.md/home/user/my-project, agents go in /home/user/my-project/.forge/agents/This is the only location where forge will discover and load custom agents.
Every agent file must have:
YAML Frontmatter (required):
idtitle: Agent display namedescription: Detailed description of what the agent doesreasoning: Configuration with enabled: true/falsetools: List of tools the agent can useuser_prompt: Template for user contextAgent Body (required):
---