Divide and Conquer

mandatory

Antes de criar comando, spec, policy ou binário novo, listar o que já existe que pode ser reusado. Aplicar a regra dos 3: extrair pattern comum quando a 3ª instância aparecer; tolera duplicação curta. Esta policy é expansão do princípio #4 de `policies/stack-principles.kmd`.

Policy — Divide and Conquer

Antes de criar item novo, *istar o que já existe que pode ser reusado* Reuso explícito é mais barato que detectar duplicação depois.

When this applies

Sempre que for criar:

  • Comando /k-* novo
  • Spec em meta/docs/stack/specs/
  • Policy em meta/docs/stack/policies/
  • Binário em dev/koder-tools/cmd/ ou similar
  • Widget de SDK em koder_kit ou koder_web_kit
  • API endpoint em backend

The 5-question checklist

Antes de criar item novo, responder explicitamente:

  1. *xiste binário Koder com função similar?*

    Search: which koder-* 2>/dev/null e ls dev/koder-tools/cmd/. Se sim, considere wrappar/estender em vez de duplicar.

  1. *xiste `tasks

*.kmd`

  1. Detects similar code blocks via:
    • Diffbased similarity (same lines or nearsame with N-gram)
    • Same heading structure across files
    • Same pseudocode pattern (for X in Y, do Z)
  2. Ranks by *RY violation severity*(instances × lines × frequency of use)
  3. Reports top-N candidates for extraction
  4. Output is *dvisory*— duplicações com motivo legítimo (ex.: cópias

    reais por boa razão arquitetural) podem ser ignoradas; report flagga pra revisão humana.

Origem

Princípio #4 de policies/stack-principles.kmd, expandido nesta policy. Levantado durante a sessão de 20260501 documentada em projects/koder-stack/backlog/pending/101-stack-framework-ui-styles-settings-spec-audit.md.

Source: ../home/koder/dev/koder/meta/docs/stack/policies/divide-and-conquer.kmd