インフラ・DevOps
Neckbeard – エージェントのためのDevOps/プラットフォーム/SREプラグイン
Neckbeard – a DevOps/platform/SRE plugin for your agent (github.com)
要約
Neckbeardは、コーディングエージェント向けのプラグインで、アプリケーションコードからレビュー可能なクラウドインフラストラクチャと月額コスト見積もりを生成します。AWS、GCP、Azureなどの主要クラウドと、サーバーレスコンテナやKubernetesをサポートし、OpenTofuモジュールカタログに基づいてインフラを定義します。エージェントはコードを分析し、インフラの計画、レンダリング、検証を決定論的なコードで行います。
全文翻訳
neckbeard
neckbeard は、あなたがインフラを管理する必要がないように、それを処理します。あなたのコーディングエージェントのためのプラグインで、アプリケーションをレビュー可能なクラウドインフラストラクチャと月額コスト見積もりに変換します。AWS、GCP、または Azure;GitHub Actions または GitLab CI;サーバーレスコンテナまたは Kubernetes — テスト済みの OpenTofu モジュールカタログからレンダリングされます。エージェントはアプリケーションを読み取り、説明します。計画、レンダリング、検証は決定論的なコードです。エージェントはインフラストラクチャを考案しません。ponytail に触発されました。
Claude Code を、2つの別々のプロンプトとしてインストールします:
/plugin marketplace add bealesh/neckbeard
/plugin install neckbeard@neckbeard
その後、アプリケーションのリポジトリで:
/neckbeard:analyze
最初 の /neckbeard: コマンドは、プラグインが駆動する小さな neckbeard CLI をインストールします(sha256 検証済みのリリースバイナリ、または Go が存在する場合は go install) — セットアップはこれだけです。コスト見積もりと静的検証は、あなたがすでに持っている可能性のあるツール(Infracost、OpenTofu、Checkov)を使用します。/neckbeard:doctor は、不足しているものと、それぞれが何をアンロックするかを教えてくれます。Codex、Cursor、または SKILL.md を話すエージェント:INSTALL.md を参照してください。
あなたが /neckbeard:analyze を実行すると何が起こるか
エージェント:リポジトリを読み取る → 証拠に基づいたプロファイル → コードでは語れないことについて質問する
あなた:質問に答える、クラウドとティアを選択する
あなた:/neckbeard:estimate
エージェント:カタログに対して計画 → 「月額 77 ドルと予想 — ここにテーブルがあり、Infracost が価格を付けられないものはこれです」
あなた:/neckbeard:sync
エージェント:スキャフォールド → 検証 → 「V0 PASSED; V1/V2 は実行されていません。次のステップは docs/bootstrap.md です」
あなた:PR のようにファイルをレビューし、実行ブックを環境ごとにフォローする
コマンド
コマンド
何をするか
/neckbeard:analyze
リポジトリを証拠に基づいた app-profile.yaml(file:line を持つ事実、信頼度を持つ推論、大きな仮定)に読み込み、未解決の質問をし、neckbeard.yaml を提案します。
/neckbeard:estimate [comparison]
モジュールカタログに対して計画し、月額コストテーブルを表示します — 環境ごとの低/予想/高、使用量の仮定、および価格設定されていないすべてのリソース — 何かが存在する前に。serverless vs kubernetes または solo vs smallteam は両方を実行します。
/neckbeard:sync
ループ:計画 → 見積もり → スキャフォールド → 検証、所有権契約の下で(あなたの編集はサイレントに上書きされることはありません)。PASSED / FAILED / NOT EXERCISED で終了します。
/neckbeard:doctor [plan|estimate|validate|all]
CLI をインストールします(不足している場合)。前提条件の存在と、それぞれが何をアンロックするかを報告します。
/neckbeard:help
クイックリファレンス。
なぜこれが存在するのか
コーディングエージェントはアプリケーションコードには優れていますが、自由形式のインフラストラクチャの作成は苦手です。失敗のモードは常に同じです:もっともらしく見える HCL が微妙に壊れており、デフォルトで安全ではなく、見積もり不可能であることです。neckbeard は役割を反転させます:人間はゴールデンパスを維持します — バージョン管理された OpenTofu モジュール、パイプラインテンプレート、GitOps レイアウト、クラウドごと、CI で変更ごとにテストされます。エージェントは分析し、パラメータ化し、説明します。アプリケーションを読み取り、必要なものを把握し、それをカタログ入力にマッピングします — すべての主張に対して証拠を提供します。その間のすべては決定論的です。同じ入力、同じバイト:プランナーはハッシュ検証済みの blueprint.yaml ロックファイルを生成し、レンダラーはそれの純粋な関数であり、再生成はあなたの編集をサイレントに上書きすることはありません。カタログが表現できないニーズは、名前付きの発見(「redis はワークロード契約の外にある」)になります。最も近いモジュールに強制的に適合させるのではなく。
誰も教えてくれない部分:コスト
同じ参照アプリケーション(HTTP サービス + ワーカー + クロン + Postgres)、最小ティア、すべての3つの環境、Infracost によるライブ価格:
Cloud Run Container Apps ECS Fargate EKS GKE (regional) AKS
月額 $77 ~$98* $250 $396 $754 ~$801*
* Infracost はまだ Container Apps のコンピューティングの価格を付けられません — そして低い数字をそのままにするのではなく、レポートは価格設定されていないすべてのリソースを名前で示します。それがハウススタイルです:アイドル時のベースラインコスト、編集可能な明示的な使用量の仮定、低/予想/高シナリオ、および出典フッター。それはまたあなたの決定の価格も付けます:このテーブルは、neckbeard がソロ開発者に「まだ Kubernetes は必要ない」と言う理由です — レシート付き。
建築としての正直さ
インフラツールは、証明されたこと以上のことを暗示するのが好きです。neckbeard は3つの判定で報告し、3番目がポイントです:
V0 PASSED tofu validate [prd]
V0 PASSED checkov policy [prd] ← すべてのスキップには理由が書かれています
V0 PASSED kubeconform (clusters/)
V1 NOT EXERCISED authenticated plan requires cloud credentials
V2 NOT EXERCISED deployment verification requires cloud credentials
静的検証はデプロイ可能性を主張しません。V0/V1/V2 は別々のレベルであり、それぞれ実行されたかどうかが報告されます。生成された .checkov.yaml のすべての Checkov スキップは、その理由を示します。理由のないスキップは、セキュリティ体制に関する嘘です。ライブ実行が失敗すると、失敗は公開の発見となり、その後カタログの修正となります。最初の実際のデプロイメントで10個が生成され、5個がその日のうちに修正となりました。低下したパスは理由を示します(Azure + GitLab マージリクエストプランはフェデレーションできません — パイプラインが謎の失敗ではなく、そのことを示します)。
何が得られるか
3つの独立した環境(dev/stg/prd)があり、独立した状態を持ち、ティアプリセットによってサイズが決定されます。トラフィック、可用性、RPO/RTO、運用容量などの明示的な次元でサイズが決定されます。すべての値はカタログのテスト済みエンベロープ内で表示および上書き可能ですが、その外の値は祝福されるのではなく、マークされます。クラウドごとに2つのランタイム:サーバーレスコンテナ(Cloud Run / ECS Fargate / Container Apps)または Kubernetes(EKS / GKE / AKS)と Flux マニフェスト。GitHub Actions または GitLab CI 用の CI/CD は、1つのモデルから:テスト → ビルド → スキャン(trivy は HIGH/CRITICAL をブロック) → プッシュ;PR では読み取り専用 ID でインフラ計画、main では書き込み ID で適用、環境保護によってゲートされた本番環境。静的なクラウドキーはゼロ — OIDC フェデレーションはどこでも、レンダリングされたパイプラインが AWS_SECRET_ACCESS_KEY に言及した場合に失敗するテストによって強制されます。セキュリティ体制は明示的な制御として:プライベートバイデフォルトのネットワーク、オペレーターが入力する名前を持つシークレットマネージャー(値は neckbeard、その状態、または Git の履歴に触れることはありません)、スコープ付き CI ID、ティアが有効にする管理された WAF ルール。状態バックエンド → OIDC トラスト → CI ID を環境ごとに、特権を持つ人間を案内するブートストラップ実行ブック(docs/bootstrap.md)。検証後のすべては意図的に人間がループに入ります。サポートされているワークロードは、1つのイメージ、最大10個の HTTP/ワーカー/cron プロセス、Postgres、オブジェクトストレージ、シークレットで、既存のアカウント、プロジェクト、またはサブスクリプションにデプロイされます。それ以外は明示的なサポートされていない発見です。
ステータス:プレアルファ、そしてその点について正確です
何が証明され、どのように証明されたか:
Claim Evidence
analyze → plan → estimate → scaffold → validate on all 12 cloud × VCS × runtime paths
Static matrix runs in CI on every PR; three unrelated fixture apps onboard end to end
Live deploy → update → rollback, serverless Passed on AWS/GitHub and Azure/GitHub with real database checks (evidence)
Live deploy on GCP, GitLab lanes, Kubernetes, promotion, recovery drills Not yet.
実装済み、実行されていません
プラグインの現在の製品は、オンボーディングの半分です:レビュー可能なインフラストラクチャ、パイプライン、コスト見積もり、および人間に渡せるブートストラップ実行ブックです。デプロイメントライフサイクル(neckbeard release …、skill で文書化)は実験的であり、ローンチプランでゲートごとに追跡されます。静的検証をデプロイメントの証明と見なさないでください。ランディングゾーン(組織構造、ガードレール — DESIGN.md の Path F)は設計されており、構築されていません。
どのように連携するか
you / your agent
deterministic core
┌──────────────────────┐
│ analyze: facts w/ │
│ evidence, questions, │
│ judgment, answers │
└──────────────────────┘
repo ──▶
┌───────────────────────────┐
│ profile │
│ config │
└─────────┬─────────────────┘
┌──────────────┼──────────────┐
▼
plan: catalog @ pinned
versions → blueprint.yaml
(hash-verified lockfile)
▼
estimate
Infracost,
scenarios,
unpriced
resources
▼
scaffold
ownership
contract:
never silently
overwrite
▼
validate
V0 static,
V1 plan,
V2 deploy
reported
リポジトリのルートはプラグインです:skills/neckbeard/SKILL.md はエージェントの操作マニュアルです。