Base de conocimiento
Los agentes AI son tan buenos como el contexto que les das. La base de conocimiento es donde almacenas decisiones de arquitectura, especificaciones de API y conocimiento de dominio que los agentes referencian cuando implementan. Sin este contexto documentado, los agentes adivinan. Con el, toman decisiones informadas basadas en tu realidad.
La base de conocimiento de Almirant es un sistema de documentacion integrado donde tu equipo puede crear, organizar y buscar documentos en formato Markdown. Los documentos se agrupan en categorias jerarquicas, se vinculan a proyectos y work items, y sirven como contexto adicional para la IA.
Que es un documento
Un documento es una pagina de contenido escrita en Markdown. Puede ser una especificacion tecnica, una guia de procesos, notas de reunion, decisiones de arquitectura o cualquier conocimiento que tu equipo necesite compartir y consultar.
Cada documento pertenece a una categoria y puede estar vinculado a uno o mas proyectos.
Crear un documento
Haz clic en Nuevo documento desde la seccion de documentos. Completa los campos:
| Campo | Obligatorio | Descripcion | Ejemplo |
|---|---|---|---|
| Titulo | Si | Nombre descriptivo del documento | "Guia de despliegue a produccion" |
| Contenido | No | Cuerpo del documento en Markdown | Texto con formato, listas, tablas, etc. |
| Categoria | No | Categoria dentro del arbol jerarquico | "Guias tecnicas > Infraestructura" |
| Proyecto | No | Proyecto al que se vincula el documento | "App Mobile v2" |
Editor Markdown
El editor soporta la sintaxis Markdown completa:
- Encabezados (
#,##,###) - Listas ordenadas y no ordenadas
- Tablas
- Bloques de codigo con resaltado de sintaxis
- Negrita, cursiva y otros formatos en linea
- Enlaces e imagenes
En la parte inferior del editor se muestra un contador de palabras para tener una referencia del tamano del documento.
Categorias jerarquicas
Los documentos se organizan en un arbol de categorias con profundidad ilimitada. Esto permite crear estructuras tan detalladas como necesites:
Documentacion
├── Guias tecnicas
│ ├── Infraestructura
│ ├── Base de datos
│ └── APIs
├── Procesos
│ ├── Onboarding
│ └── Release management
├── Decisiones de arquitectura
└── Notas de reunion
├── Sprint reviews
└── Planificacion
Crear una categoria
- En el arbol lateral de documentos, haz clic en Nueva categoria
- Introduce el nombre de la categoria
- Opcionalmente, selecciona una categoria padre para crear subcategorias
Navegacion por arbol
El sidebar izquierdo de la seccion de documentos muestra el arbol completo de categorias. Haz clic en una categoria para ver los documentos que contiene. Las categorias con subcategorias se pueden expandir y colapsar.
Busqueda full-text
El buscador de documentos permite encontrar contenido por texto completo. Busca tanto en el titulo como en el cuerpo del documento, devolviendo resultados ordenados por relevancia.
Escribe tu consulta en la barra de busqueda de la seccion de documentos para filtrar el listado en tiempo real.
Vinculacion con work items
Los documentos pueden vincularse bidireccionalmente con work items. Esto es util para:
- Asociar una especificacion tecnica a la story que la implementa
- Vincular una decision de arquitectura al epic que la origino
- Conectar notas de reunion con las tareas que surgieron de ellas
Vincular desde el documento
En el detalle del documento, busca la seccion de Work items vinculados y anade los work items que quieras asociar.
Vincular desde el work item
Desde el detalle de un work item, puedes vincular documentos existentes en la seccion correspondiente.
La vinculacion es bidireccional: si vinculas un documento a un work item, desde el work item tambien veras la referencia al documento.
Fijado (pinning)
Puedes fijar documentos importantes para que aparezcan destacados en la parte superior del listado. Esto es util para documentos de referencia frecuente como guias de estilo, procesos criticos o documentos de onboarding.
Para fijar un documento, usa el icono de pin en el listado o en el detalle del documento.
Agrupacion cross-project
Los documentos pueden vincularse a multiples proyectos, lo que permite crear documentacion transversal que aplica a varios equipos o iniciativas. Un documento de "Estandares de codigo" puede estar vinculado a todos los proyectos de desarrollo, por ejemplo.
Historial de versiones
Almirant guarda automaticamente versiones anteriores de cada documento. Cada vez que guardas cambios, se crea una nueva version almacenada en S3. Puedes:
- Ver el historial de versiones de un documento
- Consultar el contenido de versiones anteriores
- Identificar cuando y que cambios se hicieron
Documentos como contexto para IA
Los documentos de la base de conocimiento pueden servir como contexto adicional para los agentes IA conectados via MCP. Cuando un agente necesita entender una especificacion, un proceso o una decision de arquitectura, puede consultar los documentos relevantes del proyecto.
Esto es especialmente potente cuando combinas documentos con work items: la IA puede leer la especificacion tecnica vinculada a un work item antes de implementarlo.
Los documentos estan disponibles via MCP:
| Tool | Descripcion |
|---|---|
list_documents | Lista documentos con filtros por proyecto y categoria |
list_document_categories | Lista las categorias jerarquicas disponibles |
Los documentos accesibles via MCP permiten a un agente IA consultar la base de conocimiento del equipo para tomar decisiones mas informadas durante la implementacion. Por ejemplo, antes de implementar un work item, el agente puede buscar especificaciones tecnicas o decisiones de arquitectura relevantes.
Relacionado: Proyectos | Work Items