obraforge

obraforge is an open catalog of Agent Skills for AEC (architecture, engineering, and construction) in Brazil, licensed under MIT. A skill packages sector-specific knowledge as a procedure that any Agent Skills–compatible code agent (Claude Code, Codex, Gemini CLI, Cursor, GitHub Copilot, and others) loads on demand. The project is in Phase 1 — MVP: three skills are published and install with npx obraforge add <skill> --for <agent>.

O que é

obraforge é o catálogo aberto de Agent Skills para AEC (arquitetura, engenharia e construção) no Brasil, pensado para ser instalável com um comando em qualquer agente de código compatível com o padrão aberto Agent Skills — Claude Code, Codex, Gemini CLI, Cursor, GitHub Copilot e outros. Licença MIT.

Uma skill é uma pasta com um SKILL.md: conhecimento de setor empacotado como procedimento que o agente carrega sob demanda. O obraforge guarda, valida, cataloga e distribui essas pastas. Nada mais.

O que obraforge não é

• Não é runtime nem orquestrador. Quem executa é o agente do usuário, na assinatura do usuário.
• Não tem memória, fila, conta de usuário nem cobrança dentro do produto. É arquivo de texto num repositório.
• Não entrega resultado fim a fim. A skill confere, estrutura, explica ou dá modelo; o entregável de engenharia continua sendo de quem assina.
• Não é exclusivo de um LLM. Ninguém precisa trocar de assistente para usar o catálogo.

Estado atual

Fase 1 — MVP. Três skills publicadas: validar-planilha-orcamentaria (orçamento), checklist-edital (licitação) e revisar-conformidade-documental (SST).

Instalação

Na pasta do projeto, com Node 22 ou superior:

npx obraforge@latest list
npx obraforge@latest add validar-planilha-orcamentaria --for claude

| Ferramenta | --for | Pasta onde a skill fica | | --- | --- | --- | | Claude Code | claude | .claude/skills/<nome>/ | | Codex | codex | .agents/skills/<nome>/ | | Gemini CLI | gemini | .agents/skills/<nome>/ | | Outro agente compatível | agents | .agents/skills/<nome>/ |

Sem --for, a CLI detecta o agente pela pasta atual (.claude/, .agents/ ou .gemini/). Sem argumento nenhum, num terminal, npx obraforge abre o modo interativo. npx obraforge search <termo> procura no catálogo.

Antes de gravar, a CLI confere o hash da skill contra o catálogo da mesma versão e recusa se não bater. Ela não faz nenhuma chamada de rede, não executa conteúdo da skill e registra o que instalou em obraforge.lock.json.

Como contribuir

Veja CONTRIBUTING.md para o fluxo de proposta, escrita e revisão de uma skill.

Segurança

Vulnerabilidades devem ser reportadas pelo canal privado descrito em SECURITY.md, nunca por issue pública.

Aviso

Nenhuma skill do obraforge substitui o responsável técnico. Toda skill confere, estrutura, explica ou dá modelo — o entregável de engenharia ou a apuração fiscal continuam sendo de quem assina.

Licença

MIT. Veja LICENSE.