# goadesign/goa

Design-first Go framework that generates API code, documentation, and clients. Define once in an elegant DSL, deploy as HTTP and gRPC services with zero drift between code and docs.

Repository: https://github.com/goadesign/goa
Canonical: https://ross.abutalabs.com/products/goa
Homepage: https://goa.design
Language: Go
License: MIT
License Family: permissive
Topics: go, goa, microservices, rest, api, code-generation, swagger, openapi, golang
Last push: 2026-08-26T21:36:13+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 100
- inputs: {"age_days": 4289, "days_push": 7, "days_rel": 14, "gap_med": 14, "n_releases_24m": 30}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6089, forks 585 (observed 2026-08-28T04:09:34.967288+00:00)

## What it is
Goa is a design-first framework for building APIs and microservices in Go. You define your API in a Go-based DSL and it generates server code, type-safe clients, and OpenAPI documentation for HTTP, gRPC, and WebSocket transports, with a Goa-AI extension for building agentic systems with MCP tool integration.

## Use cases
- generate go api server and client code from a design
- build rest and grpc microservices in go without boilerplate
- keep openapi docs in sync with code
- define api validation rules once and enforce them
- build ai agents with typed tools in go
- integrate mcp tool servers into go agents

## When to choose
- you want design-first API development with zero drift between code and docs
- you need both HTTP and gRPC transports from a single design
- you want auto-generated OpenAPI specs and type-safe clients
- you're building agentic systems in Go with typed tool contracts

## When to avoid
- you prefer writing handlers directly without code generation
- you're building a simple one-off HTTP service where a DSL adds overhead
- your stack isn't Go

## Facets
- artifact type: framework
- maturity: active
- function: api-framework, web-framework, rpc, middleware, websocket, agent-framework, mcp
- domain: backend, apis, microservices, developer-tools, large-language-models
- platform: go, cli, cross-platform
- tags: design-first, openapi, swagger, grpc, dsl, code-generation, http-api, temporal, llm-agents, codegen, ai-agents

## Member repositories
- goadesign/goa (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:34.967288+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:48:18.071909+00:00, confidence not recorded.
  - readme: https://github.com/goadesign/goa (fetched 2026-08-28T04:09:34.967288+00:00, sha 9f30871a4200)
  - homepage: https://goa.design (fetched 2026-08-29T08:45:03.054764+00:00, sha 47ee489e0f73)
  - site_page: https://goa.design/docs/1-goa (fetched 2026-08-29T08:45:03.057559+00:00, sha 697665d64ed3)
  - site_page: https://goa.design/docs/2-goa-ai (fetched 2026-08-29T08:45:03.059938+00:00, sha b90c3e076fec)
  - site_page: https://goa.design/docs/2-goa-ai/mcp-integration (fetched 2026-08-29T08:45:03.062194+00:00, sha 50555a1b4df0)
  - site_page: https://goa.design/docs/2-goa-ai/toolsets (fetched 2026-08-29T08:45:03.064507+00:00, sha 870be6177150)
  - site_page: https://goa.design/docs/2-goa-ai/quickstart (fetched 2026-08-29T08:45:03.067534+00:00, sha 38cc79ef45e6)
  - site_page: https://goa.design/docs/1-goa/dsl-reference (fetched 2026-08-29T08:45:03.069689+00:00, sha f7b4fb82ec18)
  - site_page: https://goa.design/docs/1-goa/code-generation (fetched 2026-08-29T08:45:03.072362+00:00, sha dee5f05471ae)
  - site_page: https://goa.design/docs/1-goa/http-guide (fetched 2026-08-29T08:45:03.075018+00:00, sha 1a8932d362ff)
- Data as of 2026-08-30T08:39:29.467469+00:00.