{"id":49965662,"url":"https://github.com/roldaobatista/roldao-method","last_synced_at":"2026-05-23T09:04:00.127Z","repository":{"id":358586320,"uuid":"1241979300","full_name":"roldaobatista/roldao-method","owner":"roldaobatista","description":"Framework de desenvolvimento agil com IA, em portugues brasileiro. Especialistas virtuais, regras automaticas e workflows guiados para Claude Code, Cursor e ChatGPT.","archived":false,"fork":false,"pushed_at":"2026-05-18T04:52:45.000Z","size":261,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-18T05:39:04.727Z","etag":null,"topics":["ai-agents","bmad","brazilian-developers","chatgpt","claude-code","cursor","framework","lgpd","portugues-brasileiro","spec-driven-development"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/roldaobatista.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-18T02:50:46.000Z","updated_at":"2026-05-18T04:52:19.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/roldaobatista/roldao-method","commit_stats":null,"previous_names":["roldaobatista/roldao-method"],"tags_count":11,"template":false,"template_full_name":null,"purl":"pkg:github/roldaobatista/roldao-method","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roldaobatista%2Froldao-method","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roldaobatista%2Froldao-method/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roldaobatista%2Froldao-method/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roldaobatista%2Froldao-method/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roldaobatista","download_url":"https://codeload.github.com/roldaobatista/roldao-method/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roldaobatista%2Froldao-method/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33389230,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-23T04:15:53.637Z","status":"ssl_error","status_checked_at":"2026-05-23T04:15:53.242Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","bmad","brazilian-developers","chatgpt","claude-code","cursor","framework","lgpd","portugues-brasileiro","spec-driven-development"],"created_at":"2026-05-18T05:15:20.638Z","updated_at":"2026-05-23T09:04:00.114Z","avatar_url":"https://github.com/roldaobatista.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ROLDAO-METHOD\n\n\u003e Framework de desenvolvimento ágil assistido por IA, **em português brasileiro**, com especialistas virtuais, regras automáticas e fluxos guiados para Claude Code, Cursor, Windsurf, Cline, Roo, Aider, Continue, Gemini CLI e Codex CLI.\n\n[![CI](https://github.com/roldaobatista/roldao-method/actions/workflows/validar.yml/badge.svg)](https://github.com/roldaobatista/roldao-method/actions/workflows/validar.yml)\n[![npm](https://img.shields.io/npm/v/roldao-method.svg)](https://www.npmjs.com/package/roldao-method)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Português](https://img.shields.io/badge/idioma-pt--br-green.svg)](#)\n\n```bash\nnpx roldao-method install      # 1. instala (~2 min)\n# 2. preencha AGENTS.md (campos _(preencher)_)  OU  rode /brownfield se já tem código\n# 3. no Claude Code:\n#    /historia \"Sua primeira feature em uma frase\"\n#    /feature US-001\n```\n\n`/help` lista os 24 workflows. `.claude/agents/MAPA-VISUAL.md` mostra quem chamar. Detalhes em [`docs/QUICKSTART.md`](docs/QUICKSTART.md). Novidades em [`CHANGELOG.md`](CHANGELOG.md).\n\n---\n\n## O problema\n\nFerramentas de IA pra desenvolvimento (Cursor rules, agentes Claude Code, frameworks de prompt) são **todas em inglês**. Devs brasileiros perdem nuance e ainda têm que adaptar exemplos gringos pra realidade BR (LGPD, NF-e, Pix, Receita Federal). E pior: a maioria pula direto pra escrever código. Sem investigar. Sem ler o estado real do banco, dos logs, do payload.\n\n## Por que ROLDAO\n\nEm uma linha: **outros frameworks orientam o agente. ROLDAO impede o erro.**\n\n- 🇧🇷 **PT-BR nativo** — não é tradução. Tabela de jargão integrada pra usuário não-programador.\n- 🛡️ **35 hooks (26 bloqueadores + 2 soft warnings + 5 lifecycle + 2 utilitários)** — bloqueadores barram a ação na hora (via `exit 2` ou JSON `decision:block`); soft warnings avisam sem bloquear; lifecycle automatiza ciclo (format, snapshot, audit).\n- 🔍 **Investigação obrigatória em bug** — REGRA #0 codificada em workflow `/bug` + hook mecânico.\n- 🧾 **Cobertura BR real** — LGPD, NF-e, NFC-e, eSocial, Pix, CNPJ alfanumérico (jul/2026), Reforma Tributária 2026-2033 + 6 addons verticais.\n- 🧪 **3 auditores especializados** — segurança, qualidade, produto rodando em paralelo, bloqueando commit se reprovado.\n\n## Instalação\n\n```bash\nnpx roldao-method install              # instala\nnpx roldao-method update               # atualiza, preserva customizações\nnpx roldao-method doctor               # diagnostica instalação\nnpx roldao-method list                 # lista IDEs detectadas + addons + versão remota\nnpx roldao-method add \u003caddon\u003e          # instala addon (electron-br, fiscal-br-completo, etc.)\nnpx roldao-method remove \u003caddon\u003e       # remove addon (preserva core)\nnpx roldao-method search [termo]       # busca addons disponíveis\nnpx roldao-method tasks-to-issues      # cria GitHub Issues a partir de T-NNN\nnpx roldao-method uninstall            # remove (preserva AGENTS.md, CLAUDE.md, REGRAS)\n```\n\nFlags: `--yes` (CI), `--force`, `--dry-run`, `--no-color`. Aliases: `roldao-method` ou só `roldao`.\n\n### Requisitos\n\n- **Node.js 18+** (CI: 20+).\n- **bash 3.2+** (macOS/Linux nativo; Windows via **Git Bash**).\n- **Perl 5.12+** — usado pelos hooks para parsing seguro de JSON (já vem com Git for Windows, macOS e quase toda distro Linux).\n- **Python 3.8+** (opcional) — usado pelas skills de validação. Sem Python local, executam em CI; testes marcam SKIP claro.\n- **Windows:** rode o Claude Code a partir do **Git Bash**. PowerShell puro **não roda os hooks** — ficam silenciosos. Ver [docs/TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md#hooks).\n\n## O que vem instalado\n\n- **14 especialistas virtuais com personalidade** — Maestro (orquestrador), Sofia (PM), Detetive (investigador), Rafael (tech-lead), Bruno (dev), Helena (DBA), Inês (revisor), Caio/Julia/Pedro (3 auditores), Mariana (analista), Lia (UX), Dona Marta (fiscal-BR), Camila (tech-writer). Catálogo em [`.claude/agents/MAPA-VISUAL.md`](templates/.claude/agents/MAPA-VISUAL.md). Detalhes em [`AGENTS.md §4`](AGENTS.md).\n- **24 workflows (slash commands)** — `/inicio`, `/brownfield`, `/prd`, `/epico`, `/historia`, `/clarificar`, `/feature`, `/quick-dev`, `/bug`, `/hotfix`, `/incident-postmortem`, `/refactor`, `/qa`, `/auditoria`, `/consistencia`, `/retro`, `/replanejar`, `/sprint`, `/status`, `/checkpoint`, `/release`, `/readiness`, `/help`, `/shard`. Detalhes em [`AGENTS.md §5`](AGENTS.md).\n- **26 hooks bloqueadores + 2 soft warnings + 5 lifecycle + 2 infra (`_lib.sh`, `_test-runner.sh`) = 35 hooks** — tabela completa em [`.claude/rules/roldao-method.md`](templates/.claude/rules/roldao-method.md). Inclui: destrutivo, secrets, mascaramento, mock em integration, TODO sem ID, dado real em fixture, URLs hardcoded, chave Pix em log, fix sem investigação, readiness, sequência de agentes, escopo /quick-dev, checkpoint antes de merge, 3 auditores antes de commit, jargão PT-BR, pergunta de confirmação, pipeline incompleto.\n- **12 skills BR core** — validar-cpf-cnpj (com CNPJ alfanumérico jul/2026), validar-chave-acesso-nfe (44 dígitos NF-e/NFC-e/CT-e/MDF-e), validar-pix, validar-cep, validar-ie (27 UFs), validar-boleto, gerar-br-code, gerar-test-fixture-br, gerar-adr-pt-br, traduzir-jargao, brainstormar-ideia, checklist-lgpd. +16 nos addons = **28 skills** (inclui `calculadora-reforma-paralela` pra LC 214/2025).\n- **12 templates de spec** PT-BR (PRD, story, architecture, fullstack-arch, brownfield-PRD, PRD-fiscal, decision-log, PRFAQ, product-brief, UX-design, headless-schemas, épico).\n- **8 checklists auditáveis** + **7 knowledge bases** + **6 addons verticais BR**.\n\n\u003e **Escopo honesto dos hooks:** são guarda-corpos para um agente **cooperativo e desatento** (o caso comum). Barram o erro óbvio na hora. **Não são sandbox contra agente malicioso**: quem tem `Write` pode reescrever `settings.json`. Em Windows sem Git Bash não rodam. Defesa em profundidade, não garantia criptográfica.\n\n## Cobertura BR — IDs rastreáveis em commit\n\n`REGRAS-INEGOCIAVEIS.md` tem a lista completa: **43 regras operacionais em 7 categorias** — INV-001..006 (6 invariantes gerais), SEC-001..005 (5 segurança), TST-001..004 (4 testes), LGPD-001..010 (10 proteção de dados), FISCAL-001..007 (7 fiscal BR), PIX-001..005 (5 Pix/Open Finance), INV-AGENT-001..006 (6 regras pra agentes IA). Cada regra cita-se em commit/ADR/PR (ex: `fix: ajusta validação CPF (LGPD-001)`).\n\n## 6 addons verticais\n\n| Addon | Foco |\n|---|---|\n| [`electron-br`](addons/electron-br/) | App Electron com IPC seguro + SQLite + LGPD local |\n| [`fiscal-br-completo`](addons/fiscal-br-completo/) | NF-e 55, NFC-e, NFS-e, CNPJ alfanumérico, Reforma Tributária 2026-2033 |\n| [`lgpd-compliance`](addons/lgpd-compliance/) | DPO virtual, RIPD, canal do titular, plano de incidente 72h |\n| [`fintech-br`](addons/fintech-br/) | Pix completo (BR Code, webhook HMAC, devolução, Pix Automático), Open Finance |\n| [`esocial-completo`](addons/esocial-completo/) | Eventos S-1000 a S-3000, CIPA, NRs, prazo legal, retificação |\n| [`varejo-pdv-br`](addons/varejo-pdv-br/) | SAT-CF-e, NFC-e, TEF, MFE-CE, ECF, integração com balança/impressora |\n\nInstalar: `npx roldao-method add \u003cnome\u003e`. Criar o seu: [addons/README.md](addons/README.md).\n\n## Fluxo do `/feature`\n\n```\n[Pedido informal] → /feature\n       ↓\n[1. gerente-produto] estrutura US-NNN + AC + non-goals\n       ↓\n[2. investigador]   lê código existente, mapeia impacto (NÃO escreve código)\n       ↓\n[3. tech-lead]      ADR se decisão arquitetural (pula se trivial)\n       ↓\n[4. dev-senior]     implementa + testes (TDD na lógica crítica)\n       ↓\n[5. revisor]        aderência à US + caça anti-padrões + hooks ativos\n       ↓\n[6. auditores]      auditor-seguranca + auditor-qualidade + auditor-produto\n       ↓\n[Saída]             US entregue + commits atômicos rastreáveis\n```\n\nMudança trivial (≤ 3 arquivos, ≤ 50 linhas)? Use `/quick-dev`. Bug reportado? `/bug` — REGRA #0 obriga `investigador` antes.\n\n## Suporte por IDE — paridade real\n\nHooks bash rodam **só no Claude Code**. Nos outros 8 IDEs a disciplina vem por **prompt textual** (regra carregada via `.cursorrules`/`.windsurf/rules`/etc.).\n\n| Feature | Claude Code | Cursor | Windsurf | Continue | Cline | Roo | Aider | Gemini | Codex |\n|---|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|:-:|\n| Agentes (14) | ✅ exec | 📝 texto | 📝 texto | 📝 texto | 📝 texto | 📝 texto | 📝 texto | 📝 texto | 📝 texto |\n| Hooks bloqueadores (26) | ✅ exit 2 | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |\n| Comandos (24) | ✅ exec | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |\n| Skills (12 core) | ✅ exec | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ | ❌ |\n| Spec-driven + PT-BR | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n\nUsa Cursor/Windsurf/etc. e quer hooks mecânicos? Rode o Claude Code em paralelo nos pontos críticos (commit, release).\n\n## O que o ROLDAO-METHOD NÃO faz (non-goals)\n\n- ❌ Não é runtime de IA — depende de Claude Code, Cursor ou similares.\n- ❌ Não gera código sozinho — estrutura o trabalho do agente.\n- ❌ Não é IDE/editor.\n- ❌ Não substitui CI/CD do produto final.\n- ❌ Não é certificação legal/fiscal — orienta, não certifica.\n- ❌ Não trava idiomas além de PT-BR.\n- ❌ Não é template de projeto (Django/React/etc).\n\n## Documentação\n\n- [Quickstart](docs/QUICKSTART.md) — do zero ao primeiro `/feature` em 5 min\n- [Como funciona](docs/COMO-FUNCIONA.md) — estrutura + fluxo\n- [Exemplo de feature completa](docs/EXEMPLO-FEATURE-COMPLETA.md) — transcrição realista\n- [Exemplos materializados](docs/examples/README.md) — story preenchida (US-001) com campos vivos\n- [Estendendo o framework](docs/EXTENDENDO.md) — criar agente, hook, skill ou addon\n- [Plan mode + sessões](docs/PLAN-MODE-E-SESSOES.md) — revisar antes de tocar disco, retomar sessão\n- [FAQ](docs/FAQ.md) · [Troubleshooting](docs/TROUBLESHOOTING.md)\n- [Casos de uso BR](docs/CASOS-DE-USO-BR.md) — NF-e, telemedicina, Pix, eSocial, e-commerce, EAD, Open Finance\n- [Guia MCP](docs/MCP-GUIA-BR.md) · [Arquitetura](docs/ARQUITETURA.md)\n- [Publicar no npm](docs/PUBLICAR-NPM.md) — processo de release pro mantenedor\n- [Roadmap público](ROADMAP.md) · [Addons](addons/README.md)\n\n## Licença · Contribuir · Suporte\n\nMIT. Pull requests bem-vindos (foco em qualidade e clareza \u003e volume — ver [CONTRIBUTING.md](CONTRIBUTING.md)).\n\n- Issues: https://github.com/roldaobatista/roldao-method/issues\n- Discussões: https://github.com/roldaobatista/roldao-method/discussions\n\n---\n\n**Criado por:** Roldão · **Inspirado por:** experiência real construindo SaaS regulado no Brasil\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froldaobatista%2Froldao-method","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froldaobatista%2Froldao-method","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froldaobatista%2Froldao-method/lists"}