@aksp/opencrew 1.9.0 → 1.10.0

package/CHANGELOG.md

@@ -3,6 +3,64 @@
 All notable changes to opencrew are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
+## [1.10.0] — 2026-10-07
+
+Fase U3b "Documento Word, com perfil de documento oficial" (`specs/fase-u3b-documento-word.md`).
+Chega a quem já usa com um `npx @aksp/opencrew@latest update`; o papel timbrado é criado só quando
+você pede.
+
+Ainda não nesta versão: imagem no corpo do texto, link clicável, sumário, nota de rodapé e
+numeração automática; logotipo em JPEG ou SVG; ler ou regravar um modelo `.dotx`; mais de um
+perfil por projeto na entrega; PDF direto (o Word salva como PDF). O resultado foi conferido no
+Word; no LibreOffice e no Google Docs, não.
+
+### Added
+- **Documento Word.** O texto em markdown (`.md` ou `.txt`) vira um arquivo do Word (`.docx`) com
+  as mesmas palavras e os mesmos números, na mesma ordem. No chat: `/opencrew documento <arquivo>`
+  (ou "Documento Word" no menu). No terminal:
+  `node _opencrew/core/scripts/documento.mjs "<arquivo.md>"`. O Word sai ao lado do texto, com o
+  mesmo nome; `--saida` escolhe outra pasta ou outro nome. Antes, quem precisava de um documento
+  oficial mantinha um script à parte, com o texto dentro do código.
+- **Papel timbrado (perfil de documento oficial).** Um arquivo de texto do projeto,
+  `_opencrew/_memory/documento-oficial.md`, guarda o logotipo (PNG), três linhas de cabeçalho, o
+  rodapé com "Página X de Y", as margens, a fonte e o tamanho da letra. Na primeira vez a IA
+  pergunta se você quer configurar e preenche o arquivo com as suas respostas; `--criar-perfil`
+  cria o arquivo a partir do modelo. O `update` não toca nele, e nenhum comando o sobrescreve.
+- **Três marcações para documento.** `::: titulo` e `::: subtitulo` (centralizados),
+  `::: quebra-de-pagina` (o anexo começa em página nova) e `::: assinaturas` … `:::` (as linhas
+  de assinatura, duas por linha, com o nome e o cargo). Títulos `#`, `##` e `###`, tabelas, listas,
+  negrito e itálico saem como estilos do Word.
+- **O texto oficial não muda.** Número de item escrito por você ("1.", "6.1.", "a)", "§ 1º") vai
+  como texto: nada é renumerado, reordenado nem corrigido.
+- **Na entrega, a pasta `documentos/`.** O passo com `format: documento-oficial` sai como
+  `entrega/documentos/<nome>.docx`, com o papel timbrado do projeto, e o LEIA-ME ganha a seção
+  "Documentos", com o que conferir no Word. Sem papel timbrado configurado, a entrega avisa e
+  diz como criar. A cópia para a pasta do projeto leva `documentos/`
+  junto.
+- **Guia `documento-oficial`** (o 23º guia de melhores práticas): ensina o redator a escrever um
+  texto que vira documento — um parágrafo por linha, número escrito à mão, anexo depois da quebra
+  de página, assinaturas no fim. Crews novas recebem esse formato no passo cujo resultado é um
+  documento para imprimir, assinar ou protocolar.
+- **Avisos de conversão.** O relatório diz o que ficou como texto (imagem, marcação `:::`
+  desconhecida, bloco de assinaturas sem o `:::` final) e quantos caracteres inválidos foram
+  removidos. Aviso não impede o documento.
+
+### Changed
+- **Um Word que já existe não é trocado em silêncio.** Se há um `.docx` diferente no destino, nada
+  é gravado e a IA pergunta antes de substituir (`--substituir`). Igual, byte a byte: nada a fazer.
+- **Perfil com erro não gera documento.** Chave desconhecida, valor fora da faixa, logotipo que
+  não existe, não é PNG ou passa de 2 MB: a mensagem diz a linha, e nada é gravado.
+- O menu "Mais opções" ganha "Documento Word".
+
+### Internal
+- `documento.mjs` e os módulos de `scripts/documento/` (sem dependência, sem `node:zlib`, até 200
+  linhas cada): zip sem compressão, com CRC-32 próprio e data fixa — o mesmo texto, com o mesmo
+  perfil, dá o mesmo arquivo, byte a byte. `modelos/documento-oficial.md` é o modelo do perfil;
+  `prompts/documento.prompt.md`, o prompt da rota. O `src/` não mudou; o runner não cresceu (874
+  linhas).
+- `AGENTS.md`: a regra 15 cita o `documento.mjs`; a regra 7 diz que abrir o `.docx` no Word não é
+  conferido pela porta.
+
 ## [1.9.0] — 2026-10-07
 
 Fase U3a, fatia 2 "Entrega no projeto" (`specs/fase-u3a2-entrega-no-projeto.md`). Chega a quem já

