---
name: ingestao
description: >
  Processa a caixa de entrada do cérebro ({{PASTA}}/inbox/) — lê tudo que o {{AGENTE}} capturou na
  VPS e o que {{DONO}} jogou lá, entende o lote inteiro, apresenta um resumo em prosa do que entra
  e do que muda, e só depois do OK de {{DONO}} grava no acervo, arquiva o bruto e sobe pro GitHub.
  Use quando {{DONO}} disser "processa a inbox", "digere o que o {{AGENTE}} mandou", "esvazia a
  caixa de entrada", "organiza o que chegou", ou ao abrir uma sessão com itens pendentes lá.
  NÃO use para salvar algo novo (isso é /salvar) nem para escrever direto no acervo sem passar
  pelo resumo — o portão humano é obrigatório.
---

# /ingestao — da caixa de entrada para a memória

> Bruto → conhecimento conectado. Roda **só na workstation** (é aqui que existe o portão humano).
> **Ingestão única:** você lê o lote todo, digere do cru ao curado e apresenta a {{DONO}} um
> **resumo em prosa** antes de gravar. O OK dele é a cura.

## Passo 0 — Sincronizar (barreira, não paralelize)

```bash
git -C "{{PASTA}}" pull --rebase
```

**Espere terminar e confira o resultado antes de ler qualquer arquivo.** O {{AGENTE}} escreve na
VPS a cada 30 minutos; ler antes de puxar é decidir sobre um cérebro velho — e já causou perda de
item real. Se der conflito: **pare**, avise em linguagem simples, não force nada.

## Passo 1 — Orientar-se

Leia `MAPA.md` da raiz e, para a gaveta que o lote tocar, o `MAPA.md` dela. Você precisa saber o
que já existe antes de decidir onde algo novo mora.

## Passo 2 — Levantar o lote inteiro

Todos os `.md` de `inbox/` (exceto `_index.md`), incluindo subpastas:

- `status: na-fila` → curado pelo {{AGENTE}}, esperando destino.
- `status: sem-dono` → entidade não resolvida. Tente resolver; sem sucesso, **deixe na fila**.
- Item já com `inserido_em` → já foi processado, pule.

Leia **tudo** antes de decidir **qualquer coisa**. Item isolado engana: dois recados soltos
podem ser a mesma história.

## Passo 3 — Interpretar

Para cada item, decida:

1. **Modo** — *transformação* (algo que aconteceu → resumo BLUF com as lentes 💰 ➡️ ⚠️ 🔗,
   **preservando o literal** de números, valores e prazos num bloco `Fonte (literal)`) ou
   *enriquecimento* (conhecimento de referência → preserva o conteúdo como está).
2. **Destino** — pela tabela do `CLAUDE.md` §5. Em dúvida real, o item **fica na fila**.
3. **Costuras** — o que mais precisa mudar: `MAPA.md`, `memory/hot.md`,
   `memory/context/decisoes/AAAA-MM.md`, `memory/context/pendencias.md`.
4. **Relações** — o que esta nota cita (`relacionado`) e o que ela **não cita mas trata do mesmo
   objeto concreto** (`relacionado_contexto`, com o **elo explicado**). A régua está em
   `PADROES.md` §2: mesmo fornecedor/loja/pessoa/decisão vale; "a ideia dali serve aqui" não vale.
5. **Reconciliação** — se o item só confirma o que já existe, **não duplique**: cite como fonte
   na nota que já está lá.

> **Ponto levantado ≠ tarefa combinada.** Só vira pendência o que for obrigação de {{DONO}}.
> Quem *diz* que vai fazer não é necessariamente quem *faz*.

## Passo 4 — O portão: resumo em prosa

Apresente a {{DONO}}, **em prosa curta**, antes de gravar nada:

- **O que entra** — cada item em uma ou duas frases, e onde vai morar.
- **O que muda no cérebro** — decisões novas, pendências abertas ou fechadas, contexto que se altera.
- **As ligações que você propõe** — cada uma com o **elo explicado**, nunca só os títulos.
  ({{DONO}} não consegue julgar uma ligação pelo nome dos dois arquivos.)
- **O que você não soube resolver** — e por quê.

Ele concorda, corrige ou enriquece. **Sem esse OK, nada é gravado.** Não peça validação item a
item — é um resumo do lote, uma decisão só.

## Passo 5 — Gravar

Depois do OK:

1. Escreva as notas no destino, com o frontmatter completo do `PADROES.md`.
2. Aplique as costuras (MAPA, hot, decisões, pendências).
3. Mova o bruto para `archive/inbox/AAAA-MM/` e preencha `fonte_bruta` na nota final.
4. Apague o item da `inbox/` **só depois** de o bruto estar arquivado.
5. Atualize o `MAPA.md` de qualquer pasta onde você criou arquivo ou subpasta.

## Passo 6 — Subir

```bash
cd "{{PASTA}}"
ARQUIVOS=( <os caminhos exatos que você escreveu> )
for f in "${ARQUIVOS[@]}"; do
  [ -e "$f" ] || { echo "ABORTAR: não escrevi $f"; exit 1; }
done
git add -- "${ARQUIVOS[@]}"       # NUNCA "git add ." nem "-A"
git commit -m "ingestao: <resumo do lote>"
git pull --rebase
git push
```

**Por que caminhos explícitos:** um `.env`, um print com senha ou um `.txt` com token entraria
junto no `git add .` e ficaria **permanente** no histórico do GitHub. Você adiciona só o que
escreveu.

Se o push pedir senha ou der `Authentication failed`: **pare e avise** — "o git deste computador
não está conectado ao GitHub; é uma vez só: `gh auth login`". Nunca travar mudo.

## O que esta skill NÃO faz

Não escreve no acervo sem o resumo aprovado. Não cria pasta na raiz. Não apaga bruto sem
arquivar. Não decide sozinha uma ligação de contexto — propõe, com o elo, e espera o OK.