Agentic Coding Sandbox

このプロジェクトは、LLM（大規模言語モデル）を使用したエージェンティックコーディング技術を探索・開発するためのサンドボックスです。特に、cline、GitHub Copilot、Claudeなどのツールを活用したAI支援コーディングに焦点を当てています。

目的

• コード生成や修正のための様々なプロンプト技術を実験する
• LLM支援コーディングワークフローのベストプラクティスを開発する
• 人間とAIの効果的なコラボレーションのためのルールやガイドラインをテストし改良する
• 一般的なコーディングタスクのための再利用可能なテンプレートやパターンを作成する

プロジェクト構造

• .clinerules: clineツールのコードスタイル設定
• .github/: GitHub設定ファイル
  • /.github/prompts/: 様々なコーディングタスク用の効果的なプロンプトを含む
  • /.github/copilot-instructions.md: GitHub Copilotのカスタム指示
• CLAUDE.md: Claudeとの連携に関するガイドラインとベストプラクティス

ガイドライン

プロンプト作成

プロンプトファイルは、Markdownファイルで完全なプロンプトを作成し、チャットで参照できるようにします。プロンプトファイルは、一般的なタスクの再利用可能なテンプレートを作成し、ドメイン知識をコードベースに保存し、チーム全体でAIとのやり取りを標準化するのに役立ちます。

プロンプト作成の詳細なテンプレートとガイドラインは、.github/prompts/generate-prompt.prompt.mdを参照してください。

GitHub Copilot

GitHub Copilotは、AIを活用したペアプログラミングツールです。効果的な使用方法については、以下のリソースを参照してください：

• Copilot Chatのプロンプトエンジニアリング
• リポジトリカスタム指示の追加

このプロジェクトのCopilot設定は.github/copilot-instructions.mdで定義されています。 プロンプトは.github/prompts/*.prompt.mdというパスで保存してください。

Claude

Claudeとの効果的な連携のためのガイドラインとベストプラクティスはCLAUDE.mdに記載されています。

Claudeを使用する際は、以下の点に注意してください：

• PRコメントやコミットメッセージに "🤖 Generated with Claude Code" を含めない
• "Co-Authored-By: Claude [email protected]" を含めない

Gitワークフロー

• コミットは適切な作業単位で説明的なメッセージを付ける
• メインブランチに直接コミットしない - 常にフィーチャーブランチを使用
• Conventional Commitフォーマットに従う

ドキュメンテーションのメンテナンス

• CLAUDE.md / .clinerules / .github/copilot-instructions.md を継続的に更新する
• 明確化された新しいルールや手順を追加する
• プロジェクト固有の知識とベストプラクティスを蓄積する
• 頻繁に使用されるコマンドとショートカットを記録する
• コード規約が変更されたり新しいツールが導入されたりした場合に更新する

ビルドと開発コマンド

• ビルド: TBD (ビルドシステムが設定されたらコマンドを追加)
• 開発サーバー: TBD
• リント: TBD
• 型チェック: TBD
• テスト: TBD
• 単一テスト: TBD (特定のテストを実行するためのパターンを指定)

貢献方法

このプロジェクトへの貢献を歓迎します。貢献する際は、以下のガイドラインに従ってください：

1. プロジェクトの目的と構造を理解する
2. 適切なコードスタイルとガイドラインに従う
3. 効果的なプロンプトとAI連携のベストプラクティスを実践する
4. ドキュメントを更新し、知見を共有する