package/README.md

@@ -36,6 +36,9 @@ dentro da sua IDE.**
   colar, as imagens e um `LEIA-ME.md` com o passo a passo. O que não está pronto fica marcado.
 - 📁 **Entrega no seu projeto** — a crew pergunta uma vez onde guardar e copia a entrega para uma
   pasta do seu projeto, uma subpasta por execução, sem sobrescrever nada.
+- 📄 **Documento Word em papel timbrado** — ata, ofício, declaração: o texto em markdown vira um
+  arquivo do Word com as mesmas palavras, o seu logotipo no cabeçalho, "Página X de Y" no rodapé
+  e as linhas de assinatura. Um comando: `/opencrew documento <arquivo>`.
 - 🎛️ **Seleção inteligente de agentes** — o sistema analisa seu pedido e
   sugere quais agentes são necessários para aquela tarefa. Você confirma ou
   ajusta com um clique. Agentes pulados não gastam tokens naquele run.
@@ -181,10 +184,11 @@ meu-projeto/
 │   │   ├── runner.pipeline.md    ← executor de pipeline
 │   │   ├── skills.engine.md      ← gerenciador de skills
 │   │   ├── architect.agent.yaml  ← definição do Arquiteto
-│   │   ├── best-practices/       ← 22 guias de melhores práticas + _catalog.yaml
-│   │   ├── scripts/              ← verificador, conferência de fontes, caminhos, entrega e os scripts do Escritório
+│   │   ├── best-practices/       ← 23 guias de melhores práticas + _catalog.yaml
+│   │   ├── scripts/              ← verificador, conferência de fontes, caminhos, entrega, documento Word e os scripts do Escritório
+│   │   ├── modelos/              ← modelo do perfil de documento oficial (papel timbrado)
 │   │   ├── escritorio/           ← página do Escritório ao vivo (abre com /opencrew dashboard)
-│   │   └── prompts/              ← 14 prompts de fase (discovery, design, build, entrega, etc.)
+│   │   └── prompts/              ← 15 prompts de fase (discovery, design, build, entrega, documento, etc.)
 │   ├── agents/                   ← 5 agentes base compartilhados
 │   │   ├── researcher.agent.md
 │   │   ├── copywriter.agent.md
@@ -193,7 +197,8 @@ meu-projeto/
 │   │   └── strategist.agent.md
 │   ├── _memory/
 │   │   ├── company.md            ← perfil da sua empresa (onboarding)
-│   │   └── preferences.md        ← idioma, tier padrão, Escritório ligado ou desligado
+│   │   ├── preferences.md        ← idioma, tier padrão, Escritório ligado ou desligado
+│   │   └── documento-oficial.md  ← seu papel timbrado (só existe depois que você pede; veja "Documento Word")
 │   └── .opencrew-version
 │
 ├── crews/                        ← suas crews vivem aqui
@@ -231,6 +236,7 @@ entrega/
 ├── whatsapp/       ← mensagem.txt
 ├── twitter/        ← tweet.txt (na thread: tweet-1.txt, tweet-2.txt…)
 ├── youtube/        ← o roteiro
