Agent skill

architecture-best-practices

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

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/architecture-best-practices-yuch4-dx-selecta-2

SKILL.md

Architecture Best Practices Skill

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

入出力

種別 パス
入力 package.json, *.config.*, docs/architecture.md
出力 docs/best-practices.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(あれば)

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

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

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

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

4. ドキュメント生成

docs/best-practices.md を作成:

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

出力形式

markdown
# ベストプラクティス

## [スタック名]

### [パターン名]

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

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

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

境界(やらないこと)

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

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results