cotcodec — 作業の進め方
目的
CoTCodecは、エージェントオーケストレーションの選択を明示的、計測可能、最適化可能にするための研究プログラム兼実行可能評価ハーネスです。論文1では言語を研究していますが、共有ハーネスとエビデンス台帳は、より広範なオーケストレーション変数プログラムをカバーします。
メンタルモデルと主要ファイル
memory.jsonはコンパイルされたプロジェクトの状態とアクティブな優先順位台帳です。wiki/log.mdは追記専用の運用タイムラインです。directions/は研究仮説を管理し、experiments/は事前登録された実行を管理します。harness/は条件とベンチマークを実行し、scripts/は検証と封印を行います。research/evidence/は移植可能な決定バンドルを含みます。ローカル/生の出力は無視されるdata/に属し、誤ってGitに含めないでください。README.mdは人間向けのエントリポイントであり、AGENTS.mdは完全な運用リファレンスです。ディレクトリ内のSKILL.mdファイルはローカルな手順を定義します。
従うべきパターン / 不変条件
- 実質的な作業の前に
wiki/SOUL.md、wiki/USER.md、wiki/HEARTBEAT.md、memory.jsonを読んでください。 - 治療結果を観察する前に、反証条件、予算、クレーム範囲、停止条件を事前登録してください。完了した実験契約を書き換えないでください。
- 否定的結果や事前結果の証拠を保持してください。失敗した出力ディレクトリを上書きする代わりに、バージョン管理された再実行を作成してください。
- 決定論的なインフラ検証と、ライブモデルまたは科学的クレームを分離してください。CPUの適合性は決してH100での受け入れやメモリ品質を意味しません。
- 研究上の判断に使用される結果については、ソースリビジョン、ツリー、ライセンス、依存関係、イメージ/モデルID、実行ハッシュを必ずバインドしてください。
memory.jsonのコンパイルされた真実とwiki/log.mdのタイムラインを常に同期させてください。
一般的なタスク → 最初のアクション
| タスク | 最初のアクション |
|---|---|
| 研究を続行する | memory.json の優先順位と最新の wiki/log.md エントリを読む。 |
| 実験を実行する | skills/run-experiment.md を読み、次にそのYAML契約を読む。 |
| ベンチマークを追加する | harness/benchmarks/SKILL.md とベースアダプターを読む。 |
| オーケストレーションロジックを変更する | 最も近い harness/**/SKILL.md とペアのテストを読む。 |
| メモリシステムを追加する | infra/memory-baselines/SKILL.md とポートフォリオ/ソースバリデーターを読む。 |
| 証拠を出荷する | アーティファクトをルーティングするソース、実験、証拠、ポートフォリオのバリデーターを実行する。 |
| ドキュメントを更新する | Agent-Docs、README/current-stateページ、memory.json、wiki/log.md を更新する。 |
注意点
- 多くのベンチマークアダプターは意図的にスタブです。存在が即座に利用可能であることを意味しません。
data/には数ギガバイトのモデル、データベース、ソースツリー、Dockerアーティファクトが含まれる可能性があります。ステージング前に無視/未追跡ファイルを検査してください。- 正確なソースのライフサイクルジョブは、GPUホスト上でCPU割り当てを使用することがよくあります。ホスト名に
h100が含まれていても、GPUが要求または使用されたことは証明されません。 - 過去の
~/Documents/GitHub/kevin-wikiパスがローカルに存在しない場合があります。scripts/run-agent-docs.tsを使用する際はKEVIN_WIKI_ROOTを設定してください。