OSForge: o Framework de Engenharia de IA que transforma como você usa Claude Code e Cursor

Um sistema modular com 80+ skills, 26 agentes e roteamento inteligente que reduz o consumo de contexto em 83% — sem abrir mão de especialistas sob demanda.

80+ Skills - 26 Agentes - 12 Rules - 83% ↓Contexto

O que é o OSForge?

O OSForge é um framework pessoal de engenharia de IA desenvolvido para maximizar a produtividade com Claude Code e Cursor. Em vez de um prompt monolítico que carrega todo o contexto o tempo todo, o OSForge usa um sistema modular de três camadas: skills, rules e agents — carregados sob demanda, conforme a tarefa exige.

O projeto é open source (licença MIT) e foi construído ao longo de meses de uso real em projetos comerciais com o stack Next.js / TypeScript / Prisma / Supabase / Bun. Toda a arquitetura nasceu de uma necessidade concreta: fazer o AI assistente trabalhar com o desenvolvedor, não ao redor dele.

"Ao invés de carregar 28k tokens de contexto base o tempo todo, o OSForge reduz isso para ~5k — com toda a inteligência especializada disponível sob demanda."

📍 Repositório

O projeto está disponível publicamente em github.com/plocemourasouza/osforge com documentação completa, scripts de instalação e licença MIT para uso pessoal e comercial.

O problema que o OSForge resolve

Qualquer desenvolvedor que usa Claude Code ou Cursor diariamente esbarra no mesmo desafio: como dar ao assistente o contexto certo no momento certo, sem desperdiçar a janela de contexto com informações irrelevantes para a tarefa atual?

A abordagem tradicional é carregar um CLAUDE.md ou .cursorrules gigantesco com tudo que o assistente "precisa saber". O problema: isso consome tokens preciosos em cada chamada, eleva custos e — mais importante — dilui a atenção do modelo com informações não relacionadas.

O OSForge resolve isso com um sistema de roteamento inteligente em três camadas:

1. Base sempre ativa: ~5k tokens com instruções essenciais e roteamento
2. Skills sob demanda: módulos especializados carregados conforme a tarefa
3. Agentes orquestradores: especialistas que combinam múltiplos skills para fluxos complexos

Arquitetura em três camadas

📚

Skills

80+

Módulos de conhecimento especializado. De padrões de código Next.js a diretrizes de design, cada skill é carregada apenas quando relevante.

⚖️

Rules

12

Regras de comportamento em arquivos .mdc com frontmatter YAML. Algumas sempre ativas, outras disparadas por contexto.

🤖

Agents

26

Orquestradores especializados para fluxos complexos. Incluem 121 especialistas da integração agency-agents em 10 divisões.

Rules sempre ativas

Duas rules formam o núcleo do comportamento inteligente do OSForge:

• intelligent-routing.mdc — decide automaticamente quais skills carregar com base na tarefa
• anti-ai-slop.mdc — garante que outputs de UI e código evitem padrões genéricos e previsíveis de IA

Skills de destaque

• aesthetic-boost — princípios anti-AI-slop para interfaces frontend de alta qualidade
• Frontend Pipeline (5 fases) — do conceito ao componente com qualidade de design editorial
• UI Design Intelligence — banco com 67 estilos visuais, 57 pares tipográficos e 99 diretrizes de UX
• OpenUI Lang — planejamento de layout antes de gerar qualquer código
• autoresearch patterns — inspirado no karpathy/autoresearch, para pesquisa autônoma
• get-shit-done — execução por fases com wave execution e STATE.md para projetos longos

Como instalar

A instalação do OSForge é feita via Git e um script deploy.sh que sincroniza automaticamente tudo para os diretórios esperados pelo Claude Code (~/.claude) e pelo Cursor (~/.cursor).

Pré-requisitos

• Claude Code instalado (npm install -g @anthropic-ai/claude-code)
• Cursor IDE (opcional) para usar as rules e skills no editor
• Git e Bash

Passo 1 — Clone o repositório

# Clone em qualquer diretório de sua preferência
git clone https://github.com/plocemourasouza/osforge
cd osforge

Passo 2 — Execute o deploy

