vfarcic/dot-ai

DevOps AI Toolkit – AI‑powered platform engineering for Kubernetes

What it is – Node.jsライブラリ (@vfarcic/dot-ai) で、DevOpsワークフローに大規模言語モデル (LLM) の知能を追加します。一連のサービスとCLIを提供し、Kubernetesベースのプラットフォーム (the MCP – Managed Cloud Platform) にプラグインすることで、オペレーターが自然言語プロンプトを使用してクラスターと対話、デプロイ推奨事項の取得、および自動修復を実現します。

Core capabilities

• Natural‑language cluster queries – “Which pods are using more than 80 % CPU?” のような質問を投げ、構造化された回答を得ることができます。
• Deployment recommendations – エンジンがマニフェストを分析し、改善策 (リソース制限、ベストプラクティス設定など) を提案します。
• Issue remediation & root‑cause analysis – 障害が検出された際、AIが修正アクションを提案し、その理由を説明します。
• Policy & pattern management – 組織のポリシーを再利用可能なプロンプトとして保存し、新しいリポジトリに自動適用できます。
• Semantic documentation search – 内部ドキュメントをインデックス化し、自然言語クエリを通じて関連セクションを検索できます。
• Repository bootstrap – 統治ファイル (CODE‑OF‑CONDUCT, SECURITY.md) を事前配置した新しいリポジトリを自動生成します。
• Shared prompt libraries – 中央のプロンプト・ライブラリにより、チーム間で一貫性のある AI 駆動のワークフローを実現します。
• Untrusted‑content boundary – クラスターの生出力と AI 生成の指示を分離し、、AI による悪意のある提案の実行リスクを低減します。

How you get it

• Full stack install – ワンクリック・スクリプト (the Stack Installation Guide に記載) により、Kubernetesクラスター上に必要なすべてのコンポーネント (API server, CLI, prompt store, etc.) をプロビジョニングします。

• Individual components – Deployment Guide により、必要なパーツのみをインストール可能です (例: CLIのみ)。

• パッケージは npm (@vfarcic/dot-ai) で公開されており、あらゆる Node プロジェクトに追加可能です。

Typical workflow

1. Connect CLI または MCP UI を Kubernetesクラスターに接続します。
2. Ask 自然言語で質問またはタスクを依頼します (例: “Create a Helm chart for a Redis cache with high‑availability.”)。
3. AI Engine (Model Context Protocol と Vercel AI SDK に基づいて構築) が LLM を呼び出し、レスポンスを処理し、結果を返します。
4. (オプション) 生成されたマニフェストや修復アクションをクラスターに直接適用します。

Who benefits

• kubectl クエリを書かずに、クラスターの状態をより迅速に把握したいプラットフォーム・エンジニア。
• インシデント発生時に、迅速かつ AI 支援による根本原因分析が必要な SRE チーム。
• 自動化されたポリシー準拠のレポジトリ・スキャフォールディング (scaffolding) を求める開発チーム。
• 多くの Kubernetes クラスター環境において、一貫性のある AI 駆動のベストプラクティスを組み込みたい組織。

Project health

• Beta ステータス (オレンジ色のバッジ) – コア機能は使用可能ですが、まだ進化の過程にあります。
• 活跃的 npm リリース, GitHub stars, および OpenSSF Scorecard。
• オープンガバナンス: 貢献ガイドライン, 行動規範, セキュリティポリシー, および公開ロードマップ。
• テレメトリはオプションであり、連結のドキュメントを通じて無効化できます。

Where to learn more

• AI Engine Docs – 詳細な API とプロンプト・ライブラリのリファレンス。
• MCP Setup – Managed Cloud Platform UI の実行方法。
• CLI docs – コマンドライン使用例。
• Support – GitHub Issues, Discussions, および専用の Support Guide。

---

The DevOps AI Toolkit brings LLM‑driven intelligence to everyday cloud‑native operations, turning natural‑language requests into concrete Kubernetes actions.