Documentos
A documentação que mora ao lado do trabalho. Specs, RFCs, runbooks, atas de reunião, anotações soltas — tudo em Markdown, organizado em árvore e ligado às tarefas que descreve. Aqui você guarda o "porquê" do projeto; em Tarefas & Kanban você toca o "o quê/quando".
Abra pela barra lateral em Documentos.
Como criar um documento
- Vá em Documentos na barra lateral.
- Clique em Novo documento.
- Escolha um template na lista (ou documento em branco para começar do zero).
- O documento abre no editor, já com um título e um corpo inicial. É só escrever.
O documento salva sozinho enquanto você digita — não existe botão "Salvar". Quando aparece ● salvo na barra de informações, está tudo guardado.
Templates não são camisa de força: eles só pré-preenchem o corpo. Apague o que não usar. O esqueleto pronto economiza os 10 minutos de "como é que eu começo isso".
Organizar em árvore (e subdocumentos)
Documentos vivem numa árvore, não numa lista plana. Qualquer documento pode ter subdocumentos — e estes, os seus. Use isso para espelhar a estrutura real do que você escreve: um handbook com capítulos, um épico com uma spec por feature, um runbook com um procedimento por seção.
- Criar um subdocumento: passe o mouse sobre um documento na árvore e clique no + (adicionar filho).
- Expandir/recolher: clique no chevron à esquerda do título.
- Excluir: no menu de ações (ícone de lixeira no hover). Cuidado: excluir um documento leva junto os subdocumentos dele.
Cada item da árvore mostra o emoji, o título, um indicador de fixado (pin) e um ponto de status com a cor do ciclo de vida (rascunho, em revisão, aprovado, arquivado).
Navegar: árvore ou por tags
Você marca documentos com tags (#auth, #infra, #onboarding...) escrevendo a tag no corpo.
Na barra da árvore há um botão para alternar a visualização:
- Árvore — hierarquia pai/filho, do jeito que você organizou.
- Por tags — agrupa os documentos por tag, ignorando a hierarquia. Bom para achar "tudo de
#release" espalhado por vários projetos.
A sua preferência de visualização fica lembrada entre sessões.
Os escopos: pessoal, projeto, equipe, workspace
Todo documento pertence a um escopo — é o que decide em que contexto ele aparece. Na lateral esquerda da tela há uma trilha de ícones para alternar entre eles:
- Meus docs (pessoal) — só seus. Rascunhos, anotações, ideias soltas, notas de 1:1.
- Projetos — atrelados a um projeto específico. Aparecem no projeto (ver abaixo).
- Squads — da equipe. Aparecem no painel do time como "Docs do time".
- Workspace — visíveis para todo o workspace. Handbooks, políticas, decisões transversais.
Ao entrar num escopo de Projetos ou Squads, um seletor no topo deixa você escolher qual projeto ou squad você está olhando. Assim a árvore mostra só os documentos daquele contexto.
O escopo organiza e dá contexto — ele coloca o doc no lugar certo (no projeto, no time, no workspace). Escolha o escopo pensando em onde as pessoas vão procurar por aquele documento.
O editor Markdown
O editor é Markdown puro, com pré-visualização ao vivo. Três modos, alternáveis pelos botões no topo:
- Editar — só o texto Markdown.
- Dividido — texto à esquerda, resultado renderizado à direita (ótimo para escrever).
- Pré-visualizar — só o resultado final, do jeito que os outros vão ler.
O Markdown suportado cobre o essencial: títulos (#, ##, ###), listas com marcadores e
numeradas, listas de tarefas (checkboxes - [ ] / - [x]), tabelas, blocos de código e
código inline, citações (>), linhas divisórias (---), negrito, itálico e links.
Além do Markdown comum, o editor reconhece três coisas próprias do Projectura quando renderizado:
@menção— vira um chip com o avatar da pessoa.#tag— vira um chip de tag (e alimenta a navegação por tags).::task:ID::— vira um cartão de tarefa ao vivo, clicável, que leva ao detalhe da tarefa.
No topo do documento, clique no emoji para trocá-lo e escreva o título direto no campo grande. A barra de informações abaixo do título mostra a contagem de palavras em tempo real, junto com autor, datas de criação e edição, revisores e tags.
Embutir tarefas no documento
Specs e planos ficam muito melhores quando a tarefa real aparece dentro do texto — com status sincronizado, sem copiar e colar. Para embutir uma tarefa, escreva o marcador dela numa linha:
::task:t1a2b::
Na pré-visualização (ou no painel dividido), essa linha vira um cartão da tarefa: id, título, status atual e CI. Clicar nele abre o detalhe da tarefa. Como o cartão lê o estado real, ele reflete mudanças — se a tarefa mudar de status, o cartão acompanha.
Converter uma linha em tarefa
Escreveu um plano cheio de checkboxes e percebeu que um item merece virar tarefa de verdade? Não precisa recriá-lo do zero.
- Escreva o item como uma lista de tarefas:
- [ ] Migrar tokens para PKCE. - Na pré-visualização, passe o mouse sobre a linha (com o checkbox ainda desmarcado).
- Clique em Converter em tarefa.
O Projectura cria a tarefa com aquele texto e troca a linha pelo cartão da tarefa embutido
(::task:ID::) automaticamente. A partir daí o item vira cidadão de primeira classe: tem
responsável, prazo, CI, comentários — e continua aparecendo dentro do seu documento.
Esse é o caminho natural de uma spec: você rascunha tudo como checkboxes, discute, e converte em tarefas só o que for executar. O documento continua sendo a fonte do plano; o board passa a tocar a execução.
Ciclo de vida e revisão
Cada documento tem um status de ciclo de vida, ajustável pelo seletor no topo:
Rascunho → Em revisão → Aprovado → Arquivado
Quando um documento entra em revisão, você trabalha com revisores no painel lateral: adicione revisores e acompanhe o sign-off de cada um (pendente, aprovou, pediu mudanças); uma barra mostra quantos aprovaram do total; e, se você é revisor, tem um cartão próprio para Aprovar ou Pedir mudanças. Quando todos aprovam, dá para marcar o documento como Aprovado.
Histórico e sugestões
O painel lateral também guarda a memória do documento:
- Histórico — uma lista de versões anteriores (autor, quando, resumo). Abra uma versão e use Restaurar esta versão para voltar no tempo. A versão mais recente leva o selo ATUAL.
- Sugestões — propostas de mudança no texto, mostradas como diff. Você pode Aceitar ou Rejeitar cada uma.
O histórico é alimentado automaticamente conforme você edita — você não precisa "salvar versões" na mão.
Onde os documentos aparecem no resto do app
Documentos não ficam presos na tela de Documentos. Conforme o escopo, eles surgem onde o contexto pede:
- Fixar (pin) → README do projeto. Fixe um documento de escopo de projeto e ele vira o README em destaque na aba Overview daquele projeto, renderizado por inteiro no topo. Os demais documentos do projeto aparecem logo abaixo. Veja Equipes & Projetos.
- Docs do time. Documentos de escopo de squad aparecem no painel do time, no cartão "Docs do time", com indicador de fixado e status.
Esses pontos são reativos: criou, editou ou fixou um documento, e o projeto/equipe reflete a mudança — sem precisar recarregar nada na mão.
Dicas rápidas
- Use documentos para o contexto (decisões, racional, specs) e tarefas para a execução. Juntos, contam a história completa.
- Fixe o documento mais importante de cada projeto — ele vira o README e é a primeira coisa que o time vê.
- A IA do Projectura também trabalha com seus documentos (criar, ler, atualizar) — veja Automação com IA.