Codeck

O que Codeck faz?

Use o Codeck como ponte de execução enquanto o agente de codificação atual permanece como host e moderador. Trate o seletor de modelo de um produto host como não relacionado: alternar o modelo ativo do chat não é o mesmo que consultar modelos externos através do Codeck.

Escolha o fluxo de trabalho

• Use um único ask para uma segunda opinião somente leitura de um executor nomeado.
• Use um council para opiniões independentes de dois ou mais provedores de modelo genuinamente diferentes.
• Use delegate apenas quando o usuário explicitamente solicitar que um executor externo implemente alterações.
• Use pick antes de auto quando o roteamento for incerto.

Nunca descreva um único modelo desempenhando vários papéis como consenso multi-modelo. Rotule como single-model-multi-role.

Pré-voo

1. Execute command -v codeck.
2. Se indisponível, pare e explique que a CLI Codeck é necessária. Não a instale sem autorização do usuário.
3. Execute codeck doctor e codeck list no projeto alvo.
4. Use apenas executores íntegros e configurados cujo modo e permissões declarados sejam adequados à tarefa.
5. Se o projeto não estiver inicializado, pergunte antes de executar codeck init, pois ele cria arquivos .codeck/.

Leia references/providers.md ao configurar executores, escolher provedores para uma rede regional ou explicar por que um modelo solicitado não está disponível.

Prepare o repasse

Escreva um resumo Markdown compacto para trabalhos não triviais. Inclua o objetivo, restrições, perguntas, critérios de aceitação e apenas os arquivos necessários para o modelo externo. Prefira um anexo de arquivo em vez de incorporar um resumo longo no comando:

codeck ask <executor> "Leia o resumo da tarefa anexado e retorne uma revisão baseada em evidências." -f task.md

Não inclua segredos, credenciais, arquivos fonte não relacionados ou dados privados do usuário. Informe ao usuário quando o conteúdo da tarefa sair do produto host e for enviado a outro provedor.

Leia references/artifacts.md para os esquemas de resumo de entrada e artefato final.

Execute um conselho multi-modelo

1. Mantenha o agente de codificação atual como moderador.
2. Selecione pelo menos dois executores íntegros apoiados por provedores distintos. Prefira adequação de capacidade e disponibilidade em vez de ordem de marca.
3. Forneça a cada especialista da primeira rodada os mesmos fatos e pergunta central, além de um papel de revisão distinto.
4. Colete as respostas da primeira rodada de forma independente antes de expor a resposta de um especialista a outro.
5. Extraia afirmações, evidências, suposições, riscos e discordâncias.
6. Faça perguntas de acompanhamento direcionadas apenas sobre discordâncias materiais. Anexe as saídas anteriores relevantes como arquivos Markdown.
7. Pare quando os critérios de aceitação forem atendidos, as discordâncias restantes forem explicitamente documentadas ou o limite de rodadas configurado for atingido.
8. Produza report.md, summary.md e decisions.json quando a escrita de artefatos estiver no escopo; caso contrário, retorne a mesma estrutura na resposta.

Use codeck compare <executor-a>,<executor-b> "<tarefa>" -f task.md quando todos os especialistas devem receber o mesmo prompt. Use chamadas separadas codeck ask quando os papéis ou perguntas de acompanhamento diferirem. Não afirme execução paralela a menos que a execução observada tenha ocorrido realmente concorrentemente.

Leia references/moderation.md para prompts de papéis, tratamento de discordâncias e regras de convergência.

Roteie com segurança

• Use ask por padrão, que é destinado a consultas somente leitura.
• Não adicione -y nem chame delegate a menos que o usuário tenha autorizado implementação externa.
• Trate os campos de permissão como declarações, a menos que a CLI subjacente também imponha uma sandbox.
• Não substitua um provedor silenciosamente. Informe o executor solicitado, executor/provedor real e motivo do fallback.
• Não codifique IDs de modelo atuais. Descubra ou leia-os da configuração local, pois os nomes dos modelos dos provedores mudam.
• Se menos de dois provedores distintos estiverem disponíveis, continue apenas como uma consulta de modelo único e declare a limitação.
• Preserve as saídas externas brutas ou IDs de execução do Codeck para que a síntese permaneça auditável.

Retorne o resultado

Comece com a conclusão do moderador. Em seguida, indique:

• quais executores e provedores subjacentes realmente executaram;
• onde concordaram e discordaram;
• quais evidências sustentam a decisão;
• riscos não resolvidos e verificação recomendada;
• qualquer fallback, falha, uso estimado ou limitação regional.

Mantenha o resumo curto orientado a decisões. Mantenha o raciocínio detalhado e a atribuição de fontes no relatório completo.