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 | logdate: YYYY-MM-DD # 自動取得(git初回コミット日)last_updated: YYYY-MM-DD # 自動取得(git最終コミット日)tags: [string] # 小文字ハイフン繋ぎscope: parlourite-note | parlourite-game | universal | metatype別追加:
| type | 追加フィールド |
|---|---|
adr | status, supersedes, superseded_by |
reference | status (seed/growing/evergreen) |
page | page_type (info/legal), effective_date, revision |
log | noindex: 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-03 | LLM直出しの意図ズレへの品質懸念 | 人間レビュー必須、status: draft | reviewed 導入案 | 保留(未言及) | 中 |
| U-04 | draft版の公開・削除方針 | 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-09 | LLMへの指示ブロック自体の更新方法 | 短縮版・別ファイル化などの選択肢提示 | 保留(logには提案含めるが、改訂は今回不要) | 中 |
2.2 記事内容
| # | userの問題提起 | LLM返答(要旨) | userの確認 | 確信度 |
|---|---|---|---|---|
| U-10 | 「何を書くか」未決定 | 思考の整理ログでよい、logは構造化負担を持たせない | 合意 | 高 |
| U-11 | 生ログ/壁打ち後ログの扱い | 別ファイル+frontmatter相互リンク(raw_log / curated_log) | 合意(案A) | 高 |
| U-12 | schema更新(時間フィールド、logのtitle対称性) | time 追加、title は任意で「タイトル未設定」フォールバック | 合意(title は任意、IDフォールバックは不可) | 高 |
| U-13 | プレースホルダーの3状態表現(存在/未存在/明示TBD) | バッジ表示、ホバー動作なし、色は Champagne Silk パレット準拠 | 合意(LLMに配色任せ、ダークテーマ視認性必須) | 高 |
| U-14 | ADR/reference生成前に log を先出しする際のリンク処理 | プレースホルダーで先出し → 後続で置換 | 合意(U-07と統合) | 高 |
2.3 UI
| # | userの問題提起 | LLM返答(要旨) | userの確認 | 確信度 |
|---|---|---|---|---|
| U-15 | モバイル対応(表・画像の折り畳み) | overflow-x: auto / max-width: 100% / prose クラス | 合意 | 高 |
| U-16 | Markdown / 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 フィールド分離、命名は小文字ハイフン繋ぎ | 高 |
| Q12 | ID採番方式 | 全type統一(YYYY-MM-DD-slug)+スクリプト採番 | 高 |
| Q17 | 3状態プレースホルダー配色 | LLM任せ、ダーク視認性必須 | 高 |
| Q18 | last_updated / date の自動取得 | git履歴から自動取得(Astro build時) | 高 |
| Q19 | scope 値の命名(parlourite-app vs parlourite-game) | parlourite-game 採用(下記コメント参照) | 高 |
| Q20 | 命名規則統一・フォルダフラット化・schema共通化 | 全て合意、ADR起票が必要 | 高 |
| Q21 | LLM指示ブロック改訂 | 不要(YAGNI) | 高 |
| Q22 | 既存記事移行 | 11 ADR + 1 log + 1 note、別途対応 | 高 |
Q19に関するLLM追加コメント: parlourite-game は「ボードゲームプラットフォーム」の性質を直接表現し、意味的に自然。parlourite-app は本ブログ自体もAstroアプリという意味で曖昧性が残る。parlourite-game を推奨し、本レポートで採用。
3. 決定事項(このセッションで確定)
| ID | 決定内容 | 影響範囲 |
|---|---|---|
| D-01 | 差分表記は使わず Git履歴に一元化 | 全記事 |
| D-02 | time: "HH:MM" フィールドを log に任意追加(既定 "00:00") | log schema |
| D-03 | プレースホルダー [[R-XXXX]] 記法を維持、remarkプラグイン自作で3状態処理 | ビルドパイプライン |
| D-04 | プレースホルダー3状態: 存在=リンク/未存在=無効表示/[[TBD:...]]=明示バッジ、配色はChampagne Silk準拠でLLM都度判断、ダーク視認性必須 | CSS + プラグイン |
| D-05 | raw_log / curated_log 相互リンクを frontmatter に追加 | log schema |
| D-06 | llm_summary フィールド廃止、titleが要約になるよう運用 | 全schema |
| D-07 | log の title は任意、未指定時は「タイトル未設定」表示(IDフォールバック禁止) | log schema |
| D-08 | タグ命名規則: 小文字ハイフン繋ぎ | 全記事 |
| D-09 | scope フィールド新設: parlourite-note / parlourite-game / universal / meta | 全schema |
| D-10 | ID命名規則統一: YYYY-MM-DD-slug を全type共通に採用(Jekyll/Hexo標準準拠) | 全記事 |
| D-11 | ID採番はスクリプト化(npm run new-<type> 相当) | ビルドツール |
| D-12 | フォルダ運用フラット化: システムは再帰検索、userはフォルダを自由に整理 | Content Collections設定 |
| D-13 | URLはIDベースで不変にする(ファイル移動でURL変わらない) | ルーティング |
| D-14 | schema共通化: 全type共通フィールド + type別追加 の2層構造 | 全schema |
| D-15 | date / last_updated を git履歴から自動取得 | ビルドパイプライン |
| D-16 | Mermaid導入は将来(未完了タスクとして頭に置く) | UI |
| D-17 | LLM指示ブロックの改訂は今回不要(YAGNI) | プロセス |
4. 保留事項(今回結論を出さないもの)
| ID | 内容 | 保留理由 |
|---|---|---|
| H-01 | draft 記事の公開/削除方針 | 実運用してから判断 |
| H-02 | LLM指示ブロックの短縮化(Q10) | logの提案を蓄積してから判断 |
| H-03 | related 双方向リンク・逆引き | 今困っていない、取り返しつく |
| 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)
# npm run new-adr "astro-adoption"# → 2026-09-21-astro-adoption.md を生成、frontmatter雛形入り確信度: 高
5.2 ADR起票候補(第三者価値・再利用性で上位3件)
user発言「Q20はADR起票が必要な判断」に基づく。Q20の内容が大きいため、3本のADRに分割することを提案:
| 優先度 | ADR案タイトル | 内容 | 第三者価値 |
|---|---|---|---|
| 1 | ID命名規則の統一(YYYY-MM-DD-slug全type共通) | D-10, D-11 の決定と根拠、Jekyll/Hexo慣習との整合、ADR公式方式との比較 | 高(他プロジェクトでも参考可) |
| 2 | フォルダフラット化+user自由運用モデル | D-12, D-13 の決定、Obsidian思想との整合、Astro Content Collectionsでの実装 | 高(Zettelkasten系運用の一般パターン) |
| 3 | Frontmatter 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. 次アクションの提案
- ADR 3本の生成(優先度順): 5.2 に基づき、
ID命名規則統一→フォルダフラット化→Schema共通化の順で起票。1ターンで3本生成可能。 - 既存記事の移行スクリプト生成: U-22 の11 ADR + 1 log + 1 note を新命名規則にリネームするコマンド一括生成(別セッション推奨)。
- remarkプラグイン (P-2) の実装: ADR生成後、実装セッションへ。
LLMからの提案: 次ターンで「5.2 のADR 3本を続けて生成しますか?」の確認を待ちます。