Skip to main content
Glama

🔨 Forja

Forje seu fluxo de trabalho de engenharia. Companion do Claude Code: agents, skills e scripts orquestrados, expostos via MCP.

Jira · Análise de repositórios · Padrões de commit/PR/DevOps · Relatórios · Slides & infográficos · RAG sobre a base de conhecimento


O que é

Forja é uma plataforma modular que reúne vários agents especializados (baseados no Claude Agent SDK), skills reutilizáveis e scripts. Ele foi pensado como uma ferramenta auxiliar ao Claude Code (e similares — Cursor, Claude Desktop): expõe os agents como tools MCP que você aciona de dentro da sua sessão de código. Há também uma interface web (FastAPI + dashboard) como cockpit local opcional e um CLI.

  • MCP server (principal) — os agents viram tools no Claude Code/Cursor/Claude Desktop. Veja docs/mcp.md.

  • Dashboard web (cockpit) — executar agents por clique e revisar resultados/artefatos.

  • CLI — forja run <agent> para automações.

Agents / módulos

Módulo

Papel

Jira

Analisar e controlar tasks no Jira (via MCP Atlassian): status, backlog, triagem, resumos.

Repo Analysis

Varrer e analisar os diversos repositórios de serviços/projetos: saúde, dependências, convenções, débitos.

Commit / PR / DevOps

Gerar bons padrões de commit (Conventional Commits), descrições de PR e práticas de DevOps/CI.

Reports

Montar relatórios (status, sprint, incidentes) a partir de dados do Jira, dos repos e do RAG.

Slides & Infographics

Conectar ao NotebookLM para gerar slides e infográficos a partir dos relatórios/base.

RAG

Busca semântica sobre a base de documentos e .md gerados de outros chamados e projetos.

Tudo é exposto por um dashboard web e por uma API que orquestra os agents.

Related MCP server: Snippy MCP Server

Arquitetura (visão rápida)

┌──────────────────────────────────────────────────────────┐
│                  Web Dashboard + API (FastAPI)            │
└───────────────┬──────────────────────────────────────────┘
                │
        ┌───────▼────────┐      registry + runtime
        │  Orchestrator  │  ── Claude Agent SDK ──┐
        └───────┬────────┘                        │
   ┌────────────┼───────────────┬──────────┬──────┴──────┐
┌──▼──┐   ┌─────▼─────┐   ┌──────▼─────┐ ┌──▼────┐  ┌─────▼─────┐
│Jira │   │Repo Anal. │   │Commit/PR/  │ │Reports│  │Slides/    │
│agent│   │  agent    │   │DevOps agent│ │ agent │  │Infographic│
└──┬──┘   └─────┬─────┘   └──────┬─────┘ └──┬────┘  └─────┬─────┘
   │            │                │          │             │
┌──▼────────────▼────────────────▼──────────▼─────────────▼──┐
│  Integrations: Jira (MCP) · Git repos · NotebookLM          │
│  RAG: embeddings (configurável) + vector store (Chroma)     │
└─────────────────────────────────────────────────────────────┘

Detalhes em docs/architecture.md.

Começando

# 1. Criar e ativar o ambiente
python -m venv .venv
# Windows (PowerShell):  .venv\Scripts\Activate.ps1
# Linux/macOS:           source .venv/bin/activate

# 2. Instalar em modo editável (dev)
pip install -e ".[dev]"

# 3. Configurar variáveis
cp .env.example .env   # e preencha as chaves

# 4. Subir o dashboard
forja serve
# ou:  uvicorn forja.web.app:app --reload

Scripts de bootstrap prontos em scripts/ (bootstrap.ps1 / bootstrap.sh).

Usar com o Claude Code (MCP)

pip install -e ".[mcp]"
forja mcp            # sobe o servidor MCP (stdio)

Registre no Claude Code (copie .mcp.json.example para .mcp.json) ou:

claude mcp add forja -- ./.venv/Scripts/python.exe -m forja.mcp_server

Os agents ficam disponíveis como tools forja_jira, forja_rag, forja_reports, etc. Detalhes em docs/mcp.md.

Fluxo de desenvolvimento (Git Flow)

  • main — produção, sempre estável, com tags de release.

  • develop — integração contínua das features.

  • feature/* — uma funcionalidade por branch, PR para develop.

  • release/* — estabilização, bump de versão e CHANGELOG, PR para main + tag.

  • hotfix/* — correção urgente a partir de main.

Versionamento SemVer, histórico em CHANGELOG.md. Guia completo em docs/gitflow.md e helper em scripts/new_feature.sh.

Estrutura

src/forja/        código da plataforma (orchestrator, agents, rag, integrations, web)
knowledge_base/   documentos .md que alimentam o RAG
docs/             arquitetura, git flow e docs por agent
scripts/          bootstrap e helpers de git flow
tests/            testes (pytest)

Licença

MIT.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers