Ir para o conteúdo

Guia Rápido

Depois de instalado, abra o Claude Code em qualquer projeto e dê uma tarefa através da skill orquestradora.

Partindo de texto livre

/oh-my-sdd "adicionar endpoint de logout que invalida o refresh token"

Partindo de um card do Jira

/oh-my-sdd PROJ-123
/oh-my-sdd https://empresa.atlassian.net/browse/PROJ-123

Se a skill jira-fetch ou uma tool MCP Atlassian estiver disponível, o oh-my-sdd busca automaticamente o título, a descrição e os critérios de aceite do card. Caso contrário, ele pede que você cole a descrição da tarefa.

O que acontece depois

  1. Constitution — se seu projeto ainda não tem .oh-my-sdd/constitution.md, o Claude analisa seu código (stack, configs de lint, convenções já existentes) e o gera, perguntando só o que não conseguiu inferir. Se já existir, esta etapa é apenas uma confirmação.
  2. Specify — o Claude gera .oh-my-sdd/specs/<slug>/spec.md usando sintaxe EARS/GEARS, e então para e pede para você validar.
  3. Plan — depois do spec validado, o Claude gera .oh-my-sdd/specs/<slug>/plan.md — o "como" arquitetural.
  4. Tasks — o Claude quebra o plano em .oh-my-sdd/specs/<slug>/tasks.md, e então para novamente e pede confirmação antes de qualquer código ser escrito.
  5. Implement — só depois dessa segunda confirmação, o Claude implementa as tarefas uma a uma, marcando cada uma como concluída, e reporta quais critérios de aceite de spec.md foram atendidos.

Escala adaptativa

Antes de qualquer sub-skill rodar, Claude classifica sua tarefa e a roteia para o fluxo certo:

Escala Critérios Fluxo
QUICK Bug fix isolado, typo, 1-2 arquivos, sem decisão de design Mini-spec inline + confirmação única, depois implementação direta
SMALL 1 feature isolada, 3-10 arquivos, design já coberto pela constitution Spec condensado + tasks com decisões embutidas, mantendo os 2 checkpoints
MEDIUM Decisões de design, 10-30 arquivos Pipeline completo (constitution → spec → plan → tasks → implement)
LARGE Sistemas, compliance, mudança ampla Pipeline completo

A classificação e o motivo aparecem em uma linha e ficam registrados em .oh-my-sdd/runtime/scale.json. Você pode forçar a escala a qualquer momento ("roda fluxo completo"); o modelo só pode reclassificar para cima quando o trabalho exceder a escala prevista — nunca para baixo sem seu override.

Retomando uma feature

Se você rodar /oh-my-sdd de novo com a mesma tarefa, o Claude detecta a pasta .oh-my-sdd/specs/<slug>/ já existente e trata como continuação — mostrando o spec/plan/tasks atuais e perguntando o que você quer ajustar, em vez de começar do zero.

Uma implementação em andamento também grava estado fino em .oh-my-sdd/runtime/sessions/<slug>.json (tarefa atual, timestamps, status) — gitignored, nunca commitado. Se o session sumir ou corromper, o fluxo reconstrói o estado a partir dos checkboxes de tasks.md e segue; ao fechar a feature, o session é arquivado para não ser retomado de novo.

Saiba mais