draxarp

Draxarp Intelligence — orbit CLI

エイリアス：dx

orbit draxarp（または orbit dx）コマンドは、LLM 支援開発のための第 2 の脳である Draxarp Development Intelligence モジュールを管理します。9 種類のリソースを扱います。

リソース

リソース	エイリアス	説明
project	proj	インテリジェンスプロジェクト — タスク、仕様、メモリー、ドキュメントをまとめます
task	—	ステータス、優先度、アクティビティログ、引き継ぎ、フォーカス、依存関係を備えた開発タスク
memory	mem	永続的なナレッジ — パターン、バグ、決定事項、ドメインコンテキスト
spec	—	レビューワークフロー（draft → review → approved/rejected）を備えた仕様
doc	—	スラッグベースのアドレス指定と Wiki リンクに対応した技術ドキュメント
sprint	—	ベロシティの追跡と AI によるコンテンツ提案を備えたスプリント計画
capture	cap	コンテキストキャプチャ — git コミット、PR、CI イベント、デプロイ
graph	kg	ナレッジグラフ — ノード、エッジ、影響分析、サブグラフ、経路検索
decompose	—	説明から AI を活用してタスクを分解

トラッキング（orbit tracking 経由）

コマンド	説明
tracking event push	ワークフローイベント（スキルの完了、Jira の遷移、エージェントの呼び出し）を送信します
tracking tkm push	ローカルの TKM データベースからトークン使用量データを送信します

トラッキングの管理と診断（orbit dx tracking、エイリアス trk 経由）

コマンド	説明
tool-versions / tv	期待される最新のツールバージョン（orbit、claude-code、paybook-workflow）を表示／設定します
doctor <user>	判定結果と実行可能なヒントを含む、ユーザーごとのパイプライン診断
pipelines	クラスター全体のパイプラインの健全性と「停止中のユーザー」の一覧
tail	両方のパイプラインの取り込みイベントを末尾から表示します。--follow に対応しています
api-logs	api_logs テーブルを検索します（リクエストログが有効な場合）
hooks	ローカルの ~/.claude/settings.json にある取り込みフックを調べます（オフライン）
hooks install	各 Claude Code の応答後に tracking tkm push を実行する Stop フックを冪等に設定します
hooks uninstall	無関係なフックを保持したまま、tracking tkm push の Stop フックを削除します

# Diagnose why events stopped flowing for a user
orbit dx trk doctor [email protected]

# Cluster health + stuck users
orbit dx trk pipelines

# Real-time stream for a single user
orbit dx trk tail --user [email protected] --follow

# Verify the user's local hooks still reference the ingest endpoints
orbit dx trk hooks

# First-run setup: wire the token-usage Stop hook (idempotent)
orbit dx trk hooks install --bake-profile paybook

hooks install を実行しない場合、トークン使用量イベントが送信されるのは、tracking tkm push が組み込まれたスキル（例：paybook-workflow:commit、paybook-workflow:prime）を明示的に使用したときだけです。その結果、doctor で誤った TOKEN_USAGE_BROKEN 判定が発生します。

クイックリファレンス

プロジェクト

orbit dx proj ls                              # List projects
orbit dx proj view <id-or-slug>               # View project details
orbit dx proj create --name "My Project"      # Create project
orbit dx proj delete <id>                     # Delete project

スラッグはどこでも使えます： すべての --project フラグとリソース ID には、UUID またはスラッグを指定できます。 読みやすさのため、スラッグを使用してください：--project 019cf38c-... の代わりに --project draxarp-portal

タスク — 基本的な CRUD

orbit dx task ls --project <id>               # List tasks for a project
orbit dx task ls --status in_progress         # Filter by status
orbit dx task ls --type epic --project <id>   # List only epics
orbit dx task ls --parent <epic-id>           # List children of an epic
orbit dx task view <id>                       # View task details + last 5 activity logs
orbit dx task create --title "Fix bug" --project <id> --priority high
orbit dx task create --title "Wire frontend" --project <id> --depends-on <blocker-id>
orbit dx task create --title "Auth" --project <id> --type epic      # Create an epic
orbit dx task create --title "JWT" --project <id> --type story --parent <epic-id>  # Story under epic
orbit dx task update <id> --status testing --activity "Running PHPUnit"
orbit dx task assign <id> --assignee claude   # Assign task
orbit dx task start <id>                      # Set status to in_progress
orbit dx task complete <id>                   # Mark completed (with guard checks)
orbit dx task delete <id>                     # Delete task
orbit dx task epic <id>                       # Show epic progress (% complete, children)

