mirror of https://github.com/affaan-m/ECC.git synced 2026-08-20 06:25:43 +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

パフォーマンス最適化

モデル選択戦略

Haiku 4.5（Sonnet 機能の 90%、コスト 3 分の 1）:

頻繁に呼び出される軽量 agent
ペアプログラミングとコード生成
マルチ agent システムのワーカー agent

Sonnet 5（最高のコーディングモデル）:

メイン開発作業
マルチ agent ワークフローのオーケストレーション
複雑なコーディングタスク

Opus 5（最も深い推論）:

複雑なアーキテクチャの意思決定
最大限の推論要件
調査と分析タスク

コンテキストウィンドウ管理

次の場合はコンテキストウィンドウの最後の 20% を避ける:

大規模なリファクタリング
複数ファイルにまたがる機能実装
複雑な相互作用のデバッグ

コンテキスト感度の低いタスク:

単一ファイルの編集
独立したユーティリティの作成
ドキュメントの更新
単純なバグ修正

拡張思考 + プランモード

拡張思考はデフォルトで有効で、内部推論用に最大 31,999 トークンを予約します。

拡張思考の制御:

トグル: Option+T（macOS）/ Alt+T（Windows/Linux）
設定: ~/.claude/settings.json で alwaysThinkingEnabled を設定
予算上限: export MAX_THINKING_TOKENS=10000（bash）または $env:MAX_THINKING_TOKENS = "10000"（PowerShell）
詳細モード: Ctrl+O で思考出力を表示

深い推論を必要とする複雑なタスクの場合:

拡張思考が有効であることを確認（デフォルトで有効）
構造化されたアプローチのために プランモード を有効化
徹底的な分析のために複数の批評ラウンドを使用
多様な視点のために役割分担したサブ agent を使用

ビルドトラブルシューティング

ビルドが失敗した場合:

build-error-resolver agent を使用
エラーメッセージを分析
段階的に修正
各修正後に検証

2.0 KiB Raw Blame History Unescape Escape