// curso · academia do ruby

Para você que quer usar IA sem perder o controle do projeto.

Você instala os guardrails que fazem a IA trabalhar dentro das suas regras, não por cima delas. Tudo em código Rails real que parecerá escrito por você.

Quero o Curso → ver o que tem dentro ↓

acordeon — claude code · plan mode

$ claude

⏺ Plan Mode · Acordeon

vou adicionar ContractParty ao Contract.

1 · migration contract_parties (belongs_to :contract)

2 · model + validações + has_many no Contract

3 · rspec: associação e nullability

aprovar plano? (s/n)

// 3 min · o problema e o que o curso entrega

// não vai assistir o vídeo? é isso:

Pra dev Rails que já tem experiência em construir projeto, usa IA no chute e desconfia que dá pra fazer muito melhor.
Você aprende a configurar a disciplina no agente: CLAUDE.md como constituição, hooks que barram o que não pode passar, skills e subagents que revisam o código antes de você.
Projeto-âncora Acordeon: um SaaS B2B em Rails que você termina com 3 PRs merged passando por todos os gates.

A bolha pode estourar.
A mudança não.

A bolha .com estourou. A internet ficou. SaaS meia-boca com "AI-powered" no nome vai morrer, promessa ridícula vai virar piada — e a IA ainda assim não vai sair do seu fluxo de trabalho. Quando uma ferramenta muda como código é escrito, revisado e testado, ela parou de ser moda.

Tem diferença entre criticar a tecnologia e torcer contra ela. Criticar é obrigação: a IA erra, alucina, escreve código ruim quando entra num projeto sem contexto e sem critério. Torcer pra ela falhar é outra coisa — é querer que a mudança nunca tivesse acontecido.

A pergunta que importa não é "a IA escreve melhor que dev?". É o que acontece quando um dev competente usa IA pra acelerar parte do trabalho sem terceirizar o próprio julgamento? É isso que o nosso curso ensina.

// o problema, em números

Não é opinião. É o que sai quando a IA escreve sem ninguém segurando a régua.

45%

do código gerado por LLM vem com vulnerabilidade do OWASP Top 10.

Veracode, 2025 GenAI Code Security Report — 80+ tarefas em 100+ modelos.

1.7x (até 2.74x)

por isso, PRs feitos com IA carregam ~1.7x mais issues no total — e até 2.74x mais falhas de segurança — que PRs humanos.

CodeRabbit, dez/2025 — 470 PRs reais de open source.

75%

isso vira dívida técnica em escala: a Forrester projeta 75% dos times de tecnologia com dívida em nível moderado ou alto até 2026, puxada pela complexidade que a IA adiciona.

Forrester, Technology & Security Predictions 2025.

5.2%

e abre um buraco novo: 5.2% dos pacotes que os modelos comerciais sugerem simplesmente não existem. Alguém registra o nome e vira ataque de supply chain (slopsquatting).

Spracklen et al., USENIX Security '25.

E não, modelo maior não conserta. A Veracode mediu: os 45% ficaram parados de GPT-4 a GPT-5, passando por Claude e Gemini. O problema é estrutural — a disciplina não é paliativo até a IA melhorar, é permanente.

↗ veracode ↗ coderabbit ↗ forrester ↗ slopsquatting (arxiv)

// é pra você se…

·Você é dev Rails com experiência.
·RSpec ou Minitest e Hotwire já fazem parte do seu fluxo.
·Você usa IA no chute e desconfia que pode usar muito melhor.
·Você trabalha em codebase de produção, não em projeto de tutorial.
·Você quer conduzir a IA, não cruzar os dedos e torcer pra ela acertar.

// não é pra você se…

·Você está atrás do primeiro emprego em dev.
·Você quer aprender Rails do zero — aqui assumimos que você é proficiente.
·Você espera a IA escrever o software inteiro pra você só assinar embaixo.
·Você procura prompt mágico e fórmula de vibe-coding.
·Você acha que IA em dev é só hype e some amanhã.

