José Miguel Gómez

Volver al inicio

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