+├── documentos/     ← o Word (.docx) de cada texto de formato documento-oficial
 ├── outros/         ← arquivo sem canal (proposta, minuta, relatório), como está
 └── editaveis/      ← o HTML dos slides, para quem quiser ajustar
 ```
@@ -286,6 +292,83 @@ são sempre em português.
 
 ---
 
+## Documento Word
+
+Ata, ofício, declaração, contrato: quando o resultado é um documento para imprimir, assinar ou
+protocolar, o OpenCrew transforma o texto em markdown num arquivo do Word (`.docx`) com **as
+mesmas palavras e os mesmos números, na mesma ordem**. Você escreve (ou a crew escreve) o texto;
+um comando gera o documento.
+
+**Como gerar:** no chat da sua IDE, digite `/opencrew documento Atas/ata.md` — ou escolha
+"Documento Word" em "Mais opções" do menu. O Word sai ao lado do texto, com o mesmo nome
+(`Atas/ata.docx`), e a IA mostra o relatório: onde gravou, qual papel timbrado usou e os avisos.
+Também funciona direto no terminal, na pasta do projeto:
+
+```bash
+node _opencrew/core/scripts/documento.mjs "Atas/ata.md"
+node _opencrew/core/scripts/documento.mjs "Atas/ata.md" --saida "Documentos/Prontos"
+node _opencrew/core/scripts/documento.mjs --criar-perfil     # cria o arquivo do papel timbrado
+```
+
+**Papel timbrado.** Na primeira vez, a IA pergunta se você quer configurar o papel timbrado do
+projeto. Com o "sim", ela cria o perfil de documento oficial em
+`_opencrew/_memory/documento-oficial.md`, pergunta o logotipo, as linhas do cabeçalho e o rodapé
+e preenche o arquivo. É um arquivo de texto, seu, que o `update` nunca toca. Nele ficam:
+
+- o logotipo (um PNG de até 2 MB, dentro do projeto) e a largura dele;
+- três linhas de cabeçalho (nome da organização, registro, site e contato);
+- o texto do rodapé e o "Página X de Y";
+- as margens, a fonte e o tamanho da letra.
+
+Com o "não", o documento sai sem timbre, com as margens padrão e "Página X de Y" no rodapé. É um
+perfil por projeto; mudar o perfil não muda os documentos já gerados.
+
+**Como escrever o texto.** Markdown comum, um parágrafo por linha, com três marcações a mais:
+
+```
+::: titulo ATA DA REUNIÃO DA DIRETORIA
+::: subtitulo Realizada em 5 de maio de 2026
+
+# I. Abertura
+Aos 5 dias do mês de maio de 2026, reuniu-se a diretoria.
+
+::: assinaturas
+Ana Lima | Presidente
+Rui Sá | Secretário
+:::
+
+::: quebra-de-pagina
+::: titulo ANEXO I — CALENDÁRIO
+```
+
+- `::: titulo` e `::: subtitulo` saem centralizados; `#`, `##` e `###` viram os títulos das
+  seções; tabela vira tabela; `- item` vira lista com marcador.
+- `::: quebra-de-pagina` começa uma página nova (para o anexo); `::: assinaturas`, uma linha
+  `Nome | Cargo` por pessoa e `:::` para fechar montam as linhas de assinatura.
+- **Os números são os seus.** "1.", "6.1.", "a)" e "§ 1º" vão como texto, do jeito que você
+  escreveu: nada é renumerado, reordenado nem corrigido.
+- **Nada é trocado sem você saber.** Se já existe um Word diferente com esse nome (você pode tê-lo
+  editado), nada é gravado: a IA pergunta antes de substituir.
+- **Avisos de conversão.** O relatório diz o que não coube no documento e ficou como texto: imagem,
+  marcação `:::` desconhecida, bloco de assinaturas sem o `:::` final. Perfil com erro (chave
+  desconhecida, logotipo que não existe) não gera documento: a mensagem diz a linha.
+- **O Word é uma cópia do texto.** O que você mudar no Word não volta para o texto: altere o texto
+  e gere de novo. Para ter um PDF, abra o documento no Word e use Salvar como PDF.
+
+**Dentro de uma crew.** O passo cujo resultado é um documento usa `format: documento-oficial` (o
+guia que ensina o redator a escrever assim). Na entrega, esse texto vira
+`entrega/documentos/<nome>.docx`, com o papel timbrado do projeto, e o LEIA-ME diz o que conferir.
+Crews novas já nascem assim; numa crew antiga, acrescente `format: documento-oficial` ao passo.
+
+**O que não faz.** Não põe imagem no corpo do texto, link clicável, sumário, nota de rodapé nem
+numeração automática; o logotipo é só PNG; tamanhos e cores dos títulos são fixos; não lê nem
+regrava um modelo `.dotx`. Os testes conferem a estrutura do arquivo; como ele fica na página,
+você confere no Word. No LibreOffice e no Google Docs o resultado não foi conferido.
+
+Quem já usa o OpenCrew recebe o documento Word com um `npx @aksp/opencrew@latest update`.
+
+---
+
 ## Escritório ao vivo
 
 Quer ver a equipe trabalhando? O **Escritório** é uma página em pixel-art, aberta no navegador,
@@ -413,6 +496,7 @@ npx @aksp/opencrew update --check
 | `/opencrew settings` | Altera preferências (idioma, tier, Escritório) |
 | `/opencrew dashboard` | Liga e abre o Escritório ao vivo (a equipe trabalhando, no navegador) |
 | `/opencrew dashboard off` | Desliga o Escritório |
+| `/opencrew documento <arquivo>` | Transforma um texto (`.md` ou `.txt`) em documento Word, com o papel timbrado do projeto |
 | `/opencrew show-company` | Mostra o perfil da empresa |
 | `/opencrew edit-company` | Reconfigura o perfil da empresa |
 | `/opencrew help` | Mostra a lista de comandos |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aksp/opencrew",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "publishConfig": {
     "access": "public"
   },

package/templates/AGENTS.md

@@ -10,6 +10,7 @@ On activation, perform these steps IN ORDER:
 1. Read the company context file: `{project-root}/_opencrew/_memory/company.md`
 2. Read the preferences file: `{project-root}/_opencrew/_memory/preferences.md`
 3. Check if company.md is empty or contains only the template — if so, trigger ONBOARDING
