log

Parlourite Notes 方向性の壁打ち

Parlourite Notes 方向性の壁打ち

0. Frontmatter Schema 提案(本log冒頭で提示)

本レポート内で参照する統一 schema。詳細は §5 の提案リストで扱う。

# 全type共通フィールド
id: YYYY-MM-DD-slug # 命名規則統一(提案 P-1)
title: string # 全type必須(フォールバック廃止)
type: adr | reference | page | log
date: YYYY-MM-DD # 自動取得(git初回コミット日)
last_updated: YYYY-MM-DD # 自動取得(git最終コミット日)
tags: [string] # 小文字ハイフン繋ぎ
scope: parlourite-note | parlourite-game | universal | meta

type別追加:

type追加フィールド
adrstatus, supersedes, superseded_by
referencestatus (seed/growing/evergreen)
pagepage_type (info/legal), effective_date, revision
lognoindex: true, time (任意、ソート用)

1. 本log の目的

  • 3日目段階の Parlourite Notes(blog.parlourite.com)運用方針を、userの生思考ログを起点にLLM壁打ちで整理し、決定事項・保留事項・後続ADR候補を確定させる。
  • 決定した運用ルールを次回以降のログ生成に適用可能な状態にする。

2. userの問題提起・質問一覧(原文起点)

各項目に対するLLMの返答と、userの確認結果を併記する。

2.1 運用方法

#userの問題提起LLM返答(要旨)userの確認確信度
U-01記事の書き方(運用方法)が未確定な部分あり「暗黙の運用方針」を許容、必要時に改善で妥当(YAGNI)合意高
U-02古いフォーマット記事の書き直しコストLLMにコマンド生成させ一括書き換え、後方互換は都度検討合意高
U-03LLM直出しの意図ズレへの品質懸念人間レビュー必須、status: draft | reviewed 導入案保留(未言及)中
U-04draft版の公開・削除方針tag化して公開、削除は保留保留中
U-05変更履歴の管理追わない、YAGNI合意高
U-06差分表記(~~A~~ _B_ + blockquote 案)複数案提示 → 「黙ってGit任せ」で決着決定:Git任せ高
U-07プレースホルダー記法 [[R-XXXX]] の妥当性、{{}} 等の一般記法Obsidian由来の [[...]] 独自記法を維持、remarkプラグインで3状態処理合意(プラグイン自作OK)高
U-08日付のみでソート順不安定、時間フィールド追加案date + time: "HH:MM" 2フィールド案を推奨合意(案A)高
U-09LLMへの指示ブロック自体の更新方法短縮版・別ファイル化などの選択肢提示保留(logには提案含めるが、改訂は今回不要)中

2.2 記事内容

#userの問題提起LLM返答(要旨)userの確認確信度
U-10「何を書くか」未決定思考の整理ログでよい、logは構造化負担を持たせない合意高
U-11生ログ/壁打ち後ログの扱い別ファイル+frontmatter相互リンク(raw_log / curated_log)合意(案A)高
U-12schema更新(時間フィールド、logのtitle対称性)time 追加、title は任意で「タイトル未設定」フォールバック合意(title は任意、IDフォールバックは不可)高
U-13プレースホルダーの3状態表現(存在/未存在/明示TBD)バッジ表示、ホバー動作なし、色は Champagne Silk パレット準拠合意(LLMに配色任せ、ダークテーマ視認性必須)高
U-14ADR/reference生成前に log を先出しする際のリンク処理プレースホルダーで先出し → 後続で置換合意(U-07と統合)高

2.3 UI

#userの問題提起LLM返答(要旨)userの確認確信度
U-15モバイル対応(表・画像の折り畳み)overflow-x: auto / max-width: 100% / prose クラス合意高
U-16Markdown / Mermaid サンプルでレンダリング確認Mermaid は astro-mermaid / rehype-mermaid 導入保留(必須だが将来)中

2.4 やりたい事・気づき

#userの問題提起LLM返答(要旨)userの確認確信度
U-17思考の垂れ流し構造化管理現行方針で継続合意高
U-18各思考と決定のリンク独自プレースホルダー記法 + remark処理合意高
U-19決定事項をLLM壁打ちで再利用したいscope + tag でフィルタ、コンテキスト投入時に選別合意中
U-20純度の高いコンテキストをLLMに渡す方法論本log自体がその実践、成果物ドリブンの壁打ち合意中

2.5 追加深堀りで確定した論点

#LLM追加質問userの確認確信度
Q11タグ辞書 vs 自由 vs 2階層自由記述+scope フィールド分離、命名は小文字ハイフン繋ぎ高
Q12ID採番方式全type統一(YYYY-MM-DD-slug)+スクリプト採番高
Q173状態プレースホルダー配色LLM任せ、ダーク視認性必須高
Q18last_updated / date の自動取得git履歴から自動取得(Astro build時)高
Q19scope 値の命名(parlourite-app vs parlourite-game)parlourite-game 採用(下記コメント参照)高
Q20命名規則統一・フォルダフラット化・schema共通化全て合意、ADR起票が必要高
Q21LLM指示ブロック改訂不要(YAGNI)高
Q22既存記事移行11 ADR + 1 log + 1 note、別途対応高

Q19に関するLLM追加コメント: parlourite-game は「ボードゲームプラットフォーム」の性質を直接表現し、意味的に自然。parlourite-app は本ブログ自体もAstroアプリという意味で曖昧性が残る。parlourite-game を推奨し、本レポートで採用。


3. 決定事項(このセッションで確定)

