Skill: knowledge-graph
Grafo de entidades y relaciones PM. Almacenamiento persistente en JSONL. Consultas en lenguaje natural.
Concepto
Un grafo de conocimiento PM conecta 8 tipos de entidades (Project, PBI, Task, Member, Skill, Risk, Decision, Sprint) a través de 7 tipos de relaciones. Almacenado en JSONL para durabilidad. Soporta consultas en lenguaje natural que se traducen a traversals de grafo.
Entidades
| Tipo |
Descripción |
Atributos clave |
| Project |
Proyecto PM |
nombre, descripción, equipo, estado |
| PBI |
Product Backlog Item |
ID, título, descripción, estado, storypoints |
| Task |
Tarea técnica |
ID, descripción, estimación, estado, dueña |
| Member |
Miembro del equipo |
nombre, skills, capacidad, disponibilidad |
| Skill |
Habilidad técnica |
nombre, nivel (junior/mid/senior), demanda |
| Risk |
Riesgo identificado |
descripción, probabilidad, impacto, mitigación |
| Decision |
Decisión arquitectónica |
descripción, fecha, ADR ref, rationale |
| Sprint |
Ciclo de trabajo |
número, fechas, capacidad, velocity |
Relaciones
| Tipo |
Desde |
Hacia |
Significado |
| HAS_PBI |
Project |
PBI |
El proyecto contiene este PBI |
| DECOMPOSES_TO |
PBI |
Task |
El PBI se descompone en estas tareas |
| ASSIGNED_TO |
Task |
Member |
La tarea está asignada a este miembro |
| HAS_SKILL |
Member |
Skill |
El miembro domina esta habilidad |
| HAS_RISK |
Task |
Risk |
Esta tarea enfrenta este riesgo |
| AFFECTS |
Decision |
Task |
Esta decisión impacta esta tarea |
| CONTAINS |
Sprint |
Task |
Este sprint contiene estas tareas |
Almacenamiento
Ubicación: data/knowledge-graph/{proyecto}.jsonl
Formato JSONL (una entidad por línea):
{"type":"Project","id":"sala-reservas","name":"Sala Reservas","team":["Alice","Bob"]}
{"type":"PBI","id":"AB#1234","title":"API Reservas","status":"active","project":"sala-reservas"}
{"type":"Task","id":"AB#1234.1","title":"Diseñar endpoints","assigned":"Alice","sprint":"2026-04"}
{"type":"Member","id":"alice","name":"Alice","skills":["TypeScript","API"]}
{"type":"Skill","id":"typescript","name":"TypeScript","level":"mid"}
{"type":"Risk","id":"R001","desc":"Delay BD","prob":0.4,"impact":5}
{"type":"Decision","id":"ADR-001","desc":"GraphQL","adr":"projects/adr/ADR-001.md"}
{"type":"Sprint","id":"2026-04","number":"2026-04","capacity":80}
Construcción (fuentes)
El grafo se construye escaneando:
- Azure DevOps — work items, iteraciones, asignaciones, capacidades
- equipo.md — miembros, skills, roles
- reglas-negocio.md — decisiones, restricciones, riesgos
- agent-notes — contexto acumulado, decisiones, hallazgos
Consultas
Traduce preguntas en lenguaje natural a graph traversals:
| Pregunta |
Traversal |
Ejemplo |
| "¿Quién sabe TypeScript?" |
Member→HAS_SKILL→Skill |
Alice, Bob (senior), Charlie (junior) |
| "¿De qué depende Task #123?" |
Task←DECOMPOSES_TO←PBI |
PBI AB#456: "Migrar BD" |
| "¿Qué riesgos afectan a este sprint?" |
Sprint→CONTAINS→Task→HAS_RISK |
R001: "Delay", R004: "API down" |
| "¿Impacto de cambiar decisión ADR-5?" |
Decision→AFFECTS→Task |
Tasks AB#123, AB#124, AB#125 |
| "¿Capacidad de Alice el próximo sprint?" |
Member→(ASSIGNED_TO←Task←CONTAINS) |
32/80 SP asignados en Sprint 2026-05 |
Máximo 130 líneas
Documentación comprimida. Detalles de implementación en comandos /graph-*.
1---2name: knowledge-graph3description: "Skill: knowledge-graph"4---56# Skill: knowledge-graph78> Grafo de entidades y relaciones PM. Almacenamiento persistente en JSONL. Consultas en lenguaje natural.910## Concepto1112Un grafo de conocimiento PM conecta 8 tipos de entidades (Project, PBI, Task, Member, Skill, Risk, Decision, Sprint) a través de 7 tipos de relaciones. Almacenado en JSONL para durabilidad. Soporta consultas en lenguaje natural que se traducen a traversals de grafo.1314## Entidades1516| Tipo | Descripción | Atributos clave |17|---|---|---|18| **Project** | Proyecto PM | nombre, descripción, equipo, estado |19| **PBI** | Product Backlog Item | ID, título, descripción, estado, storypoints |20| **Task** | Tarea técnica | ID, descripción, estimación, estado, dueña |21| **Member** | Miembro del equipo | nombre, skills, capacidad, disponibilidad |22| **Skill** | Habilidad técnica | nombre, nivel (junior/mid/senior), demanda |23| **Risk** | Riesgo identificado | descripción, probabilidad, impacto, mitigación |24| **Decision** | Decisión arquitectónica | descripción, fecha, ADR ref, rationale |25| **Sprint** | Ciclo de trabajo | número, fechas, capacidad, velocity |2627## Relaciones2829| Tipo | Desde | Hacia | Significado |30|---|---|---|---|31| **HAS_PBI** | Project | PBI | El proyecto contiene este PBI |32| **DECOMPOSES_TO** | PBI | Task | El PBI se descompone en estas tareas |33| **ASSIGNED_TO** | Task | Member | La tarea está asignada a este miembro |34| **HAS_SKILL** | Member | Skill | El miembro domina esta habilidad |35| **HAS_RISK** | Task | Risk | Esta tarea enfrenta este riesgo |36| **AFFECTS** | Decision | Task | Esta decisión impacta esta tarea |37| **CONTAINS** | Sprint | Task | Este sprint contiene estas tareas |3839## Almacenamiento4041**Ubicación:** `data/knowledge-graph/{proyecto}.jsonl`4243**Formato JSONL (una entidad por línea):**44```json45{"type":"Project","id":"sala-reservas","name":"Sala Reservas","team":["Alice","Bob"]}46{"type":"PBI","id":"AB#1234","title":"API Reservas","status":"active","project":"sala-reservas"}47{"type":"Task","id":"AB#1234.1","title":"Diseñar endpoints","assigned":"Alice","sprint":"2026-04"}48{"type":"Member","id":"alice","name":"Alice","skills":["TypeScript","API"]}49{"type":"Skill","id":"typescript","name":"TypeScript","level":"mid"}50{"type":"Risk","id":"R001","desc":"Delay BD","prob":0.4,"impact":5}51{"type":"Decision","id":"ADR-001","desc":"GraphQL","adr":"projects/adr/ADR-001.md"}52{"type":"Sprint","id":"2026-04","number":"2026-04","capacity":80}53```5455## Construcción (fuentes)5657El grafo se construye escaneando:581. **Azure DevOps** — work items, iteraciones, asignaciones, capacidades592. **equipo.md** — miembros, skills, roles603. **reglas-negocio.md** — decisiones, restricciones, riesgos614. **agent-notes** — contexto acumulado, decisiones, hallazgos6263## Consultas6465Traduce preguntas en lenguaje natural a graph traversals:6667| Pregunta | Traversal | Ejemplo |68|---|---|---|69| "¿Quién sabe TypeScript?" | Member→HAS_SKILL→Skill | Alice, Bob (senior), Charlie (junior) |70| "¿De qué depende Task #123?" | Task←DECOMPOSES_TO←PBI | PBI AB#456: "Migrar BD" |71| "¿Qué riesgos afectan a este sprint?" | Sprint→CONTAINS→Task→HAS_RISK | R001: "Delay", R004: "API down" |72| "¿Impacto de cambiar decisión ADR-5?" | Decision→AFFECTS→Task | Tasks AB#123, AB#124, AB#125 |73| "¿Capacidad de Alice el próximo sprint?" | Member→(ASSIGNED_TO←Task←CONTAINS) | 32/80 SP asignados en Sprint 2026-05 |7475## Máximo 130 líneas7677Documentación comprimida. Detalles de implementación en comandos `/graph-*`.