Guides
このページは non-normative な案内です。どの reader が何を先に読むかだけを示し、 contract の意味は Reference にある英語の source に委ねます。
architect
境界と責任を先に決めたい reader 向けです。
- 共通モデル で FormRef、Form Package、Snapshot の関係を見る。
- Portable Form boundary で、Form に入る意味と Host や operator に残る事実を分ける。
- Versioning and compatibility で、4つの named stream と2つの domain version axis の違いを確認する。
ここでの結論は、portable な contract は service の意味を表し、account、credential、 placement、price、backend の選択を表さない、ということです。
Core / artifact user
package を受け取り、検証して、Snapshot を使う reader 向けです。
- Start の二つの command を実行する。
- Data-only Form Package で index、canonical digest、payload closure を確認する。
- Immutable Snapshot で exact reference closure、defaults、順序非依存の compile、失敗時の no-partial-result を読む。
- 必要なら
formpackage、snapshot、trustの package API へ進む。
command の report は data と compiler の性質を示します。Host が resource を実行した 証拠や、publisher の公開判断までは含みません。
Host / client implementer
wire と adapter の境界を実装する reader 向けです。
- Host API v1 とは で discovery、API root、lifecycle root の関係を見る。
- Host API v1 wire contract で route、exact FormRef、fence、 Operation、error の詳細を読む。
- Interface contract、Binding contract、 Artifact transport を必要な順に読む。
- standard service の protocol を扱うときは Standard services の sealed slot と Host-specific support を確認する。
client の local schema、state、import、codec、migration は client 側の責任です。Host の backend、credential、tenant policy、activation は Host 側の責任で、ここからは導けません。
verifier / reviewer
「何を検証した report なのか」を確認したい reader 向けです。
- conformance と参照実装 で claim の scope を確認する。
- Conformance language and classes で requirement keyword と independent claim の分類を読む。
- Publisher trust and revocation で caller-supplied policy、署名、 revocation の入力を確認する。
- Reference で、その page が English / normative source の mirror か、 Japanese / non-normative guide かを確認する。
一つの report から publication、Host support、activation、commercial Offering を推測しません。
OpenTofu / Provider を使う reader
OpenTofu / Provider の command、schema、state、import を調べる場合は、 terraform-provider-takoform を 参照してください。Takoform Core の guide はその project の内容や status を複製しません。
この site にないもの
この site は個別 Form の definition や実運用の example、publisher catalog、Host の実装・ support/status、client の adapter page を集めません。必要な事実は、それぞれの owner が 公開する source と report から確認してください。