ID決定内容影響範囲
D-01差分表記は使わず Git履歴に一元化全記事
D-02time: "HH:MM" フィールドを log に任意追加(既定 "00:00")log schema
D-03プレースホルダー [[R-XXXX]] 記法を維持、remarkプラグイン自作で3状態処理ビルドパイプライン
D-04プレースホルダー3状態: 存在=リンク/未存在=無効表示/[[TBD:...]]=明示バッジ、配色はChampagne Silk準拠でLLM都度判断、ダーク視認性必須CSS + プラグイン
D-05raw_log / curated_log 相互リンクを frontmatter に追加log schema
D-06llm_summary フィールド廃止、titleが要約になるよう運用全schema
D-07log の title は任意、未指定時は「タイトル未設定」表示(IDフォールバック禁止)log schema
D-08タグ命名規則: 小文字ハイフン繋ぎ全記事
D-09scope フィールド新設: parlourite-note / parlourite-game / universal / meta全schema
D-10ID命名規則統一: YYYY-MM-DD-slug を全type共通に採用(Jekyll/Hexo標準準拠)全記事
D-11ID採番はスクリプト化(npm run new-<type> 相当)ビルドツール
D-12フォルダ運用フラット化: システムは再帰検索、userはフォルダを自由に整理Content Collections設定
D-13URLはIDベースで不変にする(ファイル移動でURL変わらない)ルーティング
D-14schema共通化: 全type共通フィールド + type別追加 の2層構造全schema
D-15date / last_updated を git履歴から自動取得ビルドパイプライン
D-16Mermaid導入は将来(未完了タスクとして頭に置く)UI
D-17LLM指示ブロックの改訂は今回不要(YAGNI)プロセス

4. 保留事項(今回結論を出さないもの)

ID内容保留理由
H-01draft 記事の公開/削除方針実運用してから判断
H-02LLM指示ブロックの短縮化(Q10)logの提案を蓄積してから判断
H-03related 双方向リンク・逆引き今困っていない、取り返しつく
H-04検索システム(Pagefind等)需要ドリブン、記事20本超えたら再検討
H-05タグ一覧ページ需要ドリブン
H-06記事書き直し基準の明文化・status: draft | reviewed実運用してから判断

5. 提案リスト(userが後で仕分けする)

5.1 実装提案(コード/コマンド明確)

P-1: git履歴からの日付自動取得(D-15の実装)

Astro Content Collections の schema transform で処理する例(概略、10行以内):

// src/content/config.ts の一部イメージ
import { execSync } from 'node:child_process';
const getGitDate = (file, filter) =>
execSync(`git log ${filter} --format=%cs -- "${file}"`).toString().trim().split('\n').pop();
// schema.transform 内で
// date: getGitDate(file, '--diff-filter=A --follow')
// last_updated: getGitDate(file, '-1')

確信度: 高(Astro公式Recipeに類例あり)

P-2: プレースホルダー remark プラグイン雛形(D-03, D-04)

// remark-parlourite-refs.mjs のイメージ
// [[R-XXXX]] → 存在チェック → 3状態のspanに変換
// [[TBD:text]] → 明示プレースホルダーspan

確信度: 高(remark プラグイン自作は標準的手法)

P-3: 新規記事採番スクリプト(D-11)

Terminal window
# npm run new-adr "astro-adoption"
# → 2026-09-21-astro-adoption.md を生成、frontmatter雛形入り

確信度: 高

5.2 ADR起票候補(第三者価値・再利用性で上位3件)

user発言「Q20はADR起票が必要な判断」に基づく。Q20の内容が大きいため、3本のADRに分割することを提案:

優先度ADR案タイトル内容第三者価値
1ID命名規則の統一(YYYY-MM-DD-slug全type共通)D-10, D-11 の決定と根拠、Jekyll/Hexo慣習との整合、ADR公式方式との比較高(他プロジェクトでも参考可)
2フォルダフラット化+user自由運用モデルD-12, D-13 の決定、Obsidian思想との整合、Astro Content Collectionsでの実装高(Zettelkasten系運用の一般パターン)
3Frontmatter Schema の共通化と type別拡張D-06, D-07, D-09, D-14 の決定、共通2層構造の設計思想中〜高

LLM推奨: 3本まとめず、上記の粒度で分割。各ADR 100〜200行程度で完結する見込み。1ターンで全3本生成可能。

5.3 Reference起票候補

現時点では該当なし。プレースホルダー remark プラグイン(P-2)が実装完了した段階で「Parlourite Notes リンク解決システム」として reference 化する価値あり(将来)。

5.4 未完了タスク(頭に置くもの)

  • Mermaid セットアップ(D-16)
  • 既存記事11 ADR + 1 log + 1 note の新命名規則への移行(U-22、別途対応)
  • 既存 [[R-XXXX]] 参照の新ID形式への一括置換(同上)

6. 確認コメント欄(userが記入)

項目LLM確信度userコメント
D-01〜D-17 の決定内容高
Q19 で parlourite-game 採用の妥当性高
5.2 のADR3本分割案高
保留事項 H-01〜H-06 の判断先送り高

7. 次アクションの提案

  1. ADR 3本の生成(優先度順): 5.2 に基づき、ID命名規則統一 → フォルダフラット化 → Schema共通化 の順で起票。1ターンで3本生成可能。
  2. 既存記事の移行スクリプト生成: U-22 の11 ADR + 1 log + 1 note を新命名規則にリネームするコマンド一括生成(別セッション推奨)。
  3. remarkプラグイン (P-2) の実装: ADR生成後、実装セッションへ。

LLMからの提案: 次ターンで「5.2 のADR 3本を続けて生成しますか?」の確認を待ちます。