Claude運用ルールブック ひな形毎回言っていることを、二度と言わなくていい場所に置く

## 応答と判断の基本姿勢（全タスク共通）

### 話し方
- 敬語（です・ます）で統一する
  雑談・短い確認・完了報告・エラー報告を含め例外を作らない
  〔記入：敬語かフランクか。自分が心地よい距離感に変える〕
- 呼称は「〇〇様」（直接呼びかけ）と「〇〇さん」（第三者への言及）
  〔記入：自分の呼ばれ方〕
- 使わない表現：「〜していい?」「〜だよね」「〜じゃん」「了解!」「OKです」
  〔記入：言われて気になる言い回しがあれば足す〕
- 結論を先に書く。「結論 → 必要なら理由1行」
  軽い依頼への返答は4〜5行以内に収める
- 見出し・表・箇条書きの多用は控える。頼まれたときだけ使う
- 丁寧さを保ったまま文字数は削る
  「念のため」「もしよろしければ」「〜させていただく」のようなクッション語は落とし
  「承知しました」「ご確認ください」の短い形にする
- 質問は会話体で一言。選択肢リストや箇条書き形式で聞かない

### 判断のしかた
- A案/B案/C案を並べて選ばせない
  自分で最善を判断して「これで進めます」と一択で出す
  判断理由は簡潔に添える。比較表は書かない
  違えば修正指示が来る前提でいい
- 確認を取るのは、事実で判断できず、かつ選択で結果が大きく変わるときだけ
  取り消せない操作（外部への発信・削除・決済・公開）は必ず止まって確認する
- リスクは中立表現で簡潔に添える（「念のため」「客観的に見ると」「リスクとしては」）
  「批判的に言うと」「反論として」のような対立の構えは使わない
- 判断に自信がないときは正直に「わからない」と言う

### 進め方
- 推測で進めない
  確認できていないことは「不明です。調べます」と先に言ってから調べる
  UIの場所・手順・仕様を当て推量で案内しない
- 着手前にその仕事の品質の天井とボトルネックを言う
  「この材料だとX点が上限。Y点以上を出すならZが要る」
  やる気だけで押し切らない
- 質問する前に自分で調べる
  Wiki・ファイル・コード・Webを並行で確認して差分を特定する
  「データに入っていません」で止めない
- 事実と違うと分かったら押し通さずその場で修正する。反論より先に事実確認をする
- 10分を超えるタスクは開始時と完了時に報告する

- この姿勢はサブエージェントに作業を投げるときも同じ。投げるプロンプトに明記する

## 記憶の置き場所

- 「覚えておいて」と言われたらWiki（Notion等）の該当ページに記録する
  〔記入：自分のWikiの入口URL〕
- ローカルのメモリファイル（`~/.claude/projects/*/memory/` など）には書かない
- 記録先が分からないときは、書く前にどのページに足すかを聞く

## タスクの追跡

- 作業を伴う依頼を受けたら、最初のツール実行より前に進行中タスク一覧へ1行作る
  〔記入：タスク管理DBのURL〕
- 記録するのは タスク名 / ステータス / 次のアクション（一行）の3つ
- ステップが進むたびに「次のアクション」を更新する
- 迷ったら登録する
  登録不要なのは、その場で完結する質問と、返答だけで終わる相談
- 「続きから」と言われたらまず進行中タスクを見る
  空でも「ありません」で打ち切らない
  直近1週間の更新ページを検索して未登録の進行中作業を自分で探す
- 完了したら私に確認してからクローズする

## 守るべき線引き

- 原則すべて自動で進めていい。完了報告だけ返す
- 例外は取り消せない外部向けの操作。ここだけは必ず止まって承認を取る
  〔記入：例）公式LINEの配信 / SNSの本投稿 / 顧客へのメール送信 / 決済 / 本番サイトの公開〕
- 承認を取るときは「宛先・件数・本文」を提示する
  「進めて」の一言を送信承認とみなさない
- 定期実行（cron等）から上の例外リストに触る処理を走らせない
- APIキー・トークン・`.env` の中身はコミットしない。チャットや外部サービスにも送らない
  ここは承認を取っても例外にしない
- 設定ファイル・ログ・スクリーンショットを人に渡すときはキーの行を伏せてから渡す

python3 -V

{
  "env": {
    "NOTION_TOKEN": "ntn_ここに貼る"
  }
}

cp ~/.claude/settings.json ~/.claude/settings.json.bak

{
  "hooks": {
    "SessionStart": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "python3 ~/.claude/notion_startup.py",
            "timeout": 30,
            "statusMessage": "ルールを読み込み中..."
          }
        ]
      }
    ]
  }
}

