Instalación

Requisitos

• Python 3.9 o superior y Git.
• Tu asistente: GitHub Copilot (en VS Code) o Claude.
• Nada más: el CLI kb no tiene dependencias.

Instalar el framework

# desde el repositorio de tu organización
bash install.sh --from <url>

# o desde una carpeta compartida / un zip descomprimido
bash <ruta>/install.sh

En Windows es install.ps1 con -From. Después, abrí una terminal nueva —el PATH recién instalado no existe en la que ya tenías abierta— y comprobá:

kb check

Puesta a punto guiada

Desde el chat de Copilot o Claude, escribí /kb-instalar. El agente:

1. Corre kb check y trabaja sobre el estado real, sin suponer.
2. Te pregunta solo lo que no puede averiguar (dónde está el código, si el equipo ya tiene el repositorio de documentación).
3. Ejecuta los pasos en orden y valida cada uno.

Dos repositorios

kbspec separa código y documentación. Los expedientes viven en un repositorio de documentación aparte, uno solo para todo el equipo. kb init-docs lo crea o lo conecta.

Verificar

kb check --json

Devuelve todo el estado en un objeto: requisitos, pasos de puesta a punto, y qué sigue. Cuando listo es true, ya podés crear tu primer requerimiento.