About this place
fragment.place is where Fragment Practice publishes structured formats, protocols, technical notes, and experiments for working between people and AI. It is closer to a set of specifications and working notes than to a blog or a product site.
fragment.place は、Fragment Practice が、人とAIのあいだで文脈を構造化するための 記法・プロトコル・技術ノート・試作を公開している場所です。ブログやプロダクトサイト というより、仕様書と作業ノートの置き場に近いものです。
Why Markdown + YAML
Markdown carries the narrative: context, explanation, the reasoning behind a decision — the part a person reviews. YAML carries the explicit structure: roles, assumptions, constraints, behaviour — the part that benefits from being unambiguous. Both layers are plain text, and both are meant to be read by people and by AI: the point is not "Markdown for humans, YAML for machines" but one document whose meaning and structure stay together, diff by diff, under version control.
Markdown は文脈・説明・判断の背景を受け持ちます。人がレビューする部分です。YAML は 役割・前提・制約・振る舞いといった、曖昧さを許したくない構造を受け持ちます。 どちらもプレーンテキストで、どちらも人と AI の両方が読む前提です。 「Markdown は人間用、YAML は AI 用」ではなく、意味と構造が同じドキュメントの中で 一緒に版管理される、という点が核です。
What is Fragment
Fragment is an AI-native structured document format — a structured unit of context. One note at one URL, front-matter and typed blocks for the structure, versioned so a document can change without losing what it used to say. Prism (how AI should behave on a page), Scene and Flow (systems and processes as text-first diagrams) are protocols and notations that live inside the same format. The interactive pieces on this site are reference implementations of these ideas, not a product.
Fragment は、AI と協働するための構造化ドキュメント形式 — 文脈の構造化単位です。 1 URL に 1 ノート、front-matter と型付きブロックで構造を持ち、版で変化を残します。 Prism（ページ上で AI がどう振る舞うべきか）、Scene / Flow（システムやプロセスを テキストのまま図にする記法）は、同じ形式の中で使うプロトコルと記法です。 サイト上の対話的な実装は、これらの考え方の参照実装であって、製品ではありません。
What is published here
- Specifications — the Fragment format, its YAML layer, Prism, Scene & Flow.
- Working technical notes — the reasoning and trade-offs behind the formats.
- Examples — small, concrete structures you can copy and adapt.
- Prototypes and reference implementations — experimental, and labelled as such.
Everything carries its own status. Some documents are experimental and evolve over time; a withdrawn document stays readable with a notice rather than disappearing. Nothing here has a guarantee, and no product or paid service is currently offered here.
ここにあるものには状態があります。実験段階の文書は変わり続けますし、取り下げた文書も 消さずに、その旨を明示して読める形で残します。保証はありません。現在、一般提供・販売しているプロダクトはありません。
Relationship to Fragment Practice
fragment.place is maintained by Fragment Practice 合同会社 (Fragment Practice LLC), an independent advisory practice. The questions behind these formats — how people and AI share assumptions, who reviews what, how decisions stay readable later — come out of that practice, and what is worked out here feeds back into it. Company information, services, and contact live at fragmentpractice.com, not here.
fragment.place は Fragment Practice 合同会社 が運営しています。ここで扱う問い — 人とAIが前提を共有するには、誰が何をレビューするか、判断をあとから読める形で残すには — は実務から生まれ、ここで確かめた記法や考え方は実務へ戻っていきます。会社情報・ サービス・お問い合わせは fragmentpractice.com にあります（このサイトでは再掲しません）。
Looking for learning programmes instead of specifications? That is Setovira.