{"_id":"@brxlabs/brx-ai-dev","_rev":"3-dd136a0395766c15aed79d076e8e9f95","name":"@brxlabs/brx-ai-dev","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@brxlabs/brx-ai-dev","version":"0.1.0","keywords":["brx","ai","workflow","bmad","speckit","claude","gemini","codex","agent-deck","opencode"],"license":"UNLICENSED","_id":"@brxlabs/brx-ai-dev@0.1.0","maintainers":[{"name":"wbicca","email":"wbicca@gmail.com"}],"bin":{"brx-ai-dev":"bin/brx-ai-dev.js"},"dist":{"shasum":"305a48588af443bd28cfd96678d64cabf8f5e73a","tarball":"https://registry.npmjs.org/@brxlabs/brx-ai-dev/-/brx-ai-dev-0.1.0.tgz","fileCount":3,"integrity":"sha512-RyWhHEqqMZ/X2atghnZD+0Wd12+xfPsT5Lt4LhYY7lwHFB0Yi6RI/jgs+V7NBgzsDIiG1DTsnNKrwrK1GyKJ1Q==","signatures":[{"sig":"MEUCIHWJ1pqCJQSNcglB69neCHSHUrJUU+Dq62dIlnu51a7CAiEAzlmPja0Z3U1GsSHWNZ6XYvxH0qEw7a6zZFPlDaWAtIA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22753},"type":"module","engines":{"node":">=18"},"gitHead":"dc232fc1879a25bbb18743fdb950685f46e90a7e","private":false,"_npmUser":{"name":"wbicca","email":"wbicca@gmail.com"},"_npmVersion":"11.12.1","description":"Instalador oficial do BRX AI Dev Workflow para Windows, Linux e macOS","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/brx-ai-dev_0.1.0_1779286369535_0.7709493891531891","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@brxlabs/brx-ai-dev","version":"0.1.1","keywords":["brx","ai","workflow","bmad","speckit","claude","gemini","codex","agent-deck","opencode"],"license":"UNLICENSED","_id":"@brxlabs/brx-ai-dev@0.1.1","maintainers":[{"name":"wbicca","email":"wbicca@gmail.com"}],"bin":{"brx-ai-dev":"bin/brx-ai-dev.js"},"dist":{"shasum":"bae89955b1cb5f1bd164d2f5a574b43cfd075ac8","tarball":"https://registry.npmjs.org/@brxlabs/brx-ai-dev/-/brx-ai-dev-0.1.1.tgz","fileCount":3,"integrity":"sha512-oq78nUQzQRjPFp3yq59QKWz1gom+gxcZywv+2bVtVoLuZw1tt5UAEa8q0VEY8+xxDtIOT7UdBI4ajaLwoVpR7A==","signatures":[{"sig":"MEUCIE2QlIdX2KWJhLjBmpQrhWoLR4xzPXiHe7EtkyAa1U7RAiEA7jmt4L8SOJKY10u8M4jBzB6p436TnGpDuJJ/aC7PURU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22751},"type":"module","engines":{"node":">=18"},"gitHead":"d472286da9c3df70b93ad77c266390efa6368790","private":false,"_npmUser":{"name":"wbicca","email":"wbicca@gmail.com"},"_npmVersion":"11.12.1","description":"Instalador oficial do BRX AI Dev Workflow para Windows, Linux e macOS","directories":{},"_nodeVersion":"24.15.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/brx-ai-dev_0.1.1_1779288577998_0.5328875425902162","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@brxlabs/brx-ai-dev","version":"0.1.2","description":"Instalador oficial do BRX AI Dev Workflow para Windows, Linux e macOS","type":"module","bin":{"brx-ai-dev":"bin/brx-ai-dev.js"},"keywords":["brx","ai","workflow","bmad","speckit","claude","gemini","codex","agent-deck","opencode"],"engines":{"node":">=18"},"license":"UNLICENSED","private":false,"gitHead":"1f23caa8502d3c76ad9d6cb4f4208d706a27d922","_id":"@brxlabs/brx-ai-dev@0.1.2","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-eQH0ueY4Hpncm7k6H+UZhA7e885vtQ/lYHtnie8u5PeTiZ28sbXABjgbE80bWbcGqZBIfdL69e/mO9i4Damayg==","shasum":"7011d0232ff37bf98892eeddf3f2d8c18762ec23","tarball":"https://registry.npmjs.org/@brxlabs/brx-ai-dev/-/brx-ai-dev-0.1.2.tgz","fileCount":3,"unpackedSize":23923,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDWMftORM1X02y/Cd0mCf0o2wEINmpR+BKYfLZ6QMJeUAIgZxZ3Jyc0SkdUOYnAlVZ0BcS3XHOBA6poyqH+VRz6Ysk="}]},"_npmUser":{"name":"wbicca","email":"wbicca@gmail.com"},"directories":{},"maintainers":[{"name":"wbicca","email":"wbicca@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/brx-ai-dev_0.1.2_1779384798556_0.4305867306647979"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-20T14:12:49.341Z","modified":"2026-05-21T17:33:18.815Z","0.1.0":"2026-05-20T14:12:49.671Z","0.1.1":"2026-05-20T14:49:38.186Z","0.1.2":"2026-05-21T17:33:18.699Z"},"license":"UNLICENSED","keywords":["brx","ai","workflow","bmad","speckit","claude","gemini","codex","agent-deck","opencode"],"description":"Instalador oficial do BRX AI Dev Workflow para Windows, Linux e macOS","maintainers":[{"name":"wbicca","email":"wbicca@gmail.com"}],"readme":"# BRX AI Dev Installer\n\nInstalador oficial do **BRX AI Dev Workflow**.\n\nEste pacote fornece uma CLI cross-platform para iniciar, configurar, validar e organizar projetos da BRX com desenvolvimento assistido por IA.\n\nCompatível com:\n\n- Windows\n- Linux\n- macOS\n- WSL\n- Git Bash\n- PowerShell\n- Terminal Unix\n\n---\n\n## Visão geral\n\nO `brx-ai-dev-installer` é responsável por automatizar a criação e configuração de projetos baseados no template oficial da BRX:\n\n```txt\nbrx-ai-dev-template\n```\n\nA ideia é permitir que qualquer projeto novo da BRX já comece com:\n\n- estrutura padrão de documentação;\n- arquivos de contexto para agentes;\n- BMAD configurado;\n- Spec Kit configurado para Claude Code;\n- Agent Deck com sessões padrão;\n- OpenCode com agentes auxiliares;\n- validações básicas do projeto;\n- workflow documentado.\n\n---\n\n## Stack do workflow BRX\n\nO instalador prepara o projeto para trabalhar com:\n\n| Ferramenta | Função |\n|---|---|\n| Cursor | Editor visual e controle humano |\n| BMAD | Método macro: visão, PRD, arquitetura, épicos e stories |\n| Spec Kit | Especificação por feature: spec, plan, tasks e implement |\n| Gemini CLI | Planejamento, arquitetura e leitura ampla |\n| Claude Code | Implementação principal |\n| Codex | Revisão técnica |\n| Agent Deck | Gerenciamento de sessões de agentes |\n| OpenCode | Agentes auxiliares, documentação e auditoria |\n\n---\n\n## Diferença entre template e instalador\n\nA BRX usa dois repositórios separados:\n\n```txt\nbrx-ai-dev-template\nbrx-ai-dev-installer\n```\n\n### `brx-ai-dev-template`\n\nÉ o repositório base usado para criar novos projetos.\n\nEle contém:\n\n- `AGENTS.md`\n- `CLAUDE.md`\n- `GEMINI.md`\n- `CODEX.md`\n- `docs/brx/*`\n- `opencode.json`\n- `.opencode/agent/*`\n- `.agent-deck/*`\n- `.github/*`\n- scripts auxiliares\n- estrutura inicial de pastas\n\n### `brx-ai-dev-installer`\n\nÉ este repositório.\n\nEle contém a CLI que automatiza:\n\n- criação de projeto a partir do template;\n- instalação do BMAD;\n- inicialização do Spec Kit;\n- criação de sessões no Agent Deck;\n- validação do ambiente;\n- validação da estrutura do projeto.\n\n---\n\n## Instalação\n\nDurante o desenvolvimento local do instalador:\n\n```bash\nnpm install\nnpm link\n```\n\nDepois disso, o comando ficará disponível localmente:\n\n```bash\nbrx-ai-dev help\n```\n\nDepois de publicado no npm, o uso recomendado será:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest help\n```\n\n---\n\n## Requisitos\n\nPara usar o workflow completo, o ambiente deve ter:\n\n| Ferramenta | Obrigatória? | Uso |\n|---|---:|---|\n| Node.js 18+ | Sim | Executar o instalador |\n| Git | Sim | Controle de versão |\n| GitHub CLI (`gh`) | Sim para `new` | Criar repositórios a partir do template |\n| `uvx` / `uv` | Sim para Spec Kit | Inicializar Spec Kit |\n| Gemini CLI | Recomendado | Planejamento |\n| Claude Code | Recomendado | Implementação |\n| Codex CLI | Recomendado | Revisão |\n| Agent Deck | Recomendado | Sessões |\n| OpenCode | Recomendado | Agentes auxiliares |\n\n---\n\n## Comandos disponíveis\n\n```bash\nbrx-ai-dev new <nome-do-projeto> [--private|--public] [--owner brxlabs]\nbrx-ai-dev install [--yes]\nbrx-ai-dev agentdeck\nbrx-ai-dev doctor\nbrx-ai-dev verify\nbrx-ai-dev help\n```\n\n---\n\n## Criar um projeto novo\n\nUse:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest new crm-brx --private\n```\n\nEsse comando cria um novo repositório no GitHub a partir do template:\n\n```txt\nbrxlabs/brx-ai-dev-template\n```\n\nExemplo com owner customizado:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest new crm-brx --private --owner brxlabs\n```\n\nExemplo público:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest new crm-brx --public\n```\n\nFluxo esperado:\n\n```txt\n1. Criar repositório a partir do template\n2. Clonar repositório localmente\n3. Entrar na pasta do projeto\n4. Rodar instalação BRX\n5. Inicializar BMAD\n6. Inicializar Spec Kit\n7. Criar sessões Agent Deck\n```\n\n---\n\n## Instalar o workflow em um projeto existente\n\nDentro de um projeto criado a partir do template:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest install\n```\n\nEsse comando pode:\n\n- criar pastas base;\n- remover arquivos locais indesejados, como `.DS_Store`;\n- instalar/inicializar BMAD;\n- inicializar Spec Kit com integração Claude Code;\n- validar estrutura do projeto;\n- criar sessões no Agent Deck.\n\nModo sem perguntas interativas:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest install --yes\n```\n\n---\n\n## Validar ambiente\n\nUse:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest doctor\n```\n\nEsse comando verifica se as ferramentas principais estão instaladas:\n\n- Git\n- Node.js\n- npm\n- npx\n- uvx\n- GitHub CLI\n- Gemini CLI\n- Claude Code\n- Codex CLI\n- Agent Deck\n- OpenCode\n\nExemplo de saída esperada:\n\n```txt\n✅ Git\n✅ Node.js\n✅ npm\n✅ npx\n✅ uvx / uv\n✅ GitHub CLI\n✅ Gemini CLI\n✅ Claude Code\n✅ Codex CLI\n✅ Agent Deck\n✅ OpenCode\n```\n\n---\n\n## Criar sessões no Agent Deck\n\nUse:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest agentdeck\n```\n\nEsse comando cria quatro sessões padrão:\n\n```txt\nnome-do-projeto - Gemini Planner\nnome-do-projeto - Claude Builder\nnome-do-projeto - Codex Reviewer\nnome-do-projeto - OpenCode Helper\n```\n\nCom grupo:\n\n```txt\nnome-do-projeto\n```\n\n### Papéis das sessões\n\n#### Gemini Planner\n\nResponsável por:\n\n- ler contexto amplo;\n- validar arquitetura;\n- analisar impacto;\n- mapear riscos;\n- sugerir plano técnico.\n\n#### Claude Builder\n\nResponsável por:\n\n- implementar tasks aprovadas;\n- seguir BMAD + Spec Kit;\n- rodar validações;\n- corrigir pontos levantados por revisão.\n\n#### Codex Reviewer\n\nResponsável por:\n\n- revisar diffs;\n- identificar bugs;\n- validar segurança;\n- revisar tipagem;\n- checar aderência à spec;\n- classificar revisão como aprovado, aprovado com ajustes ou bloqueado.\n\n#### OpenCode Helper\n\nResponsável por:\n\n- atualizar documentação;\n- auditar alinhamento BMAD + Spec Kit;\n- dividir tasks grandes;\n- ajudar com tarefas auxiliares.\n\n---\n\n## Verificar estrutura do projeto\n\nUse:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest verify\n```\n\nEsse comando valida se o projeto possui os arquivos e pastas esperados:\n\n- `README.md`\n- `AGENTS.md`\n- `CLAUDE.md`\n- `GEMINI.md`\n- `CODEX.md`\n- `opencode.json`\n- `docs/brx`\n- `specs`\n- `_bmad-output`\n- `.agent-deck`\n- `.opencode`\n\nTambém valida:\n\n- se `opencode.json` é JSON válido;\n- se os arquivos Markdown possuem fences pareadas;\n- se a estrutura base do workflow existe.\n\n---\n\n## Como funciona a integração BMAD + Spec Kit\n\nO workflow BRX usa BMAD e Spec Kit juntos.\n\n### BMAD\n\nBMAD é usado para a camada macro do projeto:\n\n```txt\nvisão\n↓\nProduct Brief\n↓\nPRD\n↓\nArquitetura\n↓\nÉpicos\n↓\nStories\n↓\nSprint Planning\n```\n\n### Spec Kit\n\nSpec Kit é usado para a execução por feature:\n\n```txt\nconstitution\n↓\nspecify\n↓\nclarify\n↓\nchecklist\n↓\nplan\n↓\ntasks\n↓\nanalyze\n↓\nimplement\n```\n\n### Hierarquia\n\n```txt\nBMAD manda no macro.\nSpec Kit manda na execução da feature.\nGemini planeja.\nClaude Code implementa.\nCodex revisa.\nAgent Deck organiza.\nOpenCode auxilia.\nCursor aprova.\n```\n\n---\n\n## Comando usado para inicializar Spec Kit\n\nO instalador usa:\n\n```bash\nuvx --from git+https://github.com/github/spec-kit.git specify init . --integration claude --script sh --force\n```\n\nEsse comando tem como objetivo:\n\n- inicializar o Spec Kit no projeto atual;\n- configurar a integração com Claude Code;\n- permitir o uso dos comandos `/speckit.*`;\n- usar scripts do tipo `sh`;\n- executar sem confirmação interativa em diretório atual.\n\n---\n\n## Comandos esperados dentro do Claude Code\n\nDepois de inicializar o Spec Kit, o Claude Code deve reconhecer comandos como:\n\n```txt\n/speckit.constitution\n/speckit.specify\n/speckit.clarify\n/speckit.checklist\n/speckit.plan\n/speckit.tasks\n/speckit.analyze\n/speckit.implement\n```\n\n---\n\n## Fluxo recomendado para projeto novo\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest new crm-brx --private\ncd crm-brx\ncursor .\n```\n\nDepois, no projeto:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest doctor\nnpx @brxlabs/brx-ai-dev@latest verify\n```\n\nNo Claude Code:\n\n```txt\nbmad-help\n```\n\nDepois seguir o fluxo BMAD:\n\n```txt\nbmad-brainstorming\nbmad-product-brief\nbmad-prd\nbmad-create-ux-design\nbmad-create-architecture\nbmad-generate-project-context\nbmad-create-epics-and-stories\nbmad-check-implementation-readiness\nbmad-sprint-planning\n```\n\nPara cada feature relevante:\n\n```txt\n/speckit.specify\n/speckit.clarify\n/speckit.checklist\n/speckit.plan\n/speckit.tasks\n/speckit.analyze\n/speckit.implement\n```\n\n---\n\n## Fluxo recomendado para projeto existente\n\nDentro da pasta do projeto:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest install\n```\n\nDepois:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest verify\nnpx @brxlabs/brx-ai-dev@latest agentdeck\n```\n\n---\n\n## Publicação no npm\n\nAntes de publicar:\n\n```bash\nnpm pack --dry-run\n```\n\nValidar se o pacote inclui apenas:\n\n```txt\nbin/\nREADME.md\nLICENSE\npackage.json\n```\n\nFazer login:\n\n```bash\nnpm login\n```\n\nPublicar:\n\n```bash\nnpm publish --access public\n```\n\nDepois de publicado:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest help\nnpx @brxlabs/brx-ai-dev@latest doctor\n```\n\n---\n\n## Desenvolvimento local\n\nClone o repositório:\n\n```bash\ngit clone https://github.com/brxlabs/brx-ai-dev-installer.git\ncd brx-ai-dev-installer\n```\n\nInstale/link localmente:\n\n```bash\nnpm install\nnpm link\n```\n\nTeste:\n\n```bash\nbrx-ai-dev help\nbrx-ai-dev doctor\nbrx-ai-dev verify\n```\n\n---\n\n## Estrutura do repositório\n\n```txt\nbrx-ai-dev-installer/\n├── bin/\n│   └── brx-ai-dev.js\n├── README.md\n├── package.json\n├── .gitignore\n└── LICENSE\n```\n\n---\n\n## Comandos internos principais\n\n### `new`\n\nCria um novo projeto a partir do template BRX.\n\n```bash\nbrx-ai-dev new crm-brx --private\n```\n\n### `install`\n\nConfigura o workflow BRX em um projeto existente.\n\n```bash\nbrx-ai-dev install\n```\n\n### `doctor`\n\nVerifica se as ferramentas necessárias estão instaladas.\n\n```bash\nbrx-ai-dev doctor\n```\n\n### `agentdeck`\n\nCria sessões padrão no Agent Deck.\n\n```bash\nbrx-ai-dev agentdeck\n```\n\n### `verify`\n\nVerifica se a estrutura do projeto está correta.\n\n```bash\nbrx-ai-dev verify\n```\n\n### `help`\n\nMostra ajuda.\n\n```bash\nbrx-ai-dev help\n```\n\n---\n\n## Segurança\n\nO instalador deve evitar comandos destrutivos.\n\nEle pode remover apenas arquivos locais conhecidos e seguros, como:\n\n```txt\n.DS_Store\nThumbs.db\nehthumbs.db\nDesktop.ini\n```\n\nO instalador não deve:\n\n- apagar código do projeto;\n- apagar `.env`;\n- fazer commit automaticamente;\n- fazer push automaticamente;\n- publicar no npm automaticamente;\n- executar comandos destrutivos sem confirmação.\n\n---\n\n## Boas práticas\n\nAntes de publicar uma nova versão:\n\n```bash\nnode bin/brx-ai-dev.js help\nnode bin/brx-ai-dev.js doctor\nnode bin/brx-ai-dev.js verify\nnpm pack --dry-run\n```\n\nDepois:\n\n```bash\nnpm version patch\nnpm publish --access public\n```\n\n---\n\n## Roadmap\n\nPossíveis comandos futuros:\n\n```bash\nbrx-ai-dev update\nbrx-ai-dev doctor --fix\nbrx-ai-dev init-feature nome-da-feature\nbrx-ai-dev prompts\nbrx-ai-dev audit\n```\n\n### `update`\n\nAtualizar arquivos do workflow BRX em projetos antigos.\n\n### `doctor --fix`\n\nCorrigir automaticamente pequenos problemas, como permissões e arquivos locais indesejados.\n\n### `init-feature`\n\nCriar estrutura inicial para uma feature em `specs/`.\n\n### `prompts`\n\nExibir prompts padrão para Gemini, Claude, Codex e OpenCode.\n\n### `audit`\n\nAuditar o projeto contra o padrão BRX.\n\n---\n\n## Licença\n\nUso interno da BRX Labs.\n\n---\n\n## Resumo\n\nO `brx-ai-dev-installer` é o instalador oficial do padrão de desenvolvimento assistido por IA da BRX.\n\nEle permite iniciar projetos com um comando:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest new crm-brx --private\n```\n\nE manter o workflow consistente com:\n\n```bash\nnpx @brxlabs/brx-ai-dev@latest install\nnpx @brxlabs/brx-ai-dev@latest doctor\nnpx @brxlabs/brx-ai-dev@latest verify\nnpx @brxlabs/brx-ai-dev@latest agentdeck\n```","readmeFilename":"README.md"}