@aksp/opencrew 1.2.2 → 1.3.0

package/CHANGELOG.md

@@ -1,139 +1,139 @@
-# Changelog
-
-All notable changes to opencrew are documented here.
-The format is based on [Keep a Changelog](https://keepachangelog.com/).
-
-## [1.2.2] — 2026-08-02
-
-### Fixed
-- **`parseArgs` truncates values containing `=`**: flags like `--description=foo=bar`
-  no longer lose everything after the second `=`.
-- **`version` npm script uses `require()` in ESM project**: extracted to a dedicated
-  `scripts/stamp-version.js` that uses proper ESM imports.
-- **`skills.engine.md` numbering was out of order** in Operation 2 (Install a Skill):
-  steps 3/4 repeated instead of continuing 5–9. Cross-references updated accordingly.
-- **`init` now aborts when a workspace already exists** instead of proceeding with
-  `overwrite: false` (which silently did nothing). It prints instructions to use
-  `update` or reinstall from scratch.
-- **`deleteDir` semantics**: now returns `false` when the path does not exist (was `true`).
-- **`.env.example` placeholders** (`[REDACTED:API key param]`) removed — these were
-  security-redaction artifacts from the tooling, not real file content. No code change.
-
-### Added
-- **Short flags**: `-y` (yes), `-v` (version), `-h` (help) now work alongside their
-  `--long-form` equivalents.
-- **`OPENCREW_CATALOG_URL` env var**: forks can override the skill catalog base URL
-  without editing `catalog.json`. Documented in `CONTRIBUTING.md` → Forking.
-- **`update` now warns** that catalog skills are fully overwritten before refreshing them.
-- **`readJson` error messages now include the file path** (e.g. `Failed to read
-  /path/to/package.json: file not found`).
-- **`pickIdes` validates preselected IDs**: unknown IDs from `--ide` are filtered with
-  a warning instead of being passed through silently.
-- **`c.gray` removed** (unused). **`confirm()` removed** (dead code, never imported).
-- **ESLint** (`eslint.config.js` + `npm run lint` + CI step) with `@eslint/js` flat config.
-- **55 tests** (up from 30): new coverage for `paths.js`, `ui.js`, `fsx.js` error
-  scenarios, `normalizeIdes` string input, CLI smoke tests.
-
-### Changed
-- **CI `npm audit` raised from `moderate` to `high`** to avoid spurious build failures
-  from dev-dependency vulnerabilities without attack vectors.
-- **Playwright config**: `channel: "chrome"` removed — uses bundled Chromium for better
-  portability. `.mcp.json` now includes a `_comment` field explaining how to upgrade the
-  pinned `@playwright/mcp` version.
-- **Node version check** in `cli.js` now uses a proper semver comparison that handles
-  `||` ranges (e.g. `>=18.0.0 || >=20.0.0`).
-
-### Docs
-- **`discovery.prompt.md`**: `crew_code` uniqueness is now self-service (`ls crews/`)
-  instead of depending on the orchestrator to pass a list.
-- **`runner.pipeline.md`**: language contract table documents all fixed PT-BR headers
-  and the policy for adding new ones.
-- **`CONTRIBUTING.md`**: new "Forking" section with catalog URL, package name, and
-  publish instructions.
-
-## [1.2.1] — 2026-08-02
-
-### Changed
-- **Menu discovery for repair**: the "My crews" menu entry now mentions `repair`, so the
-  command introduced in 1.2.0 is discoverable from the menu and not only from the command
-  routing table.
-- **README**: standardized the project name as "OpenCrew" in prose (commands and the npm
-  package name stay lowercase).
-
-## [1.2.0] — 2026-08-02
-
-### Fixed
-- **Crews created without agent names**: some crews rendered their agents' functions
-  (e.g. "Pesquisador") but not their persona names (e.g. "Pedro Pesquisa"). Root cause:
-  `build.prompt.md` never specified the `crew-party.csv` schema, so the manifest could be
-  generated without a `displayName` column — the exact column the Pipeline Runner reads to
-  render agent names — even though the correct two-word names were present in each
-  `.agent.md`. Build now documents the full CSV schema (header + example) and enforces it
-  with a new blocking **Gate 0b: Crew-Party Manifest** that checks `displayName` exists and
-  matches each agent's `.agent.md` `name:`.
-
-### Added
-- **`/opencrew repair <crew>`**: repairs an already-created crew whose manifest is missing
-  agent names. It rebuilds `crew-party.csv` from the persona names already stored in each
-  `.agent.md` (no re-generation of agents, research, or pipeline). New prompt at
-  `_opencrew/core/prompts/repair.prompt.md`, routed via `AGENTS.md`.
-
-### Migration
-- To fix an existing crew that shows functions but no names:
-  1. `npx @aksp/opencrew update` — refreshes the framework and installs the repair command.
-  2. `/opencrew repair <crew>` — rewrites the crew's manifest with the correct names.
-  `update` intentionally never touches `crews/`, so the repair step is required in addition
-  to updating.
-
-## [1.1.0] — 2026-08-01
-
-### Fixed
-- **Skill catalog URLs**: `/opencrew install` now fetches skills from the correct fork
-  (`alberthpalhares/opencrew/templates/skills/`) instead of the upstream OpenSquad repo.
-- **Publish workflow**: restored `push: tags` as the sole trigger — the actual release
-  flow is `npm version` + `git push --tags`, not GitHub Releases. Documented in
-  `CONTRIBUTING.md`.
-- **Cross-platform test script**: replaced shell glob (`tests/*.test.js`) with an
-  explicit file list so `npm test` works on Windows PowerShell + Node 20.
-- **CI matrix**: test suite now runs on Ubuntu and Windows on every push/PR.
-
-### Added
-- **Test suite**: 30 tests (`node:test`) covering `fsx.js`, init, update, IDE bridge
-  validation, and documentation contracts.
-- **CI version-sync check**: `scripts/check-version-sync.js` fails the build if
-  `.opencrew-version` drifts from `package.json`.
-- **Playwright plugin warning**: `init` now warns Claude Code users to disable the
-  native Playwright extension (opencrew ships its own via `.mcp.json`).
-
-### Changed
-- **Dashboard opt-in**: Pipeline Runner `state.json` writes are now gated on
-  `Dashboard: enabled` in `preferences.md` (default: disabled). Removed the
-  unconditional 10-second sleep at the end of every pipeline run.
-- **Smaller fixes**: removed `AskUserQuestion` references from IDE-neutral files,
-  corrected `update.js` comment about overwrite behavior, pinned `@playwright/mcp`
-  version, removed stale root `skills/` directory (drifted duplicate of
-  `templates/skills/`).
-
-## [1.0.1] — 2026-08-01
-
-### Changed
-- API keys for optional skills are now requested conversationally in chat (during crew
-  creation or skill install) instead of requiring the user to manually copy/edit `.env`
-  beforehand. Values are collected and written to `.env` automatically.
-- `init` no longer tells users to configure `.env` as a next step — no setup is required
-  to start using opencrew.
-
-## [1.0.0] — 2026-08-01
-
-### Added
-- npm-style installer: `npx @aksp/opencrew init` scaffolds a full opencrew workspace.
-- `npx @aksp/opencrew update` refreshes only the framework (`_opencrew/core`, catalog
-  skills, `AGENTS.md`) while preserving `crews/`, `_memory/`, IDE bridges and `.env`.
-- Interactive IDE selection during `init` (or `--ide=`, `--all`, non-interactive fallback).
-- Single source of truth: `AGENTS.md`. Every IDE receives only a thin bridge file that
-  points to it — adding a new IDE is one entry in `src/lib/ides.js`.
-- Version stamping via `_opencrew/.opencrew-version`, read by `update`.
-
-### Notes
-- Reformulation of the OpenSquad framework (originally by Renato Asse) published under
-  the `opencrew` name by [aksp](https://www.npmjs.com/~aksp). MIT licensed.
+# Changelog
+
+All notable changes to opencrew are documented here.
+The format is based on [Keep a Changelog](https://keepachangelog.com/).
+
+## [1.2.2] — 2026-08-02
+
+### Fixed
+- **`parseArgs` truncates values containing `=`**: flags like `--description=foo=bar`
+  no longer lose everything after the second `=`.
+- **`version` npm script uses `require()` in ESM project**: extracted to a dedicated
+  `scripts/stamp-version.js` that uses proper ESM imports.
+- **`skills.engine.md` numbering was out of order** in Operation 2 (Install a Skill):
+  steps 3/4 repeated instead of continuing 5–9. Cross-references updated accordingly.
+- **`init` now aborts when a workspace already exists** instead of proceeding with
+  `overwrite: false` (which silently did nothing). It prints instructions to use
+  `update` or reinstall from scratch.
+- **`deleteDir` semantics**: now returns `false` when the path does not exist (was `true`).
+- **`.env.example` placeholders** (`[REDACTED:API key param]`) removed — these were
+  security-redaction artifacts from the tooling, not real file content. No code change.
+
+### Added
+- **Short flags**: `-y` (yes), `-v` (version), `-h` (help) now work alongside their
+  `--long-form` equivalents.
+- **`OPENCREW_CATALOG_URL` env var**: forks can override the skill catalog base URL
+  without editing `catalog.json`. Documented in `CONTRIBUTING.md` → Forking.
+- **`update` now warns** that catalog skills are fully overwritten before refreshing them.
+- **`readJson` error messages now include the file path** (e.g. `Failed to read
+  /path/to/package.json: file not found`).
+- **`pickIdes` validates preselected IDs**: unknown IDs from `--ide` are filtered with
+  a warning instead of being passed through silently.
+- **`c.gray` removed** (unused). **`confirm()` removed** (dead code, never imported).
+- **ESLint** (`eslint.config.js` + `npm run lint` + CI step) with `@eslint/js` flat config.
+- **55 tests** (up from 30): new coverage for `paths.js`, `ui.js`, `fsx.js` error
+  scenarios, `normalizeIdes` string input, CLI smoke tests.
+
+### Changed
+- **CI `npm audit` raised from `moderate` to `high`** to avoid spurious build failures
+  from dev-dependency vulnerabilities without attack vectors.
+- **Playwright config**: `channel: "chrome"` removed — uses bundled Chromium for better
+  portability. `.mcp.json` now includes a `_comment` field explaining how to upgrade the
+  pinned `@playwright/mcp` version.
+- **Node version check** in `cli.js` now uses a proper semver comparison that handles
+  `||` ranges (e.g. `>=18.0.0 || >=20.0.0`).
+
+### Docs
+- **`discovery.prompt.md`**: `crew_code` uniqueness is now self-service (`ls crews/`)
+  instead of depending on the orchestrator to pass a list.
+- **`runner.pipeline.md`**: language contract table documents all fixed PT-BR headers
+  and the policy for adding new ones.
+- **`CONTRIBUTING.md`**: new "Forking" section with catalog URL, package name, and
+  publish instructions.
+
+## [1.2.1] — 2026-08-02
+
+### Changed
+- **Menu discovery for repair**: the "My crews" menu entry now mentions `repair`, so the
+  command introduced in 1.2.0 is discoverable from the menu and not only from the command
+  routing table.
+- **README**: standardized the project name as "OpenCrew" in prose (commands and the npm
+  package name stay lowercase).
+
+## [1.2.0] — 2026-08-02
+
+### Fixed
+- **Crews created without agent names**: some crews rendered their agents' functions
+  (e.g. "Pesquisador") but not their persona names (e.g. "Pedro Pesquisa"). Root cause:
+  `build.prompt.md` never specified the `crew-party.csv` schema, so the manifest could be
+  generated without a `displayName` column — the exact column the Pipeline Runner reads to
+  render agent names — even though the correct two-word names were present in each
+  `.agent.md`. Build now documents the full CSV schema (header + example) and enforces it
+  with a new blocking **Gate 0b: Crew-Party Manifest** that checks `displayName` exists and
+  matches each agent's `.agent.md` `name:`.
+
+### Added
+- **`/opencrew repair <crew>`**: repairs an already-created crew whose manifest is missing
+  agent names. It rebuilds `crew-party.csv` from the persona names already stored in each
+  `.agent.md` (no re-generation of agents, research, or pipeline). New prompt at
+  `_opencrew/core/prompts/repair.prompt.md`, routed via `AGENTS.md`.
+
+### Migration
+- To fix an existing crew that shows functions but no names:
+  1. `npx @aksp/opencrew update` — refreshes the framework and installs the repair command.
+  2. `/opencrew repair <crew>` — rewrites the crew's manifest with the correct names.
+  `update` intentionally never touches `crews/`, so the repair step is required in addition
+  to updating.
+
+## [1.1.0] — 2026-08-01
+
+### Fixed
+- **Skill catalog URLs**: `/opencrew install` now fetches skills from the correct fork
+  (`alberthpalhares/opencrew/templates/skills/`) instead of the upstream OpenSquad repo.
+- **Publish workflow**: restored `push: tags` as the sole trigger — the actual release
+  flow is `npm version` + `git push --tags`, not GitHub Releases. Documented in
+  `CONTRIBUTING.md`.
+- **Cross-platform test script**: replaced shell glob (`tests/*.test.js`) with an
+  explicit file list so `npm test` works on Windows PowerShell + Node 20.
+- **CI matrix**: test suite now runs on Ubuntu and Windows on every push/PR.
+
+### Added
+- **Test suite**: 30 tests (`node:test`) covering `fsx.js`, init, update, IDE bridge
+  validation, and documentation contracts.
+- **CI version-sync check**: `scripts/check-version-sync.js` fails the build if
+  `.opencrew-version` drifts from `package.json`.
+- **Playwright plugin warning**: `init` now warns Claude Code users to disable the
+  native Playwright extension (opencrew ships its own via `.mcp.json`).
+
+### Changed
+- **Dashboard opt-in**: Pipeline Runner `state.json` writes are now gated on
+  `Dashboard: enabled` in `preferences.md` (default: disabled). Removed the
+  unconditional 10-second sleep at the end of every pipeline run.
+- **Smaller fixes**: removed `AskUserQuestion` references from IDE-neutral files,
+  corrected `update.js` comment about overwrite behavior, pinned `@playwright/mcp`
+  version, removed stale root `skills/` directory (drifted duplicate of
+  `templates/skills/`).
+
+## [1.0.1] — 2026-08-01
+
+### Changed
+- API keys for optional skills are now requested conversationally in chat (during crew
+  creation or skill install) instead of requiring the user to manually copy/edit `.env`
+  beforehand. Values are collected and written to `.env` automatically.
+- `init` no longer tells users to configure `.env` as a next step — no setup is required
+  to start using opencrew.
+
+## [1.0.0] — 2026-08-01
+
+### Added
+- npm-style installer: `npx @aksp/opencrew init` scaffolds a full opencrew workspace.
+- `npx @aksp/opencrew update` refreshes only the framework (`_opencrew/core`, catalog
+  skills, `AGENTS.md`) while preserving `crews/`, `_memory/`, IDE bridges and `.env`.
+- Interactive IDE selection during `init` (or `--ide=`, `--all`, non-interactive fallback).
+- Single source of truth: `AGENTS.md`. Every IDE receives only a thin bridge file that
+  points to it — adding a new IDE is one entry in `src/lib/ides.js`.
+- Version stamping via `_opencrew/.opencrew-version`, read by `update`.
+
+### Notes
+- Reformulation of the OpenSquad framework (originally by Renato Asse) published under
+  the `opencrew` name by [aksp](https://www.npmjs.com/~aksp). MIT licensed.

package/README.md

@@ -1,150 +1,150 @@
-# OpenCrew
-
-[![CI](https://github.com/alberthpalhares/opencrew/actions/workflows/ci.yml/badge.svg)](https://github.com/alberthpalhares/opencrew/actions/workflows/ci.yml)
-[![npm](https://img.shields.io/npm/v/%40aksp%2Fopencrew)](https://www.npmjs.com/package/@aksp/opencrew)
-[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-
-**Crie equipes de agentes de IA que trabalham juntos — direto na sua IDE.**
-
-> 🇧🇷 This README is in Brazilian Portuguese (PT-BR), the project's primary audience. If
-> you don't read Portuguese, use your browser's translator (e.g. Google Translate) or ask
-> an AI assistant to translate this page.
-
-OpenCrew é um framework de orquestração multi-agente. Descreva o que você precisa em
-linguagem natural e ele monta um time de agentes especializados que rodam como um pipeline
-automatizado, com pontos de aprovação humana. Funciona no Claude Code, Cursor, Codex,
-Gemini CLI, OpenCode, Antigravity e mais.
-
-> **Este não é um framework original — é a minha versão pessoal do OpenSquad.**
-> O [OpenSquad](https://github.com/renatoasse/opensquad) foi criado por
-> [Renato Asse](https://github.com/renatoasse) ([Comunidade Sem Codar](https://semcodar.com.br)).
-> Eu ([aksp](https://www.npmjs.com/~aksp)) uso o OpenSquad no dia a dia e quis melhorar
-> algumas coisas para o meu próprio fluxo de trabalho — o `OpenCrew` é essa versão
-> reformulada, compartilhada caso ajude outras pessoas também. Todo o crédito pela ideia e
-> pelo framework original é do Renato Asse. Veja [Origem e créditos](#origem-e-créditos)
-> abaixo. Licenciado sob MIT, assim como o original.
-
----
-
-## Instalação
-
-**Pré-requisito:** Node.js 20+
-
-```bash
-npx @aksp/opencrew init
-```
-
-O `init` monta o workspace na pasta atual e pergunta quais IDEs de IA você usa, gerando os
-arquivos de integração certos para cada uma. Depois:
-
-1. Abra a pasta na sua IDE de IA.
-2. Digite `/opencrew` para começar — a primeira execução configura o perfil da sua empresa.
-
-Isso já é suficiente para criar e rodar crews: nenhuma configuração prévia, instalação
-extra ou chave de API é necessária para começar.
-
-Algumas **skills opcionais** dependem de serviços externos — por exemplo, publicar no
-Instagram, gerar imagens com IA, fazer web scraping (Apify) ou enviar e-mails (Resend). Você
-não precisa se preocupar com isso antes de começar: se, ao montar uma crew, o OpenCrew
-identificar que ela precisa de uma dessas skills, ele pede a chave direto na conversa
-(explicando o que é e onde consegui-la) e salva tudo por conta própria. Não é preciso abrir
-nem editar nenhum arquivo manualmente.
-
-Você pode pré-selecionar as IDEs (pula a pergunta) ou configurar todas de uma vez:
-
-```bash
-npx @aksp/opencrew init --ide=claude-code,codex
-npx @aksp/opencrew init --all
-```
-
-## Atualizando
-
-Atualize o framework sem perder o seu trabalho:
-
-```bash
-npx @aksp/opencrew update
-```
-
-O `update` atualiza apenas `_opencrew/core`, as skills do catálogo e o `AGENTS.md`. Suas
-`crews/`, memória, integrações de IDE e `.env` continuam intactos.
-
-## IDEs suportadas
-
-| IDE | Arquivo(s) de integração gerado(s) |
-|-----|--------------------------|
-| Claude Code | `.claude/skills/opencrew/SKILL.md`, `CLAUDE.md` |
-| Codex (OpenAI) | `AGENTS.md` (nativo) + `.agents/skills/opencrew/SKILL.md` |
-| Cursor | `.cursor/rules/opencrew.mdc` |
-| VS Code + Copilot | `.github/copilot-instructions.md` |
-| OpenCode | `.opencode/commands/opencrew.md` |
-| Antigravity | `.agent/rules/opencrew.md`, `.agent/workflows/opencrew.md` |
-| Gemini CLI | `GEMINI.md` |
-| Qwen Code | `QWEN.md` |
-| Trae | `.trae/rules/opencrew.md` |
-
-Cada integração é só um ponteiro enxuto para a fonte única de verdade, o **`AGENTS.md`**.
-
-## Como funciona
-
-- **Architect** projeta uma crew a partir da sua descrição (agentes, pipeline, skills).
-- **Sherlock** (opcional) analisa perfis de referência para extrair padrões reais de conteúdo.
-- **Pipeline Runner** executa a crew, pausando nos checkpoints para sua aprovação.
-- **Skills Engine** carrega integrações (scraping, design, publicação, e-mail…) sob demanda,
-  usando um esquema em duas camadas para manter o consumo de tokens baixo.
-
-## Dashboard (opcional)
-
-O OpenCrew inclui um dashboard visual auto-contido — `dashboard/index.html`, um arquivo
-HTML único sem dependências que mostra a execução de uma crew como um escritório virtual
-animado (com agentes trabalhando em suas mesas, handoffs entre etapas, e indicador de
-progresso). 
-
-Ele é **desligado por padrão** — o Pipeline Runner não escreve `state.json` a menos que
-você ligue o recurso (`Dashboard: enabled` em `_opencrew/_memory/preferences.md`, via
-`/opencrew settings`). Inclui modo demo embutido para visualização sem precisar rodar uma
-crew real.
-
-## Comandos (dentro da sua IDE)
-
-| Comando | O que faz |
-|---------|--------------|
-| `/opencrew` | Abre o menu principal |
-| `/opencrew create <descrição>` | Cria uma nova crew |
-| `/opencrew run <nome>` | Executa uma crew |
-| `/opencrew list` | Lista suas crews |
-| `/opencrew edit <nome>` | Modifica uma crew |
-| `/opencrew skills` | Navega / instala / remove skills |
-
-## Para mantenedores
-
-Veja [CONTRIBUTING.md](CONTRIBUTING.md). Regra de ouro: `AGENTS.md` é o único lugar onde
-vivem as instruções do sistema; os arquivos por IDE são gerados a partir de `src/lib/ides.js`.
-
-## Origem e créditos
-
-`OpenCrew` é uma **distribuição reformulada do [OpenSquad](https://github.com/renatoasse/opensquad)**,
-o framework de orquestração multi-agente criado e mantido por
-**[Renato Asse](https://github.com/renatoasse)**, fundador da
-[Comunidade Sem Codar](https://semcodar.com.br). O projeto original, seu conceito, o modelo
-de agentes, o design do pipeline e o sistema de skills são trabalho dele — dê uma estrela e
-siga o [repositório original](https://github.com/renatoasse/opensquad) e assista ao
-[vídeo de lançamento](https://www.youtube.com/watch?v=CL1ppI4qHeU).
-
-Eu uso o OpenSquad no meu dia a dia e fiz algumas mudanças que se encaixam no meu jeito de
-trabalhar, que acredito que também podem ajudar outras pessoas. O que esta versão muda em
-relação ao original:
-
-- **Instalador npm no meu escopo** — `npx @aksp/opencrew init` / `update`, com um caminho
-  de atualização não destrutivo que preserva suas crews, memória e `.env`.
-- **Fonte única de verdade para multi-IDE** — um `AGENTS.md` canônico; cada IDE recebe um
-  arquivo de integração gerado e enxuto, em vez de um documento mantido manualmente para
-  cada ferramenta.
-- **Melhorias de economia de tokens e de invocação de skills** no núcleo do framework.
-
-Este é um fork independente, feito pela comunidade — **não** é afiliado nem endossado pelo
-Renato Asse ou pela Comunidade Sem Codar. Se você quiser o projeto oficial, use
-[`npx opensquad init`](https://github.com/renatoasse/opensquad).
-
-## Licença
-
-MIT — veja [LICENSE](LICENSE). Framework OpenSquad original © Renato Asse, também MIT.
+# OpenCrew
+
+[![CI](https://github.com/alberthpalhares/opencrew/actions/workflows/ci.yml/badge.svg)](https://github.com/alberthpalhares/opencrew/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/%40aksp%2Fopencrew)](https://www.npmjs.com/package/@aksp/opencrew)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+**Crie equipes de agentes de IA que trabalham juntos — direto na sua IDE.**
+
+> 🇧🇷 This README is in Brazilian Portuguese (PT-BR), the project's primary audience. If
+> you don't read Portuguese, use your browser's translator (e.g. Google Translate) or ask
+> an AI assistant to translate this page.
+
+OpenCrew é um framework de orquestração multi-agente. Descreva o que você precisa em
+linguagem natural e ele monta um time de agentes especializados que rodam como um pipeline
+automatizado, com pontos de aprovação humana. Funciona no Claude Code, Cursor, Codex,
+Gemini CLI, OpenCode, Antigravity e mais.
+
+> **Este não é um framework original — é a minha versão pessoal do OpenSquad.**
+> O [OpenSquad](https://github.com/renatoasse/opensquad) foi criado por
+> [Renato Asse](https://github.com/renatoasse) ([Comunidade Sem Codar](https://semcodar.com.br)).
+> Eu ([aksp](https://www.npmjs.com/~aksp)) uso o OpenSquad no dia a dia e quis melhorar
+> algumas coisas para o meu próprio fluxo de trabalho — o `OpenCrew` é essa versão
+> reformulada, compartilhada caso ajude outras pessoas também. Todo o crédito pela ideia e
+> pelo framework original é do Renato Asse. Veja [Origem e créditos](#origem-e-créditos)
+> abaixo. Licenciado sob MIT, assim como o original.
+
+---
+
+## Instalação
+
+**Pré-requisito:** Node.js 20+
+
+```bash
+npx @aksp/opencrew init
+```
+
+O `init` monta o workspace na pasta atual e pergunta quais IDEs de IA você usa, gerando os
+arquivos de integração certos para cada uma. Depois:
+
+1. Abra a pasta na sua IDE de IA.
+2. Digite `/opencrew` para começar — a primeira execução configura o perfil da sua empresa.
+
+Isso já é suficiente para criar e rodar crews: nenhuma configuração prévia, instalação
+extra ou chave de API é necessária para começar.
+
+Algumas **skills opcionais** dependem de serviços externos — por exemplo, publicar no
+Instagram, gerar imagens com IA, fazer web scraping (Apify) ou enviar e-mails (Resend). Você
+não precisa se preocupar com isso antes de começar: se, ao montar uma crew, o OpenCrew
+identificar que ela precisa de uma dessas skills, ele pede a chave direto na conversa
+(explicando o que é e onde consegui-la) e salva tudo por conta própria. Não é preciso abrir
+nem editar nenhum arquivo manualmente.
+
+Você pode pré-selecionar as IDEs (pula a pergunta) ou configurar todas de uma vez:
+
+```bash
+npx @aksp/opencrew init --ide=claude-code,codex
+npx @aksp/opencrew init --all
+```
+
+## Atualizando
+
+Atualize o framework sem perder o seu trabalho:
+
+```bash
+npx @aksp/opencrew update
+```
+
+O `update` atualiza apenas `_opencrew/core`, as skills do catálogo e o `AGENTS.md`. Suas
+`crews/`, memória, integrações de IDE e `.env` continuam intactos.
+
+## IDEs suportadas
+
+| IDE | Arquivo(s) de integração gerado(s) |
+|-----|--------------------------|
+| Claude Code | `.claude/skills/opencrew/SKILL.md`, `CLAUDE.md` |
+| Codex (OpenAI) | `AGENTS.md` (nativo) + `.agents/skills/opencrew/SKILL.md` |
+| Cursor | `.cursor/rules/opencrew.mdc` |
+| VS Code + Copilot | `.github/copilot-instructions.md` |
+| OpenCode | `.opencode/commands/opencrew.md` |
+| Antigravity | `.agent/rules/opencrew.md`, `.agent/workflows/opencrew.md` |
+| Gemini CLI | `GEMINI.md` |
+| Qwen Code | `QWEN.md` |
+| Trae | `.trae/rules/opencrew.md` |
+
+Cada integração é só um ponteiro enxuto para a fonte única de verdade, o **`AGENTS.md`**.
+
+## Como funciona
+
+- **Architect** projeta uma crew a partir da sua descrição (agentes, pipeline, skills).
+- **Sherlock** (opcional) analisa perfis de referência para extrair padrões reais de conteúdo.
+- **Pipeline Runner** executa a crew, pausando nos checkpoints para sua aprovação.
+- **Skills Engine** carrega integrações (scraping, design, publicação, e-mail…) sob demanda,
+  usando um esquema em duas camadas para manter o consumo de tokens baixo.
+
+## Dashboard (opcional)
+
+O OpenCrew inclui um dashboard visual auto-contido — `dashboard/index.html`, um arquivo
+HTML único sem dependências que mostra a execução de uma crew como um escritório virtual
+animado (com agentes trabalhando em suas mesas, handoffs entre etapas, e indicador de
+progresso). 
+
+Ele é **desligado por padrão** — o Pipeline Runner não escreve `state.json` a menos que
+você ligue o recurso (`Dashboard: enabled` em `_opencrew/_memory/preferences.md`, via
+`/opencrew settings`). Inclui modo demo embutido para visualização sem precisar rodar uma
+crew real.
+
+## Comandos (dentro da sua IDE)
+
+| Comando | O que faz |
+|---------|--------------|
+| `/opencrew` | Abre o menu principal |
+| `/opencrew create <descrição>` | Cria uma nova crew |
+| `/opencrew run <nome>` | Executa uma crew |
+| `/opencrew list` | Lista suas crews |
+| `/opencrew edit <nome>` | Modifica uma crew |
+| `/opencrew skills` | Navega / instala / remove skills |
+
+## Para mantenedores
+
+Veja [CONTRIBUTING.md](CONTRIBUTING.md). Regra de ouro: `AGENTS.md` é o único lugar onde
+vivem as instruções do sistema; os arquivos por IDE são gerados a partir de `src/lib/ides.js`.
+
+## Origem e créditos
+
+`OpenCrew` é uma **distribuição reformulada do [OpenSquad](https://github.com/renatoasse/opensquad)**,
+o framework de orquestração multi-agente criado e mantido por
+**[Renato Asse](https://github.com/renatoasse)**, fundador da
+[Comunidade Sem Codar](https://semcodar.com.br). O projeto original, seu conceito, o modelo
+de agentes, o design do pipeline e o sistema de skills são trabalho dele — dê uma estrela e
+siga o [repositório original](https://github.com/renatoasse/opensquad) e assista ao
+[vídeo de lançamento](https://www.youtube.com/watch?v=CL1ppI4qHeU).
+
+Eu uso o OpenSquad no meu dia a dia e fiz algumas mudanças que se encaixam no meu jeito de
+trabalhar, que acredito que também podem ajudar outras pessoas. O que esta versão muda em
+relação ao original:
+
+- **Instalador npm no meu escopo** — `npx @aksp/opencrew init` / `update`, com um caminho
+  de atualização não destrutivo que preserva suas crews, memória e `.env`.
+- **Fonte única de verdade para multi-IDE** — um `AGENTS.md` canônico; cada IDE recebe um
+  arquivo de integração gerado e enxuto, em vez de um documento mantido manualmente para
+  cada ferramenta.
+- **Melhorias de economia de tokens e de invocação de skills** no núcleo do framework.
+
+Este é um fork independente, feito pela comunidade — **não** é afiliado nem endossado pelo
+Renato Asse ou pela Comunidade Sem Codar. Se você quiser o projeto oficial, use
+[`npx opensquad init`](https://github.com/renatoasse/opensquad).
+
+## Licença
+
+MIT — veja [LICENSE](LICENSE). Framework OpenSquad original © Renato Asse, também MIT.