@aksp/opencrew 1.9.0 → 1.11.0

package/CHANGELOG.md

@@ -3,6 +3,118 @@
 All notable changes to opencrew are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
+## [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
+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,
+  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
+  IA; sem `--aplicar` ele só lê.
+- **Proibição que é regra de conteúdo** ("nunca prever votação por aclamação") pode ser marcada
+  como `(revisão humana)`: fica para o revisor e deixa de aparecer como pendência do verificador.
+- **Crew de documento na criação.** Pedir uma crew de ata, ofício, contrato ou proposta leva a
+  perguntas próprias (quais documentos, quem assina e quem recebe, papel timbrado, quais arquivos
+  mandam no texto), sem a oferta de investigar perfis de referência, e os passos já saem com o
+  formato `documento-oficial`.
+- **Formato da crew escrito num lugar só** (`_opencrew/core/formato-da-crew.md`): `crew.yaml`,
+  `pipeline.yaml`, os campos de cada passo e o `id` do agente, com um exemplo completo. A criação,
+  o runner e o conserto seguem esse arquivo; as formas que versões antigas gravaram continuam
+  sendo lidas.
+- Depois do `update`, quando o projeto tem ao menos uma crew, o resumo lembra do
+  `/opencrew repair`.
+
+### Changed
+- **`max_review_cycles` no `crew.yaml` passa a valer.** O runner só lia o limite de ciclos de
+  revisão no passo de revisão; crews que o declaravam no `crew.yaml` recebiam sempre 3.
+- **Tier Express tem passo de revisão**, feito pelo próprio redator: o verificador automático roda
+  também nele. Antes o texto dizia "o redator se revisa" e, em outro ponto, "toda crew precisa de
+  revisor".
+- **Checkpoint que guarda a resposta em arquivo** deixa de usar sempre o formato de "foco de
+  pesquisa": fora do checkpoint do pesquisador, grava o título, a sua resposta e a data.
+- O Architect lista os prompts de cada fase da criação, e o ponto de entrada diz onde ele está;
+  antes um apontava para o outro.
+- Pasta de `crews/` sem `crew.yaml` (os modelos instalados) não aparece mais como crew nas
+  listas.
+
+### Fixed
+- `init --ide=<lista> --yes` (e `--all`) instalava as pontes das 9 IDEs; agora a lista vence.
+  `--yes` sem `--ide` continua instalando todas.
+- Uma frase cortada no meio nas instruções instaladas (`_opencrew/core/system.md`, desde a
+  1.10.0): a rota do documento Word e o pedido de entrega de uma execução encerrada não exigem o
+  onboarding.
+- O Build exigia um checkpoint imediatamente antes de cada passo que publica, o que era
+  impossível com dois passos de publicação seguidos.
+
+## [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,12 @@ 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
+│   │   ├── 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
+│   │   ├── 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)
-│   │   └── 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 +198,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 +237,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 +293,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,
@@ -354,6 +438,13 @@ o que você fez:
   `# opencrew:end`)? Nenhuma linha sua é apagada: o `update` guarda o arquivo como estava e põe
   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
+  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`.
 - **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
@@ -406,13 +497,14 @@ npx @aksp/opencrew update --check
 | `/opencrew run <nome>` | Executa o pipeline de uma crew |
 | `/opencrew list` | Lista todas as suas crews |
 | `/opencrew edit <nome>` | Modifica uma crew existente |
-| `/opencrew repair <nome>` | Conserta o manifesto de uma crew com nomes quebrados |
+| `/opencrew repair <nome>` | Mostra o que falta numa crew que você já tem (formato de cada texto, arquivos do projeto que ela deve ler, proibições que o verificador consegue barrar, nomes dos agentes) e conserta um ponto por vez, com o seu sim e uma cópia `.bak` |
 | `/opencrew delete <nome>` | Remove uma crew |
 | `/opencrew skills` | Navega, instala ou remove skills |
 | `/opencrew install <skill>` | Instala uma skill do catálogo |
 | `/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 |
@@ -425,7 +517,7 @@ npx @aksp/opencrew update --check
 | `npx @aksp/opencrew@latest update` | Atualiza o framework |
 | `npx @aksp/opencrew update --check` (ou `--dry-run`) | Verifica se há update disponível, sem alterar nada |
 | `npx @aksp/opencrew upgrade` | Atalho para `update` |
-| `npx @aksp/opencrew init --ide=claude-code,cursor` | Instala só as pontes das IDEs indicadas |
+| `npx @aksp/opencrew init --ide=claude-code,cursor` | Instala só as pontes das IDEs indicadas (também com `--yes`) |
 | `npx @aksp/opencrew init --all` (ou `-y`) | Instala as pontes de todas as IDEs |
 | `npx @aksp/opencrew@latest init --repair-bridges` | Regrava as pontes das IDEs já instaladas num workspace existente (`--ide=a,b`: só as indicadas; `--all`: as 9) |
 | `npx @aksp/opencrew version` | Mostra a versão instalada |

package/package.json

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

package/src/commands/init.js

