# Goa > Goa es un framework Go que da a los agentes de programación menos código que escribir y un único contrato sobre el que razonar. Genera servidores HTTP, gRPC y JSON-RPC, clientes tipados, validación y especificaciones API. Crea agentes de IA, servidores MCP y registros de herramientas con Goa-AI. ## Why use Goa with a coding agent? Un agente escribe código por inferencia; Goa deriva el código de los contratos del diseño. Cada servidor, cliente, códec y esquema generado es código que el modelo no necesita escribir por separado. El diseño concentra el contexto, la estructura sigue siendo coherente y el compilador detecta implementaciones incompatibles tras los cambios. El agente sigue escribiendo lógica de negocio y pruebas. ## Goa and Goa-AI Goa diseña y genera API de servicios Go: HTTP, gRPC, JSON-RPC, clientes, validación y especificaciones. Goa-AI amplía el mismo DSL y generador con herramientas tipadas, agentes de IA, resultados estructurados, evaluaciones y servidores MCP. También ofrece un runtime de agentes y un servidor de registro que puedes alojar. Puedes empezar con cualquiera; Goa-AI no requiere un servicio Goa desplegado por separado. ## Install the Goa service designer skill Run in your application repository with Node.js and npm available: ```bash npx skills add goadesign/goa --skill goa-service-designer ``` For Goa-AI, also read the generated AGENTS_QUICKSTART.md in your application. ## Start here - [Develop with a coding agent](https://goa.design/es/docs/ai-development/index.md): workflow, generated-code boundaries, and a shared service/agent example. ## Documentation ### Goa - [Inicio rápido](https://goa.design/es/docs/1-goa/quickstart/index.md): Complete guide to installing Goa and building your first service - from setup to running a working HTTP endpoint. - [Guía HTTP](https://goa.design/es/docs/1-goa/http-guide/index.md): Complete guide to HTTP transport in Goa - routing, content negotiation, WebSocket, SSE, CORS, and static content. - [Guía gRPC](https://goa.design/es/docs/1-goa/grpc-guide/index.md): Complete guide to gRPC transport in Goa - service design, streaming patterns, error handling, and Protocol Buffer integration. - [Tratamiento de errores](https://goa.design/es/docs/1-goa/error-handling/index.md): Guía completa para el tratamiento de errores en Goa: definición de errores, asignación de transporte, tipos personalizados y buenas prácticas. - [Interceptors](https://goa.design/es/docs/1-goa/interceptors/index.md): Complete guide to interceptors and middleware in Goa - type-safe Goa interceptors, HTTP middleware, and gRPC interceptors. - [Producción](https://goa.design/es/docs/1-goa/production/index.md): Patrones listos para producción para servicios Goa: observabilidad, seguridad y patrones comunes de despliegue. - [Referencia DSL](https://goa.design/es/docs/1-goa/dsl-reference/index.md): Referencia completa del lenguaje de diseño de Goa: modelado de datos, servicios, métodos, asignación HTTP/gRPC y seguridad. - [Generación de código](https://goa.design/es/docs/1-goa/code-generation/index.md): Complete guide to Goa's code generation - commands, process, generated code structure, and customization options. ### Goa-AI - [Inicio rápido](https://goa.design/es/docs/2-goa-ai/quickstart/index.md): Genera y ejecuta un agente de IA local, después añade planificador, herramientas tipadas e integración del modelo. - [Conjuntos de herramientas](https://goa.design/es/docs/2-goa-ai/toolsets/index.md): Aprende sobre los tipos de conjuntos de herramientas, modelos de ejecución, validación, recuperación estructurada de fallos y catálogos de herramientas en Goa-AI. - [Composición de los agentes](https://goa.design/es/docs/2-goa-ai/agent-composition/index.md): Learn how to compose agents using agent-as-tool patterns, run trees, and streaming topology. - [Evaluaciones generadas](https://goa.design/es/docs/2-goa-ai/evaluations/index.md): Define escenarios de evaluación en el diseño Goa, genera hooks tipados y produce informes fiables. - [Integración MCP](https://goa.design/es/docs/2-goa-ai/mcp-integration/index.md): Crea servidores MCP con herramientas, recursos y prompts, y consume herramientas MCP externas. - [Memoria y sesiones](https://goa.design/es/docs/2-goa-ai/memory-sessions/index.md): Manage state with transcripts, memory stores, sessions, and runs in Goa-AI. - [Producción](https://goa.design/es/docs/2-goa-ai/production/index.md): Configura Temporal para workflows duraderos, transmite eventos a las UIs, aplica limitación de tasa adaptativa y utiliza recordatorios del sistema. - [Pruebas y resolución de problemas](https://goa.design/es/docs/2-goa-ai/testing/index.md): Aprende a probar agentes, planners y herramientas, y a resolver problemas comunes. - [Referencia DSL](https://goa.design/es/docs/2-goa-ai/dsl-reference/index.md): Referencia completa de las funciones DSL de Goa-AI: agentes, toolsets, políticas e integración MCP. - [Tiempo de ejecución](https://goa.design/es/docs/2-goa-ai/runtime/index.md): Entiende cómo el runtime de Goa-AI orquesta agentes, aplica políticas y gestiona el estado. - [Registro interno de herramientas](https://goa.design/es/docs/2-goa-ai/registry/index.md): Despliega una pasarela en clúster para descubrir e invocar toolsets entre procesos. - [Tool Payload Defaults](https://goa.design/es/docs/2-goa-ai/tool-payload-defaults/index.md): How Goa-AI applies Goa-style defaults to tool payloads (decode-body + transform) and what codegen contracts must hold. ### Ecosistema - [Modelo](https://goa.design/es/docs/3-ecosystem/model/index.md): Architecture diagrams as code using the C4 model - version-controlled, automatically generated, and interactive. - [Pulso](https://goa.design/es/docs/3-ecosystem/pulse/index.md): Distributed event infrastructure - streaming, worker pools, and replicated maps for Go microservices. - [Pista](https://goa.design/es/docs/3-ecosystem/clue/index.md): Microservice instrumentation for Go - logging, tracing, metrics, health checks, and debugging. ## Source - [Goa](https://github.com/goadesign/goa): service DSL and generator. - [Goa-AI](https://github.com/goadesign/goa-ai): agent DSL, generator, and runtime. - [Goa coding skill](https://github.com/goadesign/goa/tree/v3/skills): design-first workflow for coding agents. Edit design and application code. Regenerate gen/ with goa gen; do not edit generated files. Goa-AI also generates AGENTS_QUICKSTART.md for the application's agent design. Generation does not replace business logic, authorization, or tests.