はじめに

こんにちは！アポロ株式会社です。
弊社では、社内勉強会として「コーディングエージェント勉強会」を隔週で行っています📚

その中で、月末のみ、一般の方もご参加いただける外部開放日を設けています👏

今回は、その「コーディングエージェント勉強会#2」の内容を一部抜粋して皆さんにシェアさせていただきます。
ぜひ、この投稿を読んで参加してみたい！と思った方は、一緒にClaudeCodeをより深く学んでみませんか？

👉コーディングエージェント勉強会#3のお申込みはこちらから

1. こんな経験、ありませんか？

Claude Codeを使い始めてしばらく経つと、こんな壁にぶつかることがあります。

これらはClaude Codeの能力の問題ではなく、コンテキスト（情報・役割・手順）の渡し方が設計されていないことが原因です。

逆に言えば、設計さえ整えれば、要件定義からコードレビュー・E2Eテスト・プルリクエスト作成まで、開発の一連フローを半自動で進めることができます。この記事では、その核心となる考え方をかいつまんで紹介します。

コンテキストエンジニアリングとは、AIエージェントに渡す「文脈・情報・役割・手順」を意図的に設計することです。単に「何をしてほしいか」を伝えるだけでなく、「誰が何のためにどう動くべきか」を構造的に設計することで、AIが自立的・継続的に動けるようにします。

設計なしと設計ありでは、動き方がここまで変わります。

コンテキストエンジニアリングの核心は、メインエージェント（司令塔） と サブエージェント（専門家チーム） の役割分担です。

メインエージェント: カスタムスラッシュコマンドで起動し、どのサブエージェントをどの順番で呼ぶかを制御する

サブエージェント: 要件定義・設計・実装・レビュー・E2Eテストなど、それぞれの専門領域に特化して動く

各サブエージェントは独立した記憶を持つため、メインエージェントのコンテキストを圧迫せずに、長時間の自動開発が実現します。

/develop-feature のようなコマンドを実行すると、以下の流れが自動で進みます。

人間がレビューするのは 要件定義書と設計書だけ。 それ以降は自動で進みます。

どの情報をどのファイルに書くかが、設計の品質を決めます。

設計の3原則:

本記事では考え方の骨格を紹介しました。実際のコード例・動作デモ・トラブル対処など、「どう書くか・どう動くか」の詳細はオンデマンド配信で解説しています。

配信では以下の内容を実演しながら説明しています。

✅ CLAUDE.md・サブエージェントプロンプト・スラッシュコマンドの書き方（コード例付き）

✅ /develop-feature で要件定義〜PRまで自動で流れるライブデモ

✅ 3原則の違反例と修正例（Before/After）

✅ 推奨ディレクトリ構成・Makefile・gitignore などの実践Tips

✅ トークン消費の目安・よくあるトラブルと対処法

👉 コーディングエージェント勉強会＃2オンデマンド配信のお申し込みはこちら

コーディングエージェント勉強会の先行情報や、日々の小ネタをシェア、こういう時どうやって対処してる？なんていうちょっとしたお悩み相談まで。
ぜひ、アポロのメンバーと一緒にフランクにお話してみませんか？
👉参加希望の方はこちらから

アポロでは現在メンバーを積極的に募集しております。
こちらもご興味のある方は、ご応募お待ちしております！