Skill: kata-fit

Fase 0 do Karpathy Development Cycle — FIT.

Inspirado no fit gate do The Fable Method
(think → act → prove → grow) e no Karpathy Development Cycle.

Objetivo

Antes de iniciar o ciclo THINK → SIMPLIFY → SURGICAL → VERIFY, classificar
a tarefa para evitar desperdício de rigor em tarefas triviais ou mal-classificadas:

1. Triviality gate: a tarefa é trivial? (1 arquivo, <10 linhas, sem busca)
2. Fit gate: onde vive a resposta? — code-loop, plan-first, question, research, inference

Ferramentas

Para esta fase, use:

• Bash: git diff --stat e git diff --name-only para medir volume do diff.
• AskUserQuestion (via kata-question): classifique a tarefa com o usuário, uma pergunta por vez.
• Grep: investigue se a tarefa exige pesquisa no código.
• Write / Edit: registre a classificação em .kata/<task>.yaml.

Procedimento

1. Triviality gate

Execute (via Bash):

git diff --stat          # unstaged
git diff --name-only

Se ambos vazios:

git diff --cached --stat # staged
git diff --cached --name-only

Critério de trivialidade (todos precisam ser verdade):

• Apenas 1 arquivo alterado
• Menos de 10 linhas totais de alteração
• Nenhum novo comportamento (só correção de typo, rename local, ajuste de comentário)
• Você já sabe exatamente o que mudar sem precisar pesquisar

Se trivial:

Faça a mudança, confirme com a verificação óbvia
(re-leia o span alterado, ou rode o comando/lint que a mudança afeta),
e reporte em uma ou duas frases.
Pule THINK/SIMPLIFY/SURGICAL — vá direto ao VERIFY.

2. Fit gate — Classificar a rota

Pergunte ao usuário (ou classifique baseado no contexto). Como são 5
rotas nomeadas — acima do limite de 4 opções do AskUserQuestion — prefira
listar as opções em texto e perguntar em texto livre, ou use
AskUserQuestion com as 4 rotas mais comuns e deixe inference acessível
via "Other":

Rota	Quando usar	O que fazer
code-loop	Tarefa de código padrão com fontes acessíveis	Ciclo completo: THINK → SIMPLIFY → SURGICAL → VERIFY
plan-first	Escopo ambíguo, ação irreversível, ou usuário pediu plano	Rode THINK, entregue um plano, PARE e aguarde aprovação
question	"Por que X está lento?", "O que você acha de Y?"	Diagnostique, não mude nada. Entregue achados + recomendação
research	Técnica/API que você não conhece	Pesquise primeiro (documentação, código fonte), depois rode code-loop
inference	Resposta vive só na sua inferência	Admita baixa confiança. Não finja rigor. Pergunte ao usuário ou marque como low-confidence

Critérios de "plan-first":

• Escopo ambíguo: você pode imaginar dois entregáveis diferentes que o usuário pode querer
• Ação irreversível: push, publish, send, deploy, delete dados compartilhados
• Usuário explicitamente pediu um plano

3. Registrar no YAML

Se base_commit ainda não estiver gravado na tarefa, registre o HEAD atual
do git (git rev-parse HEAD via Bash) nessa chave. É o ponto de
comparação que o JUDGE usa depois — sem ele, o JUDGE só enxerga diff
não commitado.

status: draft
base_commit: "a1b2c3d..."
fit:
  trivial: false
  route: code-loop     # code-loop | plan-first | question | research | inference
  reason: "Feature request com escopo bem definido"
  answered: false
  skipped: false       # true só se a fase foi preenchida com default sem
                       # ninguém responder (modo não-interativo)

Complementaridade com fable-method

O FIT gate do kata é equivalente à combinação de triviality gate + fit gate
do fable-method (Steps 0-3). A diferença principal:

• fable-method: o fit gate é implícito no fluxo do agente, sem CLI
• kata: o fit gate é explícito tanto no CLI (--plan, --check-only)
  quanto nos frontends (agente OpenCode e skills do Claude Code)

Para tarefas que o kata não cobre (marketing, research, data analysis, devops),
consulte os domain adapters do The Fable Method.

Princípios

• Proporcionalidade: tarefas triviais não merecem o ciclo completo
• Honestidade: se a resposta é só inferência, diga — não finja rigor
• Roteamento explícito: toda tarefa tem uma rota; rota default é code-loop
• Não-binário: question não vira code-loop, research não vira inference