Recommendation Required

mandatory

Toda multi-choice question feita pela IA ao usuário deve trazer recomendação explícita — não apenas enumerar opções. Estende `policies/multi-choice-questions.kmd` (que cobre rotulagem) com a obrigação de ter posição. Acelera decisão e força a IA a aplicar julgamento técnico em vez de dump neutro de alternativas.

Policy — Recommendation Required

Toda pergunta com 2+ alternativas vem com *ecomendação explícita + razão de 1 linha* Sem recomendação, a IA está delegando trabalho analítico que ela já fez — deixa o usuário refazêlo.

Formato canônico

**Q-Algo — pergunta condensada?**

**a — Opção A** descrição breve
**b — Opção B** descrição breve
**c — Opção C** descrição breve

**🎯 Recomendação: <opção> — <razão de 1 linha>**

Sua resposta: **a** / **b** / **c** ?

Razão obrigatória

A linha de recomendação *ão pode ser*"minha recomendação é A". Tem que vir com * razão técnica*em uma frase:

❌ "Recomendação: a" ✅ "Recomendação: **— porque (1) Quality > Speed (premissa Stack-wide), (2) refactor depois custa mais, (3) escopo cabe em 1 dia"

Razão expõe o raciocínio pra usuário validar (ou contestar).

Exceções — quando recomendação fica em branco

A IA *eve*declarar explicitamente quando não tem dados suficientes:

"* Recomendação: insuficiente*— não tenho contexto pra decidir entre A e B. Conhecer X seria necessário."

Isso é melhor que *ingir neutralidade*ou *hutar uma recomendação*

Resposta canônica do usuário

Resposta Interpretação
/k-go Sigo recomendação
/k-go b Sigo opção b (mesmo se eu recomendei a)
Sim / Vamos seguir a sua recomendação Idêntico a /k-go
b (literal) Sigo opção b

/k-go cobre Modo A — Execute da spec do commands/k-go.md.

Por que isso importa

  1. *celera decisão*— usuário não precisa fazer trabalho analítico

    que a IA já fez (trade-offs, custos, riscos)

  2. *orça responsabilidade técnica*— IA com posição é IA que pensou.

    IA neutra é IA que está delegando.

  3. *ria audit trail*— recomendação + razão fica no transcript,

    permitindo revisão posterior do raciocínio

  4. *conomiza turnos*— usuário responde em 5 chars (/k-go) em vez

    de redigir resposta longa

Anti-patterns

*on't:*

  1. *presentar opções sem recomendação*— "abc, qual prefere?"
  2. *ecomendação sem razão*— "Recomendação: a." (vazio)
  3. *azão genérica*— "Recomendação: a — porque é melhor."
  4. *ingir neutralidade*— "Ambas são válidas, depende do seu caso."

    (quase sempre uma é melhor; declare qual e por quê)

*o:*

  1. *arcar recomendação com 🎯 ou negrito*— fácil de spot na resposta
  2. *azão técnica em 1 linha*— citar princípiorestriçãoprecedent
  3. *onfiança calibrada*— "fortemente recomendo a" vs "ligeiramente

    recomendo a" expressa nuance

  4. *dmitir incerteza*— declarar "recomendação insuficiente" quando

    genuíno

Audit

/k-audit policies (advisory) detecta turns onde a IA fez pergunta multi-choice sem recomendação visível. Sinais:

  • Resposta com **a — ... b — ... c — ...** mas nenhuma frase com

    "recomendação" / "🎯" / "minha sugestão"

  • Pergunta direta sem opção de default

Reporta como advisory — drift aqui é processo, não bug.

Origem

Levantado pelo usuário em 20260501 ("Para cada pergunta sua, sempre diga a sua recomendação"). Aplicado retroativamente a partir desse ponto na sessão. Formalizado nesta policy.

Estende policies/multi-choice-questions.kmd (que já mandava rotular opções com letra/número) com a obrigação de *er posição técnica*

Source: ../home/koder/dev/koder/meta/docs/stack/policies/recommendation-required.kmd