// como a disciplina entra no fluxo

Quatro camadas de controle

Postura

Você é dono do diff. O Claude executa; quem decide, revisa e aceita é você.

Constituição

Um CLAUDE.md de até 120 linhas dita stack, convenção e o que não fazer — a cada sessão.

# CLAUDE.md
Stack: Rails 8 · Hotwire
Nunca editar db/schema.rb à mão

Quality Gates

Hooks que rodam sozinhos e barram o que não pode passar. CLAUDE.md é conselho; hook é lei.

"PostToolUse":
  "bundle exec
   rubocop -a"

Habilidades

Skills empacotam "o jeito do time" e o Claude descobre sozinho. Subagents revisam segurança e migration em contexto isolado.

.claude/
skills/rails-service-object
agents/security-reviewer

// os 7 módulos

A grade

módulo 01

Postura & Setup

Claude Code instalado, autenticado, e os comandos que você usa todo dia.
claude /help · /cost
módulo 02

CLAUDE.md, a constituição

As regras do projeto num arquivo só. Hierarquia e escopo por path.
.claude/rules/*.md
módulo 03

O loop diário

Plan → TDD → diff review. O ciclo que separa engenheiro de prompt-DJ.
plan → red → green → review
módulo 04

Hooks como lei

RuboCop, RSpec, Brakeman rodando sozinhos. O que falha não passa.
PostToolUse → bundle exec rubocop -a
módulo 05

Skills do time

Cápsulas que ensinam o jeito do time pro Claude descobrir sozinho.
.claude/skills/rails-service-object
módulo 06

Subagents

Revisores de segurança, migration e código, cada um em contexto próprio.
.claude/agents/security-reviewer
módulo 07

Code review no PR

claude-code-action revisando todo PR no GitHub antes de qualquer humano.
uses: anthropics/claude-code-action@v1

// o projeto

Você sai com o Acordeon pronto

Acordeon é um SaaS B2B de gestão de contratos, em Rails. Você não assiste ele ser construído — você constrói, módulo a módulo, sob todas as regras do curso. No fim, você tem acesso ao repositório com 3 PRs merged que passaram por todos os gates. Cada tag (m1→m7) é um commit limpo que você pode dar checkout e estudar.

# domain model

Account has_many :users

└─ User belongs_to :account

Contract belongs_to :account

└─ ContractParty belongs_to :contract

└─ Activity belongs_to :contract_party

m1-setup Rails new + RSpec + RuboCop
m2-claude-md CLAUDE.md + rules por path
m3-loop Feature de Contract via TDD
m4-hooks Hooks no settings.json
m5-skills 3 skills auto-descobertas
m6-subagents 3 subagents revisando diffs
m7-action PRs revisados e merged no GitHub

// prova

O método não é teoria. É como eu trabalho.

Tudo que esse curso ensina é o que eu rodo nos meus próprios produtos. Não é framework de slide.

pay-abacatepay · PR #6 — fix(webhooks): verify signature with base64

Eu publiquei a gem pay-abacatepay, que liga a AbacatePay ao Pay do Rails. No processo, li o SDK oficial linha por linha e achei três bugs que já estavam em produção. O mais sério: o Webhooks.verify! comparava a assinatura com hexdigest, sendo que a AbacatePay manda em base64. Tradução: a verificação de webhook nunca batia. Abri o PR #6 com o fix.

  def verify!(payload, signature, secret)
-   expected = OpenSSL::HMAC.hexdigest("SHA256", secret, payload)
+   digest   = OpenSSL::HMAC.digest("SHA256", secret, payload)
+   expected = Base64.strict_encode64(digest)
    ActiveSupport::SecurityUtils.secure_compare(expected, signature)
  end

É exatamente isso que o curso ensina a fazer: ler o diff, desconfiar, achar o que passou. A diferença entre quem usa IA e quem é dono do que a IA produz está nessa leitura. Eu acho esse tipo de coisa porque trabalho assim — e você vai sair sabendo achar também.

[asset] print do PR #6 + gem no rubygems

E não é um caso isolado:

A plataforma que você está usando agora roda sob um CLAUDE.md de verdade.

[asset] print do CLAUDE.md real

A Amália, tutora de IA da Academia, é um RAG em produção (RubyLLM + pgvector).

[asset] screenshot da amália

Os apps iOS e Android estão publicados nas lojas, servidos pelo mesmo Rails via Hotwire Native.

[asset] prints das duas lojas

CRIADOR · ACADEMIA DO RUBY

+14 anos em Rails de produção

// quem te ensina

Daniel Moreira

Fundador da Academia do Ruby. Mais de 14 anos construindo sistemas Rails de produção em larga escala, no Brasil e no exterior. Criei e mantenho a arquitetura agêntica da Amália, a tutora de IA da plataforma — operando diariamente sob as mesmas regras que este curso ensina.

> ver os projetos de código aberto do autor

// o que está incluso

· 16 vídeo-aulas em 7 módulos (~3h)
· 7 lessons escritas, estilo Offstack (~2h de leitura)
· Acesso ao repositório do Acordeon, com as tags m1→m7
· Biblioteca de skills Rails-first
· Templates de hooks e settings prontos
· 3 subagents Rails configurados
· 7 dias de garantia incondicional

// curso completo

R$ 147

Quero o Curso →

Já é Membro da Academia? Este curso entra no seu plano assim que as inscrições abrirem — sem cobrança.

🛡️

7 dias de garantia incondicional. Não gostou da didática ou do conteúdo nos primeiros 7 dias? Devolvemos todo o seu dinheiro. Sem questionamentos, e-mails chatos ou entrevistas de saída. Processado imediatamente.

// perguntas diretas

FAQ

Precisa de Claude Pro ou Max? +

Não. Claude Code roda local e consome a API da Anthropic via Console do Desenvolvedor (pago por uso). No curso mostramos como configurar o limite de custos pra você gastar pouco. A assinatura Pro ajuda, mas não é obrigatória.

Funciona com Rails 6.1 / 7.0? +

Sim. O projeto-âncora é Rails 8, mas a constituição (CLAUDE.md), as rules por path e os quality gates locais se aplicam a codebases Rails a partir do 6.1.

Preciso usar VSCode? E se eu uso Vim / RubyMine / Cursor? +

O Claude Code opera 100% no terminal, independente do editor. Use VSCode, Neovim, RubyMine ou o que preferir — o fluxo agêntico é o mesmo.

Vale se eu já uso Cursor / GitHub Copilot? +

Sim. Claude Code é um agente de terminal que roda lints, testes e aplica diffs de forma auto-corretiva. Copilot e Cursor são autocompletes em linha — resolvem outro problema.

O método vai ficar obsoleto rápido? +

Não. A disciplina agêntica (quality gates, rules no CLAUDE.md, isolamento de contexto) é princípio de engenharia, não comando que muda. E o problema que ela resolve é estrutural: a taxa de 45% de código vulnerável medida pela Veracode não caiu de GPT-4 a GPT-5 — escalar o modelo não conserta. A disciplina vale enquanto existir agente.

// status: :inscrições_abertas

As inscrições estão abertas.

Comece agora a instalar disciplina no seu fluxo com Claude Code.

Quero o Curso →

Para você que quer usar IA sem perder o controle do projeto.

A bolha pode estourar.A mudança não.

// é pra você se…

// não é pra você se…

Quatro camadas de controle

Postura

Constituição

Quality Gates

Habilidades

A grade

Postura & Setup

CLAUDE.md, a constituição

O loop diário

Hooks como lei

Skills do time

Subagents

Code review no PR

Você sai com o Acordeon pronto

O método não é teoria. É como eu trabalho.

Daniel Moreira

FAQ

As inscrições estão abertas.

A bolha pode estourar.
A mudança não.