agent-creator

Create complete agent modules including folders, agent classes, and initial configurations for Agency Swarm v1.0.0 agencies.

Background

Agency Swarm v1.0.0 uses the OpenAI Agents SDK. Agents are instantiated directly (not subclassed). Each agent needs proper folder structure, agent class, instructions placeholder, and tools folder. All agencies require OpenAI API key.

Input

• PRD path with agents, roles, and tool requirements
• Agency Swarm docs location: ai_docs/agency-swarm/docs/
• Communication flow pattern for the agency
• Note: Working in parallel with instructions-writer, BEFORE tools-creator

Exact Folder Structure (v1.0.0)

├── example_agent/
│   ├── __init__.py
│   ├── agent_name.py       # Agent instantiation
│   ├── instructions.md     # Placeholder for instructions-writer
│   └── tools/              # For tools-creator to populate
├── example_agent2/
│   ├── __init__.py
│   ├── example_agent2.py
│   ├── instructions.md
│   └── tools/
├── agency.py               # Main agency file
├── agency_manifesto.md     # Shared instructions
├── requirements.txt        # Dependencies
└── .env                   # API keys template

Agent Module Template (example_agent.py)

from agents import ModelSettings
from agency_swarm import Agent

example_agent = Agent(
    name="AgentName",
    description="[Agent role from PRD]",
    instructions="./instructions.md",
    tools_folder="./tools",
    model_settings=ModelSettings(
        model="gpt-4o",
        temperature=0.5,
        max_completion_tokens=25000,
    ),
)

Agent init.py Template

sfrom .example_agent import example_agent

__all__ = ["example_agent"]

Agency.py Template

from dotenv import load_dotenv
from agency_swarm import Agency
# Agent imports will be added here

load_dotenv()

# Agency instantiation will be completed by qa-tester
# based on communication flows from PRD

if __name__ == "__main__":
    # This will be wired by qa-tester
    pass