このフォルダに新しいアイデアを追加する際のガイドラインです。

新しいアイデアの追加方法

1. ファイル作成

# ファイル名は小文字、ハイフン区切りで
/content/Ideas/your-idea-name.md

ファイル名のルール:

  • 小文字とハイフン(-)を使用
  • 日本語は避ける(英数字推奨)
  • 内容が分かりやすい名前にする
  • 例: ai-automation-idea.md, business-model-notes.md

2. フロントマターの設定

必須項目:

---
title: アイデアのタイトル(日本語OK)
tags:
  - アイデア # 最低1つのタグを設定
date: 2026-02-16 # 作成日(YYYY-MM-DD形式)
---

オプション項目:

draft: true # 下書き状態(公開したくない場合)
authorship:
  type: human # または ai-assisted
  model: Claude Sonnet 4.5 # AI支援の場合
  date: 2026-02-16
  reviewed: false # レビュー済みかどうか

3. タグの設定ガイドライン

推奨タグ:

  • アイデア - すべてのアイデアに必須
  • ビジネス - ビジネス関連
  • 技術 - 技術的なアイデア
  • 改善 - 改善提案
  • 実験 - 試してみたいこと
  • メモ - 簡単なメモ

タグの命名規則:

  • 日本語OK
  • 具体的で検索しやすい名前
  • 既存のタグを確認して重複を避ける
  • 1つのアイデアに2-5個程度のタグ

4. 本文の構造

TEMPLATE.md をコピーして使用することを推奨します:

cp /content/Ideas/TEMPLATE.md /content/Ideas/new-idea.md

推奨セクション:

  1. 概要 - アイデアの簡単な説明
  2. 背景・きっかけ - なぜこのアイデアを考えたか
  3. 詳細 - 具体的な内容
  4. 実現可能性・次のステップ - どう進めるか
  5. 参考リンク - 関連する情報源

チェックリスト

新しいドキュメントを作成する際は、以下を確認してください:

  • ファイル名は小文字・ハイフン区切り
  • title を設定
  • tags を最低1つ設定(アイデア タグを含める)
  • date を設定(YYYY-MM-DD形式)
  • 下書き状態なら draft: true を設定
  • AI支援の場合は authorship を設定
  • 本文に最低限の説明を記述
  • 参考リンクがあれば追加

公開フロー

下書きから公開へ

  1. 下書き作成

    draft: true
  2. 内容を充実させる

    • 概要を明確にする
    • 必要な情報を追加
    • タグを見直す
  3. 公開

    draft: false # または削除
  4. コミット&デプロイ

    git add content/Ideas/your-idea.md
    git commit -m "docs: add new idea about [テーマ]"
    git push origin main

ベストプラクティス

タグ管理

ファイル管理

  • 大きなテーマは複数ファイルに分割
  • 関連するアイデアは相互リンク
  • 古いアイデアも削除せず、draft: true で非表示に

コンテンツ品質

  • 後で読んでも分かる説明を心がける
  • 箇条書きを活用して読みやすく
  • 図や画像を使う場合は /public/images/ に配置

テンプレート

TEMPLATE.md を参照してください。

トラブルシューティング

ビルドエラー

  • フロントマターの YAML 形式を確認
  • インデントが正しいか確認
  • 日付形式が YYYY-MM-DD か確認

タグが表示されない

  • タグがリストとして正しく記述されているか確認
  • インデントが2スペースか確認

ページが表示されない

  • draft: true になっていないか確認
  • ファイル名や場所が正しいか確認
  • ビルドログでエラーを確認