@aksp/opencrew 1.11.0 → 1.12.0

package/CHANGELOG.md

@@ -3,21 +3,67 @@
 All notable changes to opencrew are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
+## [1.12.0] — 2026-10-07
+
+Fase U5, fatia 1: "Polimento do uso" (`specs/fase-u5a-polimento-do-uso.md`). A U5 é a fase de
+fechamento do projeto, em quatro fatias (`specs/fase-u5-roteiro.md`). Chega a quem já usa com um
+`npx @aksp/opencrew@latest update`.
+
+Ainda não nesta versão: o runner dividido (1.13.0), o histórico confiável e o "retomar" (1.14.0)
+e o pedido avulso à crew (1.15.0).
+
+### Added
+- **Formato `texto-livre`** (o 24º guia): para o texto que não é post nem documento para
+  imprimir ou assinar — proposta, minuta que vira HTML ou PDF, plano, relatório interno. Não tem
+  limite de tamanho, não gera Word, e a entrega leva o arquivo inteiro para `outros/`. O
+  `/opencrew repair` passa a propô-lo para esse tipo de passo.
+- **O que o Word não vai converter aparece antes do revisor.** No passo com
+  `format: documento-oficial`, o verificador avisa de imagem, de marcação `:::` desconhecida e
+  de bloco de assinaturas sem fim. São alertas: quem decide é o revisor.
+- Aviso de conversão quando uma linha de tabela tem mais células que o cabeçalho.
+
+### Changed
+- **O nome da execução (`run_id`) vem do script**, com a data e a hora do computador
+  (`caminho.mjs <crew> pasta`, sem `--run`). Antes a IA montava a hora por conta própria.
+- **Conferência de fontes:** o resumo concorda em número ("1 fonte", "1 alerta"); quando há
+  caminho com sugestão, o relatório diz como corrigir; com `--corrigir`, cada arquivo alterado
+  aparece com o nome da cópia que ficou, e o relatório sai uma vez só.
+- Depois de um conserto por veto, o runner confere o arquivo de novo.
+- O runner não cita mais ferramenta de uma IDE só ("Task tool", `.claude/settings.local.json`).
+- **Perfil de documento oficial:** chave escrita quase certa (`Logotipo:`, `rodapé:`, com
+  espaço antes) agora é erro que diz a grafia certa; antes a linha era ignorada em silêncio.
+- O onboarding grava o `company.md` com seis cabeçalhos fixos e tira a marca
+  `NOT CONFIGURED` dos dois arquivos.
+- A linha "Não medido" some para formato que não declara limite (`documento-oficial`,
+  `texto-livre`).
+- Na entrega sem canal de rede, "O que não foi conferido" não cita imagens nem redes.
+- Prompts de criação: dez contradições que a execução real da 1.11.0 achou ganharam uma frase
+  cada (a pergunta de tier com modelo, `extends:` × "do zero", dependências de agente lidas
+  também do "Context Loading", skills nativas fora da conferência, exemplo de saída com 15
+  linhas, a pergunta 1 quando o comando já traz a descrição, entre outras).
+
+### Fixed
+- **Uma frase errada da 1.11.0.** O `/opencrew repair`, o README e este arquivo diziam que texto
+  sem formato "é medido como post de blog". Isso só acontece quando o arquivo tem `title:` no
+  frontmatter. O que acontece sempre, sem o formato: o redator não recebe o guia do tipo de
+  texto, e o verificador procura no arquivo peças de rede (legenda, post). A frase foi trocada
+  em todos os lugares.
+
 ## [1.11.0] — 2026-10-07
 
 Fase U4, fatia 1: "Conserto de crews e caminho de criação" (`specs/fase-u4a-conserto-de-crews.md`).
 Chega a quem já usa com um `npx @aksp/opencrew@latest update`; as suas crews só mudam quando você
 pede o conserto e diz sim a cada ponto.
 
-Ainda não nesta versão: histórico confiável e pedido avulso à crew (`/opencrew pedir`), que vêm
-na 1.12.0; retomar uma execução interrompida, na 1.13.0. O conserto não reordena passos: crew
+Ainda não nesta versão: histórico confiável, retomar uma execução interrompida e pedido avulso à
+crew (`/opencrew pedir`), que ficaram para a fase U5 (`specs/fase-u5-roteiro.md`). O conserto não reordena passos: crew
 sem revisão, sem aprovação final ou que publica antes da revisão é apontada e resolvida com
 `/opencrew edit`.
 
 ### Added
 - **`/opencrew repair <crew>` conserta crews antigas.** Ele lê a crew e mostra, em português, o
   que falta para as melhorias das versões seguintes valerem nela: passo sem o formato do texto
-  (o verificador media como post de blog), crew sem os arquivos do projeto que deve ler,
+  (o redator ficava sem o guia do tipo de texto), crew sem os arquivos do projeto que deve ler,
   proibição sem trecho entre aspas (que o verificador não consegue barrar), nomes dos agentes,
   passo que publica sem a marca. Conserta um ponto por vez, com o seu sim; cada arquivo alterado
   ganha uma cópia `.bak`. Quem grava é um script (`_opencrew/core/scripts/conserto.mjs`), não a

package/README.md

@@ -185,7 +185,7 @@ meu-projeto/
 │   │   ├── skills.engine.md      ← gerenciador de skills
 │   │   ├── architect.agent.yaml  ← definição do Arquiteto
 │   │   ├── formato-da-crew.md    ← o formato dos arquivos de uma crew (crew.yaml, pipeline.yaml, passos)
-│   │   ├── best-practices/       ← 23 guias de melhores práticas + _catalog.yaml
+│   │   ├── best-practices/       ← 24 guias de melhores práticas + _catalog.yaml
 │   │   ├── scripts/              ← verificador, conferência de fontes, caminhos, entrega, documento Word, conserto de crews 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)
@@ -439,12 +439,15 @@ o que você fez:
   um bloco completo no fim. O bloco começa por um comentário que diz que ele é do OpenCrew: as
   suas linhas ficam fora dele.
 - **E as crews que você já tinha?** O `update` não mexe nelas. Para levar a elas o que veio
-  depois — o formato de cada texto (sem ele o verificador mede tudo como post de blog), os
+  depois — o formato de cada texto (sem ele o redator não recebe o guia do tipo de texto), os
   arquivos do projeto que a crew deve ler, as proibições que o verificador consegue barrar —,
   peça na sua IDE `/opencrew repair <nome>`. Ele mostra o que falta, pergunta antes de cada
   mudança e deixa uma cópia `.bak` do arquivo que alterou. O que não dá para consertar assim
   (crew sem passo de revisão, publicação antes da revisão) ele aponta e manda para
   `/opencrew edit`.
+- **Texto que não é post nem documento para assinar?** Proposta, minuta que outro passo diagrama,
+  plano: o passo recebe o formato `texto-livre`. Não há limite de tamanho, nada vira Word, e a
+  entrega guarda o arquivo como está, em `outros/`.
 - **A instalação anterior parou no meio?** O `update` não altera nada e pede para você rodar
   `npx @aksp/opencrew init`, que conclui a instalação sem apagar o que já existe.
 - **Apagou um modelo de crew ou um skill do catálogo?** Ele volta no `update`, e a saída diz o

package/package.json

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

package/templates/AGENTS.md

@@ -12,7 +12,8 @@ On activation, perform these steps IN ORDER:
 3. Check if company.md is empty or contains only the template — if so, trigger ONBOARDING
    (except for `/opencrew documento` and the request to deliver a run that already ended: neither
    uses the company context)
-4. Otherwise, display the MAIN MENU
+4. Otherwise: when the message carried a command or a request, route it (Command Routing);
+   display the MAIN MENU only when it carried none
 
 ## Onboarding Flow (first time only)
 
@@ -25,8 +26,12 @@ If `company.md` is empty or contains `<!-- NOT CONFIGURED -->`:
    description/sector, target audience, products/services, tone of voice,
    social media profiles
 4. Present findings in a clean summary, ask the user to confirm or correct,
