About this place
fragment.place is where Fragment Practice publishes structured formats, protocols, technical notes, and operating patterns 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 formats and patterns published here are abstracted from problems worked through in that practice — how people and AI share assumptions, who reviews what, how decisions stay readable later — then generalized for public use; what holds up here feeds back into the practice. 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.