rubberducking — método de trabalho com IA

Pacote de templates, guias e skills do Claude Code para trabalhar com agentes de IA (Claude Code, Cursor, Gemini, TestSprite, etc.) de um jeito que preserve agência humana, com papéis definidos, postura cética configurável e rastreabilidade de decisões.

---

⚠️ Status: em construção

Não é versão final. Tudo aqui é v0.x — funciona mas continua evoluindo conforme uso real. As skills do Claude Code já são usáveis hoje; os guias e templates estão estáveis o suficiente pra rodar uma sprint inteira; mas a postura filosófica, os defaults e os formatos podem mudar.

Se algo aqui não fizer sentido pro seu jeito de trabalhar — está certo, é pra adaptar, não pra seguir como dogma. Fork, mude, mande PR ou guarda só pra você.

---

Origem da ideia

Saiu de prática real trabalhando com IA em projetos de software. O jeito padrão (cola código, peço função pronta, aceito a primeira sugestão) entrega rápido, mas erode a capacidade de pensar problema desde a base. O método aqui é o anti-atalho: ritualiza o questionamento que normalmente a gente pula sob pressão de prazo.

Ele nasceu como conjunto de markdowns chumbados em uma pasta pessoal (CLAUDE.md, manifesto, ADRs), virou um padrão "Director + speckit" com papéis, e agora é um pacote instalável de skills que executa o ritual no Claude Code em vez de eu lembrar dele toda sessão.

A premissa que sustenta tudo: AI é interlocutora, não substituta. Se você pede pra IA fazer todo o pensamento, você degrada. Se você usa ela pra te questionar até a ideia aguentar peso, você fortalece. O método existe pra empurrar o uso na segunda direção.

---

O que tem aqui

rubberducking/
├── README.md                       ← você está aqui
├── INSTALL.md                      ← comandos prontos pra copiar
├── guias/
│   ├── 00_PADROES.md                  os padrões aplicados
│   ├── 01_GUIA_OPERACIONAL.md         como usar no dia a dia
│   ├── 02_GUIA_OBSIDIAN.md            knowledge base com IA
│   ├── 03_PADRAO_DIRECTOR.md          o padrão Director + speckit em detalhe
│   └── 04_EXEMPLO_RPA_OPERADORAS.md   exemplo aplicado a um projeto real
├── skills/
│   ├── personalizar-metodo.md      ← skill 0: onboarding (postura + vault + idioma → ~/.claude/metodo-config.md)
│   ├── rubberduck-metodo.md        ← skill 1: rubberducking cético da ideia → BRIEF.md
│   └── iniciar-metodo.md           ← skill 2: scaffold + entrevista cética (consome o BRIEF)
└── templates/
    ├── projeto/                    ← copie pra um projeto novo
    │   ├── CLAUDE.md
    │   ├── CONTEXT_DIRECTOR.md
    │   ├── manifesto.md
    │   ├── AGENTS.md
    │   └── .speckit/                  specs vivas (visão, ADRs, planos, tracking)
    └── obsidian-vault/             ← copie pra um vault de conhecimento
        ├── CLAUDE.md
        ├── GUIA.md
        └── templates/                 templates de notas

Os arquivos em templates/ têm placeholders {{ASSIM}} por dentro. Substitua antes de usar (manualmente, via INSTALL.md, ou via skill).

---

Por onde começar — ordem de leitura

Tempo total: ~30 min de leitura + 10-15 min de onboarding interativo.

1. Este README (3 min) — você já está aqui.
2. guias/00_PADROES.md (5 min) — os 4 padrões aplicados (papéis, sequência fixa, 3 camadas de doc, donos de pasta).
3. guias/01_GUIA_OPERACIONAL.md (15 min) — fluxo de uso no dia a dia.
4. guias/04_EXEMPLO_RPA_OPERADORAS.md (5 min, opcional) — exemplo aplicado a projeto real, ajuda a aterrar o que parece abstrato.
5. INSTALL.md §3 — instala as 3 skills do Claude Code (PowerShell pra Windows, bash pra Linux/macOS).
6. Abre Claude Code em qualquer pasta e diz "configura o método" — a skill personalizar-metodo faz o onboarding interativo.
7. Pronto. Próxima ideia, "rubberduck disso comigo".

Se quiser ler menos: README → INSTALL §3 → roda personalizar-metodo. Os guias você lê quando bater dúvida.

---

Personalize antes de usar

Cada pessoa programa diferente. O método assume que você vai personalizar — não é um framework opinativo do tipo "faça assim ou nada feito". A skill personalizar-metodo é exatamente o ponto onde a personalização acontece.

Ela pergunta:

• Identidade — nome, idioma dos documentos, qual IA você usa pra programar/planejar/testar.
• Vault de conhecimento — Obsidian? Logseq? Pasta global de markdowns? Dentro do projeto? Nenhum (modo efêmero, sem persistência entre sessões)? Cada opção configura a skill diferente.
• Postura filosófica — núcleo do método. Quatro opções pré-prontas (Pragmática, Conexões em blocos, Esforço preservado, Customizada) ou combinação. Define as perguntas canônicas que a IA vai fazer toda vez que você trouxer uma ideia nova.
• Manifesto pessoal opcional — 3-10 linhas sobre por que esse método é seu.

Tudo salva em ~/.claude/metodo-config.md, em markdown lível e editável à mão. As outras skills leem esse arquivo a cada execução — nada hard-coded, tudo dinâmico.

Se a postura padrão não te encaixa, escreva a sua na opção customizada. A skill conduz uma sub-entrevista e exige que você defenda cada pergunta canônica em uma frase. Postura mentirosa é pior que postura simples.

---

Resumo dos padrões

Estrutura para projetos de código:

• 4 papéis: Diretor (humano), Planejador (IA), Programador (IA), QA (IA)
• Sequência fixa: plano → aprovação → execução → teste → registro
• Documentação em 3 camadas:
  • manifesto.md — POR QUE o projeto existe (opcional, raramente muda)
  • CONTEXT_DIRECTOR.md — COMO trabalhamos (raramente muda)
  • .speckit/ — O QUE está sendo construído agora (muda a cada sprint)

Estrutura para Obsidian (opcional):

• Pastas com donos fixos: inbox/ (entrada bruta), notas/ (usuário escreve), wiki/ (IA escreve)
• Frontmatter YAML padronizado
• Links bidirecionais como organização principal

---

Atalho recomendado: 3 skills do Claude Code

1. Setup uma vez: "configura o método" → skill personalizar-metodo faz onboarding (nome, idioma, vault, postura) e salva em ~/.claude/metodo-config.md.
2. Cada nova ideia: "tenho uma ideia, rubberduck disso" → skill rubberduck-metodo debate a ideia aplicando a postura do seu config, e ao final escreve BRIEF.md na pasta do projeto novo, manda pra incubação, ou descarta.
3. Quando virar projeto: "inicia o método aqui" → skill iniciar-metodo consome o BRIEF.md e conduz a entrevista cética pra preencher CONTEXT_DIRECTOR.md e o resto.

Instalação em INSTALL.md §3.

---

Contribuir / dar feedback

Se você usou o método e algo foi útil, ou foi inútil, ou quebrou: abre uma issue. Vale também faísca solta — "a postura pragmática parece fraca pra projetos de pesquisa, talvez precisasse de uma quinta opção" é feedback valioso mesmo sem PR.

PRs aceitos: novos templates, traduções (especialmente EN), correções de typos, melhorias de skill (com justificativa de uso real, não só estética).

---

Última atualização: 2026-05-06 · v0.2 (3 skills, postura configurável)