AgentKit47-Qoder は何をしますか？
AgentKit47（CLI: ak47）は Qoder プラットフォーム向けの AI エンジニアリングスキャフォールドです。技術スタックを自動スキャンし、Agent/Skill/Hook/Rule の全構成を生成します。OpenSpec 仕様駆動のワークフロー（propose→design→task→archive）と3段階の変更パラダイム（L1/L2/L3）を内蔵し、.ak47/ フレームワーク層、.qoder/ プラットフォーム層、templates/ テンプレート層の3つのディレクトリで分離管理します。「要件はコーディングより先に、憶測禁止、過剰設計禁止」の行動規範を強制し、Git Worktree による隔離開発と知識資産の段階的な蓄積をサポートします。
概要
AgentKit47 は、AI エージェントが正確にプロジェクトを理解し、自律的にタスクを実行できるようにするためのプロジェクト構造とワークフローを提供します。以下のコンポーネントで構成されます。
- .ak47/: フレームワーク層。コアロジックと設定を格納。
- .qoder/: プラットフォーム層。Qoder プラットフォーム固有の設定と統合。
- templates/: テンプレート層。再利用可能なテンプレートとボイラープレート。
ワークフロー
AgentKit47 は OpenSpec 仕様に基づく以下のワークフローを強制します。
- Propose - 要件の提案と合意
- Design - アーキテクチャと設計の文書化
- Task - 実行可能なタスクへの分解
- Archive - 完了後の知識資産のアーカイブ
変更パラダイム
変更はその影響範囲に応じて3つのレベルに分類されます。
- L1: ローカルな変更。単一の関数やファイル内での修正。
- L2: モジュールレベルの変更。複数のファイルにまたがるが、モジュールの境界内に収まる。
- L3: システム全体に影響する変更。アーキテクチャや外部インターフェースの変更を含む。
行動規範
AgentKit47 は以下の行動規範を強制します。
- 要件はコーディングより先に定義する
- 憶測による実装を禁止する
- 過剰設計を禁止する
Git Worktree サポート
AgentKit47 は Git Worktree を使用した隔離開発をサポートします。各機能やタスクは独立したワーキングツリーで開発され、変更の競合を防止します。
知識資産の蓄積
完了したプロジェクトの知識資産は .ak47/ フレームワーク層にアーカイブされ、将来のプロジェクトで再利用可能になります。
利用例
# 新しいプロジェクトを初期化
ak47 init
# 現在の技術スタックをスキャン
ak47 scan
# 新しい機能を提案
ak47 propose "ユーザー認証機能"
# タスクを作成
ak47 task create "ログインフォームの実装" --level L2
注意事項
ak47コマンドは qoder CLI の一部として提供されます。- すべての設定ファイルは YAML 形式で記述されます。
- プラットフォーム固有の設定は
.qoder/ディレクトリに配置します。