notque/vexjoy-agent

VexJoy AI Agent with Intelligent Routing - /do routes plain-English requests to the right specialist agent and gates the work with reviews, tests, and a learning loop.

What it solves

VexJoy Agentは、助言的な指示を構造的な強制力に置き換えることで、AIエージェントが「ステップをスキップ」したり、壊れたコードをリリースしたりすることを防ぎます。エージェントがテストを実行したり変更を検証したりすることなく、作業が完了した、あるいは「些細な」ものであると自信満々に主張する問題を解決し、エージェントの自信のレベルに関係なく、高品質な手法が確実に実行されるようにします。

How it works

このツールキットは、AI CLIランタイム(Claude Code、Codex、Factory、Reasonixなど)に直接統合される4層アーキテクチャを通じて動作します。

  • Agents: ドメイン固有の知識(失敗モードのカタログやエラーから修正へのマッピングを含む)を提供します。
  • Skills: 厳格な終了基準を伴う段階的な手法を定義します。エージェントは、成功の証拠を提示することなく次のフェーズに進むことはできません。
  • Hooks: LLMのコストをかけずに不完全な作業をブロックする、ライフサイクルイベントのトリガーです。
  • Scripts: 実際の実行と検証を処理する決定論的なツール(linters、test runners)であり、検証プロセスからLLMの判断を排除します。

ユーザーは、ルーター(例:/do コマンドの使用)を介してシステムとやり取りし、ルーターは意図を分析して、正しい専門エージェントを適切なスキルと手法に自動的にペアリングします。

Who it’s for

  • Developers: コードの検証を保証し、デグレ(退行)を防ぐエージェント型ワークフローを必要とする開発者。
  • Knowledge Workers: コードを書かずに、リサーチ、ドラフト作成、および自己完結型のHTMLアーティファクト(レポート、スライドデッキ、プロトタイプ)を作成するためにツールキットを使用するナレッジワーカー。
  • AI Power Users: ルーティングテーブル、パイプライン、およびフックをカスタマイズしたいAIパワーユーザー。

Highlights

  • Anti-Rationalization: 終了ゲートとフックを使用して、エージェントがテストや検証をスキップすることをブロックし、アサーション(断定)ではなく終了コードを要求します。
  • Multi-Runtime Support: Claude Code、Codex、Factory、Reasonixと互換性があります。
  • Harness-Integrated Routing: 自然言語のリクエストを、適切な専門エージェントと手法に自動的にルーティングします。
  • Knowledge Work Engine: AIパターンに対してドラフトを検証し、高忠実度のHTMLアーティファクトを生成するコンテンツエンジンが含まれています。
  • Evidence-Based Evolution: 新しいスキルは、ツールキットにマージされる前に、ベースラインに対してA/Bテストが行われます。