Specgate
Approved specs in, reviewed code out
Flujo agéntico
Specgate
Approved specs in, reviewed code out
Los datos de cada proyecto se muestran en inglés; vienen tal cual de su repositorio.
Esta producción es un resumen privado: se muestran descripción, aprendizajes y stack; el código no es público.
Borrador. Escrito a partir de las notas del programa y pendiente de la revisión del autor.
- Estado
- En cartelera
- Tipo
- Flujo agéntico
- En marcha desde
- enero de 2025
- Rol
- Architect and lead engineer
- Dominios
- software delivery, governance
- Reparto
- TypeScript, GitHub Actions, OpenAPI, PostgreSQL
Contexto y problema
Delivery intelligence in Go: business-hours flow metrics, QA bugs mapped to OpenAPI contracts, specs served to coding agents over MCP.
Assumption: teams adopting AI coding agents merge code that drifts from the specification that was approved, and reviewers cannot tell which specification a change implements.
Specgate keeps approved specifications as the single input of AI coding agents and ties every reviewed change back to the specification it implements.
Cómo se construyó
Construido en 3,9 h · 224 pruebas · 10 auditorías
Fuente: Trysac/09-specgate docs/development-report.md (lines 18, 24-25); 233 min of commit time, con fecha 21 de noviembre de 2026.
Arquitectura e interfaces
- Ofrece
- mcp specgate
- Claves compartidas
- spec_ref, endpoint, error_code
Qué enseñó el proyecto
- A specification reference carried from the approved document to the pull request makes drift visible at review time instead of after release.
- Treating the approved specification as the single input of a coding agent constrains what it builds better than prompting rules do.
- Being the source of specifications for a downstream software factory requires a stable read interface; the consumer should depend on a port, not on the storage.
- Gating merges on a missing specification reference is accepted by a team once the reference is one click away.
Caso de estudio en preparación
El caso de estudio completo añade estas secciones cuando se publique:
- Restricciones
- Diagramas de arquitectura (contexto y contenedores C4)
- Tres decisiones clave
- Qué salió mal
- Resultados con evidencia fechada
- Vídeo de la demo
- Qué haría distinto
En la malla de proyectos
- Forgeline, esfuerzo zero: interface specgate provided by one and consumed by the other
- Resolvo, esfuerzo zero: 2 shared keys (endpoint, error_code) and both expose an api or mcp interface
- Tideline, esfuerzo low: shared keys endpoint, error_code; a standard interface exists
- Vigilo, esfuerzo low: shared keys endpoint; a standard interface exists
Destacados
spec driven, governance, github actions