Docs / Primeros pasos
Cómo funciona GenPM
Un paquete GenPM son tres capas que viajan juntas y están ancladas a un solo commit:
| Capa | Qué es | Dónde termina |
|---|---|---|
| Código | Código fuente de un módulo | d, por ejemplo src/lib/auth/ |
| Contexto | Reglas para tu agente de IA (x) |
<d>/AGENTS.md y archivos de reglas del IDE con alcance |
| Conexiones | Servidores MCP que necesita el módulo (m) |
.mcp.json, .cursor/mcp.json… solo con tu consentimiento |
El registry solo guarda metadatos
El registry indexa manifiestos y apunta a Git. Al instalar, el CLI descarga el código directamente del host Git en el commit exacto (c) y lo verifica: git rev-parse HEAD debe ser igual a c y cada archivo debe coincidir con el árbol del commit.
Plan antes que acción
plan() nunca escribe en tu proyecto. Resuelve dependencias, descarga a una caché global y escanea los archivos. apply() escribe con un journal: si algo falla, se revierte todo.
Nunca hay scripts
GenPM no tiene scripts de ciclo de vida. Nada de un paquete se ejecuta en tu máquina. Se rechazan los archivos que otras herramientas ejecutan solas (postinstall, .npmrc, .envrc, .vscode/tasks.json…).