mcpField
F
feature-arch-gate

feature-arch-gate

github.com/pproencaテスト・品質21869 回インストール11 週間前に更新
リポジトリ

feature-arch-gate について

feature-arch-gate は、固定ルールに基づいて React の機能単位アーキテクチャを検査するスキルです。コードを変更せず、マージ前に独立した合否判定を行います。

主な機能

  1. 01判定可能なアーキテクチャルールを33件収録
  2. 02単一のブラインドレビュープロトコル
  3. 03ルールごとに PASS、FAIL、N/A を判定
  4. 04不合格時に具体的な修正項目を提示

活用シーン

  1. 01マージ前の React アーキテクチャ PR 検査
  2. 02ブループリント移行の完了確認
  3. 03src/ ツリー全体の監査
  4. 04Agent が生成した機能コードの独立レビュー

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pproenca/dot-skills --skill feature-arch-gate

インストール後、Claude Code で/feature-arch-gateを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

gotchas.md
metadata.json
assets/templates/
verdict.md
references/
_rule-evidence.md
_sections.md
bound-feature-scoped-routing.md
bound-interface-contracts.md
bound-minimize-shared-state.md
fcomp-colocate-styles.md
fcomp-composition-over-props.md
fcomp-error-boundaries.md
fquery-avoid-n-plus-one.md
fquery-colocate-with-feature.md
fquery-feature-scoped-keys.md
fquery-parallel-fetching.md
fquery-server-component-fetching.md
fquery-single-responsibility.md
fstate-feature-scoped-stores.md
fstate-server-state-separation.md
import-avoid-barrel-files.md
import-no-cross-feature.md
import-path-aliases.md
import-public-api.md
import-type-only.md
import-unidirectional-flow.md
name-descriptive-exports.md
name-feature-naming.md
name-file-conventions.md
reviewer-prompt.md
struct-app-layer.md

詳細

Feature-Arch Gate

React のフィーチャーベースアーキテクチャへの準拠を判定する合否ゲートです。敵対的な視点で審査する単一のブラインドレビュアーサブエージェントが、feature-arch v1.1.0 のルールに照らして作業を判定し、すべてのルールが PASS または N/A の場合にのみ合格となります。このスキルは判定を下すものであり、作業を修正することはありません。

このゲートは自己完結型です。適用する判定可能な33個のルール（原典の43個のうち）は、feature-arch v1.1.0 のスナップショットとしてこのスキルの references/ ディレクトリに同梱されているため、レビューにこのフォルダー以外のものは必要ありません。references/_rule-evidence.md には、出典、各ルールの判定に用いる根拠、および判定不能として除外された原典の10個のルールが記録されています。

適用するタイミング

  • フィーチャー単位で構成された React コードベースに触れる PR またはブランチについて、マージ前にアーキテクチャ準拠の判定が必要な場合。
  • FEATURE-ARCH-TARGET.md ブループリントに基づく移行手順が完了したとされ、独立した検証が必要な場合。
  • src/ ツリー全体の監査が依頼された場合（「このコードベースは feature-arch に準拠していますか？」）。
  • エージェントが生成したフィーチャーの作業について、その作業を生み出した会話を知らない状態で判定するゲートが必要な場合。

アーキテクチャの設計や移行には、このゲートを適用しないでください。それは feature-arch スキルの役割です（ブループリントを作成します。このスキルはルールへの準拠を判定します）。

レビュープロトコル

以下の手順に正確に従ってください。すべてのレビューを同じ方法で実行することに、このゲートの価値があります。

  1. 対象を特定する。 レビュー対象（差分、ファイル一式、または src/ ツリー全体）を正確に絞り込み、レビューが曖昧さのない固定された対象に対して実行されるよう、参照先とパスを記録します。レビュアーに必要なコンテキスト情報を2つ記録します。コードベースで React Server Components を使用しているか、またクエリーライブラリ（TanStack Query など）があるかです。これらがなければ N/A となるルールが2つあります。
  2. ルールを読み込む。 references/_rule-evidence.md を読み、そこに記載された同梱ルールファイル33個を、このスキル自身の references/ ディレクトリと照合します。記載されたルールファイルが1つでも欠落している、または読み取れない場合は、直ちに停止してエラーを報告してください。ルールの一部だけで進めたり、黙って合格にしたりしてはいけません。
  3. レビュアー向けプロンプトを作成する。 references/reviewer-prompt.md に、ルールファイルのパス、対象、および対象リポジトリに存在する場合は docs/architecture/FEATURE-ARCH-TARGET.md ブループリントを記入します。作成したプロンプトは完全に自己完結している必要があります。レビュアーには会話履歴が見えないため、プロンプト外のコンテキストを参照してはいけません。
  4. ブラインドレビュアーを1人起動する。 作成したプロンプト全体だけを入力とする単一の Task サブエージェントを起動します。会話のコンテキストや、それに添えるコメントは含めません。
  5. 不合格を優先して判定する。 レビュアーの構造化された出力が判定結果です。追加のマージ手順はありません。すべてのルールが PASS または N/A の場合にのみ、総合判定は PASS となります。FAIL が1つでもあればゲートは不合格です。平均したり、重大度を考慮したり、ルールの適用を免除したりしてはいけません。「軽微な」FAIL も FAIL です。
  6. 判定結果を出力する。 assets/templates/verdict.md に記入します。FAIL の場合は、レビュアーの「PASS に不足しているもの」の提案を修正リストにまとめ、それぞれに該当箇所を付けて、原典スキルのカテゴリ優先順位（struct → import → bound → fquery → fcomp → fstate → test → name）に沿って並べます。最終結果が FAIL となったルールはすべて、記載どおりに適用できる具体的な変更とともに修正リストに含める必要があります。レビュアーの提案が違反内容を言い換えただけの場合は、出力前にルールの Correct の例から修正方法を導き出してください。

変更のない対象を再レビューした際に同じルールの判定が変わる場合、または人間が根拠を確認して判定を覆す場合、それはルールの判定可能性に関するバグです。gotchas.md に記録し、ルールを明確化してください。ゲートの判定を覆してはいけません。

判定形式

レビュー担当者は各ルールについて、PASS | FAIL | N/A、根拠（file:line または引用。PASS と FAIL の両方で必須）、および FAIL ごとに、その修正を適用するとルールが PASS になる修正内容（違反の言い換えではなく、変更内容とその場所を明記）を返します。最終レポートは assets/templates/verdict.md に従います。

ルールのカテゴリ

8 つのカテゴリとその優先順位は references/_sections.md で定義されています。33 個のベンダー提供ルールファイルは同じ references/ にあり、references/_rule-evidence.md には、それぞれを判断する根拠と、除外された 10 個のソースルール（理由付き）が記載されています。

参照ファイル

ファイル説明
references/reviewer-prompt.mdブラインドレビュー担当者向けの自己完結型プロンプトテンプレート
assets/templates/verdict.md判定レポートのテンプレート
references/_rule-evidence.mdベンダー提供の来歴、各ルールの判断根拠、除外項目
references/_sections.mdカテゴリの定義と修正リストの優先順位
references/<category>-*.md33 個のベンダー提供ルールファイル（struct/import/bound/fquery/fcomp/fstate/test/name）
metadata.jsonバージョンとソースの参照情報

関連スキル

  • feature-arch — このゲートのルールのベンダー提供元である、ソースを抽出するスキルです。利用可能な場合は、対象アーキテクチャの設計や移行に使用し、ゲートで除外されている 10 個の判断を要するルールを確認してください。レビュー時にゲート自体がこのスキルを必要とすることはありません。

コメント

Markdown 対応