HN 日本語サマリー

← 一覧へ戻る
プログラミング

Show HN: Kastor – AIエージェントのためのTerraform風仕様

Show HN: Kastor – Terraform-style specs for AI agents (github.com)

12 pointsby weirdguy12 コメント

要約

Kastorは、AIエージェントの定義を宣言的かつベンダーニュートラルに行うためのツールです。HCL形式の仕様ファイル(.agent, .tool, .prompt)とGoツールチェーンを提供し、LangGraphなどのフレームワーク向けに実行可能なプロジェクトを生成したり、ホストプラットフォーム上のエージェントの状態管理やドリフト検出を行ったりします。現時点では初期段階の概念実証ですが、LangGraphプロジェクトのビルドやローカル状態管理などが計画されています。

全文翻訳

KastorはAIエージェントのためのソース・オブ・トゥルース層です。

エージェント、ツール、プロンプト、モデル、およびプラグインバックエンドのターゲットをHCLで定義します。仕様を検証し、実行可能なフレームワークコードにコンパイルするか、ホストされているエージェントをTerraformスタイルの plan / apply / state と同期させます。

kastor init examples/weather
kastor validate examples/weather
kastor build examples/weather
kastor plan examples/weather

今日のAIエージェントは、フレームワークコード、プロンプトファイル、ツールファイル、プラットフォームUI設定、環境設定などに分散していることがよくあります。Kastorのアイデアは、エージェントが本格的なソフトウェアになる前に、バージョン管理可能でレビュー可能、かつ宣言的な契約を必要とするということです。

完全な設計はSPEC.mdにあります。

状況

Kastorは初期の概念実証です。

現在動作するもの:

  • kastor new で新しいモジュールをスキャフォールドする
  • チェックサム検証済みのプラグインを kastor init とコミットされたロックファイルでインストールする
  • .agent, .tool, .prompt, kastor.hcl をパースする
  • 参照とプロンプト変数を検証する
  • バージョン管理されたターゲットプラグインをターゲットインスタンスから分離して宣言する
  • 実行可能なLangGraphおよびeveプロジェクトをビルドする
  • LangGraph、eve、Claude Managed Agentsでポータブルに、選択されたツールに対する人間の承認を要求する
  • ビルトインのインメモリプラットフォームに対して kastor plan / kastor apply / kastor destroy を実行する
  • ホストされているClaude Managed AgentsをAnthropicターゲットプラグイン経由で同期する
  • ローカル状態ファイル、3方向差分、ドリフト検出
  • VS Codeシンタックスハイライトとファイルアイコン
  • 例:天気エージェント、コンテンツスケジューラ、サポートトリアージ

v0で計画されているもの:

  • 診断とプランのための構造化された --json レンダリング

Kastorはエージェントランタイムではありません。

デモ

[画像: Kastorがファイルからエージェントをビルドしている様子]

仕組み

.agent + .tool + .prompt + kastor.hcl
                │
                ▼
        kastor validate
                │
      ┌─────────┴─────────┐
      ▼                   ▼
kastor build        kastor plan/apply
フレームワークコード      ホストエージェント
(LangGraph, eve)    (Claude Managed Agents)

Kastorには2つのパスがあります。ターゲットは kastor.required_plugins を通じて明示的に実装を選択し、そのラベルは通常のモジュールローカルインスタンス名として残ります。

  • kastor build はKastorモジュールを実行可能なフレームワークコードにコンパイルします。
  • kastor plan / kastor apply は、長期間存在するホストエージェントを状態、差分、ドリフト検出と同期させます。

例

Kastorにおけるエージェントは、小さな宣言的な仕様です。

agent "weather" {
  description = "Answers weather questions for a location and date"

  model         = model.fast
  system_prompt = prompt.weather_system
  tools             = [tool.web_search]
  requires_approval = [tool.web_search]

  input "location" {
    type        = string
    description = "The location to get weather for"
  }

  input "date" {
    type     = string
    optional = true
  }

  output "weather" {
    type = string
  }
}

生成されたコードがソース・オブ・トゥルースではありません。Kastorモジュールがそうです。

tools は権限付与です。省略はエージェントがツールを呼び出せないことを意味します。requires_approval はその権限を絞り込み、指定されたツールは人間が承認するまで一時停止し、残りは監督なしで実行されます。

クイックスタート:独自のモジュールを開始する

kastor new はLangGraphプラグインをインストールし、その正確なリリースをロックし、プラグインに最小限の動作モジュールを要求します。フレームワークテンプレートはKastorバイナリではなく、プラグインと共に存在します。

kastor new demo
cd demo
kastor validate
kastor build

