A starter template I use for standing up new golang web services on my personal developer platform. Aims to make agentic development a little more sane (at least for me). This attempts to introduce constraints in the form of a progressively discoverable architecture.
  • Go 92.4%
  • templ 3.1%
  • CSS 2.1%
  • Just 1.7%
  • Dockerfile 0.7%
Find a file Use this template
Thomas Tu 461eaea549 Adopt MCP tool annotations and dual-path OAuth resource discovery
Port the writer app's three-shape annotation kit (read-only, additive,
destructive - all closed-world) with a pinned-table test so no tool
ships unclassified. Serve RFC 9728 metadata at both the bare and
/mcp-suffixed well-known paths, point the 401 challenge at the
suffixed form, and accept both audience spellings (origin and
origin + /mcp) ahead of the MCP 2026-07-28 spec's endpoint-derived
resource identifiers.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-07-24 09:50:16 -07:00
.claude/skills Adopt MCP tool annotations and dual-path OAuth resource discovery 2026-07-24 09:50:16 -07:00
cmd/server rename go module, more sensible layout for decomposability 2026-07-18 09:42:33 -07:00
internal Adopt MCP tool annotations and dual-path OAuth resource discovery 2026-07-24 09:50:16 -07:00
.air.toml initial template 2026-07-17 20:38:35 -07:00
.env.example initial template 2026-07-17 20:38:35 -07:00
.gitignore initial template 2026-07-17 20:38:35 -07:00
AGENTS.md Adopt MCP tool annotations and dual-path OAuth resource discovery 2026-07-24 09:50:16 -07:00
CLAUDE.md move go-idioms to global skills 2026-07-17 21:45:35 -07:00
Dockerfile initial template 2026-07-17 20:38:35 -07:00
go.mod rename go module, more sensible layout for decomposability 2026-07-18 09:42:33 -07:00
go.sum initial template 2026-07-17 20:38:35 -07:00
justfile rename go module, more sensible layout for decomposability 2026-07-18 09:42:33 -07:00
mise.toml initial template 2026-07-17 20:38:35 -07:00
README.md initial template 2026-07-17 20:38:35 -07:00

template-go-app

A domain-driven Go web app scaffold: OIDC auth (Authelia), templ + htmx, sqlite/postgres, MCP endpoint, single-binary deploys.

mise install && just dev

See AGENTS.md for architecture and conventions.