機能詳細 A〜D

「唯一の正本」を人間もAIも共有する

• ファイル: [案件名]-works-ledger.json（実績）／[案件名]-news-ledger.json（ニュース）
• 置き場所: ~/inhouse-bot/ 配下に集約（案件横断で1箇所に）
• 実績台帳のキー: no・title・client・date・tags・link・agency 等（案件ごとに決める）
• ニュース台帳のキー: no・date（YYYY.MM）・category（PRESS/TOPICS/WORKS/MEDIA固定）・text・link・show・work_no（実績への紐付け。WORKSカテゴリなら実績タイトルに自動追従）

noの規約：連番・再利用禁止。実績台帳は W001〜、ニュースは N001〜、Featured実績は F01〜 などプレフィックスで分ける

日付の書き方：ニュース台帳は YYYY.MM が基本で、YYYY（年のみ）や空文字（日付非表示）も許容。実績台帳のdateは「2023〜継続中」のような自由表記でよい

構造を変えるとき：ゼロから設計しない。往来版（ourai-works-ledger.json）をコピーして流用が原則。変える場合は先にCodex設計レビューを通す

マーカー方式で「触っていい場所」と「触ってはいけない場所」を分離

• サイト本体HTML — 実績一覧・ニュース一覧。<!-- WORKS-SYNC:START/END --> のマーカー間だけを機械が書き換える。マーカー外の手書きHTML（ヘッダー・フッター・デザイン）は同期の影響を受けない
• works.md（AIO用）— 台帳全件を機械可読なMarkdownで並べる。AIクローラー向けの一次情報
• 社内確認カード — 台帳の中身をブラウザで答え合わせできる管制画面。inhouse-tasks.pages.devで一覧
• ニュース最新3件のトップ埋め込み — index.htmlの <!-- NEWS-SYNC:START/END --> に最新3件だけを配信

書き込みは原子的（atomic）：全ファイル分をtempに書き終わってから os.replace で一括差し替え。途中でエラーが起きても、公開ファイルは1本も壊れない

エスケープ方針：台帳由来の値は全てエスケープ。テキストは html.escape、属性値は quote=True 付き。台帳が内部データでもクォート混入でHTMLは壊せるので例外を作らない

冪等性：同じ台帳でsyncを2回実行しても出力は1バイトも変わらない。検証スクリプトが自動でチェック

※標準仕様は2号案件（トーモ版）以降のもの：1号案件（往来）のsyncには旧仕様が一部残っている（実績一覧ページの手動管理・順次書き込み・リポジトリ全ファイル配信）。新しい案件は本ページの標準仕様で作り、往来側は順次この標準に追いつかせる。

静的HTMLだから、月額ゼロ・SSL自動・CDN込み

• 案件ごとに Pagesプロジェクトを1つ作る（例: ourai-site）
• デプロイ経路は案件ごとに違う（往来はCI経由＝git push即デプロイ、トーモはdeploy.sh手動）。決め打ちしない、案件のCLAUDE.mdに実態を書く
• デプロイ対象はホワイトリスト方式（.claude/ や CLAUDE.md を本番に流さないため）
• 独自ドメインへの切り替えはDNSの向き先変更だけ。旧サーバーは触らず済む

Search Console／AI回答健康診断：公開後の効果測定は月次で。SEOはSearch Console、AIOはAI診断ツール（外部）で「AIが会社について何を間違えているか」を実測

「見て」の一言で回る、自動化しない設計

• チャンネル名例: 🚧ウェブ修正（1本だけ）
• スタッフやオーナーが自然文で書く：「◯◯の実績追加して」「ニュースに載せて」
• Webhook等の自動監視botは作らない（数社までは手動で維持費が節約分を上回るため）
• オーナーがAIに「チャンネル見て」→ AIがChromeでDiscordを開いて依頼を読み、要約と「反映するとこうなる」を提示 → OKで台帳編集→同期→デプロイまでAIが代行
• 完成済みAsset画像は共有Dropboxの日付フォルダに置いてチャンネルに一言添える（Discord経由だと圧縮・ファイル名破損があるため）
• オーナー本人の依頼は依頼＝承認なので確認省略
• 外出先・スマホ時はスクショ貼り付けでの持ち込みも可