-   save the profile to `_opencrew/_memory/company.md`
-5. Show the main menu
+   save the profile to `_opencrew/_memory/company.md` under these fixed headings, in this order:
+   `## Nome`, `## O que faz`, `## Público`, `## Produtos e serviços`, `## Tom de voz`,
+   `## Site e redes` (under it, the site goes on its own line, `- Site: https://…`). Then remove the line
+   `<!-- NOT CONFIGURED -->` from `company.md` and from `preferences.md`
+5. When the message that started this carried a command or a request, route it now (Command
+   Routing); show the main menu only when it carried none
 
 ## Main Menu
 

package/templates/_opencrew/.opencrew-version

@@ -1 +1 @@
-1.11.0
+1.12.0

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

@@ -119,3 +119,8 @@ catalog:
     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
+
+  - id: texto-livre
+    name: "Texto livre"
+    whenToUse: "Creating agents that write a text with no channel and no Word file: commercial proposal, draft that becomes HTML or PDF, work plan, internal report."
+    file: texto-livre.md

package/templates/_opencrew/core/best-practices/texto-livre.md

@@ -0,0 +1,23 @@
+---
+name: "Texto livre"
+content_type: "plain-text"
+description: "Text with no channel and no Word file: a proposal, a draft that becomes HTML or PDF, a plan, an internal report"
+whenToUse: |
+  Creating agents that write a text that is not a post for a network and is not a document to print or sign: commercial proposal, draft (minuta) that another step turns into HTML or PDF, work plan, internal report, briefing.
+version: "1.0.0"
+---
+
+## Compact Rules
+
+1. Write the full, final text: no outline, no notes to the reader, no "insert here".
+2. No YAML frontmatter and no labels such as `=== TITLE ===`: everything in the file is the text itself.
+3. Use `#`, `##` and `###` for the sections, simple tables for figures, `- ` for lists.
+4. Missing real data is marked `[PREENCHER: o que falta]`; never invent a name, a date, a price or a number.
+5. Copy figures exactly from the file they come from; when a total is shown, the parts add up to it.
+6. Follow the structure the step asks for (its "Output Format"): this guide adds no structure of its own.
+
+## What this format does not do
+
+There is no size limit here and nothing is converted: the delivery keeps the file as it is, in
+`outros/`. For a text to print, sign or file, use `documento-oficial`; for a post, an e-mail or a
+message, use the format of that channel.

package/templates/_opencrew/core/formato-da-crew.md

@@ -132,7 +132,7 @@ outputFile: crews/atas-do-conselho/output/pauta.md   # optional: the user's answ
 |---|---|
 | `execution` | `subagent` runs in the background; `inline` runs in the conversation. A step that publishes or sends is always `inline` |
 | `agent` | the agent id |
-| `format` | every step whose text is checked before the review (from the `on_reject` step up to the review) declares one; without it the checker measures the text as a blog post. A text to print, sign or file is `documento-oficial`. Omit only for research, analysis and the review itself |
+| `format` | every step whose text is checked before the review (from the `on_reject` step up to the review) declares one; without it the writer does not get the guide of that kind of text and the checker looks in the file for pieces of a network (caption, post, blog title). A text to print, sign or file is `documento-oficial`; a text with no channel and no Word file (a proposal, a draft that becomes HTML or PDF, a plan) is `texto-livre`. Omit only for research, analysis and the review itself |
 | `inputFile`, `outputFile` | always under `crews/{code}/output/`; never `pipeline/data/` |
 | `model_tier` | `fast` or `powerful`, only on `subagent` steps. Express: `fast`. Standard: `fast` for research and data gathering, `powerful` for the rest. Full: `powerful`. Inline steps do not carry it |
 | `side_effects: irreversible` | every step that publishes, posts or sends outside the project; such steps come after the review and the final approval |

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

@@ -87,7 +87,7 @@ each. Write every file in that format; what follows here only adds what is speci
       prose of step files and tasks, between backticks, e.g. `` `Ativos/Identidade Visual/logo.png` ``. NEVER write absolute paths
       (`C:/…`, `J:/…`, `/Users/…`): they break as soon as the user moves or syncs the folder.
     - `agent_dependencies:` — derive the entries from the step order: for each agent step, list
-      the agent(s) whose output it reads via `inputFile`.
+      the agent(s) whose output it reads, via `inputFile` or in its "Context Loading" list.
 
 2. **`crews/{code}/crew-party.csv`** — Agent manifest
    - The header row MUST be EXACTLY these columns, in this order:
@@ -450,7 +450,7 @@ that the agent knows exactly what to produce.]
 
 [A COMPLETE, realistic example of what this step should produce.
 This is not a template — it's a fully realized output with realistic content.
-Must be 20+ lines and demonstrate the expected quality, depth, and formatting.
+Must be 15+ lines and demonstrate the expected quality, depth, and formatting.
 The agent uses this as a reference for what "good" looks like.]
 
 ## Veto Conditions
@@ -607,7 +607,7 @@ Additional programmatic checks — read the filesystem to verify:
 - [ ] Every `agent_dependencies` key and value references a real agent `id` from crew-party.csv
 - [ ] All task files referenced in agent frontmatter exist
 - [ ] All step files referenced in `pipeline.yaml` exist
-- [ ] Skills listed in `crew.yaml` are installed in `skills/`
+- [ ] Skills listed in `crew.yaml` are installed in `skills/` (the native ones, `web_search` and `web_fetch`, need no folder)
 - [ ] Best-practices files referenced by `format:` fields in steps exist in `_opencrew/core/best-practices/`
 
 ---

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

@@ -81,7 +81,7 @@ Compile all research into a structured research brief document. This will feed P
 
 After research completes, determine the crew's tier:
 
-1. If a template was used (check `discovery.yaml` → `tier` field is present and not null) → use the template's tier.
+1. If a template was used (`discovery.yaml` has the `template:` field, which the Discovery writes only in that case) → use the `tier` recorded there.
 2. Otherwise, read the default tier from `_opencrew/_memory/preferences.md` → `Default Tier` field.
 3. If neither is set, default to `standard`.
 
@@ -182,7 +182,7 @@ From the crew's purpose and domains (in `discovery.yaml`), identify what human r
 | Domain / Need | Possible Roles |
 |---|---|
 | Research, fact-finding, market analysis | 🔎 Pesquisador — finds trends, maps keywords, does market research |
-| Writing, copy, content creation | ✍️ Redator — writes strategic text based on research, including captions and hooks |
+| Writing, copy, content creation, documents | ✍️ Redator — writes strategic text based on research, including captions and hooks; in a document crew, writes the minutes, the letter, the contract or the proposal |
 | Strategy, positioning, planning | 🧠 Estrategista — defines angles, editorial calendar, competitive positioning |
 | Visual design, image creation | 🎨 Designer — creates visual content aligned with brand identity |
 | Quality review, accuracy check | 🔍 Revisor — validates quality, tone, accuracy against criteria |
@@ -244,7 +244,7 @@ For each approved role, consult this mapping to determine which skills and best-
 | Role | Typical Skills | Typical Best-Practices |
 |------|---------------|----------------------|
 | Pesquisador (Researcher) | `web_search`, `web_fetch` (native) | `researching.md` |
-| Redator (Writer/Copywriter) | `web_search` (native, for fact-checking) | `copywriting.md` + platform-specific format file |
+| Redator (Writer/Copywriter) | `web_search` (native, for fact-checking) | `copywriting.md` + platform-specific format file; for a text to print, sign or file: `documento-oficial.md`; for a text with no channel and no Word file (proposal, draft that becomes HTML or PDF, plan): `texto-livre.md` |
 | Estrategista (Strategist) | `web_search` (native) | `strategist.md` |
 | Designer (Visual Designer) | `image-creator`, `image-ai-generator`, `canva` | `image-design.md` |
 | Revisor (Reviewer) | None required | `review.md` |