スキャフォールドされたエージェントは、参照されているMCPフェッチサーバー(uvx経由で実行、APIキー不要)を通じてWebページを取得することで質問に答えます。スキャフォールドの README.md は、生成されたプロジェクトをエンドツーエンドで実行する方法を説明しています。

--from を使用して別のプラグイン所有のスターターを選択できます。例:kastor new --from github.com/getkastordev/kastor-eve demo。new は既にファイルが含まれているディレクトリを拒否します。--force はスキャフォールド自身のファイル名のみを上書きし、それ以外のすべてを保持します。

クイックスタート:認証情報不要

このパスは例を検証し、ビルトインのインメモリプラットフォームターゲットに対して plan / apply を実行します。リモートリソースを作成せず、APIキーも不要です。

go build -o kastor ./cmd/kastor
./kastor init examples/weather/
./kastor validate examples/weather/
./kastor plan examples/weather/
./kastor apply examples/weather/

例のプラン出力:

$ kastor plan examples/weather/
  + agent.forecast (not in state)
  + agent.geocoder (not in state)
  + agent.weather (not in state)

Plan for target.memory: 3 to create, 0 to update, 0 to delete, 0 unchanged.

kastor plan は純粋な読み取り操作です。リモートリソースや状態ファイルを一切変更せず、計画対象のプラットフォーム以外のネットワークも必要としません。更新は属性レベルの差分を表示し、帯域外のリモート変更はドリフト警告として表示されます。

レディネス:kastor doctor

plan と apply は「リモートは仕様と一致しているか」に答えます。「デプロイされたものが実際に実行できるか」には答えられません。MCP接続が認証されていないエージェントや、すべての権限を拒否するツール権限を持つエージェントは、仕様と完全に一致し、クリーンなプランを生成しますが、リクエストを処理できません。その質問には独自の動詞があります。

$ kastor doctor --target claude_agents examples/hubspot/
Environment:
  ✓ ANTHROPIC_API_KEY: environment variable is set
      target.claude_agents authenticates against this platform

agent.sales (agent_011CZq…)
  ✓ agent_011CZq…: remote object exists
  ✗ cred_011CZkZDLs7fYzm1hXNPeRjv ("HubSpot Prod"): connection is not authenticated: the OAuth grant has expired
      mcp_server.hubspot references connection://cred_011CZkZDLs7fYzm1hXNPeRjv, whose grant
      expired at 2026-08-01T09:14:22Z and carries no refresh token; re-authorize the
      connection on the platform
  ✓ search: tool is granted with permission "always_allow"

Readiness for target.claude_agents: 3 ok, 1 failed, 0 could not be verified.

doctor は読み取り専用です。エージェントを呼び出すことも、リモートオブジェクトを変更することも、状態を書き込むこともありません。すべてが準備完了の場合は0で終了し、何かが準備完了でない場合は1で終了します。

知っておくべき3つのこと:

  • 「検証できなかった」は「欠落」ではない。 チェックは ok, failed, unknown のいずれかを報告し、3番目は重要です。到達不可能なボールトは ? could not verify the credential against the vault を報告し、応答してその資格情報を持たないボールトは ✗ credential does not exist in the vault を報告します。これらは異なる問題であり、異なる修正が必要なため、決して統合されません。unknown はレディネスに対してカウントされます。コマンドはモジュールが準備完了であることを確立しませんでした。
  • 資格情報IDは表示名と共に表示される。 IDは識別子です。表示名はプラットフォーム上でNULL可能で一意ではないためですが、cred_011CZ… ("HubSpot Prod") は操作できるものです。
  • 環境のレディネスはプラットフォームを一切必要としない。 モジュールが宣言する env:// 参照はシェルと比較されるため、doctor はオフラインで「このモジュールが実行される前に私の環境から何が必要か」に答えます。

クイックスタート:ホストされたClaudeエージェント

これはホストパスです。Anthropicプラグインを選択するプラットフォームターゲットは、Claude Managed Agentsを通じてAnthropic組織内のエージェントを同期します。メモリプラグインとは異なり、apply は実際のリモートオブジェクトを作成し、destroy はそれらを不可逆的にアーカイブします。実行する前にClaudeエージェントの破棄をお読みください。

前提条件:

  • Managed Agentsへのアクセス権を持つAnthropic APIキー
  • モジュールの mcp ツールが指定するすべてのMCPサーバーのエンドポイントURL

モジュールを記述します — 1つのプロジェクトファイル、1つのエージェント、2つのツール、1つのプロンプト:

