# Gitea OpenCode Agent Project

This is a default project structure for an agentic OpenCode development environment using the qwen3-coder model (30b).

## Project Structure

```
gitea-opencode-agent-project/
├── docs/                     # Documentation
├── agents/                   # Agent definition files
├── scripts/                  # Automation scripts
├── config/                   # Configuration files
├── src/                      # Source code
├── README.md                 # Project documentation
├── AGENTS.md                 # OpenCode agent definitions
└── .gitignore                # Git ignore patterns
```

## Agent Definitions

Agent files are stored in the `agents/` directory with the following naming convention:
- `agent-<role>.sh` for bash agents
- `agent-<role>.py` for Python agents
- `agent-<role>.json` for configuration files

## Documentation

The `docs/` directory contains the project documentation, including:
- Agent documentation
- Implementation guides
- Usage examples
- API documentation

## Setup Instructions

1. Initialize the project with `init`
2. Configure the qwen3-coder model
3. Deploy agents using the standard OpenCode Task Master system
4. Run the environment with `docker compose up -d`

## Configuration

Configuration files are stored in `config/` and include:
- Agent parameters
- Environment settings
- Model specifications
- Deployment configurations

## OpenCode Integration

This project is designed to work with OpenCode's agent system directly without requiring dmux. The agents can be invoked as specialized tools using OpenCode's task master functionality:

```bash
# Example OpenCode task master commands
/opencode agent documentation-agent
/opencode agent scripting-agent  
/opencode agent deployment-agent
```

The qwen3-coder (30b) model integration is handled through OpenCode's provider configuration, allowing each agent to leverage the advanced reasoning capabilities of the model for:
- Complex problem identification in infrastructure documentation
- Multi-step configuration automation
- Intelligent deployment strategy recommendations
- Analysis of complex dependency chains in network diagrams