Communitygithub.com

JahacksV1/repositorio-inicializacion-agente

Comprende un repositorio sin modificar su arquitectura. Úsalo al comenzar a trabajar en un repositorio desconocido, al integrar un código base de cliente o al crear una línea base de pila/perfil.

¿Qué es repositorio-inicializacion-agente?

Esta habilidad permite a un agente de IA analizar rápidamente un repositorio de código desconocido y generar un perfil detallado basado en evidencia, sin alterar la arquitectura del proyecto. Es especialmente útil para incorporarse a un nuevo proyecto, revisar el código de un cliente o establecer una línea base técnica. El agente detecta el framework, lenguaje, gestor de paquetes y destino de despliegue, lee archivos de configuración y puntos de entrada clave, identifica scripts disponibles (dev, lint, test, build) y mapea áreas como frontend, backend, base de datos, autenticación e IA. También captura patrones arquitectónicos actuales, lista riesgos y carencias de producción, y todo ello se documenta en `.ai/PROJECT_PROFILE.md` usando una plantilla. La salida es concisa y accionable, ideal para tareas de desarrollo normales. Funciona en cualquier repositorio con archivos de configuración estándar y no requiere cambios en el código del producto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JahacksV1/day-one-agent-kit/tree/HEAD/skills/intake-repo

Preguntar en tu IA favorita

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

Documentación

Repositorio de Inicialización

Usa este flujo de trabajo para comprender rápidamente un repositorio antes de implementar cambios.

Objetivo

Producir un perfil de repositorio breve, basado en evidencia, con riesgos y próximos pasos.

Salida

  • .ai/PROJECT_PROFILE.md usando templates/PROJECT_PROFILE.md.

Reglas

  • No editar código del producto.
  • No reescribir la arquitectura.
  • Preferir patrones de código observados sobre suposiciones.
  • Mantener el perfil conciso y accionable.
  • "No aplica" es una respuesta válida y esperada para un Área Principal; un sitio estático/portafolio sin backend no tiene autenticación, base de datos ni lógica de IA que completar. Márcalo como "No aplica" en lugar de inventar contenido, adivinar una necesidad futura o dejarlo en blanco/ambiguo.

Pasos

  1. Detectar framework, lenguaje, gestor de paquetes y destino de despliegue.
  2. Leer archivos de paquetes/bloqueo/configuración y puntos de entrada principales.
  3. Identificar scripts disponibles: dev, typecheck, lint, test, build.
  4. Mapear áreas de frontend, backend, base de datos, autenticación, IA, despliegue.
  5. Identificar patrones de uso de variables de entorno.
  6. Capturar patrones de arquitectura actuales utilizados en el código.
  7. Listar carencias obvias de producción básica y riesgos clave.
  8. Generar o actualizar .ai/PROJECT_PROFILE.md.

Evidencia Mínima

Citar archivos concretos para cada hallazgo. Categorías de ejemplo:

  • fuente de script (package.json, pyproject.toml, etc.)
  • fuente de despliegue (vercel.json, Docker, flujos de CI)
  • fuente de uso de env (process.env, NEXT_PUBLIC_, etc.)
  • límites de autenticación/datos (middleware, manejadores de rutas, archivos de políticas)

Verificación de Finalización

  • El perfil incluye pila detectada, scripts, áreas principales, patrones, riesgos.
  • La salida es lo suficientemente breve como para ser útil durante tareas de codificación normales.

Skills relacionados