QOL Playbook

このセクションは、自分の作業環境で「説明を読んで、そのまま貼って、失敗しない」ための運用メモです。

目的はシンプルです。

• Windows / PowerShell / Firefox の事故パターンを減らす
• エージェントに出してほしいコマンド形式を固定する
• 毎回パスを手で加工する手間をなくす
• ローカル資料と pi skill の両方に同じ思想を持たせる

この環境の前提

項目	前提
OS	Windows 11
ターミナル	WezTerm
普段使うシェル	PowerShell 7 (pwsh)
読むブラウザ	Firefox
ファイル名検索	se (Everything CLI ラッパー) または fd
本文検索	rg (ripgrep)

読む順番

1. Windows 作業環境
2. PowerShell / WezTerm コピペ安全運用
3. Firefox で読む資料の作り方
4. エージェント出力契約

最重要ルール

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

PowerShell 7 で実行してほしいコマンドは、まず 1行コピペ版 で出す。

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

長いときはパスを変数に逃がす。

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

cd とパスを別行にしない。bash 用の activate を PowerShell 用として出さない。