---
title: "Roteiro"
description: "Como escrever ou importar o roteiro de um episódio, como as versões funcionam e o que aprovar o Roteiro põe em movimento."
url: https://www.filmsquare.ai/docs/pt-br/departments/writing/
lang: pt-BR
section: departments
updated: 2026-11-13
mcp: [get_script, edit_script, submit_breakdown, request_signoff, sign_off, work_on_step]
---

# Roteiro

O Roteiro guarda o roteiro de um episódio e cada tratamento dele. É o primeiro departamento: a decupagem, o
elenco, os cenários e os planos são todos lidos do roteiro, então tudo que vem depois depende desta aprovação. Você
trabalha nele em **Script**, em duas abas: **Script** e **Docs**.

![O departamento de Roteiro de um episódio, com o roteiro, a sua versão, Import a new version e Synopsis, treatment and notes](https://www.filmsquare.ai/docs/shots/en/board-writing-desktop.webp)

## O que esta etapa produz

Um tratamento do roteiro: o texto do episódio, numerado (`Script v1`, `Script v2` …) com uma nota sobre o que mudou.
Os tratamentos nunca mudam depois de feitos. **Script → Script** mostra o mais novo, com as cenas ao lado. Com
mais de uma versão, você pode abrir uma anterior no menu de versões, ou escolher **Changes since vN** (mudanças desde a vN). **Script →
Docs** lista o roteiro e os outros arquivos da etapa.

## Escrever o roteiro no app

Um(a) diretor(a) ou alguém acima pode escrever o roteiro aqui, e também um(a) artista que o(a) produtor(a) colocou no Roteiro.

1. Abra **Script → Script**. Sem roteiro ainda, o editor abre em uma página vazia (**Write it here** em **Docs**
   leva ao mesmo lugar). Com um roteiro, escolha **Write** (escrever).
2. Escreva em Fountain. Tab e Return percorrem os elementos do roteiro: **Scene heading** (cabeçalho de cena), **Action** (ação), **Character** (personagem),
   **Parenthetical** (rubrica), **Dialogue** (diálogo) e **Transition** (transição). O menu no cabeçalho mostra o elemento da linha em que você está
   e o muda.
3. Acrescente uma nota sobre o que mudou.
4. Escolha **Save as vN** (Ctrl Shift S), com N o próximo número.

O rascunho fica no seu navegador até você salvar. Salvar faz uma nova versão; as versões anteriores nunca mudam. Salvar
o mesmo texto de novo não faz versão nova. A página, as teclas, os rascunhos, a bíblia da história e a leitura em mesa estão em
[Escrever um roteiro](https://www.filmsquare.ai/docs/pt-br/departments/writing-a-script/).

> [!NOTE]
> Salvar um roteiro não roda a decupagem de novo. Cenas, planos, elenco e cenários ficam como estão até você importar
> o roteiro ou o seu próprio Claude enviar uma nova decupagem. As marcações no roteiro passam para a nova versão.

**Write** não é oferecido em uma versão que entrou por uma importação de pipeline, nem em uma longa demais para carregar por inteiro.

O seu próprio Claude também pode alterar parte de um roteiro: `edit_script` troca um texto exato (uma cena, uma fala, uma linha) e salva o resultado como uma nova versão, igual a **Save as vN**. Ele lê um roteiro longo em partes com `get_script`, então nunca precisa reenviar o roteiro inteiro.

## Trazer o roteiro

Um(a) diretor(a) ou alguém acima importa o roteiro em **Script → Docs**.

1. Abra **Script** e escolha a aba **Docs**.
2. Em **Bring in the script** (trazer o roteiro; ou **Import a new version** quando já existe um), cole o texto ou escolha
   **Choose file** (escolher arquivo). O app lê Final Draft (`.fdx`), `.fountain`, `.txt` e `.md`. O que um arquivo do Final Draft
   não traz junto (marcas de revisão, ScriptNotes, marcações, páginas travadas, cabeçalhos e rodapés) aparece como
   avisos no resultado da importação. Arquivos PDF, Word e Final Draft 8 (`.fdr`) são recusados com uma mensagem: salve
   o roteiro como Final Draft (`.fdx`) ou Fountain.
3. Acrescente uma nota sobre o que mudou nesta versão.
4. Escolha **Import script** (importar roteiro).

A importação salva o texto como um novo tratamento, lê-o em cenas (um plano cada), elenco, cenários e diálogo (veja
[Decupagem](https://www.filmsquare.ai/docs/pt-br/departments/breakdown/)), e então pede a aprovação do Roteiro. Importar o mesmo texto duas vezes
não faz nada: "Nada de novo: este é o mesmo roteiro da última versão."

Uma nova versão atualiza o que mudou: cenas, planos, elenco, cenários e falas são casados pelos seus códigos, @nomes e
posições, então nada é acrescentado duas vezes. Um roteiro sem numeração ou rótulos de cena próprios recebe os códigos pela posição de cada
cabeçalho, então ali uma cena é achada pelo cabeçalho: acrescente, apague ou troque cenas de lugar, e uma cena cujo cabeçalho continua
mantém os seus takes e escolhas. As exceções vêm com um aviso no resultado da importação: um cabeçalho que agora aparece um
número diferente de vezes fica onde está; um código já ocupado por algo que a importação não fez interrompe todos os movimentos,
então takes podem acabar em outra cena; uma cena cujo cabeçalho saiu enquanto outras se moveram ou o número de cenas mudou, e os outros planos de uma cena
que perdeu o rótulo, são arquivados com os seus takes.
Cenas, planos e falas que uma importação anterior fez e a nova versão
não tem mais são arquivados, nunca apagados. Um texto sem cabeçalhos de cena (`INT.`, `EXT.`) é recusado quando uma importação
anterior já fez uma decupagem, porque substituiria a decupagem inteira.

Você também pode começar uma produção a partir de um roteiro: veja [A sua primeira produção](https://www.filmsquare.ai/docs/pt-br/getting-started/first-production/).

## Imprimir e exportar o roteiro

Cada versão se exporta sozinha. Abra o menu de versões (**v3**, ao lado do nome **Script**) e escolha:

- **Print…**: a janela de impressão do navegador (Ctrl P também funciona);
- **Download PDF…**: a mesma janela, para salvar como PDF;
- **Download Fountain**;
- **Download Final Draft**.

O arquivo se chama `Production - Episode 2 - Script v3` (num filme: `Production - Script v3`). A página de rosto sai
numa folha própria. As notas e **Changes since vN** não vão no arquivo. O diálogo simultâneo é impresso lado a lado. Qualquer pessoa que possa ler
o roteiro pode exportá-lo.

## Quem trabalha nele

Em uma equipe de cinema, o(a) roteirista e o(a) diretor(a). São funções de equipe, não funções do Filmsquare: o que uma pessoa pode fazer vem
da sua [função no espaço de trabalho](https://www.filmsquare.ai/docs/pt-br/working-together/crew-and-roles/#the-six-roles). Um(a) produtor(a) define quem trabalha no Roteiro e quem o aprova na
[página Crew](https://www.filmsquare.ai/docs/pt-br/working-together/crew-and-roles/#the-crew-page-of-a-production). Um(a) diretor(a) ou alguém acima pode escrever e importar
o roteiro. Um(a) artista no Roteiro pode escrevê-lo em todos os episódios da produção, mas não importá-lo.

## Como a IA prepara

O roteiro é trabalho da sua equipe: você o escreve no app ou o traz, e o Filmsquare não o gera. O que a IA
faz aqui é lê-lo. O leitor de Fountain roda em uma importação, na hora e de graça. Para uma decupagem completa com notas de atuação, um integrante da equipe usa o seu próprio Claude (veja abaixo).

## Aprovar

Aprovar o Roteiro diz: este é o roteiro que estamos fazendo. Ele não segura os finais por padrão, mas todos os
outros departamentos dependem dele. **Ask for sign-off** (pedir aprovação) e **Sign off writing** (aprovar o roteiro) ficam no alto de **Script → Docs**.

## O que o deixa desatualizado

Um novo tratamento do roteiro, escrito ou importado, deixa o Roteiro **Changed after sign-off** (alterado após aprovação) ("O Script v4 entrou depois da aprovação"). A mudança
segue para a Decupagem e todo departamento depois dela, então uma reescrita reabre o episódio até o final.

## Quanto custa

Nada em créditos. O leitor de Fountain é grátis, e o seu próprio Claude roda na sua própria assinatura do Claude, não nos
créditos do Filmsquare.

## Com o seu próprio Claude

As ferramentas estão em Com o Claude nesta página. O prompt `break_down_episode` conduz o Claude por `get_script` e
`submit_breakdown`; veja [Prompts e método de trabalho](https://www.filmsquare.ai/docs/pt-br/claude/prompts/). Para salvar uma nova versão sem uma nova
decupagem, o Claude usa `createScriptRevision` por `find_actions` e `run_action`.
