codex-agent-loop-notes

by na-navi · 公開サイト: https://codex-agent-loop-notes.pages.dev/

OpenAI 公式記事「Codex エージェントループの展開」を読み解きながらためる na-navi の個人学習帳。MkDocs Material で静的サイト化して Cloudflare Pages に public で乗せている。

このリポジトリの姿勢

• 個人の学習帳。読者向けの解説サイトではない
• public にしている理由は 1 つ: ChatGPT / Claude 等に URL ごと渡して文脈付きで相談できるようにするため
• 論文本体は Firefox のローカル翻訳で読む。全文翻訳HTMLは作らない
• 詰まった点だけ AI に質問 → 該当ページの「引っかかりメモ」に追記していく
• 載せないもの: NDA・業務情報・個人情報・credentials・身バレ要素

内容

パス	内容
docs/index.md	サイトの表紙
docs/codex-agent-loop.md	エージェントループの構造・実装上のキモ・現在読むべき Rust 実装箇所・背景論文
docs/papers/	関連 arXiv 論文のリンク + 読む意図 + Codex との関係 + 「引っかかりメモ」
docs/qol/	Windows 11 / PowerShell 7 / WezTerm / Firefox 前提の QOL Playbook
.pi/skills/paper-copyright-guard/	論文ページを書くときに必ず読む著作権ローカルスキル。CC BY 4.0 と arXiv non-exclusive を厳密に分け、原文掲載・翻訳の可否を明示。
mkdocs.yml	MkDocs Material 設定
requirements.txt	Python 依存（バージョン固定済み）

🚀 今すぐ使う（3ステップ）

以下、<repo> はローカルクローン先（例: D:\work\codex-agent-loop-notes）に読み替える。

1. エイリアスを一度だけ入れる（PowerShell 7 で）

pwsh -NoProfile -File "<repo>\scripts\install-aliases.ps1"

2. PowerShell を再起動（または . $PROFILE.CurrentUserAllHosts）

3. どこでもこれだけ

notes-serve

エイリアス	動作
notes-serve	MkDocs 起動 → http://127.0.0.1:8000/
notes-build	strict build して site/ 生成
notes-cd	リポジトリに移動
notes-open	ブラウザで http://127.0.0.1:8000/ を開く

停止は Ctrl+C。

エイリアスなしでローカルプレビュー / ビルド

どこからでも（cd 不要）:

pwsh -NoProfile -File "<repo>\scripts\serve.ps1"

サイト内にいるなら一行で:

cd "<repo>"; .\.venv\Scripts\mkdocs.exe serve

ビルド検証（--strict = warning をエラー扱い。Cloudflare Pages ビルド失敗を事前検知）:

pwsh -NoProfile -File "<repo>\scripts\build.ps1"

Cloudflare Pages にデプロイ

A. GitHub 連携で自動デプロイ（推奨）

1. Cloudflare Dashboard → Workers & Pages → Create → Pages → Connect to Git
2. このリポジトリ (codex-agent-loop-notes) を選択
   • Private リポジトリでも Cloudflare Pages の GitHub App に権限を与えれば連携可能
3. ビルド設定:
   • Framework preset: MkDocs（または None）
   • Build command: pip install -r requirements.txt && mkdocs build --strict
   • Build output directory: site
   • Environment variable: PYTHON_VERSION = 3.12
4. Save and Deploy

以降は main への push でビルド & デプロイが自動実行される。

💡 このリポジトリは public 設計: Cloudflare Access はかけない。理由は AI に URL ごと渡して読ませるため。その代わり、NDA・職務情報・個人情報は一切載せない。

B. Wrangler で直接アップロード

# 事前にビルド
mkdocs build --strict

# Pages プロジェクトに直接アップロード
npx wrangler pages deploy site --project-name codex-agent-loop-notes

詳細は Wrangler ドキュメント 参照。

論文ページを書く際の注意 (重要)

docs/papers/ を書き足し・修正するときは、必ず paper-copyright-guard スキルを先に読むこと。

重要ポイントの圧縮:

• public サイトは公衆送信。「個人メモ」の意図では著作権を逃れられない
• <details> やトグルの裏に原文を隠しても公衆送信として扱われる
• CC BY 4.0 論文: 原文掲載・翻訳可能 (attribution 必須)
• arXiv non-exclusive 論文: 要約・短い引用・リンクのみ。原文掲載と全文翻訳は禁止
• 各ページ冷頭に Verified license ブロック、末尾に Attribution ブロック必須
• notes-build が lint (scripts/lint-papers.ps1) を含むので、ルール違反はビルド時に検知される

ライセンス

MIT