Pular para o conteúdo principal

Conectar o Playbook

O Kadu lê o Playbook de duas formas: pelo GitHub App do Kadu (recomendado) ou por uma deploy key SSH. Nos dois casos o acesso é só de leitura.

GitHub App do Kadu (recomendado)​

É o caminho do primeiro acesso ao console: o cartão Conecte o Playbook leva à instalação. Ver Primeiros passos.

Com o GitHub App
PermissãoContents: Read-only, só nos repositórios escolhidos na instalação
Leituraum token de instalação gerado a cada leitura, válido por 1 hora, restrito ao repositório da organização
Atualizaçãocada push no branch padrão avisa o Kadu, que sincroniza na hora
Desconexãodesinstalar o App, suspender a instalação ou tirar o repositório dela desliga a organização

Ao voltar do GitHub, o console confere que a instalação é de quem a fez antes de ligar o repositório. Se a instalação cobre vários repositórios, o console pede para escolher qual é o Playbook, marcando os que têm o catálogo do Playbook, .claude-plugin/marketplace.json.

Deploy key (sem o App)​

Para um repositório mantido pela Kobana, ou quando o App não pode ser instalado:

  1. A equipe da Kobana cadastra o endereço SSH do repositório na organização (git@github.com:<dono>/<repositório>.git).
  2. O Kadu gera um par de chaves e mostra a chave pública.
  3. No GitHub, em Settings → Deploy keys → Add deploy key, cole a chave pública sem marcar "Allow write access".
  4. Para a atualização a cada push, configure em Settings → Webhooks → Add webhook a URL e o secret que a equipe da Kobana informar, com content type application/json e o evento "Just the push event".

A chave privada é gravada cifrada e nunca sai do Kadu. Sem o webhook, a sincronização ainda acontece pela verificação de hora em hora.

O que o Kadu guarda​

  • O endereço do repositório e, sem o App, a deploy key cifrada.
  • O catálogo: o frontmatter das skills com bloco task:, lido a cada sincronização.
  • Os últimos commits lidos, exibidos em Configurações → Deployment.

O Kadu não guarda cópia do código das skills: cada execução clona o branch padrão no momento em que começa e apaga o clone no fim.

Um Playbook por organização​

Uma organização tem um único Playbook, e é nele que estão todos os seus workspaces. Para um novo domínio de negócio, crie um novo plugin no mesmo repositório (Novo workspace), e não um repositório novo.