re0-order

名前を指定されたリストの項目を、読み手が一言で説明できる順序に並べ替えます。位置以外は何も変更しません。

目標

関連する項目が一つの明確な軸に沿って並んでいると、リストは意味を持ちます。書かれた順に追加された項目は、その意味を曖昧にします。re0-order は、読み手が一言で説明できる原則に沿って項目を再配置し、それ以外は何も変更しません。これは、人間が名前を指定したリスト、表、カタログ、セクションの集合、列挙型、または人間が指定したスコープ内にあるものや、呼び出したパイプラインが引き継ぐものに対して作用します。結果は元の場所に反映されます。リスト自体にも、それを反映したすべてのコピーにも適用されます。

ワークフロー

1. 対象となるリストと項目を特定します。人間が指定したスコープ内にある、焦点となる順序付きの集合です。
2. ワークフローやライフサイクルの順序、依存関係、種類ごとのグループ化、重大度、頻度、アルファベット順から、最も意味のある順序にする単一の原則を決めます。潜在的な順序がすでに存在する場合は、新しい順序を押し付けるのではなく、それを明らかにして完成させます。現在の順序が意図的かどうか不明な場合は、その判断を人間に提示し、決定を委ねます。決定されるまで何も移動しません。
3. 関連項目を隣り合わせにし、そのクラスターを単一の原則に沿って並べます。
4. 原則が測定された件数（各項目の利用頻度、検索頻度など）の場合、リストが参照する記録から各件数を読み取り、出発点となる順序として使います。件数そのものをソートキーにはしません。他の項目がそこを通じてアクセスされる項目を先頭に置き、関連項目は件数に差があってもまとめ、残りは初めて使う人がたどる読解順または作業順に従わせます。その順序で決まらない部分だけを件数で確定します。件数順から外れる箇所とその理由をそれぞれ明記します。
5. 項目を元の場所で新しい順序に並べ替えます。言い換え、追加、削除はしません。
6. 翻訳されたコピーや別の表示面を含め、集合が反映されているすべての場所に同一の順序を適用します。コピーを見つけるには、集合内の項目を2つか3つ選び、項目に識別子があれば識別子で、なければ特徴的な語句でリポジトリを検索します。また、翻訳など、このファイルのコピーであることを明示しているファイルも検索します。同じ集合を含む検索結果はすべてミラーであり、人間が指定したリストの一部です。

ルール

• 並べ替えのみを行います。項目の言い換え、追加、削除、分割、統合は決して行いません。それらは別の処理です。
• 読み手が一言で説明できる原則を一つだけ使います。一つのリストに両立しない並べ替えを混在させてはいけません。
• その原則で並べ替える前に、各項目が依存する項目をすべて先に置き、人間が指定した優先順位を維持します。依存関係はソートを制約するものであり、第二の原則ではありません。知識を生み出す項目（調査、アンケート、測定など）は、それによって情報を得る計画や構築作業のすべてから依存されます。明示的に参照されていなくても同様です。対象範囲が広いことや結論が未確定であることを理由に後ろへ回してはいけません。後になって判明したことがあれば、作業をやり直すことになるからです。
• 意図的な順序を尊重します。現在の並びが実際の原則をすでに反映している場合は、置き換えるのではなく、それを完成させて整えます。判断が不明確な場合は、その旨を提示します。
• 人間が指定したスコープ内、または人間が呼び出したパイプラインが引き継ぐ範囲内だけで作業します。リストを自分で選んではいけません。順序を決めるのは人間です。並べ替え処理が独自に対象を選ぶと、誰も求めていないものまで変更してしまいます。
• 同一の集合を反映するコピーには、同じ順序を適用します。
• 安全に編集します。移動する前に各項目の存在を確認し、見つからない場合は黙って省略せず MISS と報告します。Unicode に対応した方法で編集します。大規模な構造変更は手作業で一括変更せず、スクリプトを使います。

検証

完了する前に、次の点を確認してください。

1. 読者が、結果だけから並べ替えの原則を言い当てられます。
2. 元の項目はすべて残っており、変わったのは位置だけです。表現の変更、追加、削除はありません。移動前のリストを保存し、node scripts/same-set.mjs <before-file> <after-file> [--json] を実行してください。空でない各行が項目として扱われ、終了コード 0 は多重集合が同一であること、終了コード 1 は追加、削除、または変更された項目の名前を示し、終了コード 2 は使用法エラーを示します。
3. 関連項目が隣り合い、並び順全体が一貫して同じ原則に従っています。
4. ミラーされた各コピーで、同一の順序が保たれています。コピーごとに --mirror <file> を付けて同じスクリプトを実行してください。コピーと移動後のリストで共通する項目を比較し、終了コード 1 の場合は最初に順序が異なる箇所を示します。