Menu

Formats, protocols, and experiments for structuring context between people and AI.

fragment.place is where Fragment Practice publishes working specifications and technical notes — plain text throughout, so people, AI, and version control can read the same page.

fragment.place は、Fragment Practice が記法・プロトコル・技術的な試作を公開している場所です。 本文は Markdown、構造は YAML。人と AI と Git が同じページを読める形で、 仕様とノートを少しずつ蓄積しています。

Working specifications and technical notes: some documents are experimental and evolve over time, and each carries its own status. No product or paid service is currently offered through fragment.place. Nothing here is a commitment about what comes next.

ここにあるのは作業中の仕様と技術ノートです。実験段階の文書もあり、内容は 変わっていきます。現在、fragment.place 上で一般提供・販売しているプロダクトはありません。この先を約束するものでもありません。

What this place covers

How people and AI can refer to the same assumptions; how decisions, roles, and constraints can be written as explicit structure instead of scattered prose; how diagrams and behaviour can stay as reviewable text. The material takes the form of document formats, small protocols, examples, and reference implementations — not a product.

人とAIが同じ前提を参照するにはどう書けばよいか。判断・役割・制約を、散らばった文章では なく明示的な構造として書けるか。図や振る舞いを、レビューと差分の対象になるテキストの まま保てるか。それを、文書フォーマット・小さなプロトコル・例・参照実装の形で扱います。

Core documents

Fragment format

One structured document at one URL — Markdown for the text, YAML for explicit structure, versioned.

The YAML layer

Front-matter and typed blocks: assumptions, roles, constraints, written next to the text they govern.

Prism protocol

Describing how AI should behave on a page — persona, tone, boundaries — as configuration, close to the text.

Scene & Flow

Systems, actors, and processes as text-first diagrams that stay diffable and reviewable.

Everything published here is listed in Explore.

What is a Fragment

A Fragment is an AI-native structured document format: one note at one URL, carrying its own assumptions. Markdown holds the narrative and the reasoning; YAML holds the explicit structure — roles, constraints, behaviour. Both layers are meant to be read by people and by AI, and each document is versioned, so it can change without losing what it used to say.

Fragment は、AI と協働するための構造化ドキュメント形式です。1 つの URL に 1 つのノート。 Markdown が文脈と判断の背景を、YAML が役割・制約・振る舞いといった明示的な構造を持ちます。 どちらも人と AI の両方が読む前提で、版を持つので以前の内容を失わずに変えていけます。

Maintained by Fragment Practice — an independent advisory practice. Some of what is worked out here comes from, and returns to, that practice. Why this place exists is in About.

運営は Fragment Practice(独立系アドバイザリー)。ここで組み立てた記法や考え方の一部は、実務から生まれ、 実務へ戻っていきます。

Fragment — Formats, protocols, and experiments