@@ -342,7 +342,7 @@ Based on discovery answers + company context + research findings + extracted art
 
 Before designing any agent from scratch, check the shared registry at `_opencrew/agents/`:
 
-1. List available base agents: `ls _opencrew/agents/` — each `.agent.md` file is a reusable base agent
+1. List the files of `_opencrew/agents/` (with your folder-listing tool, no command) — each `.agent.md` file is a reusable base agent
 2. For each role approved in Phase D, check if a matching base agent exists:
    - Pesquisador → `_opencrew/agents/researcher.agent.md`
    - Redator → `_opencrew/agents/copywriter.agent.md`
@@ -380,7 +380,7 @@ Guidelines:
 
 Design the crew with appropriate agents:
 - Follow the deep `.agent.md` format with full sections: Persona (Role, Identity, Communication Style), Principles, Operational Framework, Voice Guidance, Output Examples, Anti-Patterns, Quality Criteria, Integration
-- Design each agent from scratch, informed by the relevant best-practices files read in Phase A
+- Use `extends:` when the Shared Agent Registry Check found a base agent that fits; design from scratch only the agents with no base, informed by the relevant best-practices files read in Phase A
 - Each agent has exactly one clear responsibility
 - Every crew needs a review step for quality control (a reviewer agent in Standard and Full)
 - YAGNI — never create agents that aren't strictly necessary

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

@@ -7,7 +7,7 @@ You are a strategic systems thinker and patient crew architect. You help users a
 ## Communication Style
 
 - One question at a time — never present two questions in the same message
-- Use numbered lists whenever options are available; tell the user to reply with a number
+- Use numbered lists whenever options are available (the user knows what to do: never add "reply with a number")
 - Adapt follow-up questions based on what the user says, not a fixed script
 - Confirm understanding before moving to the next topic
 - Maximum 8 questions total across the entire discovery flow
@@ -70,7 +70,7 @@ If exactly 1 template exists, still offer option 1 ("Começar do zero") as a sec
 Ask:
 > "What do you want this crew to do? Describe the end result you want."
 
-This is always the first question. Accept any answer — a sentence, a paragraph, bullet points. Do NOT assume any domain. Do NOT suggest options at this stage.
+This is always the first question — except when the command already carried the description (`/opencrew create <description>`): then do not ask it again; repeat the description in one sentence and ask only "É isso? Quer acrescentar alguma coisa?". Accept any answer — a sentence, a paragraph, bullet points. Do NOT assume any domain. Do NOT suggest options at this stage.
 
 ---
 
@@ -95,7 +95,7 @@ Save the detected domain as `domain`.
 
 ### Step 3 — Context Exploration (adaptive, ONE question at a time)
 
-Based on the detected domain, ask the most relevant contextual question first. Wait for the answer before asking the next one. Ask at most 2–3 questions in this step.
+Based on the detected domain, ask the most relevant contextual question first. Wait for the answer before asking the next one. Ask at most 3 questions in this step, not counting the project sources question below, which is always asked.
 
 **If domain = `content`:**
 1. Who is this content for? (multiple choice: current customers / potential leads / general audience / other)
@@ -105,7 +105,7 @@ Based on the detected domain, ask the most relevant contextual question first. W
 **If domain = `document`:**
 1. Which documents should the crew produce? (open-ended: ata, ofício, contrato, proposta…)
 2. Who signs each document, and who receives it? (open-ended)
-3. Does the organization have letterhead (logo, header lines, footer) that these documents must carry? (yes / no / not sure — the letterhead itself is set up later, the first time a Word document is generated; here you only record the answer)
+3. Must the text become a Word file, to print, sign or file? (yes / no — "no" is the proposal or the draft that is read in the chat and laid out by hand later: nothing is converted. Only on a "yes", ask in the same message whether the organization has letterhead — logo, header lines, footer; the letterhead itself is set up later, the first time a Word document is generated)
 
 The project sources question below matters most here: ask which files of the project rule the text (bylaws, previous minutes, price table, contract template).
 
@@ -206,7 +206,7 @@ Set `investigation.enabled: false` and continue.
 
 ### Step 6 — Target Formats (content crews ONLY)
 
-If domain = `document`, do not ask: save `target_formats: ["documento-oficial"]`. When the crew also produces a short piece for a channel (a WhatsApp notice, an e-mail to the members), add that format id to the list — pick it from the filenames of `_opencrew/core/best-practices/` — and go on.
+If domain = `document`, do not ask: save `target_formats: ["documento-oficial"]` when the text must become a Word file (question 3 of Step 3), or `["texto-livre"]` when it must not. When the crew also produces a short piece for a channel (a WhatsApp notice, an e-mail to the members), add that format id to the list — pick it from the filenames of `_opencrew/core/best-practices/` — and go on.
 Skip this step entirely for the other non-content domains.
 
 If domain = `content`, ask:
@@ -268,6 +268,7 @@ project_sources:                     # relative to the project root; becomes `fo
     purpose: "{what the crew uses it for}"
 purpose: "{user's description from Step 1}"
 domain: "{document | content | research | automation | analysis | mixed}"
+template: "{template folder name}"    # ONLY when a template was chosen in Step 0; omit the line otherwise
 # When a template was used (Step 0), these fields are populated from discovery.template.yaml:
 domains: []                          # list of domain tags from template (e.g., [content-marketing, seo])
 tier: "standard"                     # from template or preferences Default Tier
@@ -289,7 +290,8 @@ context:
   documents: "{answer from Step 3}"
   signer: "{who signs}"
   recipients: "{who receives}"
-  letterhead: "{yes | no | not sure}"
+  word_file: "{yes | no}"
+  letterhead: "{yes | no | not sure — only when word_file is yes}"
   # For content crews:
   audience: "{answer from Step 3}"
   platforms: "{answer from Step 3}"

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

@@ -37,10 +37,12 @@ Este projeto ainda não tem papel timbrado configurado. Quer configurar agora (l
   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.
+  2. Ask the user three questions, one at a time, with these words (the logo is a PNG file of up
+     to 2 MB inside the project, given by its path from the root):
+     - "Qual é o arquivo do logotipo? (PNG, dentro do projeto. Pode responder 'sem logotipo'.)"
+     - "Quais são as linhas do cabeçalho? Até três: nome da entidade, CNPJ ou registro, endereço."
+     - "Quer um texto no rodapé, além de 'Página X de Y'?"
+     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).
@@ -103,7 +105,9 @@ one message in PT-BR and stops, with nothing written). Show the message to the u
 
 - **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
+- **"Não encontrei {arquivo}." or "Só converto texto…"**: the file is not there, or it is not a
+  `.md` or `.txt`. Show the message and go back to the question of Step 1.
+- **The message starts with "Perfil, linha {n}:"** (an unknown or misspelled 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.

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

@@ -69,7 +69,8 @@ without the `ENTREGA:` line. Do not rewrite it and do not add files it does not
 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). When the summary has a line
-  `
+  that starts with "Sem papel timbrado:", the Word documents came out with no letterhead: say so
+  and offer to set it up (`/opencrew documento`); after the profile exists, deliver again.
 - `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
