devcodex-labs/devcodex

Intent-driven AI coding workflow runtime for consistent context, skills, approvals, validation, and handoffs across six AI coding hosts.

DevCodex – 意図駆動型AIコーディングオーケストレーター

何であるか – DevCodexは、既存のAIコーディングアシスタント（GitHub Copilot、Claude Code、Gemini CLI、Grok、Cursorなど）の上に置かれるNode.jsコマンドラインハーネスです。モデルそのものを置き換えるものではなく、プロジェクトレベルのエンジニアリング層を追加します。これは以下の機能を実現します：

ユーザーの意図を解釈する – 自然言語によるリクエストを、構造化されたタスク（タイプ、範囲、リスク、必要なスキル、検証基準）に変換します。
プロジェクトコンテキストを管理する – 生成された Profile（プロジェクト構造、ビルド/テストコマンド、アーキテクチャ制約など）を読み取り、過去のタスク、チェックポイント、証拠を記憶します。
適切な「スキル」をロードする – 80以上のドメイン固有の機能（API設計、セキュリティレビュー、パフォーマンスチューニングなど）を内蔵したライブラリから、必要に応じてオンデマンドで読み込みます。
制御されたワークフローを実行する – 「開発」「修正」「分析」「監査」「再開」「チャット」など複数の設計されたワークフローから選択し、確認ポイント、自動進行、証拠に基づく完了を強制します。
長時間実行タスクをサポートする – セッション間でタスク状態を永続化し、安全に再開可能で、異なるAIコーディングホスト間での調整も可能になります。
証拠に基づく引き継ぎ – タスク完了を宣言する前に、変更内容、実行されたテスト、残るリスク、および将来の再利用を目的とした「自己進化」候補をオプションで生成します。

主な機能（READMEに記載）

機能	機能内容
意図駆動実行	ユーザーは目標を述べるだけで、DevCodexがワークフロー、範囲、必要なスキル、検証ステップを決定します。
マルチホスト対応	Codex、Claude Code、Copilot、Gemini CLI、Grok、Cursorの6つのAIコーディングホストに対応。共通のエンジニアリング層を使用します。
80以上のプロフェッショナルスキル	フロントエンド、バックエンド、セキュリティ、テスト、パフォーマンス、SREなど、事前にパッケージ化されたドメイン知識をオンデマンドでロード。
プロジェクトプロファイル	リポジトリ用の構造化された「エンジニアのハンドブック」（スタック、ビルド/テストコマンド、アーキテクチャ境界、契約）を生成。証拠に基づき、時間とともに改善可能。
オートモード	明示的な `@devcodex-auto`（またはエイリアス）を実行後、繰り返し確認なしで継続可能。ただし元の意図とセーフティチェックは尊重されます。
セッション間復元	タスクID、チェックポイント、証拠、残りの作業が `.devcodex/` に永続化され、新しいチャットでも前回の状態から正確に再開可能。
証拠に基づく完了	タスク完了前に、変更内容、テスト結果、ビルド結果、残るリスク、次に必要なステップを報告します。
制御された自己進化	人間の承認を得た上で、繰り返し発生する問題を再利用可能なスキルに変換可能。既存ルールの自動上書きは行いません。
並列タスクの安全分析	複数タスクを実行する前に、ファイルレベルの競合、共有状態、マージ順序をチェックします。
細粒度の権限モデル	読み取り専用分析、ファイル変更、Gitコミット、プッシュ、タグ、リリースなど、各操作に明示的な承認が必要です。
CLIユーティリティ	`devcodex init`、`status`、`doctor`、`runtime`、`governance ledger` など、検査、メンテナンス、ガバナンス用のコマンドが提供されます。

誰が恩恵を受けるか？

プロジェクトの慣習を尊重し、セッション間でコンテキストを失わないAIアシスタントを求める個人開発者。
再現可能で監査可能なAI生成コード変更を必要とし、繰り返し発生するエンジニアリング知識を再利用可能なスキルとしてキャプチャしたいチーム。
複数のAIコーディングツールを、1つのポリシー駆動型ワークフローで統合したい組織（各ツールのプロンプトを再実装しなくてもよい）。

成熟度と利用可能状況

パッケージ：npmに公開（devcodex）、READMEにバージョンバッジ表示。
ライセンス：AGPL-3.0。
Node要件：>= 18.17.0。
ドキュメント：完全なドキュメント、スタートガイド、例、APIリファレンスは https://devcodex-labs.github.io/devcodex/ にホスト。
状態：積極的にメンテナンス中（READMEに更新手順、ガバナンスレジャー、スキル進化のロードマップが記載）。

クイックスタート（READMEから）

# グローバルインストール
npm install -g devcodex

# プロジェクト初期化（.devcodex/、スタータープロファイルなどを作成）
cd /path/to/your/repo
devcodex init

devcodex status   # 現在の準備状態を確認

初期化後、自然言語でタスクを発行できます。例：

現在のプロジェクトで最も優先すべき3つの問題を分析してください。
範囲と証拠を説明し、ファイルを変更せずに分析のみを行ってください。

DevCodexは以下の通りに動作します：

意図、プロジェクト、安全な読み取り専用範囲を特定。
関連するスキルをロード。
コードに触ることなく、証拠に基づいた分析を生成。

詳細情報の入手先

ドキュメントサイト： https://devcodex-labs.github.io/devcodex/
スタートガイド： https://devcodex-labs.github.io/devcodex/guide/getting-started
例（セッション間再開）： https://devcodex-labs.github.io/devcodex/examples/resume
イシュー追跡： READMEからリンクされたGitHub Issuesページ。

まとめ

DevCodexは、既存のAIコーディングアシスタントに堅牢で意図駆動型のオーケストレーション層を追加する本格的なオープンソースプロジェクトであり、単なるコード生成を、厳密で監査可能なソフトウェアエンジニアリングワークフローに変革しています。