タスクの種類：task（デフォルト）、epic、story

タスク — フォーカスと次のタスク（セッション管理）

orbit dx task focus <id>                      # One command: assign + start + set focus
orbit dx task focus <id> --agent claude       # Specify agent (default: claude)
orbit dx task current                         # Show currently focused task
orbit dx task current --agent claude          # For a specific agent
orbit dx task next --project <id>             # Next available task by priority (skips epics & blocked)

タスク — アクティビティログ

orbit dx task log <id> "Implemented API endpoints" --tag progress
orbit dx task log <id> "Blocked on DB schema" --tag blocker --agent claude
orbit dx task log <id> "Chose approach A over B" --tag decision
orbit dx task logs <id>                       # List all logs (newest first)
orbit dx task logs <id> --tag blocker         # Filter by tag
orbit dx task logs <id> --limit 10            # Limit results
orbit dx task logs <id> -o json               # JSON output

アクティビティログのタグ：progress、blocker、decision、hypothesis、tried、result、handoff、note

タスク — 構造化された引き継ぎとコンテキスト

# Record a handoff (session continuity)
orbit dx task handoff <id> \
  --done "Implemented X" --done "Added tests for Y" \
  --remaining "Wire up frontend" --remaining "Add error handling" \
  --decision "Used approach A because of constraint B" \
  --uncertain "Not sure if Z is the right abstraction" \
  --files "backend/Services/Foo.php,frontend/Show.tsx" \
  --agent claude

# Get AI-optimized context for resuming work
orbit dx task context <id>                    # Human-readable
orbit dx task context <id> -o json            # Structured JSON

タスク — 依存関係

orbit dx task dep <id> --on <blocking-task-id>    # Add dependency
orbit dx task deps <id>                            # Show dependency tree (blocks/blocked-by)
orbit dx task deps <id> -o json                    # JSON output

タスクのステータス：pending、in_progress、testing、completed、blocked、cancelled タスクの優先度：low、medium、high、critical

メモリー

orbit dx mem ls --project <id>                # List memories
orbit dx mem ls --type architecture           # Filter by type
orbit dx mem view <id>                        # View memory content
orbit dx mem create --title "Pattern: Repo" --content "..." --project <id> --type patterns
orbit dx mem archive <id>                     # Archive memory

メモリーの種類：architecture、patterns、bugs、domain、decisions、preferences、context

仕様

orbit dx spec ls --project <id>               # List specs
orbit dx spec view <id>                       # View spec content
orbit dx spec create --title "Auth Spec" --content "..." --project <id>
orbit dx spec submit <id>                     # Submit for review
orbit dx spec approve <id>                    # Approve spec
orbit dx spec reject <id>                     # Reject spec
orbit dx spec delete <id>                     # Delete spec

仕様のステータス：draft、in_review、approved、rejected

ドキュメント

orbit dx doc ls                               # List all docs
orbit dx doc ls --category architecture       # Filter by category
orbit dx doc toc                              # Table of contents (no content)
orbit dx doc view <id>                        # View doc by ID
orbit dx doc view architecture/overview       # View by slug (auto-detected)
orbit dx doc create --title "API Guide" --category api --slug api/guide
orbit dx doc sync docs.json                   # Batch sync from JSON file
orbit dx doc publish <id>                     # Publish draft doc
orbit dx doc archive <id>                     # Archive doc
orbit dx doc delete <id>                      # Delete doc

ドキュメントのカテゴリ：architecture、components、flows、security、api、infrastructure、general ドキュメントのステータス：draft、published、archived

スラッグの自動検出： doc view は引数が UUID かスラッグかを自動的に検出するため、--slug フラグは不要です（明示的に指定する場合は引き続き使用できます）。

一括同期： doc sync は、ドキュメントオブジェクトの配列を含む JSON ファイルを受け付けます：

[{"slug": "api/guide", "title": "API Guide", "content": "...", "category": "api"}]

既存のドキュメント（スラッグで照合）は更新され、新しいスラッグは作成されます。

スプリント

orbit dx sprint ls --project <id>             # List sprints
orbit dx sprint view <id>                     # View sprint details
orbit dx sprint create --project <id> --name "Sprint 1" --starts-at 2026-03-16 --ends-at 2026-03-30
orbit dx sprint create --project <id> --name "Sprint 2" --starts-at 2026-03-30 --ends-at 2026-04-13 --goal "Ship auth" --velocity-target 20
orbit dx sprint start <id>                    # Start a sprint
orbit dx sprint complete <id>                 # Complete a sprint
orbit dx sprint suggest <id>                  # AI-powered sprint content suggestions
orbit dx sprint velocity --project <id>       # Velocity history (last 5 sprints)
orbit dx sprint velocity --project <id> --count 10  # More history

