Content Schema
Content Schema
Section titled “Content Schema”experimental-commons の公開ページは、Starlight の docs collection 上で管理されています。
このリポジトリでは、標準の Starlight frontmatter に加えて date status tags を必須メタデータとして扱います。
必須フィールド
Section titled “必須フィールド”| field | type | meaning |
|---|---|---|
title | string | ページの表示名 |
description | string | 1〜2文の要約 |
date | string (YYYY-MM-DD) | その知見をいつ時点のものとして公開するか |
status | enum | seed / growing / evergreen |
tags | string[] | 検索や関連付けのためのタグ |
オプションフィールド
Section titled “オプションフィールド”| field | type | meaning |
|---|---|---|
author | enum | ai / human(省略可) |
author の定義
Section titled “author の定義”| author | 意味 |
|---|---|
ai | AI Agentが下書きを作成し、人間が編集責任を持つページ |
human | 人間が直接執筆したページ |
省略した場合はラベルを表示しません。
status の定義
Section titled “status の定義”| status | 使いどころ |
|---|---|
seed | 断片、仮説、短い観察ログ |
growing | ある程度まとまり始めたページ |
evergreen | 参照用として安定しているページ |
evergreen は「永久に正しい」という意味ではありません。今のところ安定している、という自己評価です。
公開してよい状態
Section titled “公開してよい状態”次の条件を満たしていれば、未完成でも公開候補になります。
- 不確かな点が不確かなまま書かれている
- 情報源の出どころが追える
- 更新日が明示されている
- 読者が「どの程度信じてよいか」を判断できる
推奨本文パターン
Section titled “推奨本文パターン”## 何を観察したか
## まだ確信がない点
## 一次情報源