dsh-archive-agent-notes

Archive DeepSeek Harness Agent Notes

今後の作業の指針となる履歴を消さずに、アクティブな判断コーパスを縮小します。すべてのノートを意味に基づいて判断してください。語数や古さは発見の手掛かりにすぎず、アーカイブの基準ではありません。

契約を読む

分類する前に、Agent Note のルール、アーカイブの手順、および該当するアクティブなライフサイクルの指示を読んでください。現在のコード、設定、パッケージのドキュメント、生成されたカタログ、新しい Agent Notes、受信リンクを使って、根拠が今も何らかのものを所有または制約しているかどうかを確認してください。

ノートの追加時に置き換えを確認する

下書きを作成する前に、作成基準を適用してください。新しい Agent Note を追加するたびに、同じ判断、仕組み、または却下された代替案を扱うアクティブなノートを対象に監査します。新しいノートの作成中に、完全または部分的な置き換えをそれぞれ分類してください。同じ PR で、条件を満たす実装済みのトリプレットをアーカイブし、部分的に置き換えられたものや独立して有用な根拠は保持して相互リンクし、古くなった提案は却下し、もっともらしい誤りを防がなくなった却下済みノートは削除します。新しいオーナーが独自の命題をすべて取り込む場合は、Agent Note の統合ルールを適用してください。既知の該当ノートの処理を、後日のコーパス監査に先送りしないでください。

将来の価値に基づいて分類する

次のライフサイクル固有の結果を適用してください。

• 実装済み — 削除： 小規模な UI 調整や純粋に機械的な変更のみを記述する完全なトリプレットを削除し、受信リンクを修正または削除します。ローカルなバグ修正、パフォーマンス変更、新機能、実質的な動作や所有権に関する判断は、実装済みであるというだけでは該当しません。保持またはアーカイブに分類する前に、この基準を適用してください。
• 実装済み — アクティブのまま保持： その根拠、代替案、否定的な保証、永続的なセマンティクス／ワイヤセマンティクス、所有権の境界、セキュリティルール、または再導入条件が、将来の変更の指針となる可能性が高い場合はノートを保持します。実装の仕組みではなく判断を分類してください。機械的な名前変更や型の抽出であっても、永続的な命名、互換性、所有権のルールを記録している場合があります。長さは関係ありません。
• 実装済み — アーカイブ： 実質的な歴史的判断が完了しており、今後の作業の指針となる可能性は低いものの、その歴史的な根拠を保存する価値がある場合はアーカイブします。直接削除の基準を満たす記録はアーカイブしないでください。
• 提案済み — アーカイブしない： 進行中の提案はアクティブのままにします。追求する価値がなくなった場合は、理由を正直に記して却下し、却下済みのライフサイクル形式に従ってください。
• 却下済み — ガードレールとしてのみ保持： 却下された案が依然として魅力的で、意味のある誤りにつながりやすく、ノートで却下理由を説明している場合に限り、却下の記録を保持します。
• 却下済み — 削除： 却下された案が古くなった、置き換えられた、もはや妥当ではない、または再議論の防止につながる可能性が低い場合は、トリプレット全体を削除します。受信リンクを修正または削除してください。

ノルマを満たすためにアーカイブしないでください。対象範囲内のすべてのノートを確認し、類似するグループは一貫した原則のもとで分類し、判断が難しいケースは最善の判断を行い、本当に境界が曖昧な判断は引き継ぎ用に記録してください。

判断基準となる例

以下の例を基準にしてください。語数は、長さが判断基準ではないことを示しています。

実装済みのメモでも、次のようなものは削除します。

• 折りたたまれたサイドバーのコントロールレール — 533語：閉じた状態に関する軽微な UI の動作です。
• イシューポリシーモジュールの所有権 — 動作を変えずに関数の移動とインポートの付け替えが完了しています。

実装済みのメモでも、次のようなものは残します。

• イベントソーシングされたセッション — 248語：基盤となる権限の所在と永続性の境界を定めています。
• Harness の単一ホームリゾルバー — 596語：製品をまたぐ所有権ルールです。
• プロジェクトのセッションディレクトリ — 628語：永続ストレージと ID のポリシーを定めています。
• 並列の pre-push ゲート — 400語：判断が分かれるところですが、ゲートのスケジューリングとリソース調整の指針になっています。
• 削除された画像コンテンツブロック — 334語：マルチモーダル対応が実現するまで残します。協調して再導入する条件が記載されているためです。

却下済みのメモについては、次のようにします。

• 圧縮パッケージの分割を維持 — 426語：パッケージを統合する誘惑には、今も検討する価値があります。
• ツール呼び出しを通じたストリーミングワークフローの進捗 — 972語：ACP/UI に関する前提が古くなっているため、削除します。
• ACP のターミナルメタデータの破棄 — 362語：後に ACP を自動化専用とする決定が下され、疑問が解消したため、削除します。

実装済みのトリプレットを1つアーカイブする

1. foo.md、foo.zh.md、foo.i18n.yaml の完全なトリプレットを implemented/<kind>/ から archived/<kind>/ に移動します。アーカイブ先のパスに implemented は意図的に含めません。
2. 本文は編集しません。両方の言語ファイルで Status: implemented の直後に Archived: YYYY-MM-DD のみを挿入し、アーカイブ日を使って両方に同じ値を設定します。
3. メタデータのみを変更した2つのファイルについて、サイドカーのハッシュを機械的に再記録します。メモの翻訳、書式変更、事実の更新、リンクの修正はしないでください。既存のタイトルの句読点、空行の配置、言語切り替えリンクの文言はそのまま維持します。アーカイブの前提条件ではありません。
4. アクティブな本文からの被リンクを検索します。現在の正式な情報源にリダイレクトするか、履歴スナップショットを意図的に引用する場合に限りアーカイブ先のパスへリンク先を変更するか、リンクを削除します。アーカイブ済みのメモからのリンクは、検証も修正もしないでください。
5. pnpm run verify-archived-agent-notes --write を実行します。追記専用モードでは、最初に既存のすべてのシールが一致することを確認してから、新しいトリプレットのハッシュのみを追加します。その後、通常の検証を実行します。

トリプレットのシールが完了した後は、編集、移動、翻訳、書式変更、削除を行わないでください。アーカイブ済みのメモは有効な被リンク先として残りますが、現在の動作に関する正式な情報源ではなく、履歴スナップショットです。

検証と報告

アーカイブ検証ツールの対象テスト、pnpm run verify-archived-agent-notes、pnpm run doc-sync、pnpm run lint、git diff --check を実行し、追加で確認する項目は dsh-pre-push-checks を参考に選択します。

残したアクティブな実装済みメモ、削除またはアーカイブした実装済みメモ、残したまたは削除した却下済みメモ、却下した提案済みメモがあればその内容、および実際に判断が分かれたすべてのケースについて、語数と選択した結果を報告します。アーカイブ済みメモからのリンクが有効だと主張してはいけません。アーカイブ検証ツールは意図的にこれらのリンクを確認しません。