0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

AIエージェント時代の開発 — エージェンティックコーディング実践

0
Posted at

AIとの開発の関わり方が、「補完(オートコンプリート)」から「委譲(エージェント)」へと大きく変わりました。実装タスクをAIエージェントに任せる エージェンティックコーディング の実践的な進め方を、2026年時点の状況を踏まえて整理します。

補完からエージェントへ — 何が変わったか

少し前までのAI活用は、エディタ上でコードの続きを提案してもらう「補完」が中心でした。現在のAIコーディングエージェントは、指示を受けると 計画を立て、関連ファイルを読み、複数ファイルを編集し、テストを実行し、失敗すれば自分で修正 するところまで一連で進めます。

人間の役割は「コードを書く人」から「方針を決めて、成果物をレビューする人」へ移りつつあります。

代表的なツール(2026年時点)

いずれも一長一短で、ワークフローに合わせて選ぶのが現実解です。

ツール 特徴
Claude Code ターミナル常駐型。CLIでリポジトリ全体を扱うエージェンティックな作業が得意
OpenAI Codex クラウドで非同期にタスクを投げるスタイル。並行して複数タスクを処理
Cursor IDE型。日常の中小規模の編集を高速に回すのに向く
GitHub Copilot エディタ統合の定番。エージェントモードも提供
Cline OSSのエージェント。エディタ拡張として動作

ポイントは「エージェント=モデル+ハーネス」という見方です。同じモデルでも、周辺の仕組み(ファイル操作・テスト実行・権限管理)の出来で実用性が大きく変わります。

うまく任せるための3原則

1. タスクを小さく切る

「認証機能を全部作って」ではなく「ログインのバリデーションを追加して」のように、人間がレビューできる粒度に分けます。大きく任せるほど速く感じますが、レビュー不能な差分は結局手戻りになります。

2. 検証手段を先に渡す

テストコマンドや期待する挙動を先に伝えると、エージェントは自分で成否を判断して修正できます。

# 「このテストが通るように実装して」と依頼する
pytest tests/test_login.py -q

「作って→人間が試して→直させる」より、「作って→自分で試させて→通ったらレビュー」の方が圧倒的に速く回ります。

3. コンテキストをファイルで渡す — AGENTS.md / CLAUDE.md

2026年時点で定着した実践が、リポジトリにエージェント向けの規約ファイルを置くことです。

  • AGENTS.md — ツール非依存の統一フォーマット。Codex・Cursor・Copilot など複数のエージェントが参照
  • CLAUDE.md — Claude Code が参照するファイル

ここにプロジェクト構成・コーディング規約・使うコマンド・してはいけないことを書いておくと、毎回口頭で説明しなくても既存コードに馴染む実装が返ってきます。ホーム → プロジェクトルート → サブディレクトリの階層で上書きできる運用も一般的です。

# AGENTS.md の例
## コマンド
- テスト: pytest -q
- 起動: docker compose up -d
## 規約
- 日付処理は必ず utils/dates.py を使う
- マイグレーションは自動生成せずレビューを経る

レビューは今まで以上に重要

エージェントは高速に大量のコードを生成します。だからこそ、差分を必ず読むことが品質の要です。

  • 意図と違う実装・過剰な変更を弾く
  • 「動いたからOK」ではなく「なぜこの実装なのか」を確認する
  • 生成量が増えるほど、レビューがボトルネックになる前提でタスクを小さく保つ

権限とセキュリティ

エージェントに実行権限を渡すほど便利になりますが、その分の備えが必要です。

  • 権限は最小限に。破壊的コマンドの自動実行は許可制にする
  • 秘密情報(APIキー・パスワード)をプロンプトやリポジトリに置かない
  • 外部の文書やWebを読ませる場合は、取り込んだテキスト内の指示には従わせない(プロンプトインジェクション対策)

まとめ

  • エージェンティックコーディングの鍵は「小さく切る・検証を渡す・コンテキストを整える
  • AGENTS.md / CLAUDE.md で規約をファイル化すると、精度が安定して跳ね上がる
  • 速くなった分、レビューと権限管理が品質と安全の要になる

任せる範囲を少しずつ広げながら、自分のワークフローに馴染ませていきましょう。


SNOW CODE / 雪符しき — プログラム × 音楽 × カクテルを愛する雪猫エンジニア

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?