O projeto: transformar uma lição de treinamento em seis momentos visuais
Claude Code é mais útil para quadrinhos quando o material de origem já está em arquivos. Um técnico, equipe de comunicação escolar ou programa juvenil pode já ter um plano de aula, um guia do participante, uma referência de personagem e regras que precisam sobreviver a cada revisão. Essas entradas exigem mais estrutura do que um único prompt de imagem.
Este passo a passo usa uma lição fictícia de basquete sub-14:
verificar os tênis e aquecer antes do treino
chamar com clareza antes de receber um passe
ajudar um colega de equipe após uma queda
ouvir durante a recapitulação do técnico
terminar com uma reflexão em equipe
O objetivo não é substituir um técnico ou a política local de segurança. É criar um recurso visual curto de ensino que um adulto possa revisar antes de compartilhar. A National Youth Sports Strategy dos EUA identifica trabalho em equipe, liderança, relacionamentos e programação de qualidade como resultados significativos dos esportes juvenis. Um quadrinho pode tornar essas expectativas mais fáceis de visualizar e discutir.
Verificamos a página ativa do plugin LlamaGen.AI, o guia de configuração, a documentação da API de quadrinhos e o contrato atual da ferramenta MCP em 13 de outubro de 2026. O MCP hospedado expõe quatro ferramentas principais:
Tool
Papel neste fluxo de trabalho
search_llamagen_docs
Lê as orientações atuais de configuração, autenticação, limites, webhook e tratamento de erros.
Registro de alterações
Desperte sonhos nos jovens Onde milhões de histórias ganham vida
Um resumo dos lançamentos mais recentes de recursos do LlamaGen, melhorias no produto, atualizações de design e correções importantes de bugs.
✦
✧
✦
✧
Um novo meio para Contar histórias
Crie histórias, quadrinhos, animações, jogos e muito mais sem limites — em segundos, com impacto no público moderno
get_comic_api_usage
Verifica o plano da LlamaGen.AI e os créditos restantes da Comic API antes da geração.
create_comic_generation
Inicia uma geração com um prompt mais estilo, número de painéis, tamanho e uma URL pública opcional de referência de personagem.
get_comic_generation_status
Consulta a geração e pode inspecionar o status da geração, página ou painel.
A ferramenta de escrita atual cria uma tarefa de geração. Ela não reescreve arquivos silenciosamente, publica a lição ou substitui um painel dentro de uma página existente. Layout final, balões de fala, substituição de painel e aprovação ainda acontecem na LlamaGen.AI. Esse limite é útil: Claude Code orquestra, e um humano ainda aprova.
Estrutura do projeto
Mantenha a fonte da verdade pequena o suficiente para ser revisada:
Público, objetivo de aprendizagem, sequência aprovada, afirmações proibidas e revisor adulto.
cast.md
Fatos visuais estáveis para jogadores recorrentes e o técnico.
style.md
Direção de arte, linguagem de câmera, ordem dos painéis, tom apropriado para a idade e exclusões visuais.
scene-plan.json
O plano aprovado painel por painel que a geração deve seguir.
review-checklist.md
Verificações de continuidade, legibilidade, equipamento esportivo, proteção e conformidade com políticas.
generation-log.md
ID da geração, data, chamadas de ferramentas, resultado, erros e painéis marcados para revisão.
Não coloque o token da API da LlamaGen nesta pasta. Mantenha-o no ambiente ou em um armazenamento protegido de segredos.
Etapa 1: escreva um briefing de produção, não um parágrafo motivacional
Use um lesson.md compacto:
# U14 basketball communication comic
Audience: players ages 13-16
Learning goal: show that clear calls, teammate support, and respectful reflection
make practice safer and easier to follow.
Approved beats:
1. Jordan checks tied shoes and joins the warm-up.
2. Jordan raises a hand and calls before the pass.
3. Jordan receives the basketball in control.
4. Jordan helps a teammate stand after a normal loss of balance.
5. The adult coach leads a calm recap.
6. The team names one communication habit to repeat.
Guardrails:
- supervised indoor practice
- no diagnosis or medical instruction
- no real school or team marks
- no humiliation, punishment, or unsafe contact
- final output requires adult review
Isso é específico o suficiente para o planejamento visual, ao mesmo tempo que deixa as regras locais com a organização real.
Etapa 2: fixe o jogador recorrente
O registro do personagem deve descrever apenas fatos que afetam a imagem:
# Jordan continuity record
Age: 15
Hair: short dark curls with a clean tapered side
Uniform: plain navy practice jersey and shorts, no team logo
Anchor prop: coral wristband on the left wrist
Shoes: white high-top basketball shoes
Body language: attentive, cooperative, never aggressive
Continuity rules:
- preserve age, face, hair, jersey color, wristband side, and shoes
- use a basketball, never a soccer ball
- keep the adult coach visually distinct from players
Se você tiver uma imagem de personagem aprovada, envie-a para um local HTTPS público e passe-a como characterImageUrl. O MCP atual aceita uma URL pública opcional de referência de personagem.
Etapa 3: conecte o Claude Code ao Comic MCP
Crie ou rotacione um token nas configurações da LlamaGen.AI e então registre o MCP hospedado no escopo do usuário:
export LLAMAGEN_API_TOKEN="<YOUR_LLAMA_GEN_API_TOKEN>"
claude mcp add --scope user --transport http \
--header 'Authorization: Bearer ${LLAMAGEN_API_TOKEN}' \
llamagen https://llamagen.ai/api/mcp
Peça ao Claude Code para listar as ferramentas da LlamaGen antes de qualquer geração. Se as quatro ferramentas principais não aparecerem, pare e corrija o endpoint, a variável de ambiente ou o cabeçalho de autorização. Nunca cole o token em um arquivo de história, captura de tela, prompt ou URL pública.
Etapa 4: faça o Claude Code planejar antes de gastar créditos
Use este prompt de projeto:
Read lesson.md, cast.md, style.md, and review-checklist.md.
1. Search the current LlamaGen Comic MCP documentation.
2. Check LlamaGen Comic API usage and report it separately from Claude usage.
3. Build scene-plan.json for one six-panel landscape comic.
4. For every panel include camera distance, action, emotion, background,
continuity anchors, and the teaching purpose.
5. Flag any unsafe, medical, or policy-sensitive statement.
6. Show me the plan and wait for explicit approval.
7. Do not call create_comic_generation until I approve.
A etapa de aprovação importa. Ela permite que um técnico ou responsável por comunicação corrija a lição antes que créditos de geração sejam usados.
Etapa 5: valide o scene-plan.json
Um plano útil é concreto o suficiente para ser auditado:
{
"audience": "ages 13-16",
"panelCount": 6,
"readingOrder": "left-to-right",
"panels": [
{
"panel": 1,
"camera": "medium-wide",
"action": "Jordan checks tied shoes, then joins the warm-up line",
"continuity": ["navy jersey", "coral left wristband", "white shoes"],
"teachingPurpose": "pre-practice preparation"
},
{
"panel": 4,
"camera": "medium",
"action": "Jordan offers a hand to a teammate after a normal loss of balance",
"continuity": ["same Jordan", "basketball visible", "coach supervising"],
"teachingPurpose": "teammate support"
}
]
}
Antes da aprovação, verifique três camadas:
História: cada painel avança um momento visível?
Esporte: a bola, a quadra, os uniformes e a mecânica corporal são plausíveis?
Educação: a lição pretendida pode ser entendida sem um parágrafo de explicação?
Etapa 6: crie e consulte a geração
Após a aprovação, o Claude Code pode chamar create_comic_generation com o seguinte contrato:
{
"prompt": "The approved six-panel youth basketball lesson from scene-plan.json",
"style": "bright modern educational graphic novel, clean ink, age-appropriate",
"panelCount": 6,
"size": "16:9",
"characterImageUrl": "https://your-approved-public-reference.example/jordan.webp"
}
characterImageUrl é opcional. Não invente uma. A criação retorna um ID de geração; o Claude Code deve salvar esse ID em output/generation-log.md, consultar get_comic_generation_status e relatar ativos concluídos ou erros sem expor o token.
Um log com dados redigidos pode ficar assim:
## Generation run
- Verified: 2026-10-13
- MCP server: llamagen
- Input: approved scene-plan.json
- Requested panels: 6
- Generation ID: [redacted in public copy]
- Status: completed / failed / needs review
- Credits: copy the actual usage response; never estimate
- Review: panel 4 needs a continuity repair
Etapa 7: repare um painel sem descartar a página
Suponha que o painel 4 mude a cor do uniforme, remova a pulseira ou substitua a bola errada. Preserve os cinco painéis aprovados. Crie um briefing de painel de substituição que repita apenas os elementos necessários:
Create one replacement comic panel for panel 4.
Jordan is the same 15-year-old athlete from the approved reference: short dark curls,
plain navy practice jersey, coral wristband on the left wrist, white high-top shoes.
Jordan offers a hand to a teammate after a normal loss of balance.
Keep the same medium camera angle, indoor gym, basketball, pose direction,
adult supervision, bright educational graphic-novel style, and no readable text.
O MCP atual cria essa substituição como uma nova tarefa de geração. Ele não corrige uma página existente no próprio lugar. Revise o resultado, então substitua o painel fraco no editor da LlamaGen.AI e mantenha os outros cinco painéis inalterados.
Checklist de revisão para conteúdo de esportes juvenis
Antes de publicar, peça a um revisor adulto para confirmar:
os personagens parecem apropriados para a idade e são fictícios ou usados com consentimento
a lição corresponde às regras e à terminologia atuais do programa
o técnico permanece visivelmente responsável pela supervisão
nenhum painel fornece aconselhamento médico, de reabilitação ou de retorno ao jogo
os detalhes do equipamento e da quadra correspondem ao esporte
o contato corporal e os gestos não normalizam comportamento inseguro
o mesmo jogador mantém o mesmo rosto, uniforme, pulseira e tênis
a ordem dos painéis é óbvia em um telefone e em um folheto impresso
as legendas e os balões de fala são legíveis e acessíveis
o ativo final não contém dados privados de jogadores, segredos ou marcas não autorizadas
Modos de falha comuns
Claude Code não vê ferramentas da LlamaGen
Confirme que o endpoint é https://llamagen.ai/api/mcp, que o token está disponível para o processo do Claude Code e que o cabeçalho de autorização está presente. Depois liste as ferramentas novamente antes de gerar.
A sequência parece empolgante, mas não ensina nada
Volte para teachingPurpose em scene-plan.json. Cada painel deve mostrar um comportamento, consequência, decisão ou reflexão. Remova ações decorativas que concorram com a lição.
O jogador muda entre os painéis
Encurte o registro de continuidade para os elementos mais visíveis e repita-os em cada painel relevante. Use uma imagem pública aprovada de referência quando disponível.
Um painel está errado
Não regenere todos os seis por padrão. Escreva um briefing de substituição para o painel com falha, preserve sua câmera e contexto, gere a substituição e troque-o no editor.
FAQ
O Claude Code pode criar um quadrinho completo pela LlamaGen.AI?
O Claude Code pode organizar arquivos, planejar páginas, chamar o Comic MCP atual e consultar gerações. A LlamaGen.AI realiza a geração visual e fornece a superfície de edição. Para um livro mais longo, trabalhe página por página e mantenha um registro de personagem aprovado.
O MCP pode editar um painel existente diretamente?
A ferramenta de escrita atual cria uma geração de quadrinho. Para um painel ruim, crie uma substituição focada como uma nova tarefa, inspecione-a e substitua o painel no editor da LlamaGen.AI.
O uso do Claude inclui créditos de geração da LlamaGen.AI?
Não. Claude lida com sua própria conversa de modelo e trabalho com arquivos. Os créditos da Comic API da LlamaGen.AI pagam pela geração de quadrinhos. Verifique ambos separadamente antes de um lote.
Um quadrinho com IA é suficiente para instrução de segurança esportiva?
Não. Trate-o como um recurso de comunicação revisado. Um adulto qualificado deve confirmar o conteúdo final em relação às exigências atuais da equipe, escola, liga e localidade. Não use quadrinhos gerados como orientação médica ou de retorno ao jogo.
Crie a primeira lição revisada
O padrão útil é simples: arquivos-fonte, limites explícitos, um plano de painéis aprovado, uma chamada de geração, um ID de geração salvo e reparo focado. Isso faz do Claude Code um operador de projeto em vez de um improvisador de prompts.
