pi-new-project/README.md

pi-new-project

Paquete de pi que genera la base documental de un proyecto nuevo: AGENTS.md, README.md, CHANGELOG.md, TODO.md, INSTALL.md y .gitignore, listos para versionar y con las secciones de reglas reservadas para acordarlas después.

Contenido

pi-new-project/
├── package.json                     # manifiesto de paquete pi
├── README.md                        # este documento
├── INSTALL.md                       # instalación en otro ordenador
├── CHANGELOG.md
├── TODO.md
└── skills/
    └── new-project/
        ├── SKILL.md                 # instrucciones para el agente
        ├── scripts/new-project.sh   # andamiaje (bash, sin dependencias)
        ├── templates/               # plantillas con {{MARCADORES}}
        └── references/plantillas.md # qué es cada documento

Uso

En una sesión de pi, pide crear un proyecto nuevo; la skill new-project se activa sola. También puedes forzarla:

/skill:new-project crea el proyecto "gestor-gastos" en ~/src/gestor-gastos

O ejecutar el script directamente:

skills/new-project/scripts/new-project.sh --help
skills/new-project/scripts/new-project.sh \
  --nombre "Gestor de gastos" \
  --descripcion "API para registrar y consultar gastos personales" \
  --git ~/src/gestor-gastos

El script nunca sobreescribe ficheros existentes salvo con --force, y admite --dry-run para revisar antes.

Instalación

Ver INSTALL.md. Resumen: copia (o enlaza) el directorio en ~/.pi/agent/skills/ o instálalo como paquete con pi install ./pi-new-project.

Requisitos

• bash 4+ y git (opcional, solo para --git y el autor por defecto).
• No usa Python, Node ni dependencias externas: es bash con biblioteca estándar.