orch-refine-code

Ator · ação · alvo: orch · refine · code. Wrapper simples sobre o motor compartilhado em orch-pipeline.

Quando Usar

• Mesmo comportamento, melhor estrutura: extrair módulos, remover duplicação, eliminar código morto, reduzir aninhamento, renomear para clareza.
• Distinguir de irmãos: se o comportamento for mudar de alguma forma, esta não é a skill certa (orch-change-feature / orch-fix-defect).

Configurações de Operação

• Tamanho mínimo padrão: padrão — reestruturações afetam múltiplos arquivos.
• Máscara de fase: 0 → 2 (planejar a reestruturação) → 4 (manter verde) → 5 → 6. Nenhum teste de comportamento novo é escrito — o conjunto existente é a rede de segurança.
• Primeiro movimento (fase 4): confirmar que os testes relevantes existem e estão verdes ANTES de tocar no código; se a cobertura for fraca, adicionar testes de caracterização primeiro. Em seguida, reestruturar em pequenos passos, reexecutando os testes após cada um.

Como Funciona

1. Executar o motor orch-pipeline com as configurações acima.
2. Para varreduras de código morto / duplicação, delegar ao agente refactor-cleaner (ele executa knip / depcheck / ts-prune e remove com segurança).
3. Parar no Portão 1 (plano de reestruturação) e no Portão 2 (pré-commit).
4. Commitar como refactor: — a diferença deve ser neutra em relação ao comportamento.

Exemplo

orch-refine-code: extract the NWS HTTP client out of poller.py
→ confirm tests green → plan extraction  [GATE 1: approve]
→ move in small steps, tests green throughout → code-review
→ commit refactor:  [GATE 2: confirm]