whitelonng/mancode

何を解決するか

多くのAIコーディングエージェントは、過剰な設計をし、既存のデザインシステムを無視するか、重要な計画やレビュー段階を飛ばす傾向があります。mancodeは、これらのエージェントに工学的規律を課すローカルなワークフロー調整層を提供し、変更を実装する前に既存のコードを再利用し、構造化されたガバナンスプロセスに従うことを保証します。

動作方法

mancodeは、Claude Code、Cursor、GitHub Copilotなどの既存のAIエージェントを置き換えるのではなく、それらをラップするものです。ブートストラップアダプタをインストールし、スラッシュコマンドで特定の作業モードをトリガーできます。これらのモードは、ローカルの .mancode ディレクトリ内でタスクの状態、セッションの継続性、および根拠に基づくレビューを管理し、タスクコンテキストを一時的なチャット履歴から分離します。

対象ユーザー

• バックエンド、ウェブ、モバイル、CLIプロジェクトでAIコーディングエージェントを使用する開発者。
• 複数のエージェントや開発者間で共有メモリ、意思決定記録、協調的なタスクの引き継ぎを必要とするチーム。
• UI重視のプロジェクトで、AIエージェントが既存のデザイントークンやコンポーネントライブラリに従うことを強制したい場合。
• クリティカルな変更に対して再現可能で監査可能なコードレビューおよび検証プロセスが必要なプロジェクト。

主な特徴

• マルチエージェント対応: Claude Code、Cursor、Codex、GitHub Copilot、ZCode、Kimi Code、Qoder、DeepSeek Harness と統合可能。
• 段階的な作業モード: solo（軽量タスク用）、/man（高ガバナンス計画と9ステップ実行用）、/manba（バグ診断用）、/manteam（共有チームメモリ用）。
• YAGNIの強制: 新しい抽象化を作成するのではなく、既存のコードや標準ライブラリの再利用を優先するようエージェントを促進。
• 継続性: 安定した TaskRef 識別子を使用して、異なるチャットセッションやクライアント間でタスクを再開可能。
• 根拠に基づくレビュー: タスクを完了するには、AIの自己主張だけでなく、実際の検証証拠（ログ、テスト出力）が必要。
• プロジェクト健全性スキャン: manps を使用して、古くなったTODO、未使用の依存関係、ハードコードされたデザイン値を検出。