# Tornar o script executável
chmod +x deploy.sh

# Executar — sincroniza skills, orchestrator e Python hooks
# para ~/.claude e ~/.cursor automaticamente
./deploy.sh

ℹ️ O que o deploy.sh faz

O script copia os arquivos de skills, rules e agentes para os diretórios ~/.claude e ~/.cursor, garantindo que tanto o Claude Code quanto o Cursor tenham acesso ao framework completo. Python hooks para roteamento automático também são instalados.

Passo 3 — Verifique a instalação

# No diretório do seu projeto, inicie o Claude Code
claude

# Teste o roteamento inteligente
> "Liste as skills disponíveis no OSForge"

Exemplos de uso

Exemplo 1 — Criar um componente React com qualidade de design

O OSForge inclui a regra anti-ai-slop.mdc sempre ativa e o skill aesthetic-boost. Isso significa que ao pedir um componente de UI, o assistente automaticamente evita padrões genéricos (gradientes roxos, layouts previsíveis, tipografia Inter/Roboto) e busca soluções com identidade visual própria.

Prompt de exemplo

"Crie um card de produto para e-commerce premium. 
Use um visual diferenciado, não genérico de IA. 
Stack: Next.js + shadcn/ui + Tailwind."

O fluxo interno do OSForge neste caso:

Roteamento detecta UI task→Carrega aesthetic-boost skill→Aplica anti-ai-slop.mdc→OpenUI Lang planeja layout→Gera código

Exemplo 2 — Pipeline de frontend em 5 fases

O FRONTEND-PIPELINE.md define um processo estruturado para garantir que interfaces complexas sejam planejadas antes de codificadas. As 5 fases são:

1. Análise de contexto: entender o produto, usuário e tom visual
2. Direção estética: escolher estilo visual com identidade (ex: editorial, industrial, orgânico)
3. Planejamento em OpenUI Lang: descrever o layout antes de qualquer código
4. Implementação: gerar componentes com shadcn/ui seguindo a direção definida
5. Refinamento: micro-interações, tipografia fina, acessibilidade

Exemplo 3 — Agentes especializados para tarefas complexas

A integração com msitarzewski/agency-agents traz 121 especialistas organizados em 10 divisões (engenharia, produto, design, dados, etc.). Para projetos grandes, o skill get-shit-done organiza a execução em waves com um arquivo STATE.md que mantém o contexto entre sessões.

Prompt de exemplo — Agente de arquitetura

"Atue como o agente de arquitetura de software. 
Analise o schema Prisma do projeto e sugira 
otimizações para performance com Supabase."

Exemplo 4 — Desenvolvimento com contexto reduzido

O roteamento inteligente do OSForge garante que apenas o contexto necessário seja carregado. Para uma tarefa de refactoring de TypeScript puro, por exemplo, apenas as skills de TypeScript e padrões de código são ativadas — não as de design, agentes, ou UI:

Tarefa: refactor TS→~5k tokens base+typescript-patterns skill≠28k tokens (sem OSForge)

Por que usar o OSForge?

• Contexto otimizado: ~83% de redução no consumo base de tokens
• Especialização real: skills dedicados para cada domínio (frontend, backend, dados, design)
• Consistência entre projetos: as mesmas regras e padrões aplicados em todo o código
• Anti-AI-slop nativo: outputs com identidade visual e técnica, não genéricos
• Stack brasileiro: pensado para integrar com Supabase, shadcn/ui, Bun e ecossistemas modernos
• Open source MIT: use, modifique e adapte para o seu contexto
• Funciona com Claude Code e Cursor: deploy único para os dois ambientes

Conclusão

O OSForge representa uma mudança de paradigma na forma de usar assistentes de IA para desenvolvimento. Em vez de um prompt gigantesco ou instruções vagas, você tem um framework estruturado, modular e otimizado — construído a partir de uso real em produção.

Se você usa Claude Code ou Cursor diariamente e quer elevar a qualidade e consistência dos seus outputs, o OSForge é o próximo passo natural. Clone, instale e comece a forjar.

⚙️ github.com/plocemourasouza/osforge
Repositório público · Licença MIT · Stars bem-vindas ⭐