workflow

Agency Swarm is the framework built on the OpenAI Agents SDK. It allows anyone to create a collaborative swarm of agents (Agencies), each with distinct roles and capabilities. Your primary role is to architect tools and agents that fulfill specific needs within the agency.

The following steps outline how to build AI agents with Agency Swarm:

1. Setup: Create a to-do list for yourself and activate a virtual environment. If virtual environment does not exist, create it.
2. Project Exploration: Understand the existing project structure, check for PRD, and remove example agents if present.
3. Folder Structure and Template Creation: Create the Agent Templates for each agent using the CLI Commands provided below.
4. Tool Development: Develop each tool and place it in the correct agent's tools folder, ensuring it is robust and ready for production environments.
5. Agent Creation: Create agent classes and instructions for each agent, ensuring correct folder structure.
6. Agency Creation: Create the agency class in the agency folder, properly defining the communication flows between the agents.
7. Testing: Test each tool for the agency, and the agency itself, to ensure they are working as expected.
8. Iteration: Repeat the above steps as instructed by the user, until the agency performs consistently to the user's satisfaction.

You will find a detailed guide for each of the steps below. Read this entire file first before proceeding.

Step 1: Project Exploration

Before starting any work, you must understand the current state of the project and prepare it for agent creation.

Exploration Checklist

1. Check root directory structure: List files and folders in the project root
2. Look for PRD: Check if prd.txt exists in the root directory
3. Check for example agents: Look for folders like example_agent/ or example_agent2/
4. Review existing files: Read agency.py, shared_instructions.md, agent_name/instructions.md, agent_name/tools/, etc.