リポジトリ衛生

DispatchAtlas のバージョン管理は、手書きのソース、テスト、設定、ドキュメント、再現可能な メタデータを含みます。ローカル実行プロダクトは、ポリシーが明示的にソースへ昇格させない 限り Git の外に留まります。

🧹 生成出力ポリシー

生成された実験データ、チェックポイント、結果バンドル、カバレッジレポート、ドキュメント ビルド出力、パッケージ成果物、リリース候補は既定で無視されます。後続のゲートがそれらを 昇格させるとき、ソースから再生成され来歴を通じて記録されます。

追跡される生成ファイルは以下を必要とします:

• ソースの所有者。
• 再生成コマンド。
• 保持の根拠。
• 古い出力のレビュー経路。

🗃️ キャッシュポリシー

Python、Ruff、mypy、pytest、カバレッジ、ドキュメントビルド、仮想環境からのローカル キャッシュは無視されます。CI は依存をキャッシュしてよいですが、キャッシュキーは lockfile とワークフロー入力から導出されなければなりません。

🔬 ローカル実験出力ポリシー

ローカル実験実行は、実験ワークスペースの無視される出力層 — 実行結果、ログ、チェックポイント、 エビデンスバンドル、ワークスペース自身の README に配置されたとおり — に書き込み、outputs/ や artifacts/ のような他の無視されるスクラッチ場所と並びます。最終的な研究エビデンスは、 あらゆる公開使用の前に、検証済みのキャンペーンと分析コマンドを通じて生成されます。

📋 成果物保持ルール