scopechk

アイテムが配置される前に、対象の既存のスコープに含まれるかどうかを確認します。

目的

アイテムは、空いている場所ならどこにでも配置されがちです。そして、いったん置かれると、その場所の契約の一部として受け取られます。scopechk は、各候補対象について、対象がすでに自らについて述べている内容、つまり記述されたソース、またはそこに記載がない場合は現在のメンバーに共通する特性を読み取り、アイテムの配置可否を判定します。既存のスコープに対してアイテムを確認するものであり、作業のスコープを設定したり狭めたりすることはありません。提案を行い、移動するかどうかは人間が決定します。

ワークフロー

1. 対象を明確にする。 アイテム、各候補対象、求められている操作（追加、移動、昇格、統合、上流への反映）を明記します。アイテムが含むポインター（リンクや1行の参照）と、それが指す対象を分けます。それぞれに個別の判定を出します。アイテムまたは対象を確認できない場合は、その項目について MISS と報告し、そこで終了します。
2. スコープを確認する。 対象自身のソース（README、AGENTS.md、CONTRIBUTING、レイアウトの区分、命名規則、インストール対象、明示された対象ユーザー）から、各基準を記録し、ファイルとセクションを示します。ソースに記載がない場合は、現在のメンバーに共通する特性から基準を推定し、inferred と明記して該当するメンバーを挙げます。対象の所有者だけが判断できる基準は、所有者への質問とします。
3. 最も近いメンバーと比較する。 同じ種類のユーザーに対応する、または同じ種類の作業を行う既存のメンバーを選び、なぜ最も近いのかを説明します。各基準について、アイテムとそのメンバーを比較します。比較できるメンバーがいない場合はそう明記します。その不在自体が適合しないことを示す根拠になります。
4. 対象が引き受ける内容を列挙する。 スコアではなく、項目の一覧を作成します。新たな依存関係、対象をインストールまたはクローンする全員にアイテムが届くこと、対象が維持しなければならない各公開上の約束（安定したインストール、リリース間隔、公開インターフェース）、および追加される保守作業を記載します。
5. 到達可能性を確認する。 アイテムが指すすべてのもの（リポジトリ、パス、サービス、アカウント、ツール）を列挙し、対象のユーザーがそれぞれにアクセスできることを、ユーザーと同じ方法で開くか、公開範囲を確認して検証します。公開対象の中にある非公開リポジトリや、1台のマシン上のパスなど、ユーザーがアクセスできないものは失敗です。確認できないものには unverified と記し、対象を明記します。
6. 判定を出す。 アイテム、ポインター、対象のそれぞれについて、次のいずれかを判定します。
   • in scope：すべての基準を満たし、到達可能性の確認にも合格しています。
   • in scope after change：提案する変更の具体的な内容（削除する行、置き換えるパス、取り除く依存関係）と、その変更で満たされる基準を示します。
   • split：各部分とその配置先を示します。
   • out of scope：適合する配置先を示し、そこで手順2から5を実行します。
   • pending owner：未解決の所有者への質問によって判定が決まります。質問を記し、それぞれの回答に対してどの判定になるかを示します。
7. 終了する。 最後に Approval stop を記し、各部分の配置案、所有者への質問、および何も移動、複製、改名、登録、削除していない旨を示します。依頼した人が、どこに配置するかを決定します。

ルール

• 基準は対象のソースのみから得るか、現在のメンバーを根拠とする場合は inferred と明記します。好み、作者の希望、人気、スター数、削減できる労力は基準にしません。
• out of scope は正しい結果です。明確にそう述べ、適合する配置先を示します。
• 到達可能性の失敗または未解決の所有者への質問がある場合、in scope にはできません。推定によって所有者への質問に答えることはできません。
• 提案のみとします。実行中にアイテムや対象を編集、移動、複製、改名、登録、削除してはいけません。

検証

1. 各基準に対象内の該当箇所を示すか、根拠となるメンバーを挙げて inferred と明記します。
2. 最も近いメンバーを選んだ理由とともに示すか、該当するメンバーがいないことを明記します。
3. 各ポインターの到達可能性を確認するか、unverified と記し、in scope の判定に失敗が含まれていないことを確認します。
4. in scope 以外の各判定で、変更内容、配置先、または所有者への質問を示します。
5. 実行内容は Approval stop で終了し、何も移動していないことを確認します。