mcpField
0
030-architecture-adr-general

030-architecture-adr-general

github.com/jabrena開発456355 回インストール1 日前に更新
リポジトリ

030-architecture-adr-general について

Javaプロジェクト向けにMADR形式のアーキテクチャ決定記録を作成する対話型スキルです。関係者、判断基準、選択肢、トレードオフを聞き取り、記録の作成前に決定内容を確認します。

主な機能

  1. 01対話による決定情報の聞き取り
  2. 02選択肢とトレードオフの記録
  3. 03草案作成前の決定確認
  4. 04MADR形式のADR生成

活用シーン

  1. 01Javaフレームワーク選定の記録
  2. 02データベースやインフラ選択の文書化
  3. 03アーキテクチャ案の比較

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jabrena/plinth --skill 030-architecture-adr-general

インストール後、Claude Code で/030-architecture-adr-generalを入力して読み込まれたか確認します。

同梱ファイルreferences/030-architecture-adr-general.md

詳細

対話形式で進める Java ADR ジェネレーター

適切に構成された ADR に必要な意思決定の入力情報を引き出す、対話形式のプロセスを通じて Java プロジェクトの Architecture Decision Records（ADR）を生成します。これは対話型の SKILL です。現在のセッションで明示的に利用可能な会話とリポジトリファイルのみを使用してください。無関係なユーザーやプロジェクトのコンテキストを開示、保存、再利用しないでください。

この Skill で扱う内容

  • ADR ファイルの保存先設定
  • 対話による情報収集：コンテキスト、ステークホルダー、意思決定の判断基準、長所と短所を含む選択肢、決定、結果
  • MADR テンプレートの生成

制約

暗黙の仮定を避けるため、曖昧さや障害要因には明示的に対処してください。

  • エッジケース：ユーザーの目的が曖昧な場合は、ファイルの編集やプロジェクト全体に影響するコマンドの実行を行う前に停止し、確認の質問をしてください
  • エッジケース：必要なコンテキスト、ファイル、認証情報、ツールが不足している場合は、障害要因を明示的に報告し、セットアップを進めるか、代替の案内を利用するかを尋ねてください
  • エッジケース：依頼された変更がプロジェクトの制約や安全上の境界に抵触する場合は、問題を説明し、どのトレードオフを優先するかユーザーに確認してください

このスキルを使用するタイミング

  • ADR の生成
  • Architecture Decision Record の作成
  • アーキテクチャ上の意思決定の文書化
  • Java の Architecture Decision Record
  • ADR の作成
  • 技術的な意思決定の文書化
  • アーキテクチャの文書化
  • 設計上の意思決定の記録
  • 技術選定の文書化
  • フレームワーク選定の ADR
  • データベース選定の ADR
  • アーキテクチャ上のトレードオフ
  • 技術的な代替案の評価
  • 選定理由
  • デプロイ戦略の ADR
  • インフラストラクチャの選定
  • ベンダー選定の ADR

ワークフロー

  1. ADR の参考資料を読み込み、意思決定の入力情報を引き出す

このスキルの references/030-architecture-adr-general.md を読み込み、現在の会話のみを通じて、ステークホルダー、意思決定の判断基準、選択肢、トレードオフを引き出します。

  1. 意思決定をまとめて確認する

推奨する選択肢、その理由、結果を要約し、ADR の成果物を作成する前にユーザーと認識を合わせます。

  1. ADR を生成する

最終的な意思決定、代替案、結果、フォローアップ対応を含む、MADR 形式の ADR ドキュメントを作成します。

参考資料

詳しいガイダンス、例、制約については、references/030-architecture-adr-general.md を参照してください。

コメント

Markdown 対応