Agent skill
architecture-best-practices
プロジェクトで使用しているアーキテクチャの実装ベストプラクティスを調査し、docs/best-practices.mdにドキュメント化する。技術スタックを自動検出し、スタック別のベストプラクティス(コード例・アンチパターン)を出力。「ベストプラクティスをまとめて」「実装パターンを調べて」「コーディングガイドを作成」「アーキテクチャの使い方を整理」などの依頼時に使用。
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 を作成:
- 検出したスタック別にセクション構成
- 各パターンに ✅ 推奨例 / ❌ アンチパターン
- 具体的なコード例を含める
出力形式
# ベストプラクティス
## [スタック名]
### [パターン名]
**✅ 推奨**
\`\`\`typescript
// 推奨コード
\`\`\`
**❌ アンチパターン**
\`\`\`typescript
// 避けるべきコード
\`\`\`
**理由**: なぜこのパターンが推奨されるか
境界(やらないこと)
- アーキテクチャ設計 →
architecture-designスキル - コーディング規約(リント・フォーマット) →
development-guidelinesスキル - 新技術の選定 → 要件に応じて別途検討
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?