FAQ & resolução de problemas

Preciso de um LLM?

Não. O modo template (o default) é determinístico e sem dependências — perfeito para CI. O LLM (--model) é um polimento opcional via um modelo Ollama local.

"No commits found for the given range"

Verifica se o intervalo é válido (git log <range> funciona). Sem intervalo, o gitscribe usa <última tag>..HEAD; se não houver tags, usa todo o histórico.

Os meus commits aparecem em "Other"

Não seguem os Conventional Commits (feat:, fix:, feat(scope)!: …). Não faz mal — commits fora do padrão são agrupados em "Other". Adota a convenção para um output mais limpo.

O LLM inventou uma feature

Improvável, porque o modelo recebe a lista de commits já categorizada, não os diffs em bruto — reescreve, não investiga. Se acontecer, usa o modo template, ou um modelo local mais forte.

Posso usar em CI?

Sim — usa o modo template (sem --model) para ser determinístico e não precisar de Ollama. Ver Como funciona & uso em CI.

Que modelo Ollama devo usar?

Qualquer modelo de chat puxado funciona; modelos mais pequenos são mais rápidos. Compara-os com o ollabench.