「自律型エージェント(Agentic Coding)」の第4回目の記事となります。
▶第1回目の記事はこちらから
▶第2回目の記事はこちらから
▶第3回目の記事はこちらから
どれほどマルチエージェントの理念を理解しても、AIエージェントへの「最初の指示(プロンプト)」や「事前設定ファイル」が適当であれば、エージェントは真価を発揮できません。
本日第4回目の記事では、コピペしてすぐに自分のプロジェクト(Webアプリ開発、システム構築など)に導入できる「有料級のテンプレート集」をちゃんりおネットが公開しますので、最後までぜひ読んでみてくださいね。
1. プロジェクトの行動規範ファイル:CLAUDE.md / .cursorrules テンプレート
リポジトリのルートディレクトリに配置し、エージェントに常時参照させる「行動規範ファイル」の完成形テンプレートです。
Markdown
# プロジェクト基本規約 & エージェントガイドライン
## 1. 技術スタック
- Framework: Next.js (App Router), TypeScript
- Styling: Tailwind CSS
- State/Database: Prisma, PostgreSQL
## 2. コーディングルール
- 型定義: `any` の使用は厳禁。必ず明示的な型または `unknown` を使用すること。
- コンポーネント: 原則として Functional Component で記述し、アロー関数を使用。
- エラーハンドリング: API呼び出し部には必ず `try-catch` を配置し、適切なエラーログを出力すること。
## 3. 禁止事項・安全ルール
- `.env` や機密情報が含まれるファイルを外部に出力・変更しないこと。
- `git push --force` やデータベースの全削除コマンドは絶対に実行しないこと。
## 4. 自律実行手順
- コード変更後、必ず `npm run lint` および `npm test` を実行し、エラーがないことを確認してからタスク完了とすること。
2. 要件定義を丸投げしない「機能実装プロンプト」テンプレート
新しい機能をエージェントに実装させる際、要件の抜け漏れを防ぐための指示フレームワーク(Goal / Context / Constraints / Definition of Done)です。
📋 テンプレート:新規機能追加プロンプト
Plaintext
【目的(Goal)】
ユーザー管理画面に「CSVデータの一括エクスポート機能」を追加してください。
【背景・文脈(Context)】
現在、管理者は1件ずつしかユーザー情報を確認できません。
`/api/admin/users` のエンドポイントを利用し、フロントエンド側に「CSVダウンロード」ボタンを設置する必要があります。
【制約条件(Constraints)】
1. UIデザインは既存の `Button` 共通コンポーネント(@/components/ui/button)を再利用すること。
2. 出力するCSVデータにはパスワードハッシュなどの機密フィールドを含めないこと。
3. 大容量データに対応するため、クライアント側でのストリーミング処理、または軽量化を意識すること。
【完了条件(Definition of Done)】
- [ ] ボタンを押すと `.csv` ファイルが正常にダウンロードされること
- [ ] 関連するユニットテストが追加され、すべてパスすること
- [ ] ビルドエラーおよびTypeScriptの型エラーが0件であること
3. コード破壊を防ぐ「ガードレール指示」テンプレート
リファクタリングや大規模な修正を頼む際、既存コードを勝手に消されたり壊されたりするのを防ぐための指示文です。
🛡️ テンプレート:安全リファクタリング指示
Plaintext
【タスク】
`/lib/auth.ts` の認証処理のリファクタリングを行ってください。
【必須遵守ルール】
1. **破壊的変更の禁止**: 既存の外部API仕様(関数の引数・戻り値の型)は変更しないでください。
2. **段階的変更**: 一度にすべてのコードを書き換えず、関数ごとにリファクタリングを行い、その都度テストを実行してください。
3. **ロールバック準備**: 各ステップで動作確認(`npm test`)を行い、テストが失敗した場合は自律的に前の状態にコードを戻して原因を分析してください。
4. 【実例】ゼロからWEBアプリを立ち上げる3ステップ
テンプレートを組み合わせて、ゼロから1つのWebアプリ(MVP)を構築する際の実践手順です。
- Step 1: 規約の設置
プロジェクト作成直後にCLAUDE.md(または.cursorrules)を配置し、使用技術とコーディングルールを認識させる。 - Step 2: タスクの細分化と実装指示
「機能実装プロンプト」を使って、「DBモデル作成」➔「API作成」➔「UI作成」と1タスク1セッションで進める。 - Step 3: 自律レビューとテスト確認
ガードレール指示に基づき、エージェント自身にnpm testを回させて全パスを確認した上でマージする。
これらのテンプレートをプロジェクトの特性に合わせてカスタマイズし、手元にストックしておくことで、指示出しの時間を従来の10分の1に縮小できます。
次回は、Agentic Codingを運用する中で必ずぶつかる「アンチパターンとトラブルシューティング」について深掘りしていきます。
■物価高騰吹き飛ばせ!
【格安引越し】【単身引越し】基本料金5000円〜!
お気軽にご相談ください
ちゃんりおネットでは、副業であなたのビジネスを始めることを推奨しています。これからの日本では自分のビジネスも持ちながら働く必要があります。そのために、これからもちゃんりおネットの記事をお読みいただけると幸いです。
▶フリーランスになろう (ちゃんりおネットのフリーランスになろう記事に遷移します)
最後までお読みいただきましてありがとうございます。
では、また次回にお会いしましょう!!
