Show HN: Kastor – AIエージェントのためのTerraform風仕様
Show HN: Kastor – Terraform-style specs for AI agents (github.com)
要約
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)。このターゲットでは:
| Spec | Result |
|---|---|
source kind http, script, or runtime | Error. 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 toolset | Error. The hosted set is bash, edit, glob, grep, read, web_fetch, web_search, write. |
model with provider other than ` |