gaia-agents Repository Setup: README, structure, contribution guide

[itomek-amd]

Summary

Set up the amd/gaia-agents repository with foundational structure, documentation, and contribution guidelines before implementing the first workflow (#230).

Motivation

The gaia-agents repository will serve as the hub for GAIA agent workflows and the basis for the Agent Hub CLI (#264). It needs proper structure and documentation before we add the first workflow (Battery Workflow #230).

Repository Components

Essential Files

• README.md: Repository purpose, structure overview, contribution guide
• LICENSE: Appropriate open-source license
• .gitignore: Python, IDE files, OS-specific files
• CONTRIBUTING.md: Guidelines for adding new agents

Folder Structure

Start with flat structure initially:

/gaia-agents/
├── README.md
├── LICENSE
├── .gitignore
├── CONTRIBUTING.md
└── workflows/
    └── (empty - ready for #230)

Categories will be introduced when we reach 20-30 agents (future scope).

README Content Should Include

• Repository purpose: "Hub for GAIA agent workflows"
• How agents are organized (flat structure, future categories)
• How to contribute a new agent/workflow
• Relationship to Agent Hub CLI (Agent Hub CLI: Install and manage GAIA agents #264)
• Link to main gaia repo for SDK docs

Dependencies

• None - this should be created before CUA: Battery Conservation Workflow #230 (Battery Workflow)

Success Criteria

• Repository has README.md explaining purpose and structure
• LICENSE file included
• .gitignore configured for Python projects
• CONTRIBUTING.md guides contributors on adding agents
• Basic folder structure in place
• Ready to accept first workflow (CUA: Battery Conservation Workflow #230)

Sequence

This issue should be completed in Milestone V0.16 before #230 (Battery Workflow).

---

Related Issues:

• CUA: Battery Conservation Workflow #230 (Battery Workflow) - First workflow to add after setup
• Agent Hub CLI: Install and manage GAIA agents #264 (Agent Hub CLI) - Will install agents from this repo