---

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

Architecture Best Practices Skill

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

入出力

参照ファイル

手順

1. 技術スタック検出

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

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

2. 該当するリファレンスを読み込む

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

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

4. ドキュメント生成

docs/best-practices.md を作成:

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

出力形式

Copy# ベストプラクティス

## [スタック名]

### [パターン名]

**✅ 推奨**
\`\`\`typescript
// 推奨コード
\`\`\`

**❌ アンチパターン**
\`\`\`typescript
// 避けるべきコード
\`\`\`

**理由**: なぜこのパターンが推奨されるか

境界（やらないこと）

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