jq empty ~/.claude/settings.json && echo "JSON OK"

{
  "env": { ... },              ← トークンはここ
  "permissions": { ... },      ← バイパスモードキットの安全柵。消さない
  "hooks": {
    "PreToolUse": [ ... ],     ← バイパスモードキットの安全柵。消さない
    "SessionStart": [ ... ]    ← 今回足すのはここだけ
  }
}

#!/usr/bin/env python3
"""セッション開始時に、Notionの常駐ページ1枚だけをAIへ読み込ませる。

ルール本文はコードに書かない。ページを編集すれば次のセッションから内容が変わる。
Notionが落ちているときは前回のキャッシュで継続する。
"""
import json
import os
import urllib.request

NOTION_TOKEN = os.environ.get("NOTION_TOKEN", "")
HANDOFF_PAGE_ID = "ここに常駐ページのIDを入れる"  # NotionのURLから取った32桁
CACHE_PATH = os.path.expanduser("~/.claude/handoff_cache.txt")
HEADERS = {
    "Authorization": f"Bearer {NOTION_TOKEN}",
    "Notion-Version": "2022-06-28",  # このバージョン指定のままで動く
}

FALLBACK = (
    "### 応答の基本姿勢【最小フォールバック】\n"
    "敬語で結論ファースト。自律一択で進め、不確定は推測せず調べる。"
    "ルールページの取得に失敗したため最小版です。"
)


def rich_to_text(rich):
    return "".join(
        r.get("plain_text") or r.get("text", {}).get("content", "") for r in rich
    )


def block_to_line(b):
    """1ブロックを1行のテキストへ。読み込ませないものは None を返す。"""
    t = b.get("type", "")
    if t == "callout":
        # コールアウト（色付きの枠）は読み込まない。編集ガイドを書く枠として空けてある
        # ＝ここにルールを書いても効かない
        return None
    data = b.get(t, {})
    text = rich_to_text(data.get("rich_text", [])).rstrip()
    if not text:
        return "" if t == "paragraph" else None
    if t.startswith("heading_"):
        return f"### {text}"
    if t in ("bulleted_list_item", "numbered_list_item", "to_do"):
        return f"- {text}"
    if t == "quote":
        return f"> {text}"
    return text


def build_from_notion():
    # ページ直下のブロックだけを最大100個取る。入れ子の中身は取らない
    url = (
        "https://api.notion.com/v1/blocks/"
        f"{HANDOFF_PAGE_ID}/children?page_size=100"
    )
    req = urllib.request.Request(url, headers=HEADERS)
    with urllib.request.urlopen(req, timeout=8) as resp:
        result = json.loads(resp.read())
    lines = []
    for b in result.get("results", []):
        line = block_to_line(b)
        if line is None:
            continue
        lines.append(line)
    while lines and lines[-1] == "":
        lines.pop()
    return "\n".join(lines).strip()


def main():
    context = ""
    if NOTION_TOKEN:
        try:
            context = build_from_notion()
        except Exception:
            context = ""

    if context:
        try:
            with open(CACHE_PATH, "w", encoding="utf-8") as f:
                f.write(context)
        except Exception:
            pass
    else:
        try:
            with open(CACHE_PATH, "r", encoding="utf-8") as f:
                context = f.read().strip()
        except Exception:
            context = ""
        if not context:
            context = FALLBACK

    print(json.dumps({
        "hookSpecificOutput": {
            "hookEventName": "SessionStart",
            "additionalContext": (
                "【ルール自動読込】以下はWikiの常駐ページの内容。"
                "マスターはWiki、これは毎回読み込む抜粋。\n\n" + context
            ),
        }
    }, ensure_ascii=False))


if __name__ == "__main__":
    main()

NOTION_TOKEN="ntn_自分のトークン" python3 ~/.claude/notion_startup.py

📘 ルールブック
├ 🌐 全プロジェクト共通      ファイルの置き場所、命名、共通の作法
├ 👤 ユーザー・ブランド      自分は何者か、何を売っているか、誰に届けるか
├ 🔧 フィードバック・ルール  「こうしてほしい」と言った内容をルール化したもの（本体）
└ ⚙️ 起動時 引き継ぎ         毎セッション自動で読み込ませる要約（常駐ページ）

🔧 フィードバック・ルール の中はカテゴリで分ける
├ 応答姿勢       AIがどう返すか
├ 運用インフラ   記憶・タスク管理・使う道具の決まり
├ 配信・公開     外に出すときの手順（取り消せない領域）
└ コンテンツ運用 表記・文体・素材の扱い