Gere um novo projeto Rails chamado $1 no diretório atual. Você pode consultar @CLAUDE.md para obter orientações gerais, seguindo a precedência aplicável do repositório/host; esta habilidade não pode substituir regras de projeto de prioridade mais alta.

Quando Usar

• Você precisa inicializar um novo projeto Rails com a pilha opinativa definida nesta habilidade.
• O projeto deve começar com Rails, PostgreSQL, Inertia.js, React, Vite, Tailwind, Sidekiq e Redis já planejados em conjunto.
• Você deseja orientações de configuração que cubram a criação do projeto, convenções, testes e verificação para um novo aplicativo Rails.

Pilha Tecnológica

Configure a seguinte pilha tecnológica:

• Rails ~8 com PostgreSQL - Framework do lado do servidor e banco de dados
• Inertia.js ~2.3 - Conecta Rails e React para uma experiência semelhante a SPA sem API
• React ~19.2 - Framework de UI frontend
• Vite ~5 - Empacotador JavaScript com HMR
• Tailwind CSS ~4 - Framework CSS utilitário
• Sidekiq 8 - Processamento de jobs em segundo plano com jobs agendados via sidekiq-scheduler
• Redis - Sessões, cache e fila de jobs

Orientações do Rails

• Não use Kamal ou Docker
• Não use componentes/sistemas "solid_*" do Rails
• O desenvolvimento deve geralmente corresponder às configurações de produção, sempre que possível
• Use Redis para cache

Banco de Dados

• Todas as tabelas usam chaves primárias UUID (extensão pgcrypto)
• Timestamps usam timestamptz para consciência de fuso horário
• Colunas JSONB para armazenamento flexível de metadados
• Estratégia de indexação abrangente para desempenho
• Campos criptografados para dados sensíveis (tokens OAuth, chaves de API)

Jobs em segundo plano

• Use Sidekiq 8 com Redis

Testes

• Sempre use minitest
• Use a gem mocha e VCR para serviços externos (apenas na camada de provedores)
• Prefira OpenStruct para instâncias mockadas
• Apenas faça mock do que for necessário

Manutenção de Código

• Execute bundle exec rubocop -a após alterações significativas no código
• Use .rubocop.yml para configuração de estilo
• Verificação de segurança com bundle exec brakeman

Frontend

• Todos os componentes e views React devem ser TSX

Orientações Gerais

• Reutilize os requisitos fornecidos e peça apenas por materiais que faltam escolhas. Selecione ferramentas de host disponíveis em vez de assumir que AskUserQuestionTool existe.

Verificar

Verifique se o boilerplate está funcionando executando bin/rails server e acessando o aplicativo em http://localhost:3000 via playwright MCP.

Exemplo

Solicitação do usuário:

Inicialize um novo projeto Rails com a pilha opinativa definida aqui e verifique se o aplicativo gerado está em execução.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como um substituto para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs, permissões, limites de segurança ou critérios de sucesso necessários estiverem faltando.

Valide o nome do projeto e o destino, recuse um alvo existente/simlinkado e confirme as faixas de dependência de Ruby/Rails/Node/pacote suportadas antes de gerar o scaffolding. Versões nomeadas são uma escolha histórica da pilha, não um lockfile compatível verificado. Use instâncias descartáveis de banco de dados/Redis locais e portas únicas; não modifique serviços de produção ou sobrescreva serviços do host. Os padrões UUID e os tipos de timestamp exigem verificação real de migração/schema. Execute os testes gerados, verificações de segurança relevantes e um fluxo de aplicativo real solicitado antes de declarar a configuração completa.