Descripción general
Para repositorios públicos
La experiencia completa de Ask Devin, incluida la búsqueda avanzada de código, la planificación y la creación de sesiones, está disponible en la aplicación Devin. DeepWiki público y DeepWiki MCP ofrecen funciones básicas de documentación y de preguntas y respuestas.
Controlar DeepWiki

.devin/wiki.json te permite controlar el comportamiento predeterminado de generación de wikis de Devin, lo cual es especialmente importante para repositorios grandes que pueden alcanzar los límites incorporados.
Si se encuentra un archivo .devin/wiki.json en el directorio raíz de tu repositorio durante la generación del wiki, usaremos los repo_notes y pages proporcionados para orientar la generación del wiki. Si se proporciona pages, omitiremos la planificación predeterminada basada en clústeres y crearemos exactamente las páginas que especifiques. Esto garantiza que las partes importantes de tu base de código queden documentadas incluso cuando el sistema automático, de otro modo, las omitiría.
Formato de la configuración
.devin/wiki.json en la raíz del repositorio con la siguiente estructura:
Opciones de configuración
repo_notes (Array)
- content (string, obligatorio): El contenido de la nota (máx. 10 000 caracteres)
- author (string, opcional): Quién escribió la nota
pages (Array, opcional)
- title (string, obligatorio): El título de la página (debe ser único y no puede estar vacío)
- purpose (string, obligatorio): Lo que esta página debe documentar
- parent (string, opcional): Título de la página principal para la organización jerárquica
- page_notes (array, opcional): Notas adicionales específicas de esta página
Límites de validación
- Máximo 30 páginas (80 para Enterprise)
- Máximo 100 notas en total (repo_notes + todas las page_notes combinadas)
- Máximo 10.000 caracteres por nota
- Los títulos de las páginas deben ser únicos y no estar vacíos
Ejemplos prácticos
Ejemplo 1: Notas del repositorio para guiar la generación del wiki
Ejemplo 2: Garantizar que determinadas carpetas queden documentadas
Ejemplo 3: Cómo abordar componentes que faltan
Ejemplo 4: Estructura jerárquica de la documentación
Prácticas recomendadas
1. Usa Repo Notes de forma estratégica
- Proporciona contexto sobre qué partes de tu código son más importantes
- Menciona carpetas o componentes específicos que deban priorizarse
- Explica las relaciones entre las diferentes partes de tu sistema
2. Organizar páginas lógicamente
- Comienza con páginas de alto nivel de descripción general
- Usa relaciones padre-hijo para crear jerarquías claras
- Agrupa las funcionalidades relacionadas
3. Sé específico con los objetivos de cada página
- Indica claramente qué debe documentar cada página
- Menciona los directorios, archivos o conceptos específicos en los que deba centrarse
- Proporciona suficiente detalle para que el sistema comprenda tu intención
4. Aborda las lagunas conocidas
- Si sabes que hay ciertas partes de tu base de código que se están pasando por alto, inclúyelas explícitamente
- Usa títulos descriptivos que dejen claro qué se debe cubrir
Solución de problemas frecuentes
”Solo se documentan ciertas carpetas”
.devin/wiki.json para especificar explícitamente qué partes de tu código base deben documentarse.
”Faltan componentes importantes en la wiki”
Primeros pasos
- Crea
.devin/wiki.jsonen la raíz de tu repositorio - Agrega repo_notes que expliquen la estructura de tu código base y las prioridades
- Si es necesario, especifica todas las páginas que quieres que se creen, con títulos y propósitos claros
- Haz commit del archivo y regenera tu wiki

