SKILL.md
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スキル - 新技術の選定 → 要件に応じて別途検討