自分で付けた名前が後で読めないのを防ぐ、判定の問い1つと5つの型
メモや設計書に自分で付けた名前が、数か月後には自分でも読めなくなる。名前の良し悪しを、説明を読まずに初めて読む人が中身の見当をつけられるかの1問で判定し、読めなくなる名前を5つの型に分けた。とくに見落としやすい、記号に置き換えた名前と比喩を組み合わせた名前を、悪い例と良い例で示す。
TAG
このタグの記事が全6件あります。
メモや設計書に自分で付けた名前が、数か月後には自分でも読めなくなる。名前の良し悪しを、説明を読まずに初めて読む人が中身の見当をつけられるかの1問で判定し、読めなくなる名前を5つの型に分けた。とくに見落としやすい、記号に置き換えた名前と比喩を組み合わせた名前を、悪い例と良い例で示す。
ソニーのミラーレス一眼α7C IIで、街歩きのスナップがブレる、ピントが外れるという悩みを減らすため、撮る場面を「被写体が動くか」で3つに分け、シャッター速度やピントの合わせ方をまとめてモードダイヤルの1・2・3に登録した。
Claude Codeに「この操作はしないで」と指示書に書いても、守るかどうかはそのときのAIの判断しだいになる。元に戻せない操作のうち機械で判定できるものは、実行の直前に走るhookで止める。sedの一括置換で起きた事故、hookの書き方と試し方、hookに移せない決まりの扱い。
Claude CodeとCodexを併用すると、CLAUDE.mdとAGENTS.mdに指示が二重になります。本文をAGENTS.mdに置き、CLAUDE.mdから@AGENTS.mdで読み込む形にまとめました。Codexで@の読み込みを試した結果も載せています。
MacにアプリをコマンドでインストールできるHomebrewを初心者向けに解説。公式サイトやApp Storeから入れるのと何が違うのか、formulaとcaskの違い、最初に覚えるコマンド、Brewfileとtopgradeを使った僕の今の使い方までを1本にまとめました。
Claudeで意図せず自動課金された年額プランを返金してもらった手順を共有します。カード登録の放置で同じ目に遭った人向け。
つくることで、見える景色がある。