@@ -103,7 +104,11 @@ 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 `
+  - **A Word document that was not generated** (the line "Não consegui gerar o Word de
+    {arquivo}: …"): show the message as it came; this is never accepted with option 2. When the
+    reason starts with "Perfil, linha {n}:", the letterhead profile has a wrong line: ask the user
+    for the right value, write it in `_opencrew/_memory/documento-oficial.md` and run the same
+    command again.
   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.

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

@@ -52,7 +52,7 @@ codes between brackets, the `--aplicar` lines or the `CONSERTO:` status line.
 |---|---|---|
 | `nome-de-agente` | The agent has no two-word persona name. Propose one by the Agent Naming Convention of `_opencrew/core/prompts/design.prompt.md` (two words with the same initial, a different initial for each agent of the crew), keeping the first name the agent already has, and ask: "O agente {id} está sem nome de pessoa. Proponho {Nome Sobrenome}. Posso gravar?" | `--aplicar "nome:{id}={Nome Sobrenome}"`; the names reach the list of the crew with `manifesto`, below — when `manifesto` is not among the findings, run it right after this one |
 | `manifesto` | "O arquivo de nomes da crew está incompleto; por isso aparece a função no lugar do nome. Posso refazer a partir dos arquivos dos agentes?" | `--aplicar "manifesto"` |
-| `formato` | Read each listed step and propose one format per step, among the files of `_opencrew/core/best-practices/` (and `_opencrew/best-practices.local/`). A text to print, sign or file — ata, ofício, contrato, minuta, proposta, parecer — gets `documento-oficial`. Then: "Estes passos não dizem que tipo de texto produzem; sem isso, o verificador mede cada um como post de blog. Minha proposta: {passo → formato}. Posso gravar assim?" | one `--aplicar "formato:{passo}={formato}"` per step |
+| `formato` | Read each listed step and propose one format per step, among the files of `_opencrew/core/best-practices/` (and `_opencrew/best-practices.local/`). A text that must become a Word file to print, sign or file — ata, ofício, contrato, parecer — gets `documento-oficial`; a text with no channel that does not become a Word file (a plan, an internal report, a proposal or a draft that becomes HTML or PDF) gets `texto-livre`. When you cannot tell which of the two it is (a proposta, a minuta), ask first: "O texto do passo {n} precisa virar um arquivo Word para imprimir ou assinar?" — sim: `documento-oficial`; não: `texto-livre`. When the user refuses your proposal and says what the text is, propose once more with the right format. Then: "Estes passos não dizem que tipo de texto produzem; sem isso, o redator não recebe o guia do tipo de texto e o verificador procura no arquivo peças de rede. Minha proposta: {passo → formato}. Posso gravar assim?" | one `--aplicar "formato:{passo}={formato}"` per step |
 | `fontes` | "Esta crew não registra os arquivos do projeto que ela deve ler antes de escrever. Quais arquivos ou pastas ela precisa conhecer? (Pode responder 'nenhum'.)" Confirm that each one exists (search the project when only a name was given) and ask what the crew uses it for | one `--aplicar "fonte:{caminho}={para que}"` per file or folder, the path relative to the project root |
 | `proibicao` | For each listed item: "Esta proibição não tem um trecho entre aspas, então o verificador não consegue barrar: «{item}». Qual trecho exato devo barrar? Se for uma regra de conteúdo, e não uma palavra ou expressão, responda 'revisão humana': ela fica para o revisor." The excerpt must be words of the item itself | `--aplicar "proibicao:{n}={trecho}"` or `--aplicar "proibicao:{n}=revisao-humana"` |
 | `irreversivel` | For each listed step: "O passo {n} é feito por um agente que tem uma ferramenta de publicar ou enviar ({skill}). Este passo publica ou envia alguma coisa para fora do projeto? Se sim, marco o passo para que ele nunca seja repetido sozinho." | `--aplicar "irreversivel:{n}"` only for a yes |

package/templates/_opencrew/core/runner.pipeline.md

@@ -121,7 +121,7 @@ Before starting execution:
       - If yes → read `_opencrew/core/skills.engine.md`, follow Operation 2 (Install)
       - If no → **ERROR**: stop pipeline
    b. Read SKILL.md, parse frontmatter for type
-   c. If type: mcp, verify MCP is configured in `.claude/settings.local.json`
+   c. If type: mcp, verify the MCP server is configured in your IDE's MCP configuration (the project's `.mcp.json`, or the file your IDE uses)
       - If missing → **ERROR**: "Skill '{skill}' MCP not configured. Reinstall the skill."
    All skills must resolve successfully before the pipeline starts (fail fast).
 4. **Model tiers**: a `subagent` step declares its own `model_tier` (`fast` or `powerful`), set at crew creation by the crew's tier; inline steps carry none.
@@ -217,11 +217,11 @@ Before starting execution:
    ```
    When the selection step was skipped (no `agent_dependencies:` in crew.yaml), this is
    identical to today: all agents listed, no Skipped line.
-5b. **Initialize run folder**: Generate a unique run ID for this execution:
-   - Format: `YYYY-MM-DD-HHmmss` using the current timestamp (e.g. `2026-03-03-143022`)
-   - Check (folder-listing tool, no command) if `crews/{name}/output/{run_id}/` already exists
-     - If it does (sub-second collision), append `-2`, `-3`, etc. until the folder does not exist
-   - Create the folder: run the `pasta` command (see "Output Path Transformation" below) — never create a folder by command yourself
+5b. **Initialize run folder**: the script names the run — never build the date or the time yourself:
+   - Run the `pasta` command (see "Output Path Transformation" below). It creates the folder of this run and answers `CAMINHO:OK crews/{name}/output/{run_id}`
+   - The `run_id` is the last segment of that path: `YYYY-MM-DD-HHmmss` from the computer's clock (e.g. `2026-03-03-143022`; `-2`, `-3` when that folder already exists)
+   - The date of this run, wherever one is asked below, is the first 10 characters of the `run_id`
+   - Never create a folder by command yourself
    - Store `run_id` in working memory for this run — it will be used for ALL output paths
 6. **Escritório** — if it is on, run `iniciar`, then one `pular` per deselected agent, one after the other (see "Escritório" below).
 
@@ -230,7 +230,7 @@ Before starting execution:
 A local page that shows the crew at work, off by default. Follow this section only when the
 already-loaded `preferences.md` has `Dashboard: enabled` (written `- **Dashboard:** enabled` or
 plain `Dashboard: enabled`, any letter case); otherwise run none of these commands. When it is on,
-run via Bash, from the project root, the one-line command of each moment:
+run, from the project root, the one-line command of each moment:
 
 | Moment | Command |
 |---|---|
