architecture について
architectureは、要件と制約に基づいてソフトウェアアーキテクチャを決めるスキルです。パターン選定、トレードオフ分析、重要な判断のADR記録を支援し、まず単純な構成から始める方針です。
主な機能
- 01要件と制約の把握
- 02アーキテクチャパターンの選定
- 03トレードオフ分析
- 04ADRテンプレートと判断記録
- 05検証チェックリスト
活用シーン
- 01新規システムのパターン選定
- 02アーキテクチャ案のトレードオフ比較
- 03重要な設計判断の記録
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ vudovn/ ag-kit --skill architectureインストール後、Claude Code で/architectureを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
context-discovery.mdexamples.mdpattern-selection.mdpatterns-reference.mdtrade-off-analysis.md詳細
アーキテクチャ決定フレームワーク
「要件がアーキテクチャを決定する。トレードオフが意思決定を支える。ADRは根拠を記録する。」
🎯 選択的読み取りルール
リクエストに関連するファイルだけを読んでください! コンテンツマップを確認し、必要なものを見つけてください。
| ファイル | 説明 | 読むタイミング |
|---|---|---|
context-discovery.md | 確認すべき質問、プロジェクトの分類 | アーキテクチャ設計を開始するとき |
trade-off-analysis.md | ADR テンプレート、トレードオフのフレームワーク | 決定事項を文書化するとき |
pattern-selection.md | 決定木、アンチパターン | パターンを選択するとき |
examples.md | MVP、SaaS、エンタープライズの例 | リファレンス実装を参照するとき |
patterns-reference.md | パターンのクイックリファレンス | パターンを比較するとき |
🔗 関連スキル
| スキル | 用途 |
|---|---|
@[skills/database-design] | データベーススキーマ設計 |
@[skills/api-patterns] | API 設計パターン |
@[skills/deployment-procedures] | デプロイアーキテクチャ |
基本原則
「シンプルさこそが究極の洗練である。」
- シンプルに始める
- 複雑さは、必要性が実証された場合にのみ追加する
- パターンはいつでも後から追加できる
- 複雑さを取り除くことは、追加することよりはるかに難しい
検証チェックリスト
アーキテクチャを確定する前に:
- 要件を明確に理解している
- 制約を特定している
- 各決定にトレードオフ分析がある
- よりシンプルな代替案を検討している
- 重要な決定について ADR を作成している
- チームの専門知識が選択したパターンと合致している
コメント
Markdown 対応