# __PROJECT_NAME__

Go agent built on [Google ADK](https://google.golang.org/adk) with a LiteLLM adapter for local model routing.

## Quick start

```bash
cp .env.example .env
# edit .env with your LITELLM_API_KEY
go mod tidy
task run
```

## Harness & workflow

Single harness: **Claude Code + hyperguild** — session-based (start a session, it works, it
stops). No push-triggered dispatch. MCP connections live in `.mcp.json`: **brain** (knowledge)
and **gitea** (issues/PRs — the audit trail); provide `BRAIN_MCP_TOKEN` and `GITEA_MCP_TOKEN`.

Work flows: **issue → hyperguild session → PR (`task check` gate) → report-back comment on the
issue → brain capture if the learning is durable**. See `AGENTS.md` / `CLAUDE.md` for the full
context, `AGENT_BOUNDARIES.md` for runtime scope.

## Observability

Set `OTLP_ENDPOINT=http://jaeger.d-ma.be:4318` to emit traces. Each invocation produces:
- `invoke_agent __PROJECT_NAME__` span
- `generate_content <model>` child span with `gen_ai.request.model` attribute

## Structure

```
cmd/__PROJECT_NAME__/   agent entrypoint
pkg/litellm/           OpenAI-compat ADK adapter + OTLP telemetry helper
```