JamesShi96/project-butler

何を解決するか

AIコーディングアシスタントは、異なるセッション間で『忘却』を起こしがちであり、ユーザーがプロジェクトのアーキテクチャ、命名規則、以前の意思決定を再説明する必要がある。project-butlerは、プロジェクトフォルダを共有の真実の源に変える永続的なメモリレイヤーを提供し、Claude Code、Cursor、Codexなどの異なるAIツールが前回のセッションで終了した場所から正確に再開できるようにする。

動作方法

このツールは、プロジェクトルートに直接格納されたプレーンなMarkdownファイルとJSON設定を使用して、7つのコンポーネントからなるメモリスタックを実装する。このスタックは情報の安定性に基づいて構成されている：

• 安定したルール：人間がレビューした原則が CLAUDE.md に保存される。
• 現在の状態：プロジェクトウィキ（PROJECT.md）、ファイル構成ルール（STRUCTURE.md）、マイルストーン変更ログ（UPDATE_LOG.md）。
• 原始的な事実：セッションログと TODO.md チェックリスト。
• 引継ぎ：session-handoff.md ファイルにより、次のアシスタントにどのように再開するかを明示的に伝える。

Claude Codeのネイティブスキルとして統合され、他のアシスタント向けに互換性ファイル（例：.cursor/rules/project-system.mdc や AGENTS.md）を生成し、同じメモリプロトコルに従うことを保証する。

対象ユーザー

AIコーディングアシスタントを使用し、繰り返しのコンテキスト設定を避けたい開発者。特に、異なるAIツール間を切り替えたり、複雑なアーキテクチャを持つ長期プロジェクトに取り組んでいる人向け。

特徴

• ツール間互換性：ファイルベースのメモリシステムにより、Claude Code、Cursor、Codexで動作可能。
• コード化された引継ぎ：end session で進捗を保存し、continue でコンテキストを再開するための特定のトリガーを使用。
• プロファイル対応：プロジェクトプロファイルを作成し、ドキュメントの階層と保護されたセクションを管理することで、より強固なアーキテクチャの整合性を実現。
• 自動メンテナンス：ファイルの整理、ウィキの同期、自身の更新を自動チェックする機能を含む。