Una fuente compartida para las decisiones de producto
Modela actores, recorridos, casos de uso, reglas, términos y requisitos como artefactos Markdown. Los identificadores estables mantienen las referencias aunque cambien las rutas.
El producto
ProductShape es una implementación de referencia por línea de comandos para Product Definition as Code. Mantén el conocimiento aceptado en tu repositorio y conecta el trabajo que lo implementa mediante citas estables.
Modela actores, recorridos, casos de uso, reglas, términos y requisitos como artefactos Markdown. Los identificadores estables mantienen las referencias aunque cambien las rutas.
Los Product Changes proponen una definición futura. Valídala, revísala con las personas responsables, aplícala en una rama y acepta la nueva versión mediante una integración revisada.
Las citas vinculan documentos consumidores con el contenido de los artefactos. Si un artefacto cambia, la verificación informa de referencias vigentes, obsoletas, manipuladas o sin resolver.
Product Definition as Code no depende de un proceso SDD concreto. ProductShape ofrece integraciones para OpenSpec y Spec Kit sin acoplar el modelo central.
Cómo funciona
La validación es estructural; no juzga si el contenido del producto es verdadero. La IA puede ayudar a recuperar o redactar conocimiento, pero las personas revisan el significado y aprueban cada cambio. La verdad del producto permanece en archivos bajo control de versiones.