「意味は分からなくていいから、とりあえず書いておいて」

これをプログラミングの世界で “おまじない” と呼ぶことがある。

プログラミングの記号や予約語の意味を正しく理解するのは難しい。何度も作ってハマって、ようやく理解が追いついてくる。なので最初は理解よりもまず「成功体験」を積むことが重要だ、という考え方だ。

AIエージェントがコードを書く時代では、人間が書くのは文字通り自然言語だけになる。

自然言語にも理解しづらい語彙は当然ある。知識がないままエージェントを振り回すことは様々なリスクを孕む。プログラマー向けのツールを使うならなおさらだ。 少なくとも現時点では、それらの語彙を正しく身につけることがAIエージェントを安全に使いこなすことに直結するだろう。

今、プログラミング初学者に教えるなら、AGENTS.md (CLAUDE.mdでも同じ) はどう書かせるべきだろうか？私はこういう内容がいいと思う:

私はプログラミング初心者です。
難しい言葉は使わずに、やさしく教えてください。
危険を感じたら、すぐに手を止めて、知らせてください。

重要なのは、

• そこに何が書かれているのかを本人が理解できる
• エージェントを単なる作業者ではなく、教育者とみなす
• 本人の断片的な知識や思い込みに頼らない

そして同時に、AGENTS.mdだけは絶対に自分の手で書くようにと強く強く念を押す。

AGENTS.mdは”おまじない”ではない。