architectos

---

厳格な製品方針：ArchitectOS はユーザーのコードを決して直接変更せず、分析、説明、影響の算出、実行可能なリファクタリング計画の生成のみを行います。コードの変更は AI エージェントまたは人間の開発者が実行します。

---

⚡ クイックスタートとコアコマンド

# 1. Initialize and review repository
npx architectos

# 2. High-level repository health, security & UI review (with optional CI threshold)
architectos review
architectos review --threshold 80

# 3. Component deep-dive (supports --why, --ui, --dead, --duplication, --taint)
architectos analyze toolbar.tsx
architectos analyze toolbar.tsx --why
architectos analyze --ui
architectos analyze --dead
architectos analyze --duplication
architectos analyze --taint auth.controller.ts

# 4. View historical score timeline and trend
architectos history

# 5. Cross-graph downstream change impact & risk rating
architectos impact auth.ts

# 6. Structured refactoring migration plan
architectos plan toolbar.tsx

# 7. Symbol resolver & natural language architecture query
architectos resolve WorkspaceRepository
architectos resolve "Where is tenant isolation enforced?"

# 8. Native MCP server gateway & live watcher
architectos watch
architectos mcp

---

🏛️ ArchitectOS のパイプライン

architectos review               # High-level health & problem breakdown (--threshold 80)
      ↓
architectos analyze <target>     # Deep-dive (--why, --ui, --dead, --duplication, --taint)
      ↓
architectos impact <target>      # Cross-graph downstream change risk
      ↓
architectos plan <target>        # Step-by-step refactoring migration plan
      ↓
architectos resolve <symbol>     # Hallucination shield & symbol resolver
      ↓
architectos history              # Historical score timeline & trend tracking
      ↓
AI Agent / Developer executes refactor

---

🎯 エンジンの精度と正確性に関する機能

• CWE 対応の 25 項目 SAST エンジン：SQLi、XSS、RCE、ReDoS、プロトタイプ汚染、NoSQLi、オープンリダイレクト、安全でないデシリアライズ、脆弱な暗号化を網羅する高精度なルールを備えています。
• コンテキストを考慮したノイズフィルター：テストブロック（describe／it）、JSDoc コメント、実行されない条件分岐内の誤検知や、既知のサニタイザー（DOMPurify、escapeHtml）が検出された場合の誤検知を自動的に抑制します。
• マルチファイル汚染追跡エンジン：信頼できないユーザー入力（HTTP の req.body／searchParams）が、複数ファイルにまたがるインポートグラフを通じて危険な実行シンクに到達するまで追跡します。
• コード重複スキャナー：トークンフィンガープリントを使った Jaccard 類似度エンジンにより、モノレポのパッケージ間でコピー＆ペーストされたコードブロックを検出します。
• フレームワークのエントリーポイント許可リスト：Next.js（GET、POST、generateMetadata、middleware）、Remix、Vitest、CLI のエントリーポイントに関する誤検知を排除します。
• Tarjan SCC サイクル検出：複雑なモノレポにおける循環依存サイクルを、数学的に妥当な方法で検出します。
• スコアリングの透明性：SCORING.md で計算式と減点ルールをすべて公開しています。

---

🧪 実環境ベンチマークによる検証（v1.2.1 エンジンの内訳）

ArchitectOS は、透明性のあるサブ指標スコアリングのもと、主要なオープンソースのコードベースで実環境のテストを重ね、実際に活用しています。

リポジトリ	ファイル数	総合	アーキテクチャ	セキュリティ	品質	AI	UI	スキャン速度	主な注力領域
excalidraw/excalidraw	520+	88/100	92	84	90	94	80	<18ms	キャンバスコンポーネントの分割
calcom/cal.com	1,400+	84/100	80	88	82	90	80	<45ms	予約サービスレイヤーの分離
shadcn/ui	120+	96/100	98	95	96	95	96	<8ms	UI コンポーネントのプリミティブ境界
cgseyhan/architectos	51	100/100	100	100	100	100	該当なし	<19ms	ネイティブなセルフホスト型 AST ガバナンス

注：純粋な CLI／バックエンドのリポジトリ（例：architectos）では、UI アーキテクチャのスコアリングは省略されます。

---

🤖 MCP サーバーのネイティブ統合

ArchitectOS を Claude Code、Cursor、または Codex の MCP 設定に追加します。

{
  "mcpServers": {
    "architectos": {
      "command": "npx",
      "args": ["-y", "architectos", "mcp"]
    }
  }
}

登録済み MCP ツール

• architectos_review：リポジトリの健全性と問題の内訳を表示します。
• architectos_why：根本原因となる結合を分析します。
• architectos_impact：複数言語に対応した変更影響計算ツールです。
• architectos_plan：手順ごとの移行・リファクタリング計画を作成します。
• architectos_resolve：シンボルリゾルバーとハルシネーション防止機能です。
• architectos_dead：未使用のエクスポートとゾンビコードを検出します。
• architectos_ui：フレームワークに依存しない UI コンポーネントの構成と境界を監査します。
• architectos_remember：永続的なアーキテクチャのガードレールルールを保存します。

---

📄 ライセンス

MIT License © 2026 ArchitectOS Authors