Gondola Agentes

Coleção de agentes de IA prontos para uso em supermercados, distribuída pela VarejoTech. Cada pasta deste repositório é um agente independente, com seu próprio CLAUDE.md, skills, scripts e memórias de aprendizado.

Agentes disponíveis

| Pasta | O que faz | |---|---| | precificacao-max-lucro | Geração de sugestões de preço com foco em maximização de margem. | | analista-gc | Diagnóstico mercadológico e arquitetura de preço intra-categoria. | | categorizador | Categorização e padronização de itens do mix. | | analise-margem-vendas | Conversa sobre vendas, margem e rentabilidade a partir do parquet de vendas. | | descricao-produtos | Geração e padronização de descrições de produto. |

Instalação (1 comando)

Pré-requisitos:

• Node.js 18+ (instale a versão LTS — vale tanto Mac quanto Windows)
• Claude Code instalado

Abra o terminal na pasta onde você quer instalar os agentes e rode:

npx @varejo-tech/gondola-agentes

O instalador vai te perguntar:

1. Onde colocar (default: ./agentes-gondola)
2. Quais agentes instalar (default: todos)

E pronto. Próximo passo:

cd agentes-gondola/precificacao-max-lucro
claude

Diga ao Claude "primeira vez" ou "quero instalar" e ele te conduz pelo onboarding do agente.

Modo não-interativo

Se quiser pular as perguntas:

# Instala todos no default (./agentes-gondola)
npx @varejo-tech/gondola-agentes --all

# Define a pasta destino
npx @varejo-tech/gondola-agentes --all --dir minha-pasta

Atualizações

Quando sair uma nova versão dos agentes, basta rodar o npx de novo. Ele copia os arquivos atualizados — suas memórias e configurações por cliente (em clientes/<slug>/) ficam preservadas porque o instalador não sobrescreve subpastas que você não pediu.

Suporte

Dúvidas e suporte: comunidade VarejoTech..

Para mantenedores

Este repositório também publica o pacote npm @varejo-tech/gondola-agentes. Para liberar uma nova versão:

# 1. Bump da versão
npm version patch    # ou minor/major

# 2. Publicar
npm publish

# 3. Push da tag
git push --follow-tags