> ## 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.

# Como funciona

> As duas peças do sistema — o plugin e o hub — e por que separar código de dados de cliente importa.

# Como funciona

O COIA separa produto, dados e processo. Isso deixa o sistema atualizável, seguro e fácil de retomar.

<CardGroup cols={2}>
  <Card title="Pacote instalado" icon="package">
    Onde ficam skills, comandos, validadores, templates e arquivos do produto.
  </Card>

  <Card title="Hub do cliente" icon="folder-open">
    Onde ficam perfil, voz, identidade, wiki, peças, acervo e estados.
  </Card>

  <Card title="Skills" icon="workflow">
    Processos guiados por fases, aprovações humanas, templates e validações.
  </Card>

  <Card title="Gates" icon="shield-check">
    Validadores executáveis que impedem entrega incompleta de parecer pronta.
  </Card>
</CardGroup>

## O fluxo de trabalho

<Steps>
  <Step title="Pedido natural">
    O dono pede algo: vender, atrair, organizar, decidir ou preparar.
  </Step>

  <Step title="Roteamento">
    A porta identifica a intenção e encaminha para a skill certa.
  </Step>

  <Step title="Contexto">
    A skill lê o hub e reaproveita o que o sistema já sabe.
  </Step>

  <Step title="Perguntas mínimas">
    Se faltar informação importante, o COIA pergunta uma coisa por vez.
  </Step>

  <Step title="Entrega validada">
    Quando aplicável, o gate roda antes da entrega final.
  </Step>

  <Step title="Memória viva">
    O aprendizado pode alimentar perfil, wiki e próximas entregas.
  </Step>
</Steps>

<Info>
  O hub padrão é `~/Documents/ZoryonCOIA`. Ele guarda os dados do cliente; o pacote instalado guarda o código.
</Info>