@softize/base

Método de trabalho da Softize, independente de IDE. O pacote é dono das skills, dos agentes e dos adapters de processo que fornece; o próprio pacote os materializa no repo consumidor.

Uso

Instale como dependência de desenvolvimento e materialize a versão resolvida no lockfile:

pnpm add -D @softize/base
pnpm exec base setup

O comando é idempotente. Ele cria ou reconcilia:

• base.json, com a versão aplicada e eventuais skills excluídas;
• .agents/skills/ e o bloco gerenciado de AGENTS.md para Codex;
• .claude/skills/, .claude/agents/, .claude/hooks/, settings.json e o bloco de CLAUDE.md para Claude;
• .githooks/pre-push.d/base e .github/workflows/base.yml para enforcement fora da sessão. O dispatcher compartilhado .githooks/pre-push executa os fragmentos dos pacotes instalados.

Esses artefatos são parte do projeto e devem ser comitados. O Maestro pode oferecer uma interface visual para trabalhar, mas não é necessário para instalar, atualizar ou validar a Base.

Em clone novo, os artefatos já chegam pelo Git. Depois de instalar as dependências, execute pnpm exec base setup uma vez para configurar core.hooksPath; o comando reconcilia o conteúdo sem reescrever projeções atuais e pode ser repetido com segurança.

Atualização e verificação

Depois de atualizar a dependência, execute novamente:

pnpm exec base setup

O CI e o pre-push usam:

pnpm exec base check

check falha quando base.json, a versão instalada ou qualquer projeção comitada diverge. Uma versão nova disponível no registry não é aplicada silenciosamente: ela entra no lockfile por um PR normal e esse PR materializa seus artefatos.

Ownership e conflitos

Cada arquivo gerado leva um marcador com pacote, fonte e hash do conteúdo. O setup:

• atualiza ou remove somente arquivos íntegros que pertencem à Base;
• preserva e reporta arquivos gerenciados que foram editados;
• preserva e reporta colisões com arquivos sem marcador ou pertencentes a outro pacote;
• altera somente o bloco da Base em AGENTS.md e CLAUDE.md e seus próprios hooks em .claude/settings.json.

O campo exclude de base.json aceita apenas slugs de skills e vale para as projeções Claude e Codex. Agentes, hooks e instruções permanentes não são opcionais.

Desenvolvimento

npm run skills:check
npm test

As fontes canônicas ficam em skills/<slug>/SKILL.md. O contrato completo e seu validador estão na skill author-skill.