decisiondecided

フォルダ構造を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

問題点:

  1. type変換時にファイル移動が必要。log から reference への昇華、ADR の deprecate等でフォルダを跨ぐ。
  2. フォルダ構造がURL構造と結合しがち。ファイル移動でURLが変わり、外部リンク・内部リンクが壊れる。
  3. userが「文脈でまとめたい」場合にフォルダが邪魔。例: 「Parlourite Notes運用関連の記事」を type 横断でまとめたくても、type別フォルダでは実現不可。
  4. フォルダ構造 = 分類軸 という固定化が、他の分類軸(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.md

Rationale

  1. Obsidian思想との一致: Obsidian は「フォルダは整理の便宜、リンクとタグが本質」という設計。実在の一般パターンでありハルシネーションではない。
  2. URL不変性: 静的サイトで最も重要な「リンクが壊れない」を保証。
  3. 分類軸の複数化: フォルダ = 単一分類軸の制約から解放され、scope(frontmatter)+ tags(frontmatter)+ フォルダ(userの心理的整理)を独立に運用可能。
  4. 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: 業界慣習との整合
案C1C2C3C4C5合計
Baseline (現行 type別)000000
採用: フラット+再帰検索+++++++++8
β: type別+IDベースURL++0000+2
γ: scope別フォルダ+++00+3

Consequences

Positive

  • ファイル移動でURL/リンクが壊れない
  • type変換(log→reference等)が frontmatter 編集のみで完結
  • userがフォルダを整理しても、システムに影響なし
  • 分類軸の追加・変更が frontmatter で完結

Negative

  • Content Collections の id(Astro内部)はファイルパス相対のため、フォルダ移動で id が変わる。URL生成には frontmatter の id を使い、Astro内部の id は無視する実装が必要
  • 全ファイルがフラット検索されるため、無関係な .md ファイル(README等)をcontentディレクトリに置けない。除外設定 or content/ サブディレクトリ分離が必要

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 に一切影響しない。