@pathbit/agentdevkit 0.0.0-stage → 0.0.5

package/.pbai4devs/tools/just-bash/TOOL.json

@@ -0,0 +1,27 @@
+{
+  "name": "just-bash",
+  "description": "Execucao de comandos em shell virtual com filesystem isolado.",
+  "group": "shell",
+  "source": "https://github.com/vercel-labs/just-bash/tree/main/packages/just-bash",
+  "download": {
+    "provider": "npm",
+    "package": "just-bash",
+    "registry": "https://registry.npmjs.org/",
+    "repository": "vercel-labs/just-bash",
+    "channel": "latest"
+  },
+  "platforms": [
+    "darwin-arm64",
+    "darwin-x64",
+    "linux-arm64",
+    "linux-x64",
+    "win32-arm64",
+    "win32-x64"
+  ],
+  "scripts": {
+    "entry": "SCRIPT.mjs"
+  },
+  "probe": [
+    "--version"
+  ]
+}

package/.pbai4devs/tools/markdownlint-cli2/README.md

@@ -0,0 +1,18 @@
+---
+description: Origem e uso local do Markdown lint.
+---
+
+# Markdownlint-cli2
+
+Origem: [repositório oficial](https://github.com/DavidAnson/markdownlint-cli2).
+O [TOOL.json](TOOL.json) define o pacote npm, canal `latest` e um probe de lint.
+
+```console
+node .pbai4devs/tools/markdownlint-cli2/SCRIPT.mjs install
+node .pbai4devs/tools/markdownlint-cli2/SCRIPT.mjs update
+node .pbai4devs/tools/markdownlint-cli2/SCRIPT.mjs run README.md
+```
+
+Exige Node 24+/npm para o preparo; usa JavaScript, sem binário nativo próprio.
+`check` executa lint numa entrada válida. A aplicação dos padrões do projeto
+fica em `verificar-recursos`; relatórios locais ficam em `.agent-tests/`.

package/.pbai4devs/tools/markdownlint-cli2/SCRIPT.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { main } from '../../scripts/preparar-ferramentas/SCRIPT.mjs';
+
+try { process.exitCode = await main(['--tool', "markdownlint-cli2", ...process.argv.slice(2)]); }
+catch (error) { console.error(error.message); process.exitCode = 1; }

package/.pbai4devs/tools/markdownlint-cli2/TOOL.json

@@ -0,0 +1,28 @@
+{
+  "name": "markdownlint-cli2",
+  "description": "Lint de arquivos Markdown do projeto.",
+  "group": "base",
+  "source": "https://github.com/DavidAnson/markdownlint-cli2",
+  "download": {
+    "provider": "npm",
+    "package": "markdownlint-cli2",
+    "registry": "https://registry.npmjs.org/",
+    "repository": "DavidAnson/markdownlint-cli2",
+    "channel": "latest"
+  },
+  "platforms": [
+    "darwin-arm64",
+    "darwin-x64",
+    "linux-arm64",
+    "linux-x64",
+    "win32-arm64",
+    "win32-x64"
+  ],
+  "scripts": {
+    "entry": "SCRIPT.mjs"
+  },
+  "probe": [
+    "-"
+  ],
+  "probeInput": "---\ndescription: Local tool probe.\n---\n\n# Probe\n"
+}

package/.pbai4devs/tools/opensrc/README.md

@@ -0,0 +1,25 @@
+---
+description: Fontes de dependências com cache local isolado.
+---
+
+# Opensrc
+
+Origem: [Vercel Labs][source]. Apache-2.0; Node 24+ e Git para obter fontes.
+Configuração e canal `latest`: [TOOL.json](TOOL.json).
+
+```console
+node .pbai4devs/tools/opensrc/SCRIPT.mjs install
+node .pbai4devs/tools/opensrc/SCRIPT.mjs run list --json
+node .pbai4devs/tools/opensrc/SCRIPT.mjs run path --help
+```
+
+O instalador usa `--ignore-scripts`: o pacote inclui os binários nativos e seu
+`postinstall` pode alterar atalhos globais. `OPENSRC_HOME` direciona fontes e
+índice em `.local/cache/`. `path pacote@versao` baixa fontes ausentes no cache;
+`list --json` consulta o índice. Downloads de fontes seguem a necessidade da
+tarefa; dependências da aplicação são decididas após os documentos de produto.
+
+Suporta macOS/Linux x64 e ARM64, Linux musl e Windows x64. O release atual
+não inclui binário Windows ARM64. [Operações comuns](../README.md).
+
+[source]: https://github.com/vercel-labs/opensrc/tree/main/packages/opensrc

package/.pbai4devs/tools/opensrc/SCRIPT.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { main } from '../../scripts/preparar-ferramentas/SCRIPT.mjs';
+
+try { process.exitCode = await main(['--tool', "opensrc", ...process.argv.slice(2)]); }
+catch (error) { console.error(error.message); process.exitCode = 1; }

package/.pbai4devs/tools/opensrc/TOOL.json

@@ -0,0 +1,29 @@
+{
+  "name": "opensrc",
+  "description": "Consulta e download de fontes de dependencias.",
+  "group": "source",
+  "source": "https://github.com/vercel-labs/opensrc/tree/main/packages/opensrc",
+  "download": {
+    "provider": "npm",
+    "package": "opensrc",
+    "registry": "https://registry.npmjs.org/",
+    "repository": "vercel-labs/opensrc",
+    "channel": "latest"
+  },
+  "platforms": [
+    "darwin-arm64",
+    "darwin-x64",
+    "linux-arm64",
+    "linux-x64",
+    "win32-x64"
+  ],
+  "scripts": {
+    "entry": "SCRIPT.mjs"
+  },
+  "envPaths": {
+    "OPENSRC_HOME": "cache"
+  },
+  "probe": [
+    "--version"
+  ]
+}

package/.pbai4devs/tools/portless/README.md

@@ -0,0 +1,21 @@
+---
+description: Proxy local opcional para URLs estáveis de desenvolvimento.
+---
+
+# Portless
+
+Origem: [documentação oficial](https://portless.sh). Apache-2.0; Node 24+.
+Configuração e canal `latest`: [TOOL.json](TOOL.json).
+
+```console
+node .pbai4devs/tools/portless/SCRIPT.mjs install
+node .pbai4devs/tools/portless/SCRIPT.mjs run --help
+```
+
+Use o proxy quando a tarefa exigir, seguindo o preparo previsto no projeto.
+Comandos de execução podem iniciar serviços e configurar CA, confiança
+ou hosts; `install` do adaptador apenas prepara o CLI. O estado usa
+`.local/state/` por `PORTLESS_STATE_DIR`; alterações do SO seguem o fluxo
+explícito de configuração da ferramenta. Use o script com o binário local.
+
+[Operações comuns e plataformas](../README.md).

package/.pbai4devs/tools/portless/SCRIPT.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { main } from '../../scripts/preparar-ferramentas/SCRIPT.mjs';
+
+try { process.exitCode = await main(['--tool', "portless", ...process.argv.slice(2)]); }
+catch (error) { console.error(error.message); process.exitCode = 1; }

package/.pbai4devs/tools/portless/TOOL.json

@@ -0,0 +1,30 @@
+{
+  "name": "portless",
+  "description": "Proxy local opcional e URLs de desenvolvimento.",
+  "group": "proxy",
+  "source": "https://portless.sh",
+  "download": {
+    "provider": "npm",
+    "package": "portless",
+    "registry": "https://registry.npmjs.org/",
+    "repository": "vercel-labs/portless",
+    "channel": "latest"
+  },
+  "platforms": [
+    "darwin-arm64",
+    "darwin-x64",
+    "linux-arm64",
+    "linux-x64",
+    "win32-arm64",
+    "win32-x64"
+  ],
+  "scripts": {
+    "entry": "SCRIPT.mjs"
+  },
+  "envPaths": {
+    "PORTLESS_STATE_DIR": "state"
+  },
+  "probe": [
+    "--version"
+  ]
+}

package/.pbai4devs/tools/skills/README.md

@@ -0,0 +1,24 @@
+---
+description: Descoberta de skills externas com o CLI oficial.
+---
+
+# Skills
+
+Origem: [Vercel Labs](https://github.com/vercel-labs/skills). MIT; Node 24+.
+Configuração e canal `latest`: [TOOL.json](TOOL.json).
+
+```console
+node .pbai4devs/tools/skills/SCRIPT.mjs install
+node .pbai4devs/tools/skills/SCRIPT.mjs run find testing
+node .pbai4devs/tools/skills/SCRIPT.mjs run add vercel-labs/agent-skills --list
+```
+
+Use `find` e `add <origem> --list` para descoberta. Importações seguem
+`criar-skill` e `sincronizar-agentes`, preservando a origem em `.pbai4devs`.
+`use <origem>@<skill>` sem `--agent` imprime o prompt sem instalar nem lançar
+outro agente.
+`add` sem `--list`, `update` e `sync` alteram skills, links, cópias ou locks;
+exigem um pedido específico. Telemetria desativada com `DISABLE_TELEMETRY=1`;
+estado em `.local/state/` por `XDG_STATE_HOME`.
+
+[Operações comuns e plataformas](../README.md).

package/.pbai4devs/tools/skills/SCRIPT.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { main } from '../../scripts/preparar-ferramentas/SCRIPT.mjs';
+
+try { process.exitCode = await main(['--tool', "skills", ...process.argv.slice(2)]); }
+catch (error) { console.error(error.message); process.exitCode = 1; }

package/.pbai4devs/tools/skills/TOOL.json

@@ -0,0 +1,33 @@
+{
+  "name": "skills",
+  "description": "Descoberta de skills por meio do CLI oficial.",
+  "group": "discovery",
+  "source": "https://github.com/vercel-labs/skills",
+  "download": {
+    "provider": "npm",
+    "package": "skills",
+    "registry": "https://registry.npmjs.org/",
+    "repository": "vercel-labs/skills",
+    "channel": "latest"
+  },
+  "platforms": [
+    "darwin-arm64",
+    "darwin-x64",
+    "linux-arm64",
+    "linux-x64",
+    "win32-arm64",
+    "win32-x64"
+  ],
+  "scripts": {
+    "entry": "SCRIPT.mjs"
+  },
+  "envPaths": {
+    "XDG_STATE_HOME": "state"
+  },
+  "env": {
+    "DISABLE_TELEMETRY": "1"
+  },
+  "probe": [
+    "--version"
+  ]
+}

package/.pbai4devs/tools/webreel/README.md

@@ -0,0 +1,23 @@
+---
+description: Validação de roteiros e gravações locais de navegador.
+---
+
+# Webreel
+
+Origem: [documentação oficial](https://webreel.dev). Apache-2.0; Node 24+.
+Configuração e canal `latest`: [TOOL.json](TOOL.json).
+
+```console
+node .pbai4devs/tools/webreel/SCRIPT.mjs install
+node .pbai4devs/tools/webreel/SCRIPT.mjs run validate -c roteiro.json
+node .pbai4devs/tools/webreel/SCRIPT.mjs run record --dry-run -c roteiro.json
+```
+
+Para gravar, informe os executáveis existentes em `CHROME_HEADLESS_PATH`,
+`CHROME_PATH` e `FFMPEG_PATH`; sem os overrides o CLI baixa em `~/.webreel`.
+`validate`, `record --dry-run` e os probes dispensam esses downloads.
+Salve vídeos, frames e capturas em `.agent-tests/`; versione os roteiros.
+
+Adaptador: macOS x64/ARM64, Linux x64 e Windows x64. Outras arquiteturas
+exigem executáveis compatíveis por override e validação antes de ampliar o
+[TOOL.json](TOOL.json). [Operações comuns](../README.md).

package/.pbai4devs/tools/webreel/SCRIPT.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { main } from '../../scripts/preparar-ferramentas/SCRIPT.mjs';
+
+try { process.exitCode = await main(['--tool', "webreel", ...process.argv.slice(2)]); }
+catch (error) { console.error(error.message); process.exitCode = 1; }

package/.pbai4devs/tools/webreel/TOOL.json

@@ -0,0 +1,25 @@
+{
+  "name": "webreel",
+  "description": "Validacao de roteiros e gravacao de navegador.",
+  "group": "video",
+  "source": "https://webreel.dev",
+  "download": {
+    "provider": "npm",
+    "package": "webreel",
+    "registry": "https://registry.npmjs.org/",
+    "repository": "vercel-labs/webreel",
+    "channel": "latest"
+  },
+  "platforms": [
+    "darwin-arm64",
+    "darwin-x64",
+    "linux-x64",
+    "win32-x64"
+  ],
+  "scripts": {
+    "entry": "SCRIPT.mjs"
+  },
+  "probe": [
+    "--version"
+  ]
+}

package/CHANGELOG.md

@@ -0,0 +1,58 @@
+---
+description: Alterações verificáveis por versão do AgentDevKit.
+---
+
+# Changelog
+
+## 0.0.5 — 2026-11-11
+
+- Documentação organizada em guias, produto e manutenção, com índices próprios.
+- Instalação e próximos passos usam o pacote nomeado no npm público, sem login.
+- Notas e guias apontam para o registro e sua página de versões.
+- Publicação verifica instalação, diagnóstico e sincronização sem autenticação.
+- Publicação prioriza o secret `NPMJS_TOKEN`; sem token, usa OIDC.
+
+## 0.0.4 — 2026-11-11
+
+- Código em `src/`, testes em `tests/` e publicação em `scripts/release/`.
+- Exemplos completos em `examples/generated/`, com guia versionado e comandos.
+- Preparação dos exemplos sem depender de pastas geradas na raiz.
+- Relatórios de exemplos atualizados, sem reutilizar resultados antigos.
+- Guia rápido de desenvolvimento e automações npm para verificar e empacotar.
+- Compatibilidade de instalação, atualização e publicação mantida.
+
+## Distribuição no GitHub Packages
+
+- Pacote único `@pathbit/agentdevkit` instalável pelo registro com npx.
+- Publicação do artefato verificado e retomada para tags existentes.
+- Documentação de autenticação e acesso aos pacotes.
+
+## 0.0.3 — 2026-11-11
+
+- Fontes do produto, testes e automações concentrados em `.pbai4devs`.
+- Saídas de agentes e preferências locais fora do versionamento.
+- Layouts de clientes declarativos e entradas geradas com preservação humana.
+- Bootstrap JavaScript e uso de npx mantido, sem scripts shell próprios.
+- CI dividido por responsabilidade e release reutilizando artifact aprovado.
+
+## 0.0.2 — 2026-11-11
+
+- Seleção persistente de agentes na instalação e no comando `agents`.
+- Instalação e sincronização limitadas aos clientes escolhidos e dependências.
+- Remoção de apontamentos desmarcados com preservação de arquivos próprios.
+- Pacotes verificados como artifacts do CI e geração manual pelo Actions.
+- Releases reutilizam o pacote testado, com verificação de checksum.
+- Formulários de bugs e melhorias e modelo de pull request.
+- Wiki organizada por tarefa: instalação, CLI, fluxo, recursos e recuperação.
+- Guias de ferramentas, testes, arquitetura, contribuição e releases.
+
+## 0.0.1 — 2026-11-11
+
+- Extração das fontes compartilhadas para o repositório AgentDevKit.
+- Origem `.pbai4devs` com skills, regras, comandos, modelos e testes.
+- Documentação inicial em português, com entradas em inglês e espanhol.
+- CLI para instalar, atualizar, diagnosticar e indicar próximos passos.
+- Testes de distribuição para preservar projetos e excluir artefatos locais.
+
+Os resultados de validação ficam em relatórios ignorados e no CI, separados
+deste registro das funcionalidades entregues.

package/CONTRIBUTING.md

@@ -0,0 +1,73 @@
+---
+description: Como desenvolver, verificar e documentar o AgentDevKit.
+---
+
+# Contribuir
+
+Use [issues][issues] para bugs e propostas. Descreva o contexto, a versão e
+os passos necessários, removendo segredos e dados privados.
+
+## Preparar o checkout
+
+Use Git e Node.js 24+ com npm:
+
+```console
+git clone https://github.com/pathbit/AgentDevKit.git
+cd AgentDevKit
+npm ci --ignore-scripts
+npm run check
+```
+
+O checkout contém fontes. Execute `npm run examples` para explorar os agentes
+em `examples/generated/`, sem criar todas as pastas de clientes na raiz.
+Os exemplos gerados são locais e ignorados; seu guia fica em
+[`examples/`](examples/README.md).
+
+## Escolher a origem da mudança
+
+| Mudança | Origem |
+| --- | --- |
+| CLI e instalação | `src/` e `bin/` |
+| Layout dos clientes | `.pbai4devs/templates/clients/` |
+| Skills, regras e comandos | Respectivas pastas em `.pbai4devs/` |
+| Automação compartilhada | `.pbai4devs/scripts/` |
+| CI e publicação | `scripts/release/` e workflows do GitHub |
+| Testes do produto | `tests/` |
+| Exemplos de uso | `examples/` e gerador compartilhado |
+| Ajuda e exemplos | `docs/` e README do recurso |
+
+Leia o [guia do código-fonte][source] e o [design](docs/product/design.md).
+Modifique fontes e templates, não catálogos, estado ou arquivos dos clientes.
+
+## Verificar e enviar
+
+```console
+npm test
+npm run test:infra
+npm run check
+```
+
+Escolha verificações adicionais pelo impacto da mudança. Instalação exige
+projetos novos e existentes; Git exige preservação do índice e dos arquivos;
+distribuição exige o pacote real. Consulte [testes][tests].
+
+Mantenha testes e fixtures versionados. Relatórios, capturas, downloads,
+apontamentos e preferências locais ficam ignorados. Revise o diff antes de
+enviar e confirme que ele contém somente fontes e mudanças intencionais.
+
+Atualize a documentação e use a [revisão de entrega][review] para reunir
+critérios, evidências e revisão independente. O PR deve explicar problema,
+solução e validação. Siga as [regras Git][git]. A [publicação][release] reutiliza
+o artifact aprovado do CI; não cria um pacote diferente na hora de publicar.
+O mesmo artifact segue para o [npm público][package], usando a autenticação
+do workflow. Nunca inclua tokens no código ou no `.npmrc` versionado.
+
+[Wiki](docs/README.md) · [Licença MIT](LICENSE)
+
+[issues]: https://github.com/pathbit/AgentDevKit/issues
+[source]: docs/maintainers/development.md
+[tests]: docs/guides/tools-and-testing.md
+[review]: .pbai4devs/commands/revisar-entrega/COMMAND.md
+[git]: .pbai4devs/rules/git/RULE.md
+[release]: docs/maintainers/maintenance.md
+[package]: docs/maintainers/packages.md

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PATHBIT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,78 @@
+---
+description: Portable instructions and tools for coding agents.
+language: en
+---
+
+# AgentDevKit
+
+[Português](README.md) · [Español](README.es.md) · [npm package][npm-package]
+
+Organize work with coding agents, from planning to verification. Keep skills,
+rules, commands and agent profiles in `.pbai4devs`; the kit generates the
+references each client can discover. Code lives in `src/`, product tests in
+`tests/`, and shared agent resources in `.pbai4devs/`. Generated client
+folders, entrypoints and preferences stay local and untracked.
+See the [supported clients][clients].
+
+## Start in your project
+
+With Node.js 18+ and npm, run this in your project. No login is required:
+
+```console
+npx @pathbit/agentdevkit init
+```
+
+Choose your coding agents when prompted, or pass `--agents codex,claude`.
+The project saves your selection; use `agents` to view or change it later.
+Without interaction or a saved choice, the default is `all` clients.
+
+Then open the project in your coding agent and ask:
+
+> Read AGENTS.md and use the proximos-passos skill to guide my next steps.
+
+See [installation](docs/guides/installation.md) for Windows, missing Node, previews
+and updates. Install and update through the [public npm package][packages]; the
+[v0.0.5 release][release] retains artifacts and checksums for verification.
+No global installation is required.
+The CLI supports `pt`, `en` and `es`; it saves your selection per project.
+
+## Explore
+
+| I want to… | Read |
+| --- | --- |
+| Understand the kit | [Documentation wiki](docs/README.md) |
+| Plan or resume a project | [Workflow](docs/guides/workflow.md) |
+| Create a skill or command | [Resources](docs/guides/resources.md) |
+| Install tools and verify work | [Tools and tests][tests] |
+| Look up options or fix an error | [CLI][cli] · [Troubleshooting][help] |
+| Improve the kit | [Contributing](CONTRIBUTING.md) |
+| Try the scenarios | [Examples](https://github.com/pathbit/AgentDevKit/tree/master/examples) |
+
+## Develop this repository
+
+Use Node.js 24+ with npm. Run `npm ci --ignore-scripts`, `npm run check`,
+`npm test` and `npm run examples`. Examples are generated locally in
+`examples/generated/`; `npm run test:examples` runs the scenarios.
+See the [development guide](docs/maintainers/development.md) for the project structure.
+
+Detailed guides are in Portuguese. Installing the kit prepares instructions;
+tools are installed separately. Product documents follow your planning
+decisions. Existing projects retain their code and decisions. Discovery
+depends on the client; references alone do not prove a skill was loaded.
+
+[Changelog](CHANGELOG.md) · [Roadmap](docs/product/roadmap.md) · [MIT license](LICENSE)
+
+Found a bug or have an idea? [Open an issue][issues] using the contribution
+forms. See [how to participate](docs/maintainers/community.md).
+
+**[ Next step ]** Follow [installation](docs/guides/installation.md), then ask your
+agent to read `AGENTS.md`.
+
+[clients]: .pbai4devs/COMPATIBILIDADE.md
+[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.5
+[npm-package]: https://www.npmjs.com/package/@pathbit/agentdevkit
+[tests]: docs/guides/tools-and-testing.md
+[cli]: docs/guides/cli.md
+[help]: docs/guides/troubleshooting.md
+[issues]: https://github.com/pathbit/AgentDevKit/issues/new/choose
+[packages]: docs/maintainers/packages.md

package/README.es.md

@@ -0,0 +1,80 @@
+---
+description: Instrucciones y herramientas portátiles para agentes de desarrollo.
+language: es
+---
+
+# AgentDevKit
+
+[Português](README.md) · [English](README.en.md) · [Paquete npm][npm-package]
+
+Organiza el trabajo con agentes de código, desde la planificación hasta la
+verificación. Mantén skills, reglas, comandos y perfiles en `.pbai4devs`;
+el kit genera las referencias de cada [cliente compatible][clients].
+El código vive en `src/`, las pruebas del producto en `tests/` y los recursos
+compartidos en `.pbai4devs/`. Las carpetas, entradas y preferencias generadas
+son locales y no se versionan.
+
+## Empezar en tu proyecto
+
+Con Node.js 18+ y npm, ejecuta en tu proyecto, sin iniciar sesión:
+
+```console
+npx @pathbit/agentdevkit init
+```
+
+Elige tus agentes en la pregunta inicial o usa `--agents codex,claude`.
+La selección se guarda en el proyecto; `agents` permite consultarla o cambiarla.
+Sin interacción ni selección anterior, el valor predeterminado es `all`.
+
+Después, abre el proyecto en tu agente y pide:
+
+> Lee AGENTS.md y usa la skill proximos-passos para orientar mi trabajo.
+
+La [guía de instalación](docs/guides/installation.md) incluye Windows, Node ausente,
+simulación y actualización. Instala y actualiza mediante el
+[paquete npm público][packages];
+la [release v0.0.5][release] conserva artefactos y checksums para verificarlos.
+No requiere instalación global.
+La CLI guarda el idioma `pt`, `en` o `es` por proyecto.
+
+## Explorar
+
+| Quiero… | Leer |
+| --- | --- |
+| Entender el kit | [Wiki](docs/README.md) |
+| Planificar o retomar un proyecto | [Flujo](docs/guides/workflow.md) |
+| Crear una skill o comando | [Recursos](docs/guides/resources.md) |
+| Instalar herramientas y verificar | [Herramientas y pruebas][tests] |
+| Consultar opciones o resolver un error | [CLI][cli] · [Soluciones][help] |
+| Mejorar el kit | [Contribuir](CONTRIBUTING.md) |
+| Probar los escenarios | [Ejemplos](https://github.com/pathbit/AgentDevKit/tree/master/examples) |
+
+## Desarrollar este repositorio
+
+Usa Node.js 24+ con npm. Ejecuta `npm ci --ignore-scripts`, `npm run check`,
+`npm test` y `npm run examples`. Los ejemplos se generan localmente en
+`examples/generated/`; `npm run test:examples` ejecuta los escenarios.
+Consulta la [guía de desarrollo](docs/maintainers/development.md) para conocer
+la estructura.
+
+Las guías detalladas están en portugués. Instalar el kit prepara instrucciones;
+las herramientas se instalan por separado. Los documentos de producto siguen
+las decisiones de planificación. Los proyectos existentes conservan su código.
+Una referencia no demuestra que un cliente haya cargado la skill.
+
+[Changelog](CHANGELOG.md) · [Roadmap](docs/product/roadmap.md) · [Licencia MIT](LICENSE)
+
+¿Encontraste un problema o tienes una idea? [Abre una issue][issues] con los
+formularios. Consulta [cómo participar](docs/maintainers/community.md).
+
+**[ Próximo paso ]** Sigue la [instalación](docs/guides/installation.md) y pide
+al agente que lea `AGENTS.md`.
+
+[clients]: .pbai4devs/COMPATIBILIDADE.md
+[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.5
+[npm-package]: https://www.npmjs.com/package/@pathbit/agentdevkit
+[tests]: docs/guides/tools-and-testing.md
+[cli]: docs/guides/cli.md
+[help]: docs/guides/troubleshooting.md
+[issues]: https://github.com/pathbit/AgentDevKit/issues/new/choose
+[packages]: docs/maintainers/packages.md