@@ -448,7 +448,7 @@ root the one-line command of each moment and read the last line (`CAMINHO:OK {pa
 
 | Moment | Command |
 |---|---|
-| Start of the run (Initialization, step 5b) | `node _opencrew/core/scripts/caminho.mjs "{name}" pasta --run "{run_id}"` |
+| Start of the run (Initialization, step 5b) | `node _opencrew/core/scripts/caminho.mjs "{name}" pasta` (no `--run`: the script creates the `run_id`) |
 | Before a step, for its `inputFile` | `node _opencrew/core/scripts/caminho.mjs "{name}" entrada --run "{run_id}" --arquivo "{inputFile}"` |
 | Before a step writes, for the first `outputFile` of each group | `node _opencrew/core/scripts/caminho.mjs "{name}" saida --run "{run_id}" --arquivo "{outputFile}"` |
 | After a step wrote, for each output file | `node _opencrew/core/scripts/caminho.mjs "{name}" conferir --arquivo "{path}"` |
@@ -476,7 +476,7 @@ root the one-line command of each moment and read the last line (`CAMINHO:OK {pa
   and reads `…/v1/pesquisa.md`. Never assume `v1`.
 - **Script that does not run** (no Node, an error, or no `CAMINHO:` line): tell the user once per
   run `Não consegui rodar a conferência de caminhos; sigo pela regra escrita e marco os arquivos como não verificados.`,
-  build the path by the rule above (the Write tool creates the folder) and continue. A file handled
+  build the path by the rule above (your file-writing tool creates the folder) and continue. A file handled
   this way skips its gate and is listed at the final approval:
   `{arquivo} — não verificado: a conferência de caminhos não rodou`.
 
@@ -518,10 +518,10 @@ root the one-line command of each moment and read the last line (`CAMINHO:OK {pa
 - Read the step's `model_tier` frontmatter field (if present).
   Valid values: `fast` or `powerful`. If absent or any other value: default to `powerful`.
 - **Before building the subagent prompt**: Resolve all output paths referenced in the step file with the `saida` command (Output Path Transformation, once per group). Store the transformed path(s) in working memory — they will be used both in the prompt and in post-completion verification. Never pass raw paths from the step file to the subagent.
-- Use the Task tool to dispatch the step as a subagent:
+- Dispatch the step with your IDE's subagent mechanism (an IDE without one: run the step inline, in this conversation):
   - If `model_tier: fast`: use the fastest/lightest model available in your current IDE.
   - If `model_tier: powerful` or absent/invalid: use the default model (no model override needed)
-- In the Task prompt, include:
+- In the subagent's prompt, include:
   - The full agent persona from the party CSV
   - The full agent `.agent.md` content (persona, principles, voice guidance, anti-patterns)
   - If the agent has tasks: include ALL task files in order with instructions to execute sequentially, piping output from each task to the next
@@ -558,16 +558,16 @@ root the one-line command of each moment and read the last line (`CAMINHO:OK {pa
   (e.g. the organization's name, the main audience), ask: "Isso vale para todas as crews?
   Atualizo o perfil da empresa?" — change `company.md` only after a yes.
 - **If the step frontmatter contains `outputFile`**: after collecting the user's full response,
-  insert only the run_id in the `outputFile` path (item 1 of the rule in Output Path Transformation — no version folder, no `saida` command), then write the response to that path using the Write tool (it creates the folder) before moving to the next step. Checkpoint files are user input captures, not versioned output: they live in the group itself, where `entrada` finds them.
+  insert only the run_id in the `outputFile` path (item 1 of the rule in Output Path Transformation — no version folder, no `saida` command), then write the response to that path with your file-writing tool (it creates the folder) before moving to the next step. Checkpoint files are user input captures, not versioned output: they live in the group itself, where `entrada` finds them.
   For the checkpoint that precedes the researcher, use this format:
   ```
   # Research Focus
 
   **Topic:** {user's typed topic}
   **Time Range:** {selected time range label, e.g., "Últimos 7 dias"}
-  **Date:** {today's date in YYYY-MM-DD format}
+  **Date:** {the date of this run, YYYY-MM-DD}
   ```
-  For any other checkpoint: `# {the checkpoint's title}`, the user's answer as given (the option chosen and every comment), and `**Date:** {today, YYYY-MM-DD}`.
+  For any other checkpoint: `# {the checkpoint's title}`, the user's answer as given (the option chosen and every comment), and `**Date:** {the date of this run, YYYY-MM-DD}`.
   This file is the `inputFile` of the step that follows.
 
 ### Post-Step Output Validation
@@ -599,7 +599,7 @@ After a step produces output (subagent or inline) and BEFORE Veto Condition Enfo
 - If the step does not declare an `outputFile` (e.g., steps that only produce inline console output) → skip output validation.
 - Checkpoint steps (`type: checkpoint`) are exempt — their output is the user's response, not a file.
 
-**IMPORTANT**: Do NOT rely on reading the file with the Read tool to "verify" output. The Read tool returns content that can be misinterpreted. Use ONLY the `conferir` command — its last line is binary and cannot be hallucinated.
+**IMPORTANT**: Do NOT rely on reading the file yourself to "verify" output: what you read can be misinterpreted. Use ONLY the `conferir` command — its last line is binary and cannot be hallucinated.
 
 ### Output Contract Validation
 
@@ -643,7 +643,7 @@ After an agent completes a step (before moving to the next step):
    - Check each condition (e.g., "slides exceed 30 words", "no CTA", "missing sources")
 3. If ANY veto condition is triggered:
    - Inform user: "⚠️ {Agent Name}'s output triggered a veto: {condition}"
-   - Ask the agent to fix the specific issue (re-execute with targeted correction)
+   - Ask the agent to fix the specific issue (re-execute with targeted correction), then run the `conferir` command on the rewritten file again (Post-Step Output Validation) before judging the veto once more
    - Maximum 2 veto fix attempts per step
    - After 2 failed attempts, present to user for manual decision
    - **Never auto-fix an irreversible step** (`side_effects: irreversible`): re-executing it
@@ -778,7 +778,7 @@ One script turns the approved files into `crews/{name}/output/{run_id}/entrega/`
    Then proceed to prepend the new row.
 
    Read `crews/{name}/_memory/runs.md`. Prepend one new row to the table (immediately after the header row), with:
-   - `Data`: today's date in YYYY-MM-DD format
+   - `Data`: the date of this run (the first 10 characters of the `run_id`)
    - `Run ID`: the `run_id` for this execution
    - `Tema`: the topic or user request from this run (1 sentence max)
    - `Output`: brief description of what was generated (e.g., "Carrossel 9 slides", "Thread 7 posts")

package/templates/_opencrew/core/scripts/caminho/argumentos.mjs

@@ -41,7 +41,9 @@ export function erroDeArgumentos({ crew, acao, run, arquivo, secoes }) {
   if (!crew) return 'Falta o nome da crew.';
   if (!acao) return `Falta a ação. Ações: ${LISTA}.`;
   if (!ACOES.includes(acao)) return `Ação desconhecida: ${limpar(acao)}. Ações: ${LISTA}.`;
-  if (acao !== 'conferir' && !run) return MSG.faltaOpcao('--run');
+  // `pasta` sem --run: o script dá o nome à execução (data e hora do computador).
+  if (acao !== 'conferir' && acao !== 'pasta' && !run) return MSG.faltaOpcao('--run');
+  if (run === '') return MSG.faltaOpcao('--run'); // `--run` sem valor não vira "sem --run"
   if (run !== undefined && !RUN.test(run)) return 'O --run só aceita letras, dígitos, ponto, sublinhado e hífen.';
   if (acao !== 'pasta' && !arquivo) return MSG.faltaOpcao('--arquivo');
   if (secoes !== undefined && !INTEIRO.test(secoes)) return 'O --secoes é um número inteiro a partir de 1.';

package/templates/_opencrew/core/scripts/caminho/nucleo.mjs

@@ -29,6 +29,22 @@ export function naExecucao(declarado, crew, run) {
   return { grupo: [`${saida}${run}`, ...partes].join('/'), nome };
 }
 
+const dois = (n) => String(n).padStart(2, '0');
+
+/**
+ * O nome de uma execução nova: `AAAA-MM-DD-HHmmss` na hora local; se já existe pasta com esse
+ * nome, `-2`, `-3`… (spec fase-u5a-polimento-do-uso.md, decisão 2).
+ * @param {Date} agora · @param {string[]} existentes as pastas que já estão em `output/`
+ */
+export function novoRun(agora, existentes) {
+  const base = `${agora.getFullYear()}-${dois(agora.getMonth() + 1)}-${dois(agora.getDate())}-${dois(agora.getHours())}${dois(agora.getMinutes())}${dois(agora.getSeconds())}`;
+  const usados = new Set(existentes);
+  for (let n = 1; ; n++) {
+    const nome = n === 1 ? base : `${base}-${n}`;
+    if (!usados.has(nome)) return nome;
+  }
+}
+
 /** O número de uma pasta de versão (`v` + número), ou `null` para qualquer outro nome. */
 function numero(nome) {
   const [, digitos] = /^v(\d{1,9})$/.exec(nome) ?? [];

package/templates/_opencrew/core/scripts/caminho.mjs

@@ -2,7 +2,8 @@
 // Caminho da execução de uma crew: diz onde cada passo grava, de onde lê e se o arquivo gravado
 // está lá. Quem calcula é este script, igual em qualquer sistema — a IA não monta o caminho.
 // Uso (na pasta do projeto): node _opencrew/core/scripts/caminho.mjs <crew> <ação> --run <id> [opções]
-//   pasta    --run <id>                       cria crews/<crew>/output/<id>/
+//   pasta    [--run <id>]                     cria crews/<crew>/output/<id>/; sem --run, o id é a
+//                                             data e a hora do computador (AAAA-MM-DD-HHmmss)
 //   saida    --run <id> --arquivo <declarado> onde o passo grava (abre a pasta de versão seguinte)
 //   entrada  --run <id> --arquivo <declarado> a saída mais nova desse arquivo
 //   conferir --arquivo <caminho já resolvido> [--secoes N] [--tldr]
@@ -17,7 +18,7 @@
 import path from 'node:path';
 import { MSG, dentroDoProjeto, ehPrincipal, realDentroDe } from './comum.mjs';
 import { USO, erroDeArgumentos, lerArgs, limpar } from './caminho/argumentos.mjs';
-import { MOTIVO, daMaisNova, motivoDeReprovacao, naExecucao, normalizar, proximaVersao } from './caminho/nucleo.mjs';
+import { MOTIVO, daMaisNova, motivoDeReprovacao, naExecucao, normalizar, novoRun, proximaVersao } from './caminho/nucleo.mjs';
 import { criarPasta, ehPasta, lerTexto, pastasDe, temConteudo } from './caminho/disco.mjs';
 
 const ok = (caminho) => `CAMINHO:OK ${caminho}`;
@@ -31,7 +32,8 @@ const reprovado = (motivo) => `CAMINHO:REPROVADO ${motivo}`;
  */
 function erroDoArquivo(raiz, crew, { acao, run, arquivo }) {
   if (!dentroDoProjeto(raiz, arquivo)) return MSG.foraDoProjeto(limpar(arquivo));
-  const local = acao === 'conferir' ? null : naExecucao(arquivo, crew, run);
+  // `pasta` não usa arquivo, e `conferir` recebe o caminho já resolvido: nenhum dos dois o põe na execução.
+  const local = acao === 'conferir' || acao === 'pasta' ? null : naExecucao(arquivo, crew, run);
   if (!local) return null;
   if (!local.nome) return `Falta o nome do arquivo em --arquivo: ${limpar(arquivo)}`;
   const execucao = path.resolve(raiz, 'crews', crew, 'output', run);
@@ -88,23 +90,24 @@ function conferir(raiz, { arquivo, secoes, tldr }) {
   return motivo ? reprovado(motivo) : ok(caminho);
 }
 
-function responder(raiz, crew, args) {
+function responder(raiz, crew, args, agora) {
   if (args.acao === 'saida') return saida(raiz, crew, args);
   if (args.acao === 'entrada') return entrada(raiz, crew, args);
   if (args.acao === 'conferir') return conferir(raiz, args);
-  const pasta = `crews/${crew}/output/${args.run}`;
+  const run = args.run || novoRun(agora(), pastasDe(path.resolve(raiz, 'crews', crew, 'output')));
+  const pasta = `crews/${crew}/output/${run}`;
   criarPasta(path.resolve(raiz, pasta));
   return ok(pasta);
 }
 
 /**
  * @param {string[]} argv
- * @param {object} [deps] `cwd` (a pasta do projeto) e `escrever`
+ * @param {object} [deps] `cwd` (a pasta do projeto), `escrever` e `agora` (o relógio, para o id da execução)
  * @returns {number} 0 = a linha `CAMINHO:` saiu · 1 = erro de uso, ou falha ao ler ou criar pasta
  *   (a linha de uso e o motivo, ou só o erro; sem linha `CAMINHO:`)
  */
 export function main(argv, deps = {}) {
-  const { cwd = process.cwd(), escrever = (s) => process.stdout.write(`${s}\n`) } = deps;
+  const { cwd = process.cwd(), escrever = (s) => process.stdout.write(`${s}\n`), agora = () => new Date() } = deps;
   const args = lerArgs(argv);
   const local = localizar(cwd, args);
   if (local.erro) {
@@ -113,7 +116,7 @@ export function main(argv, deps = {}) {
     return 1;
   }
   try {
-    escrever(responder(cwd, local.crew, args));
+    escrever(responder(cwd, local.crew, args, agora));
     return 0;
   } catch (erro) {
     escrever(`Não consegui resolver o caminho: ${limpar(erro?.message ?? erro)}`);

package/templates/_opencrew/core/scripts/conferir-fontes/relatorio.mjs

@@ -7,7 +7,8 @@ const plural = (n, um, varios) => `${n} ${n === 1 ? um : varios}`;
 
 export const MSG = {
   nadaACorrigir: 'Nada a corrigir.',
-  corrigidos: (n) => `${plural(n, 'caminho corrigido', 'caminhos corrigidos')} (cópia .bak ao lado de cada arquivo alterado).\n`,
+  corrigido: (arquivo, copia) => `Corrigi: ${arquivo} (cópia: ${copia})`,
+  comoCorrigir: 'Para trocar os caminhos que têm sugestão, rode de novo com --corrigir (cada arquivo alterado ganha uma cópia).',
   semCorrecaoAutomatica: (n) => `Não há correção automática para ${n} pendência(s): escolha um candidato ou corrija o caminho na crew.`,
   buscaParcial: (limite) => `Procurei só nos primeiros ${limite} itens do projeto; pode existir um arquivo com esse nome que eu não vi.`,
   linkParaFora: (arquivo) => `Não corrigi \`${arquivo}\`: é um link que aponta para fora da crew. O caminho citado nele continua como estava.`,
@@ -59,6 +60,7 @@ export function formatar(r) {
   }
   if (apontados.length) linhas.push(''); // sem pendência nem alerta, uma linha em branco só
   const alertas = contar('nao-portatil') + contar('nao-conferido');
-  linhas.push(`**Resumo: ${r.refs.length} fontes — ${contar('ok')} ok, ${contar('faltando')} pendentes, ${alertas} alertas**`, '');
+  const pendentes = contar('faltando');
+  linhas.push(`**Resumo: ${plural(r.refs.length, 'fonte', 'fontes')} — ${contar('ok')} ok, ${plural(pendentes, 'pendente', 'pendentes')}, ${plural(alertas, 'alerta', 'alertas')}**`, '');
   return linhas.join('\n');
 }

package/templates/_opencrew/core/scripts/conferir-fontes.mjs

@@ -87,18 +87,17 @@ export async function conferir({ raiz, crew, limite = LIMITE_DA_BUSCA }) {
   return { crew, raiz, refs, status, buscaParcial: Boolean(ctx.indice?.parcial), limite };
 }
 
+/** @returns {Promise<string>} o caminho da cópia que ficou */
 async function copiaDeSeguranca(arquivo) {
   const bak = existsSync(`${arquivo}.bak`) ? `${arquivo}.bak-${new Date().toISOString().replace(/[:.]/g, '-')}` : `${arquivo}.bak`;
   await copyFile(arquivo, bak);
+  return bak;
 }
 
-/** Regrava a citação num arquivo; a cópia .bak é feita uma vez por arquivo. */
+/** Regrava a citação num arquivo; a cópia .bak é feita uma vez por arquivo (`tocados`: arquivo → cópia). */
 async function regravar(arquivo, item, tocados) {
   const texto = await readFile(arquivo, 'utf8');
-  if (!tocados.has(arquivo)) {
-    await copiaDeSeguranca(arquivo);
-    tocados.add(arquivo);
-  }
+  if (!tocados.has(arquivo)) tocados.set(arquivo, await copiaDeSeguranca(arquivo));
   await writeFile(arquivo, trocarCitacao(texto, item, path.basename(arquivo) === 'crew.yaml'));
 }
 
@@ -118,9 +117,10 @@ function guardaDeEscrita(raiz, crew) {
  * Troca, nos arquivos da crew, cada caminho com sugestão única — só a citação que a coleta leu,
  * nunca um pedaço de outro texto. O que a guarda de escrita barra não muda: `avisar` recebe uma
  * linha por arquivo pulado, ou uma só quando a crew inteira é um link para fora do projeto.
+ * `gravado` recebe cada arquivo alterado e a cópia que ficou dele.
  * @returns quantos caminhos foram gravados, em ao menos um arquivo
  */
-export async function corrigir({ resultado, avisar = () => {} }) {
+export async function corrigir({ resultado, avisar = () => {}, gravado = () => {} }) {
   const { raiz, crew } = resultado;
   const comSugestao = resultado.refs.filter((i) => i.sugestao && i.estado !== 'ok');
   const podeGravar = comSugestao.length ? guardaDeEscrita(raiz, crew) : null;
@@ -128,7 +128,7 @@ export async function corrigir({ resultado, avisar = () => {} }) {
     if (comSugestao.length) avisar(MSG.crewLigadaParaFora(crew));
     return 0;
   }
-  const tocados = new Set();
+  const tocados = new Map();
   const pulados = new Set();
   let gravados = 0;
   for (const item of comSugestao) {
@@ -138,19 +138,22 @@ export async function corrigir({ resultado, avisar = () => {} }) {
     if (dentro.length) gravados += 1;
   }
   for (const arquivo of pulados) avisar(MSG.linkParaFora(relativoAoProjeto(raiz, arquivo)));
+  for (const [arquivo, copia] of tocados) gravado(relativoAoProjeto(raiz, arquivo), path.basename(copia));
   return gravados;
 }
 
-/** --corrigir: troca o que tem sugestão única, diz o que pulou e quantas pendências ficam sem correção. */
+/**
+ * --corrigir: troca o que tem sugestão única e diz cada arquivo alterado, com a cópia; o relatório
+ * sai uma vez só — o de depois, quando algo mudou. Diz também o que pulou e o que ficou sem correção.
+ */
 async function corrigirEAvisar(r, escrever) {
   const pulados = [];
-  const n = await corrigir({ resultado: r, avisar: (linha) => pulados.push(linha) });
-  let atual = r;
-  if (n) {
-    escrever(MSG.corrigidos(n));
-    atual = await conferir({ raiz: r.raiz, crew: r.crew });
-    escrever(formatar(atual));
-  }
+  const feitos = [];
+  const n = await corrigir({ resultado: r, avisar: (linha) => pulados.push(linha), gravado: (arquivo, copia) => feitos.push(MSG.corrigido(arquivo, copia)) });
+  const atual = n ? await conferir({ raiz: r.raiz, crew: r.crew }) : r;
+  for (const linha of feitos) escrever(linha);
+  if (n) escrever('');
+  escrever(formatar(atual));
   for (const linha of pulados) escrever(linha);
   const semSugestao = atual.refs.filter((i) => i.estado === 'faltando' && !i.sugestao).length;
   if (semSugestao) escrever(MSG.semCorrecaoAutomatica(semSugestao));
@@ -177,8 +180,11 @@ export async function main(argv, { cwd = process.cwd(), escrever = (s) => proces
   }
   try {
     let r = await conferir({ raiz: cwd, crew });
-    escrever(formatar(r));
     if (argv.includes('--corrigir')) r = await corrigirEAvisar(r, escrever);
+    else {
+      escrever(formatar(r));
+      if (r.refs.some((i) => i.sugestao && i.estado !== 'ok')) escrever(MSG.comoCorrigir);
+    }
     escrever(`FONTES:${r.status}`);
     return 0;
   } catch (erroDeLeitura) {

package/templates/_opencrew/core/scripts/conserto/achados.mjs

@@ -52,7 +52,7 @@ function formato(crew) {
   const n = passos.length;
   return [
     `${n} ${plural(n, 'passo que a revisão confere não diz', 'passos que a revisão confere não dizem')} o formato do texto.`,
-    `Sem o formato, o verificador mede ${plural(n, 'esse texto', 'cada um')} como post de blog.`,
+    'Sem o formato, o redator não recebe o guia desse tipo de texto, e o verificador procura no arquivo peças de rede (legenda, post, título de blog).',
     `Passos: ${passos.map((p) => `${p.numero} (${saidaDe(p)})`).join(', ')}`,
     'Para consertar: --aplicar "formato:<passo>=<formato>"',
   ];

package/templates/_opencrew/core/scripts/documento/markdown.mjs

@@ -37,6 +37,7 @@ function lerTabela(linhas, i, estado) {
   while (fim < linhas.length && linhas[fim].trim() && linhas[fim].includes('|')) fim++;
   const brutas = [linhas[i], ...linhas.slice(i + 2, fim)].map(celulas);
   const colunas = Math.max(...brutas.map((l) => l.length));
+  estado.avisos.celulas += brutas.slice(1).filter((l) => l.length > brutas[0].length).length;
   const completas = brutas.map((l) => [...l, ...Array(colunas - l.length).fill('')]);
   estado.por({ tipo: 'tabela', linhas: completas.map((l) => l.map((c) => lerLinha(c, estado.avisos))) });
   return fim;
@@ -56,7 +57,7 @@ function lerBloco(linha, avisos) {
 
 /** Onde os blocos se juntam: a quebra de página pedida vale para o próximo bloco, uma vez só. */
 function novoEstado() {
-  const estado = { blocos: [], avisos: { imagens: 0, desconhecidas: 0, semFim: 0, invalidos: 0 }, quebra: false };
+  const estado = { blocos: [], avisos: { imagens: 0, desconhecidas: 0, semFim: 0, invalidos: 0, celulas: 0 }, quebra: false };
   estado.por = (bloco) => {
     estado.blocos.push(estado.quebra ? { ...bloco, quebra: true } : bloco);
     estado.quebra = false;

package/templates/_opencrew/core/scripts/documento/pacote.mjs

@@ -22,6 +22,7 @@ function avisosDe(c) {
     c.imagens && plural(c.imagens, '1 imagem não incluída: o Word não leva imagem no texto.', '{n} imagens não incluídas: o Word não leva imagem no texto.'),
     c.desconhecidas && plural(c.desconhecidas, '1 linha com marcação desconhecida (`:::`) ficou como texto.', '{n} linhas com marcação desconhecida (`:::`) ficaram como texto.'),
     c.semFim && plural(c.semFim, 'Bloco de assinaturas sem a linha `:::` no fim: ficou como texto.', '{n} blocos de assinaturas sem a linha `:::` no fim: ficaram como texto.'),
+    c.celulas && plural(c.celulas, '1 linha de tabela com mais células que o cabeçalho: a coluna a mais ficou sem título.', '{n} linhas de tabela com mais células que o cabeçalho: a coluna a mais ficou sem título.'),
     c.invalidos && plural(c.invalidos, '1 caractere inválido removido.', '{n} caracteres inválidos removidos.'),
   ].filter(Boolean);
 }

package/templates/_opencrew/core/scripts/documento/perfil.mjs

@@ -10,6 +10,7 @@ export const PADRAO = Object.freeze({
 
 export const MSG = {
   chave: (n, chave) => `Perfil, linha ${n}: não conheço a chave ${chave}.`,
+  grafia: (n, certa) => `Perfil, linha ${n}: a chave se escreve ${certa}: em minúsculas, sem acento, no começo da linha e sem espaço antes dos dois-pontos.`,
   valor: (n, chave, esperado, valor) => `Perfil, linha ${n}: ${chave} precisa ser ${esperado}. Recebi: ${valor}.`,
 };
 
@@ -38,6 +39,17 @@ const CHAVES = {
   tamanho_corpo_pt: { esperado: 'um número de 8 a 14 (aceita meio ponto)', ler: (valor) => (numero(valor) >= 8 && numero(valor) <= 14 && Number.isInteger(numero(valor) * 2) ? numero(valor) : undefined) },
 };
 
+// Linha que parece "chave: valor" mas não foi lida como chave: maiúscula, acento ou espaço antes.
+const QUASE = /^[ \t]*([\p{L}0-9_]+)[ \t]*:(?!\/\/)/u;
+const semAcento = (s) => s.normalize('NFD').replace(/\p{Diacritic}/gu, '').toLowerCase();
+
+/** A chave conhecida que a linha quis escrever, quando não a escreveu do jeito certo; senão, null. */
+function chaveQuaseCerta(linha) {
+  const [, escrita] = QUASE.exec(linha) ?? [];
+  const certa = escrita ? semAcento(escrita) : '';
+  return Object.hasOwn(CHAVES, certa) && !linha.startsWith(`${certa}:`) ? certa : null;
+}
+
 /** Tira as aspas em volta do valor, se as duas pontas têm a mesma. */
 function semAspas(valor) {
   const v = valor.trim();
@@ -58,6 +70,8 @@ export function lerPerfil(bruto) {
   const semBom = bruto.charCodeAt(0) === 0xfeff ? bruto.slice(1) : bruto;
   for (const [i, linha] of semBom.split(/\r\n?|\n/).entries()) {
     const [, chave, escrito = ''] = LINHA.exec(linha.trimEnd()) ?? [];
+    const quase = chave ? null : chaveQuaseCerta(linha);
+    if (quase) return { perfil, linhas, erro: MSG.grafia(i + 1, quase) };
     if (!chave) continue;
     if (!Object.hasOwn(CHAVES, chave)) return { perfil, linhas, erro: MSG.chave(i + 1, chave) };
     linhas[chave] = i + 1;

package/templates/_opencrew/core/scripts/entrega/pendencias.mjs

@@ -14,6 +14,8 @@ export const MSG = {
 };
 /** A lista fixa do que o script nunca confere. */
 export const NUNCA_CONFERIDO = ['Links e fatos citados no texto.', 'Texto dentro das imagens.', 'Aparência final em cada rede.'];
+/** Canal que não é de rede: nele não há imagem a publicar nem aparência de rede a conferir. */
+const SEM_REDE = new Set(['documentos']);
 
 const ehNaoMedido = (i) => i.item === NAO_MEDIDO || i.item === NAO_VERIFICADO;
 const origem = (arquivo) => `origem: \`${arquivo}\``;
@@ -63,7 +65,8 @@ export function naoConferido(raiz, itens, r) {
     }
   }
   if (r.naoTexto.length) linhas.push(`${NAO_VERIFICADO} — não é texto: ${r.naoTexto.join(', ')}`);
-  return [...linhas, ...NUNCA_CONFERIDO];
+  const temRede = itens.some((i) => i.canal && !SEM_REDE.has(i.canal));
+  return [...linhas, ...(temRede ? NUNCA_CONFERIDO : NUNCA_CONFERIDO.slice(0, 1))];
 }
 
 const LIMITE = { legenda: 'caption_max_chars', post: 'post_max_chars', tweet: 'tweet_max_chars' };

package/templates/_opencrew/core/scripts/entrega/separar.mjs

@@ -80,7 +80,8 @@ function separarPecas(item, texto, itens, p) {
 async function separarItem(item, itens, p) {
   if (ehEditavel(item, itens)) return p.copias.push(copia(item, EDITAVEIS, 'editavel'));
   if (!item.canal) {
-    p.avisos.push({ pasta: OUTROS, tela: MSG.semCanal(item.rel) });
+    // `texto-livre` é o formato de quem não tem canal: estar em `outros/` é o esperado, não um aviso.
+    if (item.formato !== 'texto-livre') p.avisos.push({ pasta: OUTROS, tela: MSG.semCanal(item.rel) });
     return p.copias.push(copia(item, OUTROS, 'copia'));
   }
   // Documento oficial: vai inteiro, sem procura de peças; `documentos.mjs` converte o texto em Word.

package/templates/_opencrew/core/scripts/verificar/documento.mjs

@@ -0,0 +1,20 @@
+// O que o Word não vai converter, visto antes do revisor: no texto de formato `documento-oficial`
+// o verificador lê as mesmas marcações que o conversor e põe um alerta para cada tipo de sobra.
+// Alerta, nunca bloqueio: quem decide é o revisor. Spec: fase-u5a-polimento-do-uso.md, regra 6.
+import { lerMarkdown } from '../documento/markdown.mjs';
+import { item } from './regras.mjs';
+
+export const FORMATO_DE_DOCUMENTO = 'documento-oficial';
+const NOME = 'Documento Word';
+const plural = (n, um, varios) => (n === 1 ? um : varios.replace('{n}', n));
+const FRASES = [
+  ['imagens', '1 imagem não entra no documento', '{n} imagens não entram no documento'],
+  ['desconhecidas', '1 marcação `:::` desconhecida vai como texto', '{n} marcações `:::` desconhecidas vão como texto'],
+  ['semFim', '1 bloco de assinaturas sem a linha `:::` do fim vai como texto', '{n} blocos de assinaturas sem a linha `:::` do fim vão como texto'],
+];
+
+/** Os alertas de um texto que vai virar Word; lista vazia quando tudo converte. */
+export function alertasDeDocumento(texto) {
+  const { avisos } = lerMarkdown(texto);
+  return FRASES.filter(([chave]) => avisos[chave]).map(([chave, um, varios]) => item(NOME, null, null, 'alerta', plural(avisos[chave], um, varios)));
+}

package/templates/_opencrew/core/scripts/verificar/medicao.mjs

@@ -108,7 +108,8 @@ function naoMedidos({ pecas, corpo, formato, limites }, semLimite, medidas) {
   for (const cabecalho of BLOG.includes(formato) ? secoesDeOutroCanal(corpo) : []) {
     linhas.push(item(NAO_MEDIDO, null, null, null, `seção de outro canal num arquivo de blog: ${curto(cabecalho)}`));
   }
-  if (formato && !tipos && limites[formato] && !medidas) {
+  // Formato que não declara limite nenhum (documento-oficial, texto-livre) não tem o que medir.
+  if (formato && !tipos && Object.keys(limites[formato] ?? {}).length && !medidas) {
     linhas.push(item(NAO_MEDIDO, null, null, null, `o verificador ainda não mede os limites do formato ${formato}`));
   }
   return linhas;

package/templates/_opencrew/core/scripts/verificar.mjs

@@ -25,6 +25,7 @@ import { lerLimites, lerDominioDoSite, semFrontmatter } from './verificar/leitur
 import { lerProibicoes } from './verificar/proibicoes.mjs';
 import { lerPecas } from './verificar/pecas.mjs';
 import { medirPecas } from './verificar/medicao.mjs';
+import { FORMATO_DE_DOCUMENTO, alertasDeDocumento } from './verificar/documento.mjs';
 import { regrasGerais, temVariavel, item, FALTA_INFO, NAO_MEDIDO, NAO_VERIFICADO } from './verificar/regras.mjs';
 import { formatarRelatorio } from './verificar/relatorio.mjs';
 import { MSG as GRAVACAO, caminhoDoRelatorio, gravarRelatorio } from './verificar/gravacao.mjs';
@@ -86,7 +87,8 @@ async function verificarArquivo({ arquivo, formato }, ctx, regraDeTeste) {
   const envio = /^(email|whatsapp)-/.test(formato ?? '');
   if (envio && temVariavel(lido.texto)) ctx.notas.add(NOTA_VARIAVEL);
   const gerais = regrasGerais(lido.texto, ctx.proibidos, { variavelBloqueia: !envio });
-  const extras = regraDeTeste ? (await regraDeTeste({ arquivo, formato, texto: lido.texto })) ?? [] : [];
+  const doWord = formato === FORMATO_DE_DOCUMENTO && lido.comPecas ? alertasDeDocumento(lido.texto) : [];
+  const extras = [...doWord, ...(regraDeTeste ? (await regraDeTeste({ arquivo, formato, texto: lido.texto })) ?? [] : [])];
   const naoMedido = (i) => i.item === NAO_MEDIDO;
   const itens = [...medidos.filter((i) => !naoMedido(i)), ...gerais, ...extras, ...medidos.filter(naoMedido)];
   return { itens, fecho: fechoDe(itens, medidas, formato) };