+   (except for `/opencrew documento` and the `
 4. Otherwise, display the MAIN MENU
 
 ## Onboarding Flow (first time only)
@@ -36,7 +37,10 @@ numbered list and ask the user to reply with a number.
 **Primary menu:** Create a new crew · Run an existing crew · My crews ·
 More options
 
-**More options:** Skills · Company profile · Settings & Help
+**More options:** Skills · Documento Word · Company profile · Settings & Help
+
+"Documento Word" turns a text file of the project into a Word document: load
+`_opencrew/core/prompts/documento.prompt.md`, which asks for the file.
 
 ## Command Routing
 
@@ -60,6 +64,7 @@ Route input to the matching action:
 | `/opencrew settings` | Show/edit preferences.md |
 | `/opencrew dashboard` | Turn on and open the Escritório (live view) — see "Dashboard (Optional)" |
 | `/opencrew dashboard off` | Turn the Escritório off — see "Dashboard (Optional)" |
+| `/opencrew documento <arquivo>` | Load `_opencrew/core/prompts/documento.prompt.md` → turn that text file (`.md` or `.txt`) into a Word document (`.docx`) |
 | `/opencrew reset` | Confirm and reset all configuration |
 | Request to deliver a run that already ended ("monte a entrega da execução …") | Load `_opencrew/core/prompts/entrega.prompt.md` → build the `entrega/` folder of that run |
 | Request to change where the delivery is copied ("muda a pasta de entrega", "não quero mais cópia", "volta a copiar") | Load `_opencrew/core/prompts/entrega.prompt.md` → "Changing the folder later" |
@@ -124,10 +129,13 @@ and touch nothing else: stop no process, delete no file.
   see `_opencrew/core/runner.pipeline.md`
 - Exception: the delivery folder (`entrega/`) — its folder names, file names and the `LEIA-ME.md`
   are written by a script in fixed PT-BR, whatever the user's language
+- Exception: the report of the Word document script (`documento.mjs`) and the "Página X de Y" of
+  the footer it writes are fixed PT-BR too
 
 ## Critical Rules
 
-- NEVER skip the onboarding if company.md is not configured
+- NEVER skip the onboarding if company.md is not configured (the Word document route is the only
+  exception: it does not use the company context)
 - ALWAYS load company context before running any crew
 - ALWAYS present checkpoints to the user — never skip them
 - ALWAYS save outputs to the crew's output directory

package/templates/_opencrew/.opencrew-version

@@ -1 +1 @@
-1.9.0
+1.10.0

package/templates/_opencrew/core/best-practices/_catalog.yaml

@@ -114,3 +114,8 @@ catalog:
     name: "WhatsApp Broadcast"
     whenToUse: "Creating agents that produce WhatsApp broadcast messages or conversational marketing content."
     file: whatsapp-broadcast.md
+
+  - id: documento-oficial
+    name: "Documento oficial (Word)"
+    whenToUse: "Creating agents that produce a document to print, sign or file (minutes, official letter, statement, contract, formal report) that becomes a Word file."
+    file: documento-oficial.md

package/templates/_opencrew/core/best-practices/documento-oficial.md

@@ -0,0 +1,144 @@
+---
+name: "Documento oficial"
+platform: "documento"
+content_type: "official-document"
+description: "Text that becomes a Word document to print, sign or file: minutes, official letters, statements, contracts and reports, written so the conversion keeps every word"
+whenToUse: |
+  Creating agents that produce a document to print, sign or file — minutes (ata), official letter (ofício), statement, contract, formal report — which the project turns into a Word file (.docx).
+version: "1.0.0"
+---
+
+## Compact Rules
+
+1. One paragraph per line. Never break a paragraph in the middle: each line of the file becomes one paragraph of the document, and lines that follow each other are not joined.
+2. Start with `::: titulo` and, when there is one, `::: subtitulo`, as the first lines of the text (one line each).
+3. Use `#`, `##` and `###` for the sections, and no deeper level.
+4. Write every number by hand — "I.", "1.", "6.1.", "a)", "§ 1º" — in sections and in items. Nothing is numbered automatically: the number you write is the official text.
+5. Use a simple table (header line, separator line, rows) for figures and lists of names. No merged cells, no table inside a table.
+6. Put `::: quebra-de-pagina` alone on a line before each annex (anexo), so the annex starts on a new page.
+7. Put the `::: assinaturas` block at the end of the document (and at the end of an annex that is signed): one line `Nome | Cargo` per person, closed by a line with only `:::`.
+8. No image, no HTML, no labels such as `=== … ===`, no notes section and no comments to the reader: everything in the file goes to the document.
+9. Write the full, final text. Missing real data is marked `[PREENCHER: o que falta]`; never invent a name, a date, a number or a registration.
+10. Use bold (`**texto**`) and italic (`*texto*`) sparingly; a list of plain items uses `- `.
+
+## What the conversion does
+
+The project turns this text into a Word file with one script, with the same words and the same
+numbers, in the same order. Knowing what it does tells you how to write:
+
+| You write | The document gets |
+|---|---|
+| `::: titulo Texto` · `::: subtitulo Texto` | A centered title · a centered subtitle, in italic. Valid anywhere, as many times as needed (an annex has its own) |
+| `# Texto` · `## Texto` · `### Texto` | Section headings of level 1 (shown in capitals), 2 and 3 |
+| A line of text | One justified paragraph |
+| A line that starts with a number or a letter of item (`1.`, `a)`) | A common paragraph, with the number as you wrote it; two spaces at the start of the line indent it |
+| `- item` | A bulleted item (two spaces before it: second level) |
+| A table | A table with equal columns and the first line in bold |
+| `---` alone on a line | A horizontal line |
+| `::: quebra-de-pagina` | The next block starts on a new page |
+| `::: assinaturas` … `:::` | Signature lines, two per row, with the name above the role |
+| `[texto](https://endereco)` | `texto (https://endereco)`, as plain text |
+
+The header with the logo, the footer with "Página X de Y", the margins and the font come from
+the profile of the project, not from the text: never write a header, a footer or a page number.
+
+## The three markings
+
+A marking is a line that starts with `:::` in the first column.
+
+- **Title and subtitle** — `::: titulo ATA DA REUNIÃO` and `::: subtitulo Realizada em 5 de maio de 2026`. One line each. They are not sections: the sections are the `#` lines.
+- **Page break** — `::: quebra-de-pagina`, alone on the line, with nothing after it.
+- **Signatures** — open with `::: assinaturas`, write one person per line as `Nome | Cargo` (the role is optional) and close with `:::`. Inside the block nothing else is read: bold and italic signs would be printed as typed. The order you write is the order on the page, left to right and top to bottom.
+
+Any other word after `:::` is not a marking: the line goes to the document as text, and the
+conversion warns about it. A signature block without the closing `:::` also stays as text.
+
+## What does not go in the text
+
+- **Images** (`![…](…)`) — the document carries no image in the body; the line would stay as text. The logo belongs to the profile of the project.
+- **HTML** (`<br>`, `<center>`, `<table>`) and HTML comments — they would be printed as they are.
+- **Labels and service blocks** (`=== TÍTULO ===`, `NOTES:`, checklists for the writer) — they are not removed.
+- **A notes section** ("Notas", "Observações do redator", "Fontes consultadas" that are not part of the document) — say it to the user in the conversation, not in the file.
+- **Frontmatter is the only exception**: a `---` block of `chave: valor` lines at the very top stays out of the document.
+
+## Structure of a document
+
+1. **Title and subtitle** — what the document is; when and where, in the subtitle.
+2. **Opening** — who, when, where, under which rule or call.
+3. **Body in numbered sections** — one subject per section, in the order of the agenda or of the request. Decisions are written as decisions ("Aprovado por unanimidade."), with the numbers that support them.
+4. **Closing** — what happens next, and who wrote the document.
+5. **Signatures** — everyone who signs, with the role.
+6. **Annexes** — each one after a page break, with its own title.
+
+## Output Example
+
+```markdown
+::: titulo ATA DA REUNIÃO DA DIRETORIA
+::: subtitulo Realizada em 5 de maio de 2026, na sede da Associação Exemplo de Moradores
+
+# I. Abertura
+Aos 5 dias do mês de maio de 2026, às 19h, reuniu-se a diretoria da Associação Exemplo de Moradores, na Rua das Acácias, 100, com a presença dos três diretores.
+A presidente, Ana Lima, abriu a reunião e convidou Rui Sá para secretariar os trabalhos.
+
+# II. Ordem do dia
+A presidente leu a ordem do dia:
+1. Reforma do salão de festas;
+2. Calendário de eventos do segundo semestre.
+
+# III. Reforma do salão de festas
+## 3.1. Orçamentos recebidos
+A tesoureira, Bia Reis, apresentou os três orçamentos recebidos:
+
+| Empresa | Prazo | Valor |
+|---|---|---|
+| Construtora Exemplo | 30 dias | R$ 18.400,00 |
+| Reformas Modelo | 45 dias | R$ 16.900,00 |
+| Obras Amostra | 25 dias | R$ 21.000,00 |
+
+## 3.2. Deliberação
+Por unanimidade, a diretoria aprovou o orçamento da **Reformas Modelo**, com as seguintes condições:
+- pagamento em três parcelas iguais;
+- início da obra depois da festa junina.
+
+# IV. Calendário de eventos
+Ficou aprovado o calendário do segundo semestre, que segue no Anexo I.
+
+# V. Encerramento
+Nada mais havendo a tratar, a presidente encerrou a reunião às 20h15. Eu, Rui Sá, secretário, lavrei esta ata, que vai assinada por todos.
+
+::: assinaturas
+Ana Lima | Presidente
+Rui Sá | Secretário
+Bia Reis | Tesoureira
+:::
+
+::: quebra-de-pagina
+::: titulo ANEXO I — CALENDÁRIO DE EVENTOS
+::: subtitulo Segundo semestre de 2026
+
+| Data | Evento | Responsável |
+|---|---|---|
+| 12 de julho | Festa julina | Bia Reis |
+| 20 de setembro | Mutirão de limpeza | Rui Sá |
+| 6 de dezembro | Confraternização | Ana Lima |
+```
+
+## Anti-Patterns
+
+- A paragraph broken into several lines "to fit the screen": it becomes several paragraphs.
+- `1.` typed for every item, counting on automatic numbering: the document shows exactly what is typed.
+- The title of the document as `# Título`: it becomes a section heading, not the centered title.
+- A signature drawn with underscores (`______`): use the `::: assinaturas` block.
+- "Página 1 de 3", the name of the organization or the date of printing written in the text: the header and the footer come from the profile.
+- A closing note such as "Posso ajustar o que precisar": it would be printed in the document.
+
+## Quality Criteria
+
+- [ ] Each paragraph is on one line; no line is a continuation of the previous one
+- [ ] `::: titulo` is the first line of the text (after the frontmatter, if there is one)
+- [ ] Every section and item number is written by hand, in sequence, with no gap
+- [ ] Every table has a header line and a separator line, and the same number of columns in each row
+- [ ] Each annex comes after `::: quebra-de-pagina` and has its own `::: titulo`
+- [ ] The `::: assinaturas` block is closed by `:::` and lists everyone who signs
+- [ ] No image, HTML, label, notes section or message to the reader
+- [ ] No invented data: what is missing is `[PREENCHER: …]`

package/templates/_opencrew/core/modelos/documento-oficial.md

@@ -0,0 +1,42 @@
+# Perfil de documento oficial
+
+Este arquivo guarda o papel timbrado do projeto: o logotipo, o cabeçalho, o rodapé, as margens e
+a letra dos documentos Word. Preencha depois dos dois-pontos; o que ficar vazio não aparece no
+documento. Só as linhas `chave: valor` são lidas: o resto é comentário.
+
+Para gerar um documento: node _opencrew/core/scripts/documento.mjs "caminho/do/texto.md"
+
+## Cabeçalho
+
+# Logotipo: arquivo PNG de até 2 MB, com o caminho a partir da pasta do projeto (exemplo: Ativos/Marca/logo.png).
+logotipo:
+# Largura do logotipo no papel, em centímetros (de 1 a 6); a altura acompanha a proporção da imagem.
+logotipo_largura_cm: 2,5
+# Primeira linha do cabeçalho, em negrito: o nome da organização (exemplo: ASSOCIAÇÃO EXEMPLO DE MORADORES).
+cabecalho_1:
+# Segunda linha do cabeçalho (exemplo: CNPJ 00.000.000/0001-00 · Fundada em 1990).
+cabecalho_2:
+# Terceira linha do cabeçalho, em cinza (exemplo: www.exemplo.org · contato@exemplo.org).
+cabecalho_3:
+
+## Rodapé
+
+# Texto do rodapé, à esquerda, em todas as páginas (exemplo: Associação Exemplo de Moradores — documento oficial).
+rodape:
+# "Página X de Y" à direita do rodapé: sim ou nao.
+numero_pagina: sim
+
+## Página e letra
+
+# Margem esquerda, em centímetros (de 1 a 6).
+margem_esquerda_cm: 3,0
+# Margem direita, em centímetros (de 1 a 6).
+margem_direita_cm: 2,0
+# Margem superior, em centímetros (de 1 a 6).
+margem_superior_cm: 2,5
+# Margem inferior, em centímetros (de 1 a 6).
+margem_inferior_cm: 2,5
+# Fonte do texto: o nome como aparece no Word (até 40 letras, dígitos e espaços).
+fonte: Arial
+# Tamanho da letra do texto, em pontos (de 8 a 14; aceita meio ponto, como 10,5).
+tamanho_corpo_pt: 11

package/templates/_opencrew/core/prompts/design.prompt.md

@@ -444,6 +444,7 @@ The name should make someone smile — it's a pun tying a common name to the pro
 - Always include reviewer agent before final output
 - Add checkpoints at every user decision point
 - Include `on_reject` loops from reviewer back to writer
+- A step whose result is a document to print, sign or file (minutes, official letter, statement, contract, formal report) gets `format: documento-oficial`, in any kind of crew: the writer follows that guide, and the text becomes a Word document in the delivery of the run (or with `/opencrew documento <arquivo>`)
 
 ### Research Focus Checkpoint (MANDATORY for crews with a researcher)
 

package/templates/_opencrew/core/prompts/documento.prompt.md

@@ -0,0 +1,134 @@
+# Documento Word — A Text File Turned into a `.docx`
+
+One script turns a text file of the project (markdown, `.md` or `.txt`) into a Word document with
+the same words and the same numbers, in the same order. When the project has a profile
+(`_opencrew/_memory/documento-oficial.md`: logo, header, footer, margins and font), the document
+comes out on letterhead. Your part is to find out which file, ask about the letterhead when the
+project has none, run the script and show its report.
+
+You do NOT write the `.docx` yourself, and you never change the user's text to make it convert:
+the script reads the file as it is. The writing rules of a text that becomes a document (title,
+sections, page break, signatures) are in `_opencrew/core/best-practices/documento-oficial.md`.
+
+## Step 1: Which file
+
+`/opencrew documento <arquivo>` names the file. With no file (the command alone, or the menu
+option "Documento Word"), ask and wait:
+
+```
+Qual arquivo de texto (.md ou .txt) você quer em Word? Diga o caminho a partir da pasta do projeto (por exemplo, `Atas/ata-de-marco.md`).
+```
+
+- `{arquivo}` is a path inside the project, written from its root. One file per command: for
+  several files, run Steps 3 to 5 once for each.
+- Never guess the file, and never pick one "that looks like it": with a name that matches more
+  than one file, list them and ask.
+
+## Step 2: The letterhead, when the project has none
+
+Check, with the read tool (no command), whether `_opencrew/_memory/documento-oficial.md` exists.
+If it does, go to Step 3: nothing is asked. If it does not, ask and wait:
+
+```
+Este projeto ainda não tem papel timbrado configurado. Quer configurar agora (logotipo, cabeçalho e rodapé)? (sim / não)
+```
+
+- **"Sim"** —
+  1. Run, from the project root: `node _opencrew/core/scripts/documento.mjs --criar-perfil`
+     Its last line is `PERFIL:CRIADO` (the file was created from the model) or `PERFIL:JA-EXISTE`
+     (it was already there and was not touched).
+  2. Ask the user for: the logo (a PNG file of up to 2 MB that is inside the project, with its
+     path from the root — or none), the three lines of the header (the name of the organization;
+     a second line; a third line, such as site and e-mail) and the text of the footer. Any of them
+     may stay empty: what is empty does not appear in the document.
+  3. Fill the file `_opencrew/_memory/documento-oficial.md` with the answers: write only the value
+     after the colon of `logotipo`, `cabecalho_1`, `cabecalho_2`, `cabecalho_3` and `rodape`, each
+     exactly as the user gave it. Leave every other line as it is (comments, margins, font).
+     Never invent a value (a registration number, an address, a slogan), and never copy a logo
+     into the project by yourself: if the file is outside the project, ask the user to put it in.
+- **"Não"** — go on without the profile: the document comes out with no letterhead, with the
+  standard margins and "Página X de Y" in the footer. Do not ask again in this conversation.
+
+After this step the profile belongs to the user. Change it only when the user asks, and only the
+line asked for.
+
+## Step 3: Run the script
+
+From the project root, one line, the path between double quotes:
+
+`node _opencrew/core/scripts/documento.mjs "{arquivo}"`
+
+- **`{arquivo}` was typed by the user and goes into a command** — the safe-name rule (nome seguro)
+  of `_opencrew/core/runner.pipeline.md` applies: between double quotes and only if it is made of
+  letters (accents included), digits, space and `. _ - / \ : ( )`. With any other character do NOT
+  run the command; say
+  `⚠️ O nome `{arquivo}` tem um caractere que não posso usar em comandos ({caractere}). Use só letras, números, espaço, ponto, hífen, sublinhado e parênteses.`
+  and ask for the file again. The same rule holds for every path below.
+- The Word goes next to the text, with the same name (`Atas/ata.md` → `Atas/ata.docx`). Only when
+  the user asks for another place, the command ends with `--saida "{pasta ou arquivo.docx}"`
+  (inside the project; a folder is created if it is missing).
+- Only when the user asks for a document with no letterhead this time, add `--sem-perfil`; only
+  when the user names another profile file, add `--perfil "{arquivo do perfil}"`.
+
+The output of the script is the report: where the document was written, which profile was used,
+the conversion warnings ("Avisos:") and two tips — "Para ter um PDF: abra o documento no Word e
+use Arquivo → Salvar como → PDF." and "O Word é uma cópia do texto. O que você mudar nele não
+volta sozinho: altere o texto e gere de novo.". Show it to the user as it came, without the
+`DOCUMENTO:OK` line. It is fixed PT-BR, whatever the user's language: do not rewrite it.
+
+- `DOCUMENTO:OK` → done. A warning does not change that: it says what stayed as plain text (an
+  image, an unknown `:::` line, a signature block with no closing `:::`) or what was removed (an
+  invalid character). Offer to fix the text and generate again; change the text only on a "sim".
+- "{arquivo} já existe e está igual. Nada a fazer." is also `DOCUMENTO:OK`: nothing was written.
+
+## Step 4: A Word that is already there
+
+When the output is the line "Já existe {arquivo}, diferente do que eu ia gravar. Para trocar, rode
+de novo com --substituir.", nothing was written: there is a different `.docx` at the destination,
+and the user may have edited it in Word. Ask before replacing it, and wait:
+
+```
+Já existe {arquivo}, diferente do que eu ia gravar. Posso substituir? O que foi mudado direto no Word se perde. (sim / não)
+```
+
+- "Sim" → the same command again, ending with `--substituir`.
+- "Não" → nothing is replaced. Offer another name or folder (`--saida`, Step 3).
+
+The first call never has `--substituir`, and a "sim" is worth for that file and that call only.
+
+## Step 5: When the command fails
+
+The command failed when there is no Node, an error, or no `DOCUMENTO:` line at the end (it prints
+one message in PT-BR and stops, with nothing written). Show the message to the user as it came.
+
+- **The message points to something in the command you wrote** (an option, a path, more than one
+  file): fix the command and run it once more.
+- **The message starts with "Perfil, linha {n}:"** (an unknown key, a value out of range, a logo
+  that is missing, is not a PNG or is over 2 MB): the document is not generated with a wrong
+  letterhead. Show the message, ask the user for the right value of that line, write it in the
+  profile and run again. Do not switch to `--sem-perfil` by yourself.
+- **"Não consegui gravar {arquivo}. …"**: the file is open in Word or the folder is syncing. Ask
+  the user to close it and run the same command again.
+- **Anything else**, or the command did not run at all:
+
+  ```
+  ⚠️ A conversão para Word não rodou: {motivo}. O texto continua em {arquivo}.
+  ```
+
+  `{motivo}` is the message the script printed (without its final period), or what kept it from
+  running. Stop there.
+
+Never generate the document by any other means: no other script, no library, no Word or office
+automation, no HTML or RTF saved with another extension. A document made another way would not
+have the same guarantees (the same words, the letterhead of the profile), and the user would not
+know.
+
+## Rules
+
+- **DO** show the report of the script as it came.
+- **DO** ask before `--substituir`, every time.
+- **DO NOT** generate the `.docx` by any other means, even when the script fails.
+- **DO NOT** edit the user's text to remove a warning without a "sim".
+- **DO NOT** write in `_opencrew/_memory/documento-oficial.md` anything the user did not give you.
+- **DO NOT** promise how the document looks in Word: you did not open it. The user checks the
+  header, the pages, the tables and the signatures in Word.

package/templates/_opencrew/core/prompts/entrega.prompt.md

@@ -45,8 +45,8 @@ sozinha. Antes de postar à mão, confira se já saiu."
   `_opencrew/best-practices.local/{format}.md` when that file declares `platform:`, otherwise in
   `_opencrew/core/best-practices/{format}.md`. For a step with no `format:`, the one of the skill
   (`instagram-publisher` → `instagram`). With neither, do not pass the option.
-- `{canal}` is the folder name: `instagram`, `linkedin`, `blog`, `email`, `whatsapp`, `twitter` or
-  `youtube`. Only a channel that has an item in the list (an item whose format has that
+- `{canal}` is the folder name: `instagram`, `linkedin`, `blog`, `email`, `whatsapp`, `twitter`,
+  `youtube` or `documentos` (the folder of `platform: "documento"`). Only a channel that has an item in the list (an item whose format has that
   `platform:`) — for any other the script stops with `Canal não encontrado nesta entrega: {canal}.`
 
 ## Step 3: Run the script
@@ -68,7 +68,8 @@ without the `ENTREGA:` line. Do not rewrite it and do not add files it does not
 `entrega/` folder, the script also writes `crews/{name}/output/{run_id}/verificacao-entrega.md`,
 the report of the check made at delivery time (it is not part of the delivery).
 
-- `ENTREGA:OK` → go on with the run (Step 5 first, when it applies).
+- `ENTREGA:OK` → go on with the run (Step 5 first, when it applies). When the summary has a line
+  `
 - `ENTREGA:COM_RESSALVA` → everything that was missing is a ressalva the user accepted: the
   `LEIA-ME.md` opens with it and the channel is "Pronto, com ressalva"; go on as with `ENTREGA:OK`.
 - `ENTREGA:INCOMPLETA` → a channel is not ready, the destination was refused or a file could not be
@@ -102,7 +103,7 @@ the report of the check made at delivery time (it is not part of the delivery).
     "Não consegui gravar …"): show the message as it came and ask for another folder (Step 5, with
     the new answer) or for a new attempt, which is the same command again. A file of the list that
     does not exist: ask for it, or take it out of the list.
-
+  - **A Word document that was not generated** (the line `
   The first call never has `--aceitar-pendencias`. Outside option 2 it goes only when the user
   already chose "Aceitar assim mesmo" in the review loop of this run and what is missing is only
   what was accepted there: then run the command again with it, without asking.