Este site é feito com Chinaski

Existe uma versão deste texto que seria constrangedora de escrever: aquela em que o software que deveria facilitar a criação de sites se mostra um pesadelo para usar no seu próprio site. Fico feliz que não seja este o caso.

chinaski.net é um site feito com Chinaski. O conteúdo é gerenciado no admin do Chinaski, compilado em HTML estático pelo builder do Chinaski e servido como arquivos estáticos pelo nginx. O tema que você está lendo agora é um tema em Template Toolkit armazenado no banco de dados do Chinaski. Tudo que você navegou neste site passou pelo mesmo pipeline descrito na documentação.

Como foi construído

A maior parte do trabalho aconteceu pelo servidor MCP. Conectei o Claude ao endpoint MCP do Chinaski e trabalhei pelo site em conversa: criar esta página, adicionar esses blocos, definir os metadados, configurar a navegação. A IA redigiu o conteúdo de todas as páginas: 29 páginas em inglês e português, distribuídas em 57 blocos de conteúdo.

Não esperava que esse fluxo de trabalho funcionasse tão bem. As ferramentas MCP são tipadas e explícitas: create_page, update_block, trigger_build. O agente não precisa adivinhar a estrutura. Ele cria um bloco hero, define o título e o subtítulo, chama trigger_build, e o resultado é uma página publicada. Sem interface web, sem copiar e colar, sem lidar com um editor de texto rico.

O conteúdo em si levou cerca de duas horas de vai e vem para ficar certo. O agente redigia um bloco de colunas, eu lia, questionava algo que soava muito como uma landing page de startup, e ele revisava. As páginas de filosofia passaram por algumas rodadas. O FAQ Respostas honestas na página Por que o Chinaski ("O que o Chinaski não faz?") é o tipo de texto difícil de conseguir de um modelo sem que ele se esquive, mas chegou lá.

O que quebrou

Dois problemas precisaram de correção após o build inicial, e ambos foram instrutivos.

O header mobile estava uma bagunça. O menu não tinha botão hambúrguer. Em telas pequenas, toda a navegação ficava empilhada verticalmente e aberta o tempo todo, incluindo todos os submenus ao mesmo tempo. É um problema de CSS no tema, não do Chinaski em si, mas é o tipo de coisa fácil de ignorar quando você está desenvolvendo em um navegador desktop. Adicionar um botão de toggle com um pequeno script JS resolveu. O tema é apenas Template Toolkit e CSS, então a correção foi uma edição simples em dois arquivos.

Oito itens do menu apontavam para erros 404. O motivo: páginas com um pai na hierarquia de páginas são construídas em caminhos aninhados (/en/about/features/ em vez de /en/features/), mas os itens de navegação tinham sido criados com os caminhos simples. Corrigir foram oito chamadas a update_nav_item. A estrutura de URLs do menu é algo que o admin deveria alertar sobre; registrei como uma lacuna conhecida.

O que isso demonstra

O objetivo de construir este site com Chinaski não foi só economizar tempo, embora tenha economizado. Foi fechar o ciclo da afirmação sobre MCP. A documentação diz que um agente pode gerenciar todo o seu site por uma interface de ferramentas tipada. Essa é uma afirmação específica, e é fácil demonstrá-la com um exemplo simples. Este é um site de produção com conteúdo real, navegação real e idiomas reais, e foi construído em grande parte por um agente em uma tarde.

O output estático também funcionou exatamente como esperado. O tempo de build em um VPS de $5 é de menos de dois segundos para o site completo. As páginas ao vivo não têm camada de aplicação nem JavaScript. Uma inspeção na aba de rede do navegador em qualquer página deste site mostra um único documento HTML, um arquivo CSS e as fontes. É isso.

Os problemas são reais. O tema das URLs do menu em particular é algo que um novo usuário vai encontrar. Mas nenhum deles exigiu tocar no núcleo do Chinaski. Foram edições no tema e correções nos dados. A ferramenta fez o que deveria fazer.