言葉が通じないまま、進む

実際に起きたこと4件

• 全般

  「専門用語をやめてほしい」と言うまで、止まらなかった

  ある日、作業に入る前に、こちらから切り出しました。「まず前提として専門用語をやめてほしい。私が理解できてない」

  その日の話の入り口で言っています。 つまり、前の日までの分からなさが積み上がって、そこで限界が来たということです。

  自分の作業記録を検索したら、同じ趣旨のことを1ヶ月で30回言っていました。「これどういう意味？」「わからん」「わかりやすく」。

  30回言ったということは、言わなかった回がその何倍かあるということです。毎回言うのは疲れるので、途中から言わなくなります。

• 設定作業

  「左メニューの『サイトマップ』をクリック」で止まっていた

  ある管理画面での設定を説明したときの話です。「左メニューの『サイトマップ』をクリック」と書いたら、「これがわからん」と返ってきました。

  説明する側は、その画面を知っている前提で書いています。私はその画面を開いたことがありません。「左メニュー」がどこを指すのかが、そもそも分かりません。

  操作の説明では、ボタンの名前より先に「どの画面の、どのあたりにあるか」が要ります。

• 調べもの

  説明が長くなるほど、確認が減っていった

  作業が込み入ってくると、返ってくる説明が長くなります。長い説明の中には、知らない言葉がいくつも混ざります。

  そこで毎回止めて聞き返すと、話が進みません。だんだん「たぶんこういうことだろう」で流すようになりました。

  分からないと言わなくなったのは、分かるようになったからではありません。 聞き返す手間のほうが大きくなったからです。

  この型が厄介なのはここです。進むほど確認が減り、確認が減るほど分からない部分が積み上がります。

• サイト作り

  自分で作った3つの見出しが、区別できなかった

  ページの中に「次からどうするか」「そのまま貼れる」「手元で確かめる」という3つの見出しを並べていました。

  読み返して「このあたりが似ていてややこしい。初心者には区別できない」と気づきました。

  書いた側には、3つの違いがはっきり見えています。 違うから分けたのです。でも初めて読む人には、似た日本語が3つ並んでいるようにしか見えません。

  難しい言葉を使っていなくても、この型は起きます。分けた理由が書いていなければ、分かれていないのと同じです。

そもそもの原因

説明する側は、その言葉を知っています。知っている言葉は、難しく感じません。だから「ここは補足が要る」という感覚が生まれません。しかも相手の語彙は、聞かないかぎり分かりません。確かめる仕組みを入れないと、情報がこちらに返ってこない構造になっています。

この型を防ぐには

やることは3つです。渡す相手が、それぞれ違います。

次の決まりを、いま作業しているフォルダの CLAUDE.md に書き足してください。
ファイルが無ければ作ってください。

説明のしかたは、いつも次を守ってください。

・専門用語を使うときは、**初めて出てくるところで、かっこ書きの言い換えを1行**付けてください
・画面を操作する説明では、ボタンの名前より先に
　**「どの画面の、どのあたりにあるか」**から書いてください
・区切りごとに、その回に出した用語を3つまで挙げて、
　**私がそれを説明できるかどうか確認してください**
・私が「はい」「なるほど」としか返していないときは、伝わっていないかもしれません。
　**私の沈黙を、伝わった証拠にしないでください**

私が理解できていない状態で先に進むより、止まって聞き返してもらうほうが助かります。

守ってほしいこと
・文はそのまま書いてください。言い換えないでください
・すでにある決まりは消さないでください
・似た決まりが既にあれば、書く前に教えてください
・書いたあと、CLAUDE.md 全体をそのまま表示してください