[BUG]

Preflight Checklist

• [x] I have searched existing issues and this hasn't been reported yet
• [x] This is a single bug report (please file separate reports for different bugs)
• [x] I am using the latest version of Claude Code

What's Wrong?

Essa semana um projeto em produção quebrou por causa de um conselho errado de IA.

Tenho um dashboard de monitoramento rodando no Google Apps Script dentro do
Google Workspace de uma fábrica. Sistema em produção, usado pelo time de qualidade
diariamente.

Pedi para a minha IA principal de programação construir o projeto. Ela gerou um
único arquivo HTML de 1.800 linhas. Parecia certo. Deploy feito.

Resultado: sistema fora do ar. Time sem acesso. Produção parada.

O problema é documentado pelo próprio Google: Apps Script tem limitações de
renderização para HTML monolítico. A arquitetura correta é separar em múltiplos
arquivos usando o padrão include():

→ index.html (entry point)
→ libs.html (bibliotecas externas)
→ styles.html (CSS)
→ layout.html (estrutura HTML)
→ scripts_core.html / scripts_pa.html (JavaScript por módulo)

Isso está na documentação oficial de boas práticas do Google Apps Script. A IA
simplesmente não sugeriu. E eu não sabia que precisava perguntar.

Tive que assinar outra ferramenta para conseguir essa resposta — algo que me custou
tempo, dinheiro e tranquilidade.

O que fiz para não repetir:

1. Criei skills customizadas na minha IA com os padrões corretos de Apps Script,

para que ela ative automaticamente quando o contexto for esse

1. Abri um issue no GitHub do Claude Code relatando o problema, para que outros

desenvolvedores não passem pelo mesmo

1. Escrevi esse post, porque provavelmente tem mais gente usando Apps Script +

HtmlService sem saber desse detalhe

Se você serve Web Apps via Google Apps Script: use o padrão include() desde o início.
Economiza horas de debug e evita quebrar produção.

#GoogleAppsScript #GoogleWorkspace #AppsDeveloper #Automacao #LicoesAprendidas

What Should Happen?

Essa semana um projeto em produção quebrou por causa de um conselho errado de IA.

Tenho um dashboard de monitoramento rodando no Google Apps Script dentro do
Google Workspace de uma fábrica. Sistema em produção, usado pelo time de qualidade
diariamente.

Pedi para a minha IA principal de programação construir o projeto. Ela gerou um
único arquivo HTML de 1.800 linhas. Parecia certo. Deploy feito.

Resultado: sistema fora do ar. Time sem acesso. Produção parada.

O problema é documentado pelo próprio Google: Apps Script tem limitações de
renderização para HTML monolítico. A arquitetura correta é separar em múltiplos
arquivos usando o padrão include():

→ index.html (entry point)
→ libs.html (bibliotecas externas)
→ styles.html (CSS)
→ layout.html (estrutura HTML)
→ scripts_core.html / scripts_pa.html (JavaScript por módulo)

Isso está na documentação oficial de boas práticas do Google Apps Script. A IA
simplesmente não sugeriu. E eu não sabia que precisava perguntar.

Tive que assinar outra ferramenta para conseguir essa resposta — algo que me custou
tempo, dinheiro e tranquilidade.

O que fiz para não repetir:

1. Criei skills customizadas na minha IA com os padrões corretos de Apps Script,

para que ela ative automaticamente quando o contexto for esse

1. Abri um issue no GitHub do Claude Code relatando o problema, para que outros

desenvolvedores não passem pelo mesmo

1. Escrevi esse post, porque provavelmente tem mais gente usando Apps Script +

HtmlService sem saber desse detalhe

Se você serve Web Apps via Google Apps Script: use o padrão include() desde o início.
Economiza horas de debug e evita quebrar produção.

#GoogleAppsScript #GoogleWorkspace #AppsDeveloper #Automacao #LicoesAprendidas

Error Messages/Logs

Steps to Reproduce

Essa semana um projeto em produção quebrou por causa de um conselho errado de IA.

Tenho um dashboard de monitoramento rodando no Google Apps Script dentro do
Google Workspace de uma fábrica. Sistema em produção, usado pelo time de qualidade
diariamente.

Pedi para a minha IA principal de programação construir o projeto. Ela gerou um
único arquivo HTML de 1.800 linhas. Parecia certo. Deploy feito.

Resultado: sistema fora do ar. Time sem acesso. Produção parada.

O problema é documentado pelo próprio Google: Apps Script tem limitações de
renderização para HTML monolítico. A arquitetura correta é separar em múltiplos
arquivos usando o padrão include():

→ index.html (entry point)
→ libs.html (bibliotecas externas)
→ styles.html (CSS)
→ layout.html (estrutura HTML)
→ scripts_core.html / scripts_pa.html (JavaScript por módulo)

Isso está na documentação oficial de boas práticas do Google Apps Script. A IA
simplesmente não sugeriu. E eu não sabia que precisava perguntar.

Tive que assinar outra ferramenta para conseguir essa resposta — algo que me custou
tempo, dinheiro e tranquilidade.

O que fiz para não repetir:

1. Criei skills customizadas na minha IA com os padrões corretos de Apps Script,

para que ela ative automaticamente quando o contexto for esse

1. Abri um issue no GitHub do Claude Code relatando o problema, para que outros

desenvolvedores não passem pelo mesmo

1. Escrevi esse post, porque provavelmente tem mais gente usando Apps Script +

HtmlService sem saber desse detalhe

Se você serve Web Apps via Google Apps Script: use o padrão include() desde o início.
Economiza horas de debug e evita quebrar produção.

#GoogleAppsScript #GoogleWorkspace #AppsDeveloper #Automacao #LicoesAprendidas

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

_No response_

Claude Code Version

Claude Code

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

Essa semana um projeto em produção quebrou por causa de um conselho errado de IA.

Tenho um dashboard de monitoramento rodando no Google Apps Script dentro do
Google Workspace de uma fábrica. Sistema em produção, usado pelo time de qualidade
diariamente.

Pedi para a minha IA principal de programação construir o projeto. Ela gerou um
único arquivo HTML de 1.800 linhas. Parecia certo. Deploy feito.

Resultado: sistema fora do ar. Time sem acesso. Produção parada.

O problema é documentado pelo próprio Google: Apps Script tem limitações de
renderização para HTML monolítico. A arquitetura correta é separar em múltiplos
arquivos usando o padrão include():

→ index.html (entry point)
→ libs.html (bibliotecas externas)
→ styles.html (CSS)
→ layout.html (estrutura HTML)
→ scripts_core.html / scripts_pa.html (JavaScript por módulo)

Isso está na documentação oficial de boas práticas do Google Apps Script. A IA
simplesmente não sugeriu. E eu não sabia que precisava perguntar.

Tive que assinar outra ferramenta para conseguir essa resposta — algo que me custou
tempo, dinheiro e tranquilidade.

O que fiz para não repetir:

1. Criei skills customizadas na minha IA com os padrões corretos de Apps Script,

para que ela ative automaticamente quando o contexto for esse

1. Abri um issue no GitHub do Claude Code relatando o problema, para que outros

desenvolvedores não passem pelo mesmo

1. Escrevi esse post, porque provavelmente tem mais gente usando Apps Script +

HtmlService sem saber desse detalhe

Se você serve Web Apps via Google Apps Script: use o padrão include() desde o início.
Economiza horas de debug e evita quebrar produção.

#GoogleAppsScript #GoogleWorkspace #AppsDeveloper #Automacao #LicoesAprendidas