> For the complete documentation index, see [llms.txt](https://planetz.gitbook.io/planetz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://planetz.gitbook.io/planetz/ja/gotono/spec-studio.md).

# Spec Studio と Intent

> Status: 製品紹介 · 対象バージョン 0.1.x ｜ ラベルは実機で確認のこと

## このページの内容

Spec Studio は、あなたの**意図**が住む場所です——何が欲しいかを決め、それを固定し、後で実装が本当に一致したかを確認する。[意図台帳](/planetz/ja/tonarue/intent-ledger.md) の、人間向けのフロントエンドです。

***

## 3 つのフェーズ

Spec Studio は、spec スレッドを 3 つのフェーズで進めます。

1. **Pin down intent（意図を固める）** — **Decided intent**（決定された意図）を捉える：*何を満たすか*、*なぜ*（背景と狙い）、そして何が**対象外**か。直接書いても、**会話から自動生成**してもかまいません。
2. **Lock in the spec（仕様を固定する）** — 意図を、要件と決定（ADR 風の記録）を持つ仕様に変える。これが、後の作業が説明責任を負う対象になります。
3. **Check implementation drift（実装ドリフトを確認する）** — タスクが仕様に対して走ると、**Trace**（トレース）ビューが、各実行がどの決定を参照したか、実装がどこであなたの決めたことから**ドリフト**したかを示します。

## 平易な言葉での「決定された意図」

製品が使う言い回しに注目してください——*何を満たすか*、*なぜ*、*対象外*。あなたは形式的な仕様言語を書くのではなく、欲しいものと欲しくないものを人間の言葉で述べているのです。これが **recognition 優先**のアプローチです——意図は、シニアエンジニアでなくても表現し確認できるものです。

## 決定とトレース

仕様内の各決定は、あなたの意図を **satisfies（満たす）** か **deviates（逸れる）** か、そしてその出自（Required / Designed / Assumed / Observed）を記録します。レビュー時には **It's correct（これで正しい）**、**Reverse it（撤回する）**、観測を要件へ **Adopt（採用）**、**Create fix task（修正タスクを作成）** を選べます。検証は、*意図リンクのない要件*や*リンク要件のない決定済み意図*といった穴を表面化します。

> これが真実源の反転の実践です。仕様とその決定がアンカーであり、各実行がそれに照らして確認される——その逆ではありません。

## 次に読む

* [Decisions](/planetz/ja/gotono/decisions.md) — エージェントの決定を裁定する、集中したキュー。
* [意図台帳](/planetz/ja/tonarue/intent-ledger.md) — この画面の背後にある概念と仕組み。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://planetz.gitbook.io/planetz/ja/gotono/spec-studio.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.