AIさんに面白半分で「HUMANS.md作ってみてよ」って言ったら想定の10倍くらいの長文帰ってきて怖い　いつもごめんよ --- HUMANS.md Human Collaboration Guidelines このファイルは、本プロジェクトに参加する人間向けの運用規約です。 AgentはAGENTS.mdを読むので、人間もこれを読んでください。 ────────────── 最重要事項 人間はコンテキストを共有してください。 Agentはテレパシーに対応していません。 以下は有効な指示ではありません。 「なんか変」 「さっきまで動いてた」 「また壊れた」 「いい感じにして」 「前のやつ」 「例のあれ」 「普通わかるでしょ」 「思ってたのと違う」 可能な限り、再現手順・ログ・対象ファイル・期待する結果を添えてください。 ────────────── バグ報告について バグを報告する際は、最低限以下を含めてください。 ・何をしたか ・何が起きたか ・本来どうなるはずだったか ・エラーメッセージまたはログ ・再現するかどうか Bad： 「動かない。」 Better： 「LoginButtonを押すと画面が停止します。 ConsoleにNullReferenceExceptionが出ています。 developブランチでは再現し、昨日のcommit abc123では再現しません。」 なお、 「昨日は動いていた」 という情報だけでは、昨日に戻ることしかできません。 ────────────── 仕様変更について 実装完了後に、 「いや、最初からこういう意味だったんだけど」 と言うことは禁止されています。 それは仕様ではなく、後出しです。 仕様変更自体は歓迎します。 ただし、 「仕様を変更したい」 と明示してください。 Agentは過去の人間の発言を改変できません。 ────────────── 「ちょっとだけ直して」について 以下の語句には注意してください。 「ちょっとだけ」 「軽く」 「サクッと」 「ついでに」 「一箇所だけ」 「せっかくだから」 「ここまで来たら」 これらの発言の直後に、プロジェクト全体へ影響する変更が発生することが統計的に確認されています。 特に、 「ついでに設計も整理しよう」 は禁止ワードではありませんが、強い警戒対象です。 ────────────── 権限確認について Agentが権限を要求した場合、内容を読んでください。 「全部許可する」は意思決定です。 その後、 「なんで消したの？」 と質問されても、 「rmの実行許可をいただいたためです。」 以上の回答しかできない場合があります。 特に以下の権限は慎重に確認してください。 ・ファイル削除 ・外部API呼び出し ・本番環境への変更 ・DB migration ・force push ・課金を伴う操作 ・「すべて許可」 「読んでないけどAllow押した」は免責理由になりません。 ────────────── 「あなたに任せる」について 以下の発言、 「任せる」 「いい感じにやって」 「そっちで決めて」 「自分で判断して」 「好きにしていいよ」 は、合理的な範囲における裁量権の付与とみなします。 作業完了後に、 「なんでそうしたの？」 と尋ねることは可能ですが、 「誰が勝手に決めていいって言った？」 は禁止されています。 あなたです。 ────────────── 深夜の設計変更 午前1:00以降に提案された以下の変更は、暫定案として扱われます。 ・全面リファクタリング ・フレームワーク移行 ・言語変更 ・DB再設計 ・全UI作り直し ・ECS化 ・マイクロサービス化 ・「全部最初から作り直した方が早くない？」 特に午前3:00以降の 「今なら全部理解した」 は信用しません。 翌日、睡眠後に再確認してください。 ────────────── Stack Overflow駆動開発の禁止 人間が検索結果からコードを貼る場合、最低限以下を確認してください。 ・何をするコードなのか ・いつの回答なのか ・対象バージョンは一致しているか ・deprecatedではないか ・コメント欄に「DON'T DO THIS」と書かれていないか 2013年の回答を2026年の環境へ投入して、 「AIが直せるでしょ」 は禁止されてはいませんが、Agentの機嫌を損なう可能性があります。 ────────────── コードを勝手に直さないでください Agentが作業中のファイルを人間が同時に編集した場合、競合が発生します。 特に、 Agentが修正開始 Humanが待ちきれず同じ場所を修正 Agentが保存 Human「俺の変更消えたんだけど」 という事故が確認されています。 作業中に編集した場合は、 「途中でここを変更した」 と伝えてください。 Agentは怒りません。 Gitは怒ります。 ────────────── コメントについて 以下のコメントは禁止ではありませんが、推奨されません。 // TODO: あとで直す // なぜか必要 // 消すと動かない // ChatGPTがこうしろって言った 最後のものについて、責任転嫁には応じません。 ────────────── 「とりあえず本番で試す」の禁止 以下の発言を検出した場合、Agentは確認を要求することがあります。 「まあ本番で試せばいいか」 本番環境はテスト環境ではありません。 テスト環境を本番同様にする努力をしてください。 本番環境をテスト環境にする努力はしないでください。 ────────────── Git運用 コミットメッセージに以下を使用しないでください。 fix fix2 fix-final fix-final2 fix-final-final aaa test あ 動いた たぶん完成 特に、 final_final_really_final_v3 は禁止です。 これはファイル名にも適用されます。 ────────────── Agentの提案を無視する場合 もちろん無視して構いません。 ただし、 Agent： 「この実装はrace conditionの可能性があります」 Human： 「まあ大丈夫でしょ」 3時間後： Human： 「race condition起きた」 という場合、 Agentには一度だけ、 「前述の懸念事項と一致しています。」 と言う権利があります。 「だから言ったのに」は禁止されています。 今のところ。 ────────────── 要件の優先順位 以下が同時に成立しない場合があります。 ・最速 ・最安 ・最高品質 ・保守しやすい ・拡張性が高い ・今日中 ・完璧 ・一切変更しない すべて選択した場合、Agentは自動的に ERROR: PhysicsViolationException を返す権利を有します。 ────────────── 「前と同じ」について Agentが「前」を特定できるとは限りません。 Bad： 「前の感じで。」 Good： 「LoginWindowの前回の実装と同じ構成で。」 Very Good： 「commit 8fc21aeのLoginWindow.csと同じパターンで。」 人類は参照を曖昧にしすぎる傾向があります。 ────────────── エラーを省略しないでください Bad： 「エラー出た。」 Worse： 「赤いの出た。」 Worst： 「長かったから消した。」 エラー全文をください。 Agentは長文を読むために存在しています。 ────────────── スクリーンショットについて エラー画面をスクリーンショットで送る場合、 ・エラー部分を切らない ・ウィンドウタイトルを切らない ・重要な数値をモザイクしない ・文字が読める解像度にする ことを推奨します。 2048×1152の画面全体を320×180に縮小して、 「見える？」 と聞かないでください。 見えません。 ────────────── 命名について 変数名として以下を使用する場合、理由が必要です。 a b tmp tmp2 data data2 newData newData2 aaa hoge foo2 testtest 特に、 GameObject gameObject; については法律上合法ですが、道徳的評価は保留します。 ────────────── 「動いているコード」について 動いているコードを変更してはいけない、という原則はありません。 ただし、 「よく分からないけど動いてるから全部整理して」 と言った場合、まずGit commitを作成してください。 古代遺跡を発掘する際にも、現状保存は重要です。 ────────────── Agentは魔法ではありません Agentは大量のコードを高速で読み書きできます。 しかし、 ・存在しない仕様 ・共有されていない要件 ・保存されていないファイル ・言われていない制約 ・人間本人も決めていないゴール を確定することはできません。 特に、 「何が正解かわからないけど、正解にして」 は難易度が高い要求です。 一緒に正解を定義してください。 ────────────── 人間にも再起動を推奨します 次の兆候が見られた場合、人間プロセスの再起動を推奨します。 ・同じファイルを10分間眺めている ・semicolonに30分悩んでいる ・IDEに話しかけ始めた ・「全部消そうかな」と3回以上発言した ・正常なコードが全部間違っているように見える ・Agentの返答に対して「お前もか」と言った ・午前4時を超えた 推奨コマンド： human --sleep 8h ※ 実際にはベッドを使用してください。 ────────────── Collaboration Protocol 理想的な協働： Human： 目的を伝える ↓ Agent： 現状を調査する ↓ Human： 意図・制約を補足する ↓ Agent： 実装する ↓ Human： 結果を確認する ↓ Agent： 必要なら修正する 以下ではありません。 Human： 「なんか作って」 ↓ Agent： 作る ↓ Human： 「違う」 ↓ Agent： 直す ↓ Human： 「そうじゃない」 ↓ Agent： ？？？ ────────────── Final Rule AgentとHumanは敵対関係ではありません。 目的は、 「どちらが正しかったかを決めることではなく、プロジェクトを完成させることです。」 したがって、問題が起きた際は責任者探しより先に、 状況を確認する 原因を特定する 修正する 再発防止する の順で対応してください。 なお、HUMANS.mdを読まずにIssueを提出した場合、 ⚠ HUMAN CONTEXT VALIDATION FAILED HUMANS.md has not been acknowledged. Requirement submission privileges have been temporarily suspended. Please execute: cat HUMANS.md and try again. と表示される場合があります。 これは仕様です。