F
fnunes9/bran_backend
Skill que transforma o Claude num QA de backend
updated 2026-11-18
View on GitHub ↗Direct link · no redirect page
- Star count
- 0 ★ · fnunes9/bran_backend · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 2 sources
- Score
- score 203 · 2 sources · repo
FAQ (answers come from our records)
Who is it for?
We filed it under these tags: Open Source. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
fnunes9/bran_backend;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# Bran — agente de QA de backend
Excerpted from the repository README (abridged)
O Bran é uma skill do Claude Code: um manual de comportamento que transforma o Claude num QA de backend. Ele lê a tarefa do kanban, cruza com a documentação, monta e executa as chamadas de API, confere o banco de dados, registra o resultado na tarefa e avisa no Discord.
> Skill, em poucas palavras: um arquivo de instruções (SKILL.md) que o Claude carrega quando você chama pelo nome (/bran). Não é um programa: é o "jeito de trabalhar" do agente. Os scripts da pasta scripts/ são as ferramentas que ele usa.
## 1. Mapa da pasta
Bran/
├── CLAUDE.md regras desta pasta (o Bran é independente; limites)
├── README.md este guia
├── .env.example modelo das variáveis (sem valores; pode compartilhar)
├── .env seus valores reais (NUNCA compartilhar)
├── .gitignore impede .env e .cache/ de irem para o Git
├── .claude/
│ ├── skills/bran/SKILL.md a skill: como o Bran testa e decide
│ ├── settings.json liga o hook de proteção do banco
│ └── hooks/guard_sql.sh bloqueia DELETE/UPDATE sem WHERE e DROP/TRUNCATE/ALTER
├── config/
│ ├── perfil.md seu perfil: kanban, colunas, classificações, sistemas
│ └── login.sh como fazer login na sua API (imprime só o token)
├── scripts/
│ ├── api_request.sh chamadas de API com token automático
│ ├── get_token.sh token com cache (sem login a toda hora)
│ ├── db_query.sh consultas ao MySQL
│ ├── discord_send.sh mensagens ao Discord
│ └── _load_env.sh carrega o .env (usado pelos outros scripts)
├── api/ collection do Bruno (criada por você no Bruno)
└── Epicos/
└── /
├── documentacao.md documentação de produto
├── duvidas.md doc de dúvidas (vence as outras fontes)
├── regras-aprendidas/regras.md
└── / relatorio_AAAA-MM-DD.md + evidencias/
Como as partes se conectam: você chama /bran BMD-1234 → o Claude carrega a SKILL.md → lê config/perfil.md para saber como falar com o kanban → lê a tarefa e os documentos do épico → executa os testes com os scripts (que leem o .env) → grava o relatório em Epicos/ e atualiza a tarefa no kanban.
## 2. Pré-requisitos
| O quê | Para quê | Como conferir |
| Claude Code (terminal ou extensão do VS Code) | Rodar o Bran | claude --version |
| curl e jq | Chamadas de API e leitura de JSON | curl --version e jq --version |
| Cliente MySQL de terminal | Consultas ao banco | mysql --version |
| Bruno (aplicativo) | Ver e repetir as requisições | Abrir o aplicativo |
| Acesso ao kanban com integração MCP | Ler e atualizar tarefas | claude mcp list |
| Usuário de teste exclusivo do Bran na API de homolog | Login sem derrubar a sessão de ninguém | — |
| Acesso de leitura ao banco de homolog | Conferir o que a API gravou | — |
| Webhooks do Discord (reprovação e produto) | Avisos do Bran | — |
> MCP, em poucas palavras: um padrão de "tomada" que dá ao Claude ferramentas novas. O kanban expõe um servidor MCP; ao registrá-lo, o Claude ganha ferramentas como "buscar tarefa" e "comentar".
## 3. Instalação passo a passo
Os comandos são para Linux (Ubuntu/Debian). Rode na raiz da pasta do Bran.
### 3.1. Ferramentas básicas
bash
sudo apt update
sudo apt install curl jq mysql-client
apt update atualiza a lista de pacotes; apt install instala. Vai pedir sua senha do Linux.
O pacote mysql-client instala só o cliente (não um servidor). Se aparecer "pacote não encontrado", tente default-mysql-client.
> Skill, em poucas palavras: um arquivo de instruções (SKILL.md) que o Claude carrega quando você chama pelo nome (/bran). Não é um programa: é o "jeito de trabalhar" do agente. Os scripts da pasta scripts/ são as ferramentas que ele usa.
## 1. Mapa da pasta
Bran/
├── CLAUDE.md regras desta pasta (o Bran é independente; limites)
├── README.md este guia
├── .env.example modelo das variáveis (sem valores; pode compartilhar)
├── .env seus valores reais (NUNCA compartilhar)
├── .gitignore impede .env e .cache/ de irem para o Git
├── .claude/
│ ├── skills/bran/SKILL.md a skill: como o Bran testa e decide
│ ├── settings.json liga o hook de proteção do banco
│ └── hooks/guard_sql.sh bloqueia DELETE/UPDATE sem WHERE e DROP/TRUNCATE/ALTER
├── config/
│ ├── perfil.md seu perfil: kanban, colunas, classificações, sistemas
│ └── login.sh como fazer login na sua API (imprime só o token)
├── scripts/
│ ├── api_request.sh chamadas de API com token automático
│ ├── get_token.sh token com cache (sem login a toda hora)
│ ├── db_query.sh consultas ao MySQL
│ ├── discord_send.sh mensagens ao Discord
│ └── _load_env.sh carrega o .env (usado pelos outros scripts)
├── api/ collection do Bruno (criada por você no Bruno)
└── Epicos/
└── /
├── documentacao.md documentação de produto
├── duvidas.md doc de dúvidas (vence as outras fontes)
├── regras-aprendidas/regras.md
└── / relatorio_AAAA-MM-DD.md + evidencias/
Como as partes se conectam: você chama /bran BMD-1234 → o Claude carrega a SKILL.md → lê config/perfil.md para saber como falar com o kanban → lê a tarefa e os documentos do épico → executa os testes com os scripts (que leem o .env) → grava o relatório em Epicos/ e atualiza a tarefa no kanban.
## 2. Pré-requisitos
| O quê | Para quê | Como conferir |
| Claude Code (terminal ou extensão do VS Code) | Rodar o Bran | claude --version |
| curl e jq | Chamadas de API e leitura de JSON | curl --version e jq --version |
| Cliente MySQL de terminal | Consultas ao banco | mysql --version |
| Bruno (aplicativo) | Ver e repetir as requisições | Abrir o aplicativo |
| Acesso ao kanban com integração MCP | Ler e atualizar tarefas | claude mcp list |
| Usuário de teste exclusivo do Bran na API de homolog | Login sem derrubar a sessão de ninguém | — |
| Acesso de leitura ao banco de homolog | Conferir o que a API gravou | — |
| Webhooks do Discord (reprovação e produto) | Avisos do Bran | — |
> MCP, em poucas palavras: um padrão de "tomada" que dá ao Claude ferramentas novas. O kanban expõe um servidor MCP; ao registrá-lo, o Claude ganha ferramentas como "buscar tarefa" e "comentar".
## 3. Instalação passo a passo
Os comandos são para Linux (Ubuntu/Debian). Rode na raiz da pasta do Bran.
### 3.1. Ferramentas básicas
bash
sudo apt update
sudo apt install curl jq mysql-client
apt update atualiza a lista de pacotes; apt install instala. Vai pedir sua senha do Linux.
O pacote mysql-client instala só o cliente (não um servidor). Se aparecer "pacote não encontrado", tente default-mysql-client.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/fnunes9-bran-backend/)
- Source
- github · https://github.com/fnunes9/bran_backend
- Browse by field
- Open source
- Listed by
- 2 independent sources
- added
- today
More entries
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.