mirror of https://github.com/affaan-m/ECC.git synced 2026-08-17 21:15:40 +02:00

Files

T

fd1b11cfc7 docs: refresh model-selection guidance to the Claude 5 families (#2723 )

Model-routing guidance across the rules, skills, and harness-steering docs
still recommends Sonnet 4.6 / Opus 4.5-4.6 by name. Readers on the current
generation have to map those onto Sonnet 5 / Opus 5 themselves, and the
recommendation reads as pinned to a superseded generation.

Renames the recommended models in guidance tables and updates two pinned
model IDs in code samples:

- rules/steering guidance: .cursor, .kiro, and the seven translated
  performance.md copies (ja-JP, zh-CN, zh-TW, ko-KR, pt-BR, es, tr)
- skills/prompt-optimizer complexity-routing table (+ zh-CN copy)
- skills/cost-aware-llm-pipeline MODEL_SONNET constant (+ zh-CN, ja-JP)
- docs/examples project-guidelines template, which pinned the invalid ID
  claude-sonnet-4-5-20250514 (+ zh-TW, ja-JP copies)

Deliberately left alone:

- The "Pricing Reference (2025-2026)" table in cost-aware-llm-pipeline.
  Renaming those rows while keeping the existing per-token figures would
  assert Claude 5 pricing this change has not verified.
- Executable model config (.opencode/opencode.json, agent.yaml). Those pins
  change real agent behavior and belong in their own reviewed change.
- Historical and illustrative references: the-shortform-guide session
  transcripts, the ECC-PRO roadmap log entry, gan-style-harness's
  "Opus 4.5-class"/"Opus 4.6-class" capability tiers, and
  strategic-compact's deliberately generic "400k Opus 4.x" example.
- docs/ATLAS-CLOUD-GUIDE.md, which lists a third-party provider's catalog.

Documentation wording only; no behavioral change.

Co-authored-by: Phumchai Tanonsi <274848436+phumchai1515-prog@users.noreply.github.com>

2026-08-11 19:36:48 -04:00

2.0 KiB

Raw Blame History

Otimização de Desempenho

Estratégia de Seleção de Modelo

Haiku 4.5 (90% da capacidade do Sonnet, 3x economia de custo):

Agentes leves com invocação frequente
Programação em par e geração de código
Agentes worker em sistemas multi-agente

Sonnet 5 (Melhor modelo para codificação):

Trabalho principal de desenvolvimento
Orquestrando fluxos de trabalho multi-agente
Tarefas de codificação complexas

Opus 5 (Raciocínio mais profundo):

Decisões arquiteturais complexas
Requisitos máximos de raciocínio
Pesquisa e análise

Gerenciamento da Janela de Contexto

Evite os últimos 20% da janela de contexto para:

Refatoração em grande escala
Implementação de recursos abrangendo múltiplos arquivos
Depuração de interações complexas

Tarefas com menor sensibilidade ao contexto:

Edições de arquivo único
Criação de utilitários independentes
Atualizações de documentação
Correções de bugs simples

Pensamento Estendido + Modo de Plano

O pensamento estendido está habilitado por padrão, reservando até 31.999 tokens para raciocínio interno.

Controle o pensamento estendido via:

Toggle: Option+T (macOS) / Alt+T (Windows/Linux)
Config: Defina alwaysThinkingEnabled em ~/.claude/settings.json
Limite de orçamento: export MAX_THINKING_TOKENS=10000 (bash) ou $env:MAX_THINKING_TOKENS = "10000" (PowerShell)
Modo verbose: Ctrl+O para ver a saída de pensamento

Para tarefas complexas que requerem raciocínio profundo:

Garantir que o pensamento estendido esteja habilitado (habilitado por padrão)
Habilitar Modo de Plano para abordagem estruturada
Usar múltiplas rodadas de crítica para análise minuciosa
Usar subagentes com papéis divididos para perspectivas diversas

Resolução de Problemas de Build

Se o build falhar:

Use o agente build-error-resolver
Analise mensagens de erro
Corrija incrementalmente
Verifique após cada correção

2.0 KiB Raw Blame History