Saltar al contenido
Puruto

puruto-data

¿Qué es puruto-data?

puruto-data es el repositorio central de almacenamiento del ecosistema Puruto. Todos los Purutos del ecosistema leen y escriben sus datos aquí — nunca en las carpetas de otros Purutos.

Es un Puruto completo (implementa init, help, list, status) y actúa como guardián del acceso a los datos del ecosistema.

Cuándo necesitarlo

  • Cuando tienes más de un Puruto que comparte datos
  • Cuando quieres un punto único de consulta sobre tus datos personales
  • Cuando necesitas que los datos persistan aunque muevas o reinstales un Puruto

Si solo tienes un Puruto, puede almacenar sus datos localmente en db/. Cuando el ecosistema crece, centralizarlo en puruto-data es la solución natural.

Generarlo

Ventana de terminal
# Con /init (genera todo el ecosistema de una vez)
/init


# O solo puruto-data
python3 .claude/skills/puruto-generator/scripts/generate.py --name puruto-data

Estructura

~/purutos/puruto-data/
├── CLAUDE.md              ← reglas de acceso y gestión de datos
├── agent.md
├── README.md
├── .env.example
├── registry.json          ← índice de Purutos registrados
├── shared/                ← datos compartidos (acceso controlado)
├── <puruto-name>/         ← datos de cada Puruto registrado
├── .env                   ← opcional (entorno local)
├── .puruto-standard-version
└── .claude/skills/
    ├── init/SKILL.md
    ├── help/SKILL.md
    ├── list/SKILL.md
    ├── status/SKILL.md
    ├── register/SKILL.md  ← registra Purutos en la bóveda
    ├── read/SKILL.md      ← lectura de datos (si está en el scaffold)
    └── write/SKILL.md     ← escritura de datos (si está en el scaffold)

Los datos de cada Puruto se almacenan en su propia subcarpeta:

~/purutos/puruto-data/
├── puruto-finanzas/       ← datos propiedad de puruto-finanzas
├── puruto-salud/          ← datos propiedad de puruto-salud
├── puruto-notas/          ← datos propiedad de puruto-notas
└── shared/                ← datos cross-dominio (acceso controlado)

Cómo lo encuentran los demás Purutos

Cada Puruto busca puruto-data en este orden:

  1. Ruta especificada en PURUTO_DATA_PATH del .env del Puruto
  2. ../puruto-data/ relativo al directorio del Puruto (convención de co-localización)
Ventana de terminal
# En el .env de cualquier Puruto:
PURUTO_DATA_PATH=../puruto-data/   # por defecto
# o con ruta absoluta:
PURUTO_DATA_PATH=/home/user/purutos/puruto-data/

Política de acceso

  • Cada Puruto solo escribe en su propia carpeta (<puruto-name>/ en la raíz de puruto-data)
  • El acceso a shared/ está abierto a todos los Purutos del ecosistema
  • puruto-data nunca se publica en el marketplace — es un repo privado por diseño

Ver también