# Architecture Best Practices

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

- Skill: `majiayu000/architecture-best-practices` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/architecture-best-practices`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/architecture-best-practices/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/architecture-best-practices

---


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