mathias/template-go-agent

Template

Fork 0

Use this template

T

mathiasandClaude Opus 5.5 7c2bfb05aa

CD / Lint / Test / Vet (push) Successful in 11s

Details

CD / Build & Import (push) Skipped

Details

CD / Deploy via GitOps (push) Skipped

Details

fix(deps): bump OTel to v1.45.0 and gRPC to v1.83.1 past GO-2026-6348, GO-2026-6061, GO-2026-6615, GO-2026-6505, GO-2026-4985

Generated children inherited the vulnerable set via pkg/litellm/telemetry.go.
otel/log + sdk/log + otlploghttp v0.21.0 is the set consistent with otel
v1.45.0; ADK v1.2.0 does not compile against it, so ADK moves to v1.7.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-04 22:56:22 +02:00

.gitea

ci(deploy): refuse to patch a manifest with an empty IMAGE_TAG (infra#311)

2026-08-25 17:25:24 +02:00

cmd/__PROJECT_NAME__

fix(template): children were red because ./... cannot see the entrypoint

2026-09-17 18:00:00 +02:00

internal/agent

feat: add agent boundaries, network policy, agent stub, dockerfile, CI

2026-05-28 20:54:04 +02:00

pkg/litellm

fix(ci): go mod tidy + check resp.Body.Close error (template-go-agent#3)

2026-07-24 15:19:17 +02:00

scripts/tests

fix(test): grade golangci-lint on its exit code, not on grepping its output

2026-09-17 18:14:10 +02:00

.env.example

feat: initial scaffold with context adapters and litellm pkg

2026-05-19 23:02:07 +02:00

.gitignore

feat: initial scaffold with context adapters and litellm pkg

2026-05-19 23:02:07 +02:00

.golangci.yml

chore(lint): adopt the canonical .golangci.yml from infra/ci-templates

2026-09-05 12:51:06 +02:00

.mcp.json

refactor(template): match single-harness (hyperguild) architecture (infra#178)

2026-07-01 22:20:37 +02:00

AGENT_BOUNDARIES.md

refactor(template): match single-harness (hyperguild) architecture (infra#178)

2026-07-01 22:20:37 +02:00

AGENTS.md

refactor(template): match single-harness (hyperguild) architecture (infra#178)

2026-07-01 22:20:37 +02:00

CLAUDE.md

refactor(template): match single-harness (hyperguild) architecture (infra#178)

2026-07-01 22:20:37 +02:00

Dockerfile

feat: add agent boundaries, network policy, agent stub, dockerfile, CI

2026-05-28 20:54:04 +02:00

go.mod

fix(deps): bump OTel to v1.45.0 and gRPC to v1.83.1 past GO-2026-6348, GO-2026-6061, GO-2026-6615, GO-2026-6505, GO-2026-4985

2026-10-04 22:56:22 +02:00

go.sum

fix(deps): bump OTel to v1.45.0 and gRPC to v1.83.1 past GO-2026-6348, GO-2026-6061, GO-2026-6615, GO-2026-6505, GO-2026-4985

2026-10-04 22:56:22 +02:00

README.md

refactor(template): match single-harness (hyperguild) architecture (infra#178)

2026-07-01 22:20:37 +02:00

Taskfile.yml

fix(template): children were red because ./... cannot see the entrypoint

2026-09-17 18:00:00 +02:00

README.md

PROJECT_NAME

Go agent built on Google ADK with a LiteLLM adapter for local model routing.

Quick start

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