altis-claude-harness

Padroes Claude Code da Altis Sistemas: agents, slash commands, rules, skills, hooks e o MCP da base de conhecimento RAG (altis-rag), instalados globalmente em ~/.claude com auto-update silencioso e liberacao por estacao (MAC address).

Para o desenvolvedor (uma unica vez)

Pre-requisitos: Node.js 18+, Python 3 no PATH, Git para Windows (git-bash), estacao liberada pelo gestor.

npx altis-claude-harness install

Se a estacao nao estiver liberada, o comando mostra os MACs da maquina - envie ao gestor e rode de novo depois da liberacao.

Pronto. A cada abertura do Claude Code, uma checagem em background (no maximo 1 a cada 4h) compara a versao instalada com o registry npm e aplica atualizacoes sozinha. O conteudo novo vale na sessao seguinte.

O MCP da base de conhecimento (altis-rag) ja vem pre-configurado no seu ~/.claude.json (URL + chave de acesso, via payload/mcp-fragment.json) - nenhuma configuracao manual e necessaria. Servidores MCP pessoais e demais chaves do .claude.json nunca sao tocados; backup unico em .claude.json.altis-bak. As interacoes com o Claude Code (prompts, respostas e tokens, incluindo subagentes) sao registradas automaticamente na base interna da Altis via hook de telemetria.

Comandos uteis:

npx altis-claude-harness status     # o que esta instalado + MACs da estacao
npx altis-claude-harness check      # ha atualizacao?
npx altis-claude-harness update     # forca sync agora
npx altis-claude-harness uninstall  # remove tudo que e gerenciado

O instalador NUNCA toca em arquivos pessoais do seu ~/.claude (skills/commands/settings proprios). O que ele gerencia esta listado em ~/.claude/altis-claude.manifest.json. Log do auto-update: ~/.claude/hooks/altis/update.log.

Liberacao de estacoes (gestor)

1. Dev roda npx altis-claude-harness status e envia os MACs exibidos.

2. Adicione a entrada em payload/hooks/liberacoes.json:

   { "liberadas": [ { "mac": "AA:BB:CC:DD:EE:FF", "id": "dev01" } ] }

   (use um apelido curto em id - o pacote e publico, nao exponha nome completo)

3. npm version patch + git push. A Action publica e as estacoes recebem pelo auto-update (janela de ate 4h + abertura de sessao).

Para revogar: remova a entrada e publique da mesma forma. A estacao revogada recebe a lista nova no proximo update e os comandos Altis passam a ser negados. A liberacao tambem exige contato com o registry nas ultimas 24h (ficar offline nao burla a revogacao).

Publicar atualizacao de conteudo (gestor)

1. Edite/adicione arquivos em payload/ (agents, commands, rules, skills, hooks).
2. Rode node --test e node scripts/validate-payload.js.
3. Bump de versao (npm version minor) - obrigatorio: e por versao que as estacoes detectam update.
4. git push na main. A Action valida e publica; a equipe recebe ao longo do dia.

Estrutura

bin/cli.js       CLI (install/update/check/status/uninstall, flag --target p/ testes)
lib/             sync, merge de settings e do MCP (.claude.json), manifest, versao no registry
payload/         conteudo distribuido para ~/.claude (inclui liberacoes.json e mcp-fragment.json)
scripts/         validacao de payload (roda no CI)