A Figma lançou em 15 de outubro o Figma Specs, um editor colaborativo de Markdown que pode existir como arquivo próprio ou dentro do canvas do Figma Design e do FigJam. Anunciado durante a Config India 2026, o recurso entrou em beta aberto com distribuição gradual e foi criado para manter especificações, decisões, designs, diagramas e código no mesmo contexto compartilhado.
O Specs aceita arquivos .md existentes, permite relacionar trechos do documento a elementos do canvas e entrega esse conjunto a agentes de programação por meio do servidor MCP da Figma. A edição manual do documento não usa créditos de IA, mas ações executadas pelo agente consomem créditos conforme a complexidade e a quantidade de contexto processado.
O que é o Figma Specs?
O Figma Specs é um tipo de documento Markdown com colaboração em tempo real e integração aos demais materiais de um projeto no Figma. Em vez de manter um PRD, uma decisão de arquitetura ou uma especificação técnica isolada no computador, a equipe pode colocar o documento ao lado dos designs e protótipos que ele descreve.
Segundo o anúncio oficial do Figma Specs, uma especificação pode incorporar referências a um arquivo do FigJam, a um frame, a um diagrama, a uma code layer ou a outro nó do canvas. Essas referências preservam a relação entre texto e material visual sem depender apenas de capturas de tela ou links soltos.
O documento também participa do modelo colaborativo do Figma. Pessoas podem editar, duplicar alternativas e comentar na especificação. O agente da Figma consegue ler e responder aos comentários, permitindo que sugestões automatizadas e decisões humanas permaneçam na mesma conversa.
Markdown pode entrar e sair do canvas
Uma equipe não precisa começar o documento do zero. Um arquivo Markdown pode ser arrastado para o canvas para virar uma Spec. Também é possível criar um arquivo independente pela área de arquivos ou inserir uma especificação diretamente no Figma Design e no FigJam.
O formato continua sendo Markdown, mas ganha recursos que dependem do ambiente do Figma. A documentação do Specs descreve a possibilidade de manter designs, diagramas e trechos de código junto ao texto, além de usar conectores para buscar contexto em serviços externos.
Essa diferença é importante para portabilidade. O conteúdo textual pode ser lido como Markdown, enquanto referências a frames, comentários, permissões e integrações só funcionam por completo dentro do ambiente que as conhece. Exportar apenas o arquivo .md não transforma automaticamente todos esses vínculos em arquivos locais equivalentes.
O recurso pode ser usado para requisitos de produto, decisões de interface, planejamento técnico, documentação de componentes e registros de arquitetura. A estrutura não obriga a equipe a adotar um modelo único de documento: ela oferece um contêiner comum para texto e referências.
Agentes recebem o documento e as referências vinculadas
A integração com agentes acontece pelo servidor MCP da Figma. Depois que a equipe aprova uma especificação, o link da Spec pode ser incluído no pedido enviado a um agente de programação. De acordo com a Figma, o contexto fornecido pode incluir o Markdown, frames relacionados, diagramas, code layers e trechos associados pelo Code Connect.
O agente não recebe apenas uma descrição textual da tela. Ele pode consultar as referências que sustentam a decisão e usar esse material para entender estados, componentes e restrições antes de alterar o código. A qualidade da execução ainda depende da clareza da especificação, das permissões concedidas e das ferramentas disponíveis no ambiente do agente.
Esse comportamento aproxima o Specs do mesmo princípio usado por agentes de IA com ferramentas bem descritas: contexto, escopo e limites precisam estar explícitos para que a automação faça uma ação verificável. Colocar mais arquivos ao alcance do agente não elimina a necessidade de revisar o plano, o diff e os testes produzidos.
O acesso também não é irrestrito. Conectores, repositórios e arquivos continuam sujeitos às permissões dos serviços de origem. Uma referência no documento não concede por si só acesso a um repositório privado ou a dados que a pessoa e o agente não estejam autorizados a consultar.
A especificação pode gerar design e código
O Figma apresenta o Specs como uma passagem entre intenção escrita, exploração visual e implementação. Um PRD pode servir de base para o agente propor designs ou code layers. No sentido inverso, uma equipe pode usar designs e código existentes para organizar uma especificação técnica.
Code layers são elementos do canvas executados com código real. Na atualização de 15 de outubro, elas também avançaram para beta aberto. A equipe pode importar um repositório do GitHub, enviar uma pasta local, capturar código de uma página ou transformar um frame em uma camada executável. Uma Spec pode referenciar essas camadas sem incorporar o repositório inteiro ao documento.
O fluxo não torna design e código uma única fonte de verdade automática. Alterações no repositório, no canvas e na especificação continuam precisando de revisão e sincronização conforme as integrações usadas. O recurso reduz a distância entre os materiais, mas não substitui histórico de commits, revisão de código, testes ou rastreamento de entrega.
Para times que acompanham Developer Experience e desempenho de engenharia, o ponto mensurável será o efeito sobre retrabalho, tempo de alinhamento e divergências entre requisito, design e implementação. O anúncio não apresenta comparação independente ou métricas públicas que demonstrem esses ganhos.
Um fluxo com Specs mantém cada artefato em seu sistema
Um fluxo pode começar com a pessoa responsável pelo produto importando um PRD em Markdown. Dentro do canvas, ela relaciona o documento ao diagrama da jornada, aos frames aprovados e às decisões registradas nos comentários. A Spec passa a concentrar a explicação e os vínculos, mas cada material continua com sua função própria.
Quando o trabalho chega à engenharia, o link da especificação pode ser enviado ao agente de programação. O agente consulta os elementos permitidos pelo MCP, identifica componentes e estados relevantes e prepara uma proposta de implementação. O código produzido continua sujeito ao processo do repositório: branch, revisão, testes e integração não são substituídos pela existência da Spec.
Durante a revisão, uma mudança de requisito pode ser registrada no documento e associada ao frame correspondente. Se uma code layer for usada para explorar a alteração, o time pode comparar a experiência executável com o design e extrair elementos visuais de volta para o canvas. A atualização do documento, do design e do repositório ainda precisa ser confirmada em cada destino.
Esse encadeamento exige responsabilidades claras. Uma Spec pode indicar qual decisão foi tomada, quem precisa revisar e quais referências sustentam a implementação, mas o anúncio não descreve um mecanismo universal de aprovação ou bloqueio entre todos os sistemas conectados. Times que dependem de trilhas formais precisam manter esses controles na ferramenta responsável ou implementá-los por meio das integrações disponíveis.
Também é necessário preservar o contexto que não deve sair de um sistema. Dados confidenciais, segredos, informações pessoais e repositórios restritos não devem ser copiados para a especificação apenas para facilitar a automação. O agente deve receber o menor conjunto de permissões e materiais necessário para a tarefa.
Conectores ampliam o contexto disponível
A apresentação da Config India cita integrações que permitem trazer contexto externo para uma Spec. Um agente pode, por exemplo, consultar um repositório conectado no GitHub para ajudar a redigir uma especificação técnica ou usar dados de outra ferramenta autorizada como entrada para um documento de produto.
O caminho também pode funcionar na direção oposta. A documentação descreve ações para enviar atualizações a fontes externas, como issues ou repositórios, a partir de uma especificação. A operação depende do conector, das capacidades expostas por ele e das permissões concedidas à conta.
Esse desenho evita que o Markdown precise conter cópias de todo o material usado no projeto. Ao mesmo tempo, cria dependências: se uma integração for removida, uma permissão expirar ou um arquivo mudar de endereço, parte do contexto pode deixar de estar disponível. Equipes que usam Specs como registro de decisão ainda precisam definir o que deve permanecer no Figma e o que deve ser preservado nos sistemas responsáveis por código, tarefas e dados.
O beta aberto tem liberação gradual
O resumo oficial da Config India 2026 classifica o Specs como beta aberto e informa que o acesso será distribuído ao longo das semanas seguintes ao anúncio. O recurso funciona na web, nos aplicativos para desktop e no aplicativo móvel, mas a criação e a edição exigem acesso compatível ao arquivo.
A documentação consultada no dia do lançamento lista o Specs para planos pagos e para modalidades específicas de educação, organizações, empresas e governo. Como a distribuição é gradual, duas pessoas ou equipes podem receber o recurso em datas diferentes. A ausência do botão de criação no primeiro dia não significa que o produto deixou o beta.
Também não há lançamento regional separado para o Brasil nas páginas oficiais consultadas. A disponibilidade depende do plano, do tipo de acesso e do rollout da conta, não de uma data brasileira anunciada.
Editar texto e usar o agente têm custos diferentes
Escrever ou editar uma Spec manualmente não consome créditos de IA. O consumo aparece quando o agente é usado para criar, transformar ou analisar conteúdo, incluindo tarefas que leem referências e executam ações ligadas à especificação.
A Figma não define um número único de créditos para o Specs. O guia de créditos de IA informa que o gasto varia conforme a complexidade da solicitação, as ações realizadas e o volume de contexto entregue ao agente. O recibo exibido depois de uma interação permite conferir o consumo daquela execução.
Esse modelo separa o editor colaborativo das funções generativas. Uma equipe pode manter documentação em Markdown sem acionar o agente, mas deve acompanhar orçamento e permissões quando automatiza a criação de designs, código ou atualizações externas.
Specs permanece em beta e pode mudar
O Figma Specs ainda não está em disponibilidade geral. A Figma alerta que recursos em beta podem apresentar falhas e receber alterações antes da versão estável. O lançamento também não informa prazo para o fim do beta nem uma tabela exclusiva de preços para o editor.
No estado anunciado em 15 de outubro, o recurso oferece criação e importação de Markdown, colaboração no canvas, referências a materiais do Figma e integração com agentes pelo MCP. O acesso é gradual, a edição manual não usa créditos de IA e o uso do agente tem consumo variável. Repositórios, tarefas, dados externos e controles de acesso continuam administrados pelos respectivos sistemas conectados.
