aicm AGENTS.md

プロジェクト概要

このファイルは、このリポジトリでコードを扱う際に Claude Code (claude.ai/code)、Cline, Corsor, Github Copilot、Codex など各種 AI コードエージェント にガイダンスを提供します。

言語

• エージェントのやり取りは必ず日本語で対応すること
• rust コード上のコメント及び、コマンドの出力は、英語で記載すること

プロジェクト概要

このリポジトリは、複数の AI コーディングエージェント用の context ファイルを統一設定から自動生成する Rust 製コマンドラインツール aicm です。

目的

• GitHub Copilot、Cline、Cursor、Claude Code、OpenAI Codex 用の context ファイルを一元管理
• 一つの設定ファイルから各ツール固有のファイル形式を自動生成
• 開発チーム間での AI ツール設定の一貫性を保つ
• Rust による高速・安全な実装

サポート対象ツール

1. ✅ Cursor: .cursor/rules/*.mdc ファイル（実装済み）
2. ✅ Cline: .clinerules/*.md ファイル（実装済み）
3. ✅ GitHub Copilot: .github/instructions/*.instructions.md または .github/copilot-instructions.md（applyTo オプション対応済み）
4. ✅ Claude Code: CLAUDE.md（実装済み）
5. ✅ OpenAI Codex: AGENTS.md（実装済み）

詳細な設計概要は @docs/concept.md を参照してください。

セキュリティ 🔒

機密ファイル

以下のファイルは読み取りや修正を行わないでください：

• .env ファイル
• */config/secrets.
• */.pem
• API キー、トークン、認証情報を含むファイル

セキュリティプラクティス

• 機密ファイルをコミットしない
• シークレットには環境変数を使用
• 認証情報をログや出力に含めない

アーキテクチャ

設計原則

• 型安全性: Rust の型システムによるコンパイル時エラー検出
• メモリ安全性: 所有権システムによる安全なメモリ管理
• 並行処理: Tokio による効率的な非同期処理
• 抽象化: トレイトベースのエージェント設計
• 統一管理: 共通の設定ファイルから各ツール用ファイルを生成

プロジェクト構造

src/
├── main.rs                 # CLI エントリーポイント
├── lib.rs                  # ライブラリエントリーポイント
├── config/                 # 設定管理
│   ├── mod.rs
│   ├── loader.rs           # 設定読み込み
│   └── error.rs            # 設定エラー型
├── core/                   # コア機能
│   ├── mod.rs
│   └── markdown_merger.rs  # Markdownファイル結合
├── agents/                 # エージェント実装
│   ├── mod.rs
│   ├── base.rs            # ベースユーティリティ
│   ├── cursor.rs          # Cursor実装（実装済み）
│   ├── cline.rs           # Cline実装（実装済み）
│   ├── github.rs          # GitHub Copilot実装（実装済み）
│   └── claude.rs          # Claude実装（実装済み）
└── types/                  # 型定義
    ├── mod.rs
    ├── config.rs          # 設定型
    └── agent.rs           # エージェント型

docs/                      # 設計ドキュメント
├── concept.md             # 設計概要
├── design_doc.md          # 技術仕様書（Rust版）
└── requirements.md        # 要件定義

target/                    # ビルド出力
├── debug/                 # デバッグビルド
└── release/               # リリースビルド

Cargo.toml                 # プロジェクト設定
Cargo.lock                 # 依存関係ロック