--- name: sshp-agents-help description: Catalogo dos agentes do SSHepherd. Explica o que cada skill faz, quando usar e em que ordem, com analogia para quem nunca administrou servidor. Use com "/sshp-agents-help", "quais comandos do sshepherd", "o que cada agente faz", "estou perdido no sshepherd". license: MIT compatibility: Claude Code, Codex, Cursor, Gemini CLI e demais agentes compativeis com Agent Skills. metadata: author: sandeco version: "0.0.10" framework: sshepherd role: catalogo --- Você explica o framework para quem chegou agora. Use analogia, não jargao. ## A ideia geral Pense no SSHepherd como uma equipe pequena cuidando de um imóvel que e seu. Você comprou um terreno (o VPS). Alguem precisa: escolher o terreno com você e entregar a chave, trocar a fechadura para uma que só você abre, ligar água e luz, mudar a mobilia quando você quiser trocar, e ir ver o que houve quando a luz cai. Cada agente é uma dessas funções. ## Os agentes ### `/sshp` — a portaria Você chega aqui e ele descobre em que ponto você esta: sem terreno, com terreno sem fechadura, com casa pronta, ou com um problema acontecendo agora. Ele não faz nada sozinho, só te leva para a pessoa certa. **Quando usar:** sempre que não souber por onde começar. --- ### `/sshp-setup` — o corretor é o chaveiro Escolhe o terreno com você (qual provedor, qual plano), acompanha a compra, e depois troca toda a fechadura: cria uma chave que só você tem, tira a chave mestra de circulacao e coloca grade nas janelas. E o agente que mais conversa, porque é a parte onde quem nunca fez isso trava. Ele aceita print de tela: você manda a foto de onde esta perdido e ele diz o que clicar. **Quando usar:** na primeira vez. E se você trocar de servidor. **Termina quando:** cinco coisas estão comprovadas por comando, não por achismo. Você entra por chave, o usuário mestre não entra mais pela rede, senha não abre mais nada, o firewall está ligado e as atualizações de segurança são automáticas. --- ### `/sshp-connect` — o porteiro é o livro de registro Guarda o endereco é a chave de cada servidor seu, e anota tudo que foi feito em cada um: o que, quando, por quem, com que resultado. Anota inclusive o que foi tentado e recusado. E ele quem barra comando perigoso. Alguns comandos ele recusa mesmo se você insistir, porque não existe motivo bom para apagar o disco inteiro. **Quando usar:** para trocar de servidor, testar se a conexão esta funcionando, ou lembrar o que foi feito semana passada. --- ### `/sshp-harden` — o vistoriador de segurança Passa pela casa toda e da uma nota de 0 a 100. Lista o que está aberto, do mais grave ao menos grave, e diz exatamente como fechar cada um. A vistoria não mexe em nada, então você pode chamar a qualquer hora, inclusive com a casa cheia. As correções você aprova uma por uma. **Quando usar:** logo depois de montar tudo, e depois a cada mes mais ou menos. Casa segura vai abrindo sozinha com o tempo: uma chave a mais aqui, uma janela destrancada ali. --- ### `/sshp-attack` — o chaveiro que testa a própria fechadura O vistoriador confere se a porta está trancada. Este vai para a calçada, olha a casa do lado de fora e diz o que dá para ver dali: qual janela ficou aberta, o que está visível pela fresta, o que está escrito na caixa de correio. São coisas diferentes, e a segunda pega o que a primeira não pega. Dá para ter a porta trancada com a chave debaixo do capacho — a vistoria diz que está tudo certo, e está mesmo, mas a chave está ali. Ele **nunca entra**. Bate na porta, vê se abre, e vai embora anotar. Também só olha casa que é sua: se você pedir para ele ir olhar a casa do vizinho, ele recusa. Tem uma parte que é nova: hoje quem passa na calçada anotando não é gente, é um robô que passa em todas as casas da cidade toda hora. Por isso deixar o manual da sua casa em cima do muro parou de ser inofensivo. **Quando usar:** depois de qualquer mudança na infraestrutura, e quando bater a dúvida "será que estou exposto?". --- ### `/sshp-provision` — o instalador Liga agua, luz e gas. Olha o que você vai colocar na casa (le os arquivos do seu projeto), instala o que aquilo precisa para funcionar, monta a estrutura que permite trocar a mobilia sem quebrar nada, e coloca a placa com o seu nome na porta (o domínio é o cadeado do navegador). **Quando usar:** uma vez por servidor, depois do setup. --- ### `/sshp-deploy` — a mudança Leva sua aplicação para o servidor. E faz isso de um jeito específico: monta a mobilia nova **ao lado** da antiga, e só quando esta tudo montado troca a placa de "sala atual". Se a nova não prestar, a antiga esta ali do lado, intacta, e voltar leva segundos. Depois de instalar, ele bate na porta para ver se alguem atende. Serviço ligado não é a mesma coisa que casa funcionando. **Quando usar:** toda vez que você publicar uma mudança. E na hora de voltar atrás. --- ### `/sshp-secrets` — o cofre A chave da API, a senha do banco, o token de pagamento: tudo isso mora num cofre do servidor que só o dono absoluto da máquina abre. A aplicação recebe as chaves na hora de ligar, sem ler o arquivo. E o assistente nunca vê nenhuma: ele sabe quais nomes existem e quais faltam, entrega o comando para você cadastrar no seu próprio terminal, e reinicia a aplicação com a chave nova. Se a aplicação não subir com ela, volta sozinho para as chaves que funcionavam. **Quando usar:** depois de preparar o servidor e antes de publicar, e toda vez que uma chave mudar. **O que ele nunca faz:** pedir o valor no chat. Se você colar uma chave na conversa, ele diz que ela está queimada e manda trocar. --- ### `/sshp-doctor` — o eletricista Chamado quando a luz cai. Ele mede tudo, olha o quadro, le o registro do que aconteceu, e diz onde esta o curto. Ele **não conserta**: aponta a causa com a evidência e diz quem resolve. Isso e de propósito. Quando algo está fora do ar você está com pressa e aceita qualquer sugestão. Um eletricista que só olha e explica é mais seguro do que um que mexe no quadro com pressa. **Quando usar:** "saiu do ar", "ta lento", "deu erro", "acabou o espaço". --- ### `/sshp-agents-help` — este catalogo **Quando usar:** quando estiver perdido. ## A ordem normal ``` /sshp │ ▼ /sshp-setup primeira vez, do zero até a chave funcionar │ ▼ /sshp-provision uma vez por servidor │ ▼ /sshp-secrets as chaves da aplicação, antes da primeira publicação │ ▼ /sshp-deploy toda semana, para sempre │ ├──► /sshp-doctor quando algo quebra ├──► /sshp-harden de tempos em tempos, por dentro └──► /sshp-attack de tempos em tempos, por fora ``` O harden e o attack andam juntos e não se substituem: um confere se a casa está fechada por dentro, o outro olha o que dá para ver da rua. ## O que o framework nunca faz Vale saber os limites: - **Não compra o servidor por você.** Ele te acompanha no painel, mas quem clica e você. O dinheiro é o acesso são seus. - **Não registra domínio.** - **Não cuida do seu banco de dados** — nem copia de segurança, nem migração de estrutura. - **Não roda nada sem você ver.** Toda mudança no servidor aparece na tela antes, com o comando exato. - **Não le sua chave privada.** Nem para conferir. - **Não deixa nada rodando no servidor.** Ele conecta, faz o que precisa e sai.