name: architecture-best-practices description: > プロジェクトで使用しているアーキテクチャの実装ベストプラクティスを調査し、 docs/best-practices.md にドキュメント化する。技術スタックを自動検出し、 スタック別のベストプラクティス（コード例・アンチパターン）を出力する。 「ベストプラクティスをまとめて」「実装パターンを調べて」「コーディングガイドを作成」 「アーキテクチャの使い方を整理」などの依頼時に発火。

Architecture Best Practices Skill

プロジェクトの技術スタックを検出し、対応する実装ベストプラクティスをドキュメント化する。

入出力

参照ファイル

手順

1. 技術スタック検出

以下から技術スタックを特定：

• package.json の dependencies/devDependencies
• 設定ファイル（next.config.*, supabase/config.toml 等）
• docs/architecture.md（あれば）
• 既存の .github/instructions/*.instructions.md

2. 該当する references を読み込む

3. プロジェクト固有のカスタマイズ

• 既存 instructions との整合性確認
• プロジェクト固有のパターンを抽出
• ディレクトリ構造に合わせたパス例

4. ドキュメント生成

./template.md をベースに docs/best-practices.md を作成:

• 検出したスタック別にセクション構成
• 各パターンに ✅ 推奨例 / ❌ アンチパターン
• 具体的なコード例を含める

発火例

• 「ベストプラクティスをまとめて」
• 「実装パターンを整理して」
• 「コーディングガイドを作成して」
• 「Next.jsの使い方をドキュメント化」
• 「Supabaseの実装例をまとめて」

境界（やらないこと）

• アーキテクチャ設計 → architecture-design スキル
• コーディング規約（リント・フォーマット） → development-guidelines スキル
• 新技術の選定 → 要件に応じて別途検討