docs: gestion de producto multi-repo con agentes de IA#31
Merged
Conversation
Artículo ~6000 palabras sobre cómo definir, documentar y mantener el conocimiento de producto en entornos multi-repositorio usando agentes de IA, SDD, knowledge graphs y contract testing. Incluye roadmap incremental (crawl/walk/run), modos de fallo, template del repo de producto y stack de herramientas por fase.
added 2 commits
June 23, 2026 00:04
…anular Segunda revision del articulo tras feedback: - Nueva seccion 1.5: checklist '¿Es SDD para ti?' - Nueva seccion 1.6: alternativas ligeras (ADR, BDD, contract testing) - Seccion 4.1 reescrita: explicacion SDD desde cero con ejemplo OpenAPI real - Glosario de terminos (OpenAPI, AsyncAPI, Gherkin, ADR, contract testing, drift) - Roadmap con sub-pasos diarios/semanales y checkpoints - Template de requisito cross-cutting en el cuerpo del articulo - Nueva seccion 6.8: '¿Y si solo quiero el 20%?' (3 combos progresivos) - SDD vs TDD aclarado
AGENTS.md, project-specific skills, conexion con el pipeline del articulo (agentes de reuniones, SDD, drift, coordinador). Ejemplos concretos de AGENTS.md para repo de codigo y para product-specs. Tabla de ahorro de tokens.
Tres bloques fundacionales que faltaban: - 2.0 Workspaces: abstraccion de trabajo del agente multi-repo - 2.3 Arquitectura multi-repo: contratos como seams, 3 patrones de relacion, 3 niveles de acoplamiento, ejemplo completo - 4.1 Taxonomia de specs: 5 tipos (contrato, comportamiento, requisito, arquitectura, dominio) con formatos y ejemplos. Que NO es una spec.
- 4.7: OpenSpec (56k⭐) y GSD Core (64k⭐) como herramientas SDD reales - Piramide (2.1) reconciliada con taxonomia (4.1): tabla de mapping - Spec de dominio redefinida: glosario consultable, no verificable - Contratos unificados: AGENTS.md usa formato estructurado Provee/Consume - Acoplamiento de BD añadido como 4o nivel (a eliminar) - 6.8: Matriz RACI de responsabilidades - 6.9: Quickstart de 15 minutos con comandos copia-y-pega - 6.10-6.11: renumeracion de combos y template
- Seccion 2.4: knowledge graph definido (repo vs Neo4j por fase)
- 'Tres niveles' → 'cuatro niveles' de acoplamiento
- OpenSpec y GSD integrados en roadmap (Mes 5, Mas alla)
- RACI movido al apendice (8.2)
- Quickstart: heredoc sin comillas, commit inicial, nota sobre dirs
- Deadlock de contract testing resuelto (mock en CI consumidor)
- Convencion de naming REQ-{CAT}-{NNN} (8.3)
- Resumen reconciliado: 'marco de trabajo', no 'no es teoria'
- Conclusion: 'marco de trabajo', no 'marco teorico'
- Renumeracion: 6.8 quickstart, 6.9 combos, 6.10 template
- Apendices reorganizados: 8.1 stack, 8.2 RACI, 8.3 naming
- Nueva seccion 3.6: RFCs (formato, estados, ciclo propuesto→aceptado) - RFCs como alternativa ligera (Opcion A en 1.6, por delante de ADRs) - Template actualizado: rfcs/ en product-specs - Alternativas renumeradas: A(RFC) B(ADR) C(BDD) D(Contract) E(SDD) - Integracion con el resto del sistema: CI valida RFCs aceptados, drift cruza RFCs con codigo, rechazados no se borran
…monorepo Hallazgos del subagente de investigacion: - Counterpoint monorepo: Shopify (Packwerk) y Stripe como alternativa - GitHub Spec-Kit anadido junto a OpenSpec en 4.7 - Backstage (Spotify, CNCF) anadido al apendice de herramientas - Nota de honestidad intelectual: criticas documentadas a SDD (waterfall risk, 72-80% fracaso GraphRAG, overhead abandono) - 'Se documenta solo' matizado: el trabajo humano se desplaza, no desaparece - Claim '60% del valor' eliminada (sin evidencia)
TellMeAlex
approved these changes
Jun 23, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
📋 Artículo — 6,085 palabras
Resumen
Sistema integral para gestionar el conocimiento de producto en entornos multi-repo usando agentes de IA, Specification-Driven Development, knowledge graphs y contract testing.
Estructura
Correcciones aplicadas tras revisión
product-specs/Tipo
tipo: ensayo— artículo de opinión técnica fundamentada.