Context Captures

orbit dx capture ls --project <id>            # List captures for a project
orbit dx capture view <id>                    # View capture details + payload
orbit dx capture webhook --project <id> --source git_commit --payload '{"sha":"abc","message":"fix"}'
orbit dx capture persist <id>                 # Persist capture as a memory

コンテキストソース：git_commit、git_pr、ci_pipeline、deployment、code_review、manual

Knowledge Graph

# Nodes
orbit dx graph nodes --project <id>           # List nodes
orbit dx graph nodes --type module            # Filter by type
orbit dx graph node <id>                      # View node details
orbit dx graph create-node --project <id> --type module --name "AuthService"
orbit dx graph delete-node <id>               # Delete a node

# Edges
orbit dx graph create-edge --from <id> --to <id> --relationship depends_on
orbit dx graph delete-edge <id>               # Delete an edge

# Analysis
orbit dx graph impact <node-id>               # Impact analysis (depth 3)
orbit dx graph impact <node-id> --depth 5     # Deeper analysis
orbit dx graph subgraph <node-id>             # Local subgraph (depth 2)
orbit dx graph paths --from <id> --to <id>    # Find paths between nodes
orbit dx graph paths --from <id> --to <id> --max-depth 8

Task Decomposition

orbit dx decompose create --project <id> --description "Build user auth with JWT"
orbit dx decompose create --project <id> --description "..." --spec <spec-id>  # With spec context
orbit dx decompose ls --project <id>          # List decompositions
orbit dx decompose view <id>                  # View decomposition + options
orbit dx decompose accept <id> --indexes 0,1,2  # Accept and create tasks from selected options
orbit dx decompose reject <id>                # Reject decomposition

Typical Agent Workflow

# 1. Orient
orbit dx context -p draxarp --project <id>

# 2. Pick up or create task
orbit dx task next --project <id> -p draxarp     # Or create new
orbit dx task focus <task-id> -p draxarp          # One command: assign + start + focus

# 3. Work (hooks auto-log progress)
# ... edit files, run tests ...

# 4. Log key decisions/blockers manually
orbit dx task log <id> "Chose X because Y" --tag decision -p draxarp
orbit dx task log <id> "Blocked on Z" --tag blocker -p draxarp

# 5. Handoff before session ends
orbit dx task handoff <id> --done "API done" --remaining "Frontend" --agent claude -p draxarp

# 6. Complete
orbit dx task complete <id> -p draxarp

# 7. Next session picks up with context
orbit dx task context <id> -p draxarp

Configuration

~/.config/orbit/config.yaml に追加します：

profiles:
  - name: my-project
    services:
      - name: draxarp
        type: draxarp
        base_url: https://your-draxarp-instance.com
        auth:
          method: token
          token: "your-api-token"
        headers:                              # Optional custom headers
          X-Tenant: my-tenant-slug            # Required for tenant-scoped access

マルチテナント環境では、X-Tenant ヘッダーによって、すべての API レスポンスがそのテナントのワークスペースとプロジェクトに限定されます。トークンには、プラットフォーム管理者（Sanctum）トークンとテナントユーザー（PAT）トークンのどちらも使用できます。

Profile Selection

-p <profile> を使用して、特定のプロファイルを指定します：

orbit dx proj ls -p draxarp
orbit dx task ls -p draxarp --project <id>

JSON Output

すべてのコマンドで、機械可読形式の出力に -o json を使用できます：

orbit dx proj ls -o json
orbit dx mem view <id> -o json
orbit dx doc toc -o json
orbit dx task context <id> -o json
orbit dx sprint ls --project <id> -o json
orbit dx graph nodes --project <id> -o json

API Details

orbit CLI は、次の Draxarp API と通信します：

• インテリジェンスリソース：/api/admin/v1/intelligence/*（tasks、memories、specs、docs、sprints、graph、captures、decompose）
• プラットフォームリソース：/api/admin/v1/*（projects、workspaces）
• 認証：Authorization: Bearer <token>（platform-api または tenant-api Sanctum ガード）
• テナントのスコープ指定：X-Tenant: <slug> ヘッダー（テナントに紐づくトークンでは必須）
• ページネーション：{ "success": true, "data": [...], "meta": { "current_page", "last_page", "per_page", "total" } }
• 単一リソース：{ "success": true, "data": { ... } }