codenamev/ai-software-architect

プロジェクトに厳密なソフトウェアアーキテクチャ実践を導入するためのマークダウンベースのフレームワークです。

インストール型ツール要確認企画・設計JavaScript難易度
780 保存
11フォーク16Issue

中辛 の解説

JavaScriptで実装されたプラグイン・MCPサーバー・従来型セットアップの3つのインストール方法を提供します。Claude Code(推奨)、Cursor、GitHub Copilotなど複数のAIアシスタントに対応し、ADR作成・マルチレビュー・段階的な実装トラッキングが可能です。デモビデオがLoomで公開されており、即座に試験できます。Tier-1(決定的なファイル操作)とTier-2(LLMベースのレビュー)の二層構成により、軽量な利用から本格的な建築運営まで対応します。

こんなリポジトリです

こんなときに便利です

  • マイクロサービスやモノリシック構造の大規模な設計変更時に、複数の専門家視点から建築レビューを自動化したいとき
  • プロジェクトの拡大に伴い、過去の設計決定の根拠を一元管理し後発チームメンバーへの知識継承を効率化するとき
  • セキュリティ・スケーラビリティ・保守性など異なる視点から建築方針の一貫性を継続的に検証したいとき

主な機能

マークダウンベースのADRテンプレートとワークフロー複数視点による自動建築レビュー(Tier-1の決定的ツール+Tier-2のLLMベースレビュー)3つのインストール方法(プラグイン・MCP・従来型)による柔軟な導入

ほかとの違い

Pragmatic Modeと二層構造(決定的なファイル操作と推論ベースのレビューの分離)により、軽量な意思決定記録から本格的な建築運営まで段階的にスケールでき、複数のAIアシスタント間での互換性を保ちながらレビュー品質を最大化できます。

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

準備するもの

  • Node.js ≥18(プラグイン・MCP版)
  • Claude Code、Cursor、またはGitHub Copilot/CodexなどのAIアシスタント

すぐに始める

  1. Claude Codeを使用している場合、プラグインマーケットプレイスからインストールします
/plugin marketplace add codenamev/ai-software-architect
/plugin install ai-software-architect@ai-software-architect
  1. インストール完了後、フレームワークを初期化します
Setup ai-software-architect
  1. 最初の建築的意思決定を記録します
Create ADR for [決定内容]
  1. 建築レビューを開始します
Start architecture review for [バージョン/機能]
  1. 特定の専門家の見解を取得します
Ask [専門家名] to review [対象]

Cursor使用時はMCP Serverを推奨します:

npm install -g ai-software-architect

然後在Cursor设定(settings.json)中设定:

{
  "mcp.servers": {
    "ai-software-architect": {
      "command": "mcp",
      "args": []
    }
  }
}

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try codenamev/ai-software-architect

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

スター推移 · 7日

787日間の増加数を計算するための比較データが不足しています

確認日時

使いやすさ · まねしやすいか

サンプル評点 26/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2025 年に作成

「企画・設計」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/codenamev/ai-software-architect.svg)](https://www.gitbap.com/r/codenamev/ai-software-architect)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る