> ## Documentation Index
> Fetch the complete documentation index at: https://zos-help.zoryon.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Guia de uso

> O que pedir ao COIA, quando usar terminal e como não se perder no começo.

# Guia de uso

Você pode usar o COIA em linguagem natural. Na maior parte do dia a dia, não precisa decorar comandos: diga o que quer produzir, melhorar, diagnosticar ou organizar.

Use o terminal apenas para operação da máquina: instalar, validar, atualizar, configurar backup, puxar antes de trabalhar e enviar ao terminar.

## Antes da primeira entrega

Siga esta ordem:

<Steps>
  <Step title="Baixar e ativar">
    Instale com sua key.

    ```bash theme={null}
    curl -fsSL https://z-os.zoryon.co/install.sh | KEY=SUA-KEY bash
    ```
  </Step>

  <Step title="Validar">
    Confirme se a instalação está saudável.

    ```bash theme={null}
    zoryon --doctor
    zoryon status
    ```
  </Step>

  <Step title="Preparar ferramentas e backup">
    Rode o setup guiado.

    ```bash theme={null}
    zoryon-setup
    ```
  </Step>

  <Step title="Trabalhar com backup">
    Antes de trabalhar, puxe. Ao terminar, envie.

    ```bash theme={null}
    zoryon-pull
    zoryon-push
    ```
  </Step>
</Steps>

## O que pedir ao COIA

### Começar

"Começar", "instalei", "configurar meu cliente", "quero deixar meu negócio pronto".

Encaminha para onboarding, licença, hub, perfil do cliente, Genesis e menu inicial.

### Marketing

"Quero um carrossel", "faz um reel", "cria um artigo", "preciso de copy", "monta um anúncio".

Encaminha para linha editorial ou skill de formato.

### Vendas

"Minhas vendas travaram", "lead some", "faz uma proposta", "quero uma régua de qualificação".

Encaminha para diagnóstico, oferta, objeções, proposta ou playbook de vendas.

### Operações

"Estou afogado", "abre um projeto", "cria um processo", "quero delegar".

Encaminha para playbooks de operações, processos, rotina e organização.

### Estratégia

"O que o conselho acha?", "devo contratar?", "devo mudar preço?", "qual decisão faz mais sentido?".

Encaminha para o conselho executivo.

## Quando usar terminal

| Situação                        | Comando           |
| ------------------------------- | ----------------- |
| Validar instalação              | `zoryon --doctor` |
| Ver status do backup            | `zoryon status`   |
| Abrir setup guiado              | `zoryon-setup`    |
| Puxar backup antes de trabalhar | `zoryon-pull`     |
| Enviar backup ao terminar       | `zoryon-push`     |
| Puxar e enviar em sequência     | `zoryon-sync`     |
| Ver comandos disponíveis        | `zoryon comandos` |

## Regra prática

Se o pedido estiver vago, o COIA deve fazer poucas perguntas e sugerir o caminho mais provável. Ele não deve despejar uma lista enorme de opções.

<CardGroup cols={3}>
  <Card title="Caminho ideal" icon="route" href="/comecar/caminho-ideal">
    A ordem recomendada para começar sem se perder.
  </Card>

  <Card title="Comandos" icon="terminal" href="/operar/comandos-terminal">
    Todos os comandos práticos reunidos em uma página.
  </Card>

  <Card title="Backup GitHub" icon="github" href="/operar/backup-github">
    Proteja o hub em um repositório privado.
  </Card>
</CardGroup>