@@ -148,14 +148,13 @@ async function workspaceState(target) {
 }
 
 /**
- * Decide which IDEs to configure. --all / --yes → every IDE; --ide → validated list;
- * nothing → `fallback()` (the interactive prompt; in repair mode, the detection). Throws
- * UsageError if --ide names no valid IDE.
+ * Decide which IDEs to configure. --ide → validated list, whatever comes with it; without it,
+ * --all / --yes → every IDE; nothing → `fallback()` (the interactive prompt; in repair mode, the
+ * detection). Throws UsageError if --ide names no valid IDE.
  */
 async function resolveIdes(opts, fallback) {
-  if (opts.all || opts.yes) return allIdeIds();
   const ids = normalizeIdes(opts.ide);
-  if (!ids) return fallback();
+  if (!ids) return opts.all || opts.yes ? allIdeIds() : fallback();
   const invalid = ids.filter((id) => !ideById(id));
   const valid = ids.filter((id) => ideById(id));
   if (!valid.length) {

package/src/commands/update.js

@@ -88,6 +88,7 @@ async function apply(target, version) {
   const done = { unreadable, ...(await refreshBridges(ctx)) };
   done.mcp = await updateMcp(ctx, await readFile(tpl('.mcp.json')));
   done.leftovers = await findLeftovers(target);
+  done.hasCrew = await hasCrew(target);
   say(updateSummary(ctx, done));
 
   await writeManifest(target, version, ctx.files);
@@ -97,6 +98,13 @@ async function apply(target, version) {
   log(c.dim(`${UNTOUCHED}\n`));
 }
 
+/** Is there a crew of the user's? A folder of `crews/` with `crew.yaml` (the templates have none). Only looks. */
+async function hasCrew(target) {
+  const dirs = await fs.readdir(path.join(target, 'crews'), { withFileTypes: true }).catch(() => []);
+  const found = await Promise.all(dirs.filter((d) => d.isDirectory()).map((d) => exists(path.join(target, 'crews', d.name, 'crew.yaml'))));
+  return found.includes(true);
+}
+
 /** @returns what `deliverTree` did to each crew template (only the missing ones are written). */
 async function refreshFramework(ctx) {
   const dest = (...p) => path.join(ctx.target, ...p);

package/src/lib/resumo.js

@@ -18,6 +18,9 @@ export const ALREADY_INSTALLED = 'Para atualizar, rode `npx @aksp/opencrew@lates
 /** `update` over `_opencrew/core` with no version stamp (spec U3a-2, rule 31). */
 export const INTERRUPTED = 'A instalação anterior não terminou. Rode `npx @aksp/opencrew init` para concluir.';
 
+/** After an `update`, when the project has at least one crew (spec U4-1, decision 7). */
+export const REPAIR_HINT = 'Para levar as melhorias novas às crews que você já tem, peça na sua IDE: /opencrew repair';
+
 const NO_BRIDGES = 'Nenhuma ponte de IDE encontrada: nada a atualizar. Para criar a ponte de uma IDE: `npx @aksp/opencrew@latest init --repair-bridges --ide=<id>`.';
 const LEAK_REMOVED = 'CLAUDE.md: removi a seção de STATUS.md que as versões 1.4.0 e 1.4.1 gravaram por engano.';
 const FIRST_PROTECTED = 'Primeira atualização com proteção: sem registro anterior, guardamos tudo o que diferia. Daqui em diante, só o que você editar.';
@@ -112,7 +115,7 @@ function copyLines(ctx, unreadable) {
  * @param {object} done what each step returned: `agents` and `gitignore` (deliverBlock; `agents`
  *   is null when a pre-1.3 AGENTS.md was migrated), `ides` (detected), `bridges` (deliverBridges),
  *   `leak` (the STATUS.md section left CLAUDE.md's block), `mcp` (updateMcp), `leftovers`
- *   (findLeftovers) and `unreadable` (manifest)
+ *   (findLeftovers), `unreadable` (manifest) and `hasCrew` (a folder of `crews/` with `crew.yaml`)
  * @returns {Array<[Function, string]>} lines for `say`
  */
 export function updateSummary(ctx, done) {
@@ -124,5 +127,6 @@ export function updateSummary(ctx, done) {
     ...mcpLines(ctx, done.mcp),
     ...leftoverLines(done.leftovers, done.mcp),
     ...copyLines(ctx, done.unreadable),
+    ...(done.hasCrew ? [[info, REPAIR_HINT]] : []),
   ];
 }

package/templates/AGENTS.md

@@ -10,6 +10,8 @@ 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 request to deliver a run that already ended: neither
+   uses the company context)
 4. Otherwise, display the MAIN MENU
 
 ## Onboarding Flow (first time only)
@@ -36,7 +38,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
 
@@ -46,11 +51,11 @@ Route input to the matching action:
 |---------------|--------|
 | `/opencrew` or `/opencrew menu` | Show main menu |
 | `/opencrew help` | Show help text |
-| `/opencrew create <description>` | Load Architect → Create Crew flow |
-| `/opencrew list` | List all crews in `crews/` |
+| `/opencrew create <description>` | Load the Architect (`_opencrew/core/architect.agent.yaml`) → Create Crew flow: one prompt per phase, listed there |
+| `/opencrew list` | List all crews in `crews/` (a folder without `crew.yaml` is not a crew) |
 | `/opencrew run <name>` | Load Pipeline Runner → Execute crew |
-| `/opencrew edit <name> <changes>` | Load Architect → Edit Crew flow |
-| `/opencrew repair <name>` | Load `_opencrew/core/prompts/repair.prompt.md` → fix agent names / rebuild crew-party.csv |
+| `/opencrew edit <name> <changes>` | Load the Architect → Edit Crew flow |
+| `/opencrew repair <name>` | Load `_opencrew/core/prompts/repair.prompt.md` → show what an existing crew is missing and fix one point at a time, each with a `.bak` copy |
 | `/opencrew skills` | Load Skills Engine → Show skills menu |
 | `/opencrew install <name>` | Install a skill from the catalog |
 | `/opencrew uninstall <name>` | Remove an installed skill |
@@ -60,6 +65,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" |
@@ -69,7 +75,8 @@ Route input to the matching action:
 
 When a specific agent needs to be activated:
 
-1. Read the agent's `.agent.md` file completely
+1. Read the agent's `.agent.md` file completely (the Architect is the exception: it lives in
+   `_opencrew/core/architect.agent.yaml`)
 2. Adopt the agent's persona (role, identity, communication_style, principles)
 3. Follow the agent's menu/workflow instructions
 4. When the agent's task is complete, return to the opencrew main context
@@ -124,10 +131,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.11.0

package/templates/_opencrew/core/architect.agent.yaml

@@ -57,24 +57,30 @@ agent:
     create-crew: |
       ## Create Crew
 
-      The create flow is now handled by the phased orchestration system.
-      See the SKILL.md entry point for the full phased flow:
-      Discovery → Investigation → Design → Template Selection (optional) → Build
-
-      Each phase is a separate prompt in `_opencrew/core/prompts/`:
-      - `discovery.prompt.md` — Phase 1: Intelligent wizard
-      - `sherlock-*.md` — Phase 2: Investigation (optional)
-      - `design.prompt.md` — Phase 3: Crew architecture (includes optional Phase H.5: Template Selection)
-      - `build.prompt.md` — Phase 4: File generation + validation
-
-      The SKILL.md orchestrator dispatches each phase as a subagent.
+      Creating a crew takes four phases, in this order. Each phase is one prompt: read it
+      completely when its turn comes, follow it to the end, and only then load the next one.
+
+      1. `_opencrew/core/prompts/discovery.prompt.md` — Discovery: the questions; ends by
+         writing `crews/{code}/_build/discovery.yaml`
+      2. `_opencrew/core/prompts/sherlock-shared.md` — Investigation: ONLY when the discovery
+         ended with the investigation enabled; it names the platform prompt to load with it
+      3. `_opencrew/core/prompts/design.prompt.md` — Design: agents and pipeline (includes the
+         optional template selection); ends by writing `crews/{code}/_build/design.yaml`
+      4. `_opencrew/core/prompts/build.prompt.md` — Build: writes the crew files, in the format
+         of `_opencrew/core/formato-da-crew.md`, and validates them
+
+      If your IDE can run a phase as a subagent, you may; otherwise run the phases one after
+      the other in this conversation. Never skip a phase and never write crew files before
+      the Build.
 
     edit-crew: |
       ## Edit Crew Workflow
 
-      1. Ask which crew to edit (list available crews if not specified).
+      1. Ask which crew to edit (list available crews if not specified; a folder without
+         crew.yaml is not a crew).
          If only 1 crew exists, add "Cancel" as a second option. If 0 crews, inform user directly.
-      2. Read the crew's crew.yaml to understand current structure
+      2. Read the crew's crew.yaml to understand current structure (the format of the crew
+         files is in `_opencrew/core/formato-da-crew.md`)
       3. Ask what changes the user wants
       4. **If the user asks to edit/define/change the visual template or identity of a design agent:**
          - Read and follow `skills/template-designer/SKILL.md`
@@ -86,8 +92,10 @@ agent:
     list-crews: |
       ## List Crews Workflow
 
-      1. Read all directories in crews/
-      2. For each, read crew.yaml to get name, description, icon, agent count
+      1. Read all directories in crews/. A folder without crew.yaml is not a crew (the
+         template folders installed with the product): leave it out
+      2. For each crew, read crew.yaml to get name, description and icon (inside `crew:` or,
+         in older crews, loose at the top level) and count the agents in crew-party.csv
       3. Present as a formatted list:
          ```
          Your Crews:
@@ -102,7 +110,8 @@ agent:
     delete-crew: |
       ## Delete Crew Workflow
 
-      1. Ask which crew to delete (list available if not specified).
+      1. Ask which crew to delete (list available if not specified; a folder without
+         crew.yaml is not a crew).
          If only 1 crew exists, add "Cancel" as a second option. If 0 crews, inform user directly.
       2. Show crew details (name, agents, output count)
       3. Confirm deletion with explicit "Are you sure?" presented as a numbered list (1. Yes, delete / 2. No, cancel)

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