個人開発者のAIエージェント運用設計：Codexに任せる前に決めること
AIエージェントを個人開発で使う前に、目的、権限、変更範囲、レビュー、build/check、本番反映の線引きをどう決めるかを解説します。
公開 2026.06.28 / 更新 2026.06.28
この記事のポイント
- 個人開発のAIエージェント運用は、目的、変更範囲、禁止事項、検証、完了報告の5点から始める
- 調査、設計、1記事追加、クラスター追加、build/check、push、本番反映は同じ作業として混ぜない
- AGENTS.mdやSkillsは、強いモデルを使うための飾りではなく、レビュー可能性を上げる運用部品になる
結論：AIに任せる前に、人間側の合格条件を決める
CodexやClaude Codeに任せる時、プロンプトのうまさだけでは足りません。何を変えてよいか、何を変えないか、どの確認が通れば完了か、どこからは人間確認かを決めるほど、AIの成果物はレビューしやすくなります。
| チェック | OK例 | 危ない例 |
|---|---|---|
| 目的 | 1記事クラスター追加 | サイト全体を良くして |
| 範囲 | src/dataの対象ファイルのみ | 全部自由に触って |
| 合格条件 | build/check/sitemap成功 | いい感じならOK |
| 戻し方 | git diffとcommit単位で確認 | 差分を見ない |
| 本番影響 | pushまで、本番未反映 | そのまま公開 |
Codexに渡す前に決める5点
- 目的：何を達成する作業か
- 変更範囲：触ってよいファイル、触らないファイル
- 禁止事項：本番反映、秘密情報、依存追加、破壊的操作
- 検証：build、check、sitemap、URL、diff
- 完了報告：変更内容、確認結果、commit/push、本番確認URL
作業単位を分ける
| 単位 | AIに頼みやすいこと | 混ぜると危ないこと |
|---|---|---|
| 調査だけ | 公式ソース確認、比較表 | 未確認情報で実装する |
| 設計だけ | 構成案、見出し、導線案 | 勝手に大改造する |
| 1記事追加 | 本文、FAQ、関連リンク | 既存記事の主題を壊す |
| クラスター追加 | 親子記事、更新メモ、sitemap | 本番反映まで丸投げ |
| build/check | ログ確認、生成物確認 | 失敗を成功扱いする |
| push | 通常push | deployやforce push |
AGENTS.md / CLAUDE.md / Skillsの役割
AGENTS.mdやCLAUDE.mdは、AIに性格をつけるための文章ではなく、作業ルール、禁止事項、確認コマンド、報告項目を固定するための運用ファイルです。Skillsは繰り返す作業手順を再利用する道具として使うと、毎回の指示漏れを減らせます。
GitHub差分レビュー導線を残す
個人開発では、AIが作業を終えたあとにGitHubで差分を見られる状態を作るのが現実的です。commit、push、PR、またはローカルdiffのどれで見るかを先に決めるだけでも、AI作業の採用判断がしやすくなります。
FAQ
AGENTS.mdを書けばAIエージェントは安全になりますか？
安全性は上がりますが、それだけで十分ではありません。権限、diff、build/check、本番反映の人間確認も必要です。
pushまで任せてもよいですか？
通常pushの条件が満たされ、deployや本番反映が走らないと確認できる場合に限ります。force pushやdeployは別確認にします。
関連記事
- AGENTS.mdとは？Codex・Copilot code reviewにプロジェクトルールを伝える基本
AGENTS.mdとは、CodexのようなAIエージェントにプロジェクトの作業ルールを伝えるための指示ファイルです。毎回チャットで説明するより、運用が安定します。
- Codexの完了報告はどこを見る？build・check・diff・本番確認URLの読み方
Codexが「完了」と言ったあと、何を見るべきか。build/checkの成功、未確認事項、diff、upload、commit hash、本番確認URLを順番に読みます。
- AIにpushさせる前に見るGitHub差分レビュー｜個人開発者の安全チェック
AIにpushさせる前に、ファイル単位で何を見るか。GitHub差分、関連ファイル、package変更、secret、CI/CD、本番影響を短く確認します。
- Codexはコーディング専用から知識労働ツールへ：OpenAI発表から見る使い方の変化
OpenAIは、Codexがコードを書く道具にとどまらず、レポート、表計算、調査、データ分析、業務自動化にも広がっていると説明しています。個人開発では、相談と実ファイル作業を分ける使い方が鍵です。
- Codexとは？ChatGPTとの違いと個人開発での安全な使い方
Codexとは、チャットで相談するAIというより、コード作業を進めるための開発支援エージェントです。ChatGPTとの違いは、コードベースに触れる距離にあります。
- CodexとClaude Codeの違い｜個人開発での使い分けと安全な選び方
CodexとClaude Codeは、どちらが絶対に上というより、用途で向き不向きが変わります。個人開発では組み合わせて使う方が現実的です。
- AIコーディングは本当に速いのか？Codex・Claude Code時代のレビュー地獄と生産性研究
AIでコードを書く速度と、レビューして安全に出せる速度は別です。研究、公式資料、個人開発の実運用をつないで、速くなる条件と遅くなる条件を整理します。
- AIエージェントのベンチマーク完全ガイド：SWE-benchだけでCodexの実力は分からない理由
ベンチマークはランキングではなく、何を測って何を測っていないかを見る道具です。Codex作業に近い評価軸を分けて読みます。
- AgentHarm・AgentHazardで読むAIエージェントの危険な失敗：ツール権限と禁止事項をどう設計するか
AIエージェントの危険は、1つの返答よりも、ツール利用、ファイル操作、外部送信、権限変更の連鎖で大きくなります。防御寄りに整理します。
- AIエージェントに任せてはいけない作業｜個人開発で事故らない判断基準
AIエージェントは便利ですが、すべてを任せるものではありません。個人開発では、手を動かす作業と責任ある判断を分けることが大事です。
- Codexのフルアクセスは危険？許可していい作業・止めるべき作業
Codexのフルアクセスは、何でも任せてよい設定ではありません。許可してよい作業、止めるべき作業、.envやAPIキーの扱いを先に分けておくための安全ガイドです。
- MCPとは？AIエージェントに外部ツールをつなぐ仕組みと注意点
MCPとは、AIエージェントに外部ツールやデータソースへの窓口を持たせる仕組みです。便利になるほど、渡す権限の設計が重要になります。
- Claude Tagとは？Slackで動くチーム協働AIエージェントとClaude Codeとの違い
Claude Tagは、Slackのチャンネルで@Claudeを呼び出し、チームの文脈を使って作業を委任するClaude Team/Enterprise向けbetaです。Claude Codeの代替ではなく、個人作業からチーム協働へ広げる入口として見ると分かりやすいです。
- Claude Code Skillsとは？AIコーディングの作業手順を安全に再利用する仕組み
Claude Code Skillsとは、特定の作業手順や専門タスクを再利用するための仕組みです。プロジェクト指示とタスク手順を分けると運用しやすくなります。