> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Codificar com IA

> Instale o fluxo do Jelou Functions na sua ferramenta de IA para que ela entenda a API define(), os comandos CLI e as convenções da plataforma.

Com `jelou skill install` você instala um arquivo `SKILL.md` na sua ferramenta de codificação com IA. Esse arquivo ensina tudo sobre Jelou Functions: a API `define()`, o objeto `ctx`, validação com Zod, cron, testes e comandos CLI. Com isso, sua ferramenta pode escrever código correto para a plataforma desde o primeiro prompt.

## Instalação

<Steps>
  <Step title="Execute o instalador">
    A partir da raiz do seu projeto Jelou Functions:

    ```bash theme={null}
    jelou skill install
    ```
  </Step>

  <Step title="Verifique a saída">
    O CLI detecta automaticamente quais ferramentas você tem instaladas:

    ```bash theme={null}
    ✓ Installed jelou-functions skill for 4 agents

    ▸ Claude Code
    ▸ Cursor
    ▸ Windsurf
    ▸ Cline

    Installed locally — commit .agents/ to share with your team.
    ```
  </Step>

  <Step title="Abra sua ferramenta e comece a codificar">
    O fluxo é ativado automaticamente quando a ferramenta detecta código relacionado ao Jelou Functions (`define()`, `@jelou/functions`, `ctx.env`, etc.).
  </Step>
</Steps>

## Ferramentas suportadas

O instalador detecta 12 ferramentas de codificação com IA. Cada uma usa seu próprio diretório de workflows, mas todas recebem o mesmo conteúdo.

<Tabs>
  <Tab title="Claude Code">
    **Diretório:** `.claude/skills/jelou-functions/SKILL.md`

    Detectado automaticamente. O fluxo aparece como contexto disponível nas suas conversas.
  </Tab>

  <Tab title="Cursor">
    **Diretório:** `.cursor/skills/jelou-functions/SKILL.md`

    Detectado automaticamente. O Cursor carrega o fluxo quando você trabalha em arquivos do Jelou Functions.
  </Tab>

  <Tab title="Windsurf">
    **Diretório:** `.windsurf/skills/jelou-functions/SKILL.md`

    Detectado automaticamente quando o projeto é aberto.
  </Tab>

  <Tab title="Universal">
    **Diretório compartilhado:** `.agents/skills/jelou-functions/SKILL.md`

    As seguintes ferramentas leem do diretório universal `.agents/skills/`:

    | Ferramenta     | Detecção                              |
    | -------------- | ------------------------------------- |
    | Amp            | `~/.config/amp`                       |
    | Codex          | `~/.codex`                            |
    | Gemini CLI     | `~/.gemini`                           |
    | GitHub Copilot | `.github/` no projeto ou `~/.copilot` |
    | OpenCode       | `~/.config/opencode`                  |
    | Kimi Code CLI  | `~/.kimi`                             |
  </Tab>

  <Tab title="Outras">
    As seguintes ferramentas têm seu próprio diretório de workflows:

    | Ferramenta | Diretório           |
    | ---------- | ------------------- |
    | Cline      | `.cline/skills/`    |
    | Continue   | `.continue/skills/` |
    | Roo Code   | `.roo/skills/`      |

    O instalador cria um symlink de cada diretório para a cópia canônica em `.agents/skills/`.
  </Tab>
</Tabs>

## Como usar

Uma vez instalada, sua ferramenta de IA entende a plataforma completa. Experimente prompts como:

```
Create a function that queries a customer's balance by phone
```

```
Add Zod validation to the input with .describe() so MCP has good descriptions
```

```
Configure a cron that runs every hour to clean up old records
```

```
Write tests with createMockContext for the customer query function
```

O fluxo é ativado automaticamente quando a ferramenta detecta padrões como `define()`, `@jelou/functions`, `ctx.env`, `ctx.isCron`, `createMockContext` ou comandos `jelou`.

## Local vs global

| Modo   | Comando                        | Localização                  | Uso                                         |
| ------ | ------------------------------ | ---------------------------- | ------------------------------------------- |
| Local  | `jelou skill install`          | `.agents/skills/` no projeto | Por projeto, compartilhe com o time via git |
| Global | `jelou skill install --global` | Diretório home (`~`)         | Ativo em todos os projetos                  |

**Local** é ideal para equipes: ao fazer commit de `.agents/skills/`, qualquer membro da equipe que clonar o repositório terá o fluxo disponível sem precisar executar nada.

**Global** é útil se você trabalha em múltiplos projetos Jelou Functions e quer o fluxo sempre ativo.

<Tip>
  Faça commit de `.agents/skills/` no seu repositório para que toda a sua equipe obtenha o fluxo automaticamente ao clonar o projeto.
</Tip>