CommunityProgramación y desarrollogithub.com

Mapa del Código Base

Explica dónde reside el comportamiento en un repositorio, crea o actualiza un mapa de arquitectura respaldado por evidencia, o dibuja relaciones reales de componentes en Mermaid o draw.io. Útil para orientación en repositorios y diagramas de arquitectura.

¿Qué es Mapa del Código Base?

Esta habilidad ayuda a desarrolladores y agentes de IA a navegar y comprender la estructura de un repositorio de código, localizando rápidamente el código relevante para tareas específicas y preservando el contexto de orientación. Es particularmente útil para repositorios grandes o desconocidos, ya que puede generar mapas de arquitectura persistentes basados en evidencia o diagramas visuales de relaciones entre componentes. La habilidad soporta dos modos principales: orientación rápida (respondiendo preguntas como '¿dónde está X?') y creación de documentación detallada como mapas de arquitectura visual o diagramas. Para repositorios extensos, permite descubrimiento paralelo mediante agentes de solo lectura que exploran regiones acotadas de forma independiente, reduciendo el trabajo innecesario. El resultado siempre se basa en evidencia verificable del código fuente, la configuración declarada y el comportamiento observado en tiempo de ejecución, y se enfoca en proporcionar respuestas concisas y directas, sin rodeos ni información redundante.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Dev-PGVAA/skills/tree/HEAD/codebase-map

Installed? Explore more Programación y desarrollo skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Mapa del Código Base?

Localiza el código necesario para la tarea del usuario y preserva la orientación útil cuando se solicite. Distingue entre evidencia de fuente, configuración declarada y comportamiento observado en tiempo de ejecución.

Ruta según el entregable solicitado

  • Dónde está X / orientación rápida: lee el mapa existente relevante y verifica sus rutas contra el checkout. Responde con un flujo corto y enlaces a puntos de entrada; no se requieren escrituras de documentación.
  • Crear / actualizar un mapa persistente: usa orient. Preserva el diseño de la documentación existente y las instrucciones locales.
  • Visual de arquitectura: usa diagram. Se puede hacer un diagrama a partir de un barrido enfocado de la fuente sin generar primero un conjunto de documentación.

Descubrimiento paralelo

Para un repositorio grande, delega regiones acotadas independientes (por ejemplo, API/auth, trabajadores/datos, UI/navegación). Cada explorador es de solo lectura y devuelve rutas/símbolos reales, puntos de entrada, dependencias con evidencia, incertidumbres y la revisión exacta inspeccionada. No le pidas a cada explorador que escanee todo el árbol.

El padre posee el índice, la documentación compartida y las conexiones entre regiones. Verifica afirmaciones sobre límites, desduplica y reconcilia nombres inconsistentes antes de escribir. Si los agentes no están disponibles o el alcance es pequeño, realiza el mismo descubrimiento enfocado de forma secuencial. La delegación solo es útil cuando ahorra trabajo; nunca crees un agente por archivo.

Evidencia y finalización

La presencia de un paquete no prueba que se ejecute en producción; una importación no prueba un despliegue en red. Registra lo que se inspeccionó y lo que permanece desconocido. Verifica todos los enlaces locales entregados y la sintaxis de la fuente del diagrama con las herramientas disponibles. Informa la validación real y el mejor archivo de inicio, no una lista completa del repositorio.

Voz de la respuesta

Di el punto primero. Sin aperturas preparadas, sin "no X sino Y", sin restos de chat, sin relleno de importancia. Frases cortas junto a otras largas. Los hechos y calificadores se mantienen tan fuertes como la evidencia.

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills relacionados