Architecture Best Practices Skill

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

入出力

| 種別 | パス | |------|------| | 入力 | package.json, *.config.*, docs/architecture.md | | 出力 | docs/best-practices.md |

参照ファイル

| ファイル | 読むタイミング | |----------|----------------| | ./template.md | 出力時のベース | | ./references/nextjs-app-router.md | Next.js App Router 検出時 | | ./references/supabase.md | Supabase 検出時 | | ./references/integration.md | 複数スタック統合パターン |

手順

1. 技術スタック検出

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

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

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

| スタック | Reference | |----------|-----------| | Next.js App Router | ./references/nextjs-app-router.md | | Supabase | ./references/supabase.md | | 複合 | ./references/integration.md |

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

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

4. ドキュメント生成

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

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

発火例

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

境界（やらないこと）

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