フォルダ構造をuser自由運用にし、システムは再帰検索する
フォルダ構造をuser自由運用にし、システムは再帰検索する
Context
現行の Parlourite Notes は、type別にフォルダを分けていた:
content/ adr/ 2026-09-20-astro-adoption.md 2026-09-20-home-about-integration.md reference/ REF-0001.md pages/ 2026-09-19-about.md logs/ LOG-2026-09-21-xxx.md問題点:
- type変換時にファイル移動が必要。log から reference への昇華、ADR の deprecate等でフォルダを跨ぐ。
- フォルダ構造がURL構造と結合しがち。ファイル移動でURLが変わり、外部リンク・内部リンクが壊れる。
- userが「文脈でまとめたい」場合にフォルダが邪魔。例: 「Parlourite Notes運用関連の記事」を type 横断でまとめたくても、type別フォルダでは実現不可。
- フォルダ構造 = 分類軸 という固定化が、他の分類軸(scope, tags)と競合する。
Decision
フォルダ構造をuserの自由運用領域とし、システムは type/scope/tags を frontmatter からのみ判定する。
- Content Collections の
globパターンでcontent/**/*.mdを再帰検索 - フォルダ名・階層はビルド時に一切参照しない
- URLはID(
YYYY-MM-DD-slug)ベースで生成、ファイルパスに依存しない - userはいつでもファイルを別フォルダに移動可能、URLは不変
初期のフォルダ構成(あくまで初期案、user自由変更可)
content/ 2026-09-21-parlourite-notes-direction.md # 完全フラットも可 # または meta/ 2026-09-21-id-naming-convention.md parlourite-game/ 2026-09-15-astro-adoption.mdRationale
- Obsidian思想との一致: Obsidian は「フォルダは整理の便宜、リンクとタグが本質」という設計。実在の一般パターンでありハルシネーションではない。
- URL不変性: 静的サイトで最も重要な「リンクが壊れない」を保証。
- 分類軸の複数化: フォルダ = 単一分類軸の制約から解放され、scope(frontmatter)+ tags(frontmatter)+ フォルダ(userの心理的整理)を独立に運用可能。
- type昇華の摩擦除去: log → reference のような type 変更でファイル移動不要(frontmatter の
typeを書き換えるだけ)。
Alternatives Considered
案α: 現行維持(type別フォルダ、URLもフォルダ反映)
- 却下理由: 上記問題点が解消しない。
案β: type別フォルダを維持、URLはIDベース
- 却下理由: 半端。ファイル移動時のフォルダ変更判断が残る。userの認知負荷軽減にならない。
案γ: scope別フォルダ(meta/, parlourite-game/, universal/)
- 却下理由: scope も分類軸の一つでしかない。将来 scope 値が増えた時に再度フォルダ整理が必要。フラット+frontmatter判定なら scope 追加も frontmatter 更新のみ。
Pugh Matrix
評価軸:
- C1: URL不変性
- C2: フォルダ移動の自由度
- C3: 分類軸の柔軟性
- C4: 実装単純性
- C5: 業界慣習との整合
| 案 | C1 | C2 | C3 | C4 | C5 | 合計 |
|---|---|---|---|---|---|---|
| Baseline (現行 type別) | 0 | 0 | 0 | 0 | 0 | 0 |
| 採用: フラット+再帰検索 | ++ | ++ | ++ | + | + | +8 |
| β: type別+IDベースURL | ++ | 0 | 0 | 0 | 0 | +2 |
| γ: scope別フォルダ | + | + | + | 0 | 0 | +3 |
Consequences
Positive
- ファイル移動でURL/リンクが壊れない
- type変換(log→reference等)が frontmatter 編集のみで完結
- userがフォルダを整理しても、システムに影響なし
- 分類軸の追加・変更が frontmatter で完結
Negative
- Content Collections の
id(Astro内部)はファイルパス相対のため、フォルダ移動でidが変わる。URL生成には frontmatter のidを使い、Astro内部のidは無視する実装が必要 - 全ファイルがフラット検索されるため、無関係な
.mdファイル(README等)をcontentディレクトリに置けない。除外設定 orcontent/サブディレクトリ分離が必要
Neutral
- 初期は全ファイル
content/直下フラットでよい。記事増加で user が自然にフォルダ分けを始める想定
Implementation Notes
Astro Content Collections での設定イメージ:
// src/content.config.ts のイメージimport { defineCollection } from 'astro:content';import { glob } from 'astro/loaders';
const notes = defineCollection({ loader: glob({ pattern: '**/*.md', base: './content' }), // schema は別ADR参照});ルーティング:
src/pages/[id].astro # frontmatterのidをパラメータに使用getStaticPaths() で全記事の entry.data.id を URL として返す。ファイルパスは URL に一切影響しない。