Manifesto — why Fragment is built this way
Fragment Manifesto
Fragment treats each note as a small piece of shared structure, not just a block of text. YAML holds assumptions and boundaries; Markdown holds the story and reasoning. Both humans and AI read the same page.
Fragment は、ノートを「ただの文章」ではなく、前提や境界線をふくむ小さな構造として扱います。YAML に前提や配慮を、Markdown に本文や流れを書き、人と AI が同じページを読む前提をつくります。
YAML × MarkdownEthics as configurationCalm, AI-native notebook
TL;DR
Fragment is less a “note app” and more a small protocol for thinking. YAML captures who is speaking, from what perspective, and with which boundaries. Markdown carries the main narrative. Together, they make it easier for humans and AI to share the same context.
Fragment は「ノートアプリ」というより、思考と関係性のための小さなプロトコルだと考えています。YAML で「誰が・どんな前提で・どこまで踏み込んでほしいか」を書き、Markdown で本文を残すことで、人と AI が同じコンテキストを共有しやすくします。
A Fragment isn't just a free-form page. At the top and in small blocks, you can describe who is writing, for whom, and why this note exists. This structure stays small on purpose, so it feels like part of everyday writing rather than a separate “config screen”.
- YAML for author, intent, audience, and a few flags.
- Markdown for the main narrative, questions, and decisions.
- Both live on the same page, so you don't lose the link between them.
Many tools keep values and safety rules in distant policy docs. Fragment keeps them closer. With small Prism blocks, you can say what to avoid, what to double-check, and how direct the tone should be when AI responds on this page.
- Describe tone (calm, direct, gentle) in YAML instead of just “vibes”.
- List topics where you want extra care or clear boundaries.
- Let AI read these settings before it answers, not after something goes wrong.
Instead of keeping a private “prompt document” on one side and a separate note on the other, Fragment lets both live together. When the model replies, it can respect the same structure you use with colleagues, students, or your future self.
- One Fragment can be read by you, your team, and an AI with the same context.
- Scene / Flow diagrams stay as text, so they are searchable and diff-able.
- Over time, your pages become a shared history, not one-off chats.
Fragment is not trying to gamify thinking or flood you with suggestions. The aim is a notebook you can open on an ordinary day, leave one small Fragment, and trust that it will still feel understandable a week or a year later.
- Fewer badges and alerts, more readable pages.
- AI helps after you've written something, so your voice stays visible.
- Structure can change later; getting one honest note down is enough for today.
What to do with this manifesto
You don't have to agree with every word. If anything here resonates, the simplest way to try it is to write one Fragment with a tiny YAML block — a short note plus a few lines about how you want AI (and people) to read it.
このマニフェストは、立派な約束というより「こういう方向で育てていきたい」というメモです。 もし少しでもしっくりくるところがあれば、1 件の Fragment に小さな YAML を添えるところから試してみてください。