# kastor.hcl
kastor {
  required_plugins {
    anthropic = {
      source  = "github.com/getkastordev/kastor-anthropic"
      version = "~> 0.1"
    }
  }
}

model "haiku" {
  provider = "anthropic"
  id       = "claude-haiku-4-5"
}

target "claude_agents" {
	type   = "platform"
	plugin = "anthropic"

	config {
		api_key_env = "ANTHROPIC_API_KEY"
		vault_id    = "vlt_011CZkZDLs7fYzm1hXNPeRjv"
	}
}

# MCPサーバーツール.tavily_searchがバインドされるもの。これを宣言することが、
mcp://search-server/<tool> を解決可能にします。`ref` は認証情報がどこにあるかを指定します — 認証情報ではなく、このターゲットではAnthropicが既に保持しているもので、ターゲットが指定するボールト内にあります。
mcp_server "search-server" {
  url = "https://mcp.tavily.com/mcp"

  auth {
    ref = "connection://cred_011CZkZDLs7fYzm1hXNPeRjv"
  }
}
# researcher.agent
agent "researcher" {
  description = "Answers research questions with web search and a hosted MCP server"

  model         = model.haiku
  system_prompt = prompt.researcher_system

  tools = [tool.web_search, tool.tavily_search]
}
# research.tool
tool "web_search" {
  description = "Claude's hosted web search"

  returns {
    type = string
  }

  source {
    kind = "builtin"
  }
}

tool "tavily_search" {
  description = "Search the web through Tavily's hosted MCP server"

  param "query" {
    type = string
  }

  returns {
    type = string
  }

  source {
    kind = "mcp"
    uri  = "mcp://search-server/tavily_search"
  }
}
# researcher_system.prompt
---
name     = "researcher_system"
requires = []
---
You are a research assistant. Answer concisely and cite your sources.

1つの環境変数 — プラットフォームの認証情報:

export ANTHROPIC_API_KEY=sk-ant-YOUR-KEY

ANTHROPIC_API_KEY はデフォルトの認証情報です。上記の auth ブロックはそれを明示的に名前付けしているだけです。他のどの変数でも機能します — api_key_env = "ANTHROPIC_API_KEY_PROD" — そして auth ブロックは完全に省略可能です。

MCPサーバーはそれ以上のシェルでの設定を必要としません。そのアドレスは仕様であり(mcp_server ブロック)、その認証情報はAnthropicが既に保持しているもので、connection:// 参照で名前が付けられ、Kastorではなくプラットフォームによって解決されます。Kastorは認証情報を保持しません。トークンを保存せず、何もリフレッシュせず、サーバーの名前とURLのみをプラットフォームに送信します。状態は値ではなく参照を記録するため、その背後にあるシークレットをローテーションしてもKastorには見えません。これは正しいです。なぜならKastorはシークレットを管理しないからです。

plan と apply はボールトに一切接続しません。認証情報が実際に解決されるかどうかは、保留中の変更ではなくレディネスの問題であり、したがってkastor doctorに属します。これは、名前でタイプミスされた、アーカイブされた、または誤った宛先の認証情報を報告します。

プランしてから適用します:

$ kastor plan
  + agent.researcher (not in state)

Plan for target.claude_agents: 1 to create, 0 to update, 0 to delete, 0 unchanged.

$ kastor apply
  + agent.researcher (not in state)

Plan for target.claude_agents: 1 to create, 0 to update, 0 to delete, 0 unchanged.

Applied target.claude_agents: 1 created, 0 updated, 0 deleted.

KastorはリモートIDを kastor.state.json に書き込み、リモートエージェントに metadata.kastor_managed = "agent.researcher" というマーカーを付けます。そのマーカーは所有権の主張です。Kastorはそのマーカーを持たないリモートエージェントと比較(したがって更新)することを拒否するため、コンソールで作成されたエージェントがサイレントに上書きされることは決してありません。

仕様を編集して再適用すると、変更は属性レベルの更新として適用されます。代わりにコンソールでエージェントを変更すると、次の plan はドリフトを報告し、仕様に収束させる更新を計画します。

claude_agents がサポートしないもの

Managed AgentsリソースはKastorエージェントブロックよりも狭く、Kastorはターゲットにとって意味のないフィールドを無視するのではなくエラーとして扱います(SPEC.md §3.5)。このターゲットでは:

SpecResult
source kind http, script, or runtimeError. These are client-executed tools, and kastor is not a runtime. Wrap the implementation in an MCP server and declare it kind = "mcp".
source kind builtin outside the hosted toolsetError. The hosted set is bash, edit, glob, grep, read, web_fetch, web_search, write.
model with provider other than `