ARCH-02 Ontologia del grafo de conocimiento

ARCH-02 — Ontología del grafo de conocimiento

• Fuente: ARCH-01, RF-05, RF-07.

Propósito

Definir el modelo de datos del conocimiento de DevMind. Es el activo central del producto: la IA navega este grafo, pero no lo define. Sin aristas tipadas, “Estoy perdido” (RF-07) y el mapa (RF-05) no son implementables.

Tipos de nodo

Tipo	Descripción
Concept	Unidad de conocimiento (DI, JWT, Coroutines).
Technology	Agrupación (Flutter, Spring Boot, Kotlin).
Note	Captura del usuario (Hoy).
Project	Proyecto real (Tasks API, DevMind).
Decision	Entrada del estándar, versionada.
Experiment	Prueba acotada con hipótesis.
Problem	Duda/obstáculo (“no entiendo X”).

Tipos de arista (tipadas, obligatorias)

Arista	Significado	Ejemplo
PREREQUISITE_OF	A debe entenderse antes que B	HTTP Filter → SecurityFilterChain
EXEMPLIFIES	Un ejemplo/código ilustra un concepto	AuthExample → JWT
USED_IN	Concepto/tecnología usada en un proyecto	Kotlin → Tasks API
EVALUATED_BY	Un experimento evalúa una tecnología	Hexagonal → mini-orders
SUPERSEDES	Una decisión reemplaza a otra	Kotlin(v2) → Java(v1)
REVIEWS	Una nota/revisión atañe a un nodo	Nota → Decisión
RELATED_TO	Relación genérica explícita (último recurso)	—

Estados de dominio (por Concept)

Descubierto · Aprendiendo · Experimentando · Adoptado · Descartado · Revisar

Reglas

1. Toda arista tiene tipo; RELATED_TO se evita si existe un tipo más preciso.
2. PREREQUISITE_OF es un DAG (sin ciclos).
3. Las aristas propuestas por IA nacen como propuesta hasta que el usuario las confirma.
4. El estado de dominio lo declara el usuario.

Diagrama

flowchart LR
    TECH[Technology] -->|contiene| CON[Concept]
    NOTE[Note] -->|EXEMPLIFIES| CON
    CON -->|USED_IN| PROJ[Project]
    EXP[Experiment] -->|EVALUATED_BY| CON
    DEC1[Decision v1] -->|SUPERSEDES| DEC2[Decision v2]
    PREREQ[Concept A] -->|PREREQUISITE_OF| CONB[Concept B]

Trazabilidad

• Upstream: ARCH-01.
• Downstream previsto: ADR-02, RF-05, RF-07, RF-10.