Vinix24/vnx-orchestration / .claude/skills/t0-orchestrator
t0-orchestrator
VerifiedMaster orchestration for the VNX multi-terminal system. Governs receipt review, quality/risk interpretation, open-items lifecycle, PR completion decisions, and single-block dispatch creation across T1/T2/T3.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.7 KB |
| scripts/dispatch_guard.shexecutable | script | 15.1 KB |
| scripts/intelligence.shexecutable | script | 10.1 KB |
scripts/intelligence.sh
View on GitHub#!/bin/bash
# Intelligence queries for T0 orchestration
# Live state monitoring and orchestration pattern queries
# Bind to the repo this script ships in, not the caller's cwd.
_INTEL_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
_INTEL_REPO_ROOT="$(git -C "$_INTEL_DIR" rev-parse --show-toplevel 2>/dev/null || echo "$(cd "$_INTEL_DIR/../../../.." && pwd)")"
# Install roots in the order a consumer finds VNX: the repo itself, the install named by
# VNX_HOME, the central install. The same order dispatch_guard.sh uses for the CLI.
_intel_roots() {
printf '%s\n' "$_INTEL_REPO_ROOT"
[ -z "${VNX_HOME:-}" ] || printf '%s\n' "$VNX_HOME"
[ -z "${HOME:-}" ] || printf '%s\n' "$HOME/.vnx-system/current"
}
# First install root that holds the relative path $1 (a file or an executable).
_intel_locate() {
local root
while IFS= read -r root; do
if [ -e "$root/$1" ]; then
printf '%s\n' "$root/$1"
return 0
fi
done < <(_intel_roots)
return 1
}
# Central state/dispatch dirs (ADR-026). An explicit VNX_STATE_DIR / VNX_DISPATCH_DIR
# wins and is never overwritten. Otherwise the central resolver (vnx_paths.py) runs with
# the repo root as cwd and its KEY=VALUE lines are parsed, never eval'd. Unresolvable
# leaves both empty; the functions that need them refuse (_require_dirs).
_intel_resolver() {
_intel_locate "scripts/lib/vnx_paths.py"
}
_intel_resolve_dirs() {
local resolver line
STATE_DIR="${VNX_STATE_DIR:-}"
DISPATCH_DIR="${VNX_DISPATCH_DIR:-}"
if [ -n "$STATE_DIR" ] && [ -n "$DISPATCH_DIR" ]; then
return 0
fi
resolver="$(_intel_resolver)" || return 0
while IFS= read -r line; do
case "$line" in
VNX_STATE_DIR=*) [ -n "$STATE_DIR" ] || STATE_DIR="${line#VNX_STATE_DIR=}" ;;
VNX_DISPATCH_DIR=*) [ -n "$DISPATCH_DIR" ] || DISPATCH_DIR="${line#VNX_DISPATCH_DIR=}" ;;
esac
done < <(cd "$_INTEL_REPO_ROOT" && VNX_PROJECT_ROOT="$_INTEL_REPO_ROOT" python3 "$resolver" 2>/dev/null || true)
return 0
}
_intel_resolve_dirs
_require_state_dir() {
[ -n "$STATE_DIR" ] || { echo "Error: VNX state dir unresolved"; return 1; }
}
_require_dispatch_dir() {
[ -n "$DISPATCH_DIR" ] || { echo "Error: VNX state dir unresolved"; return 1; }
}
# ============================================
# LIVE STATE QUERIES
# ============================================
# Resolve the vnx CLI, first executable wins, the same order dispatch_guard.sh uses:
# the repo's own bin/vnx, the install named by VNX_HOME, an explicit VNX_BIN, the
# project-pin shim ~/.vnx-system/bin/vnx (honours .vnx-version), the central install
# ~/.vnx-system/current, then `vnx` on PATH. A non-executable file is skipped.
_intel_vnx_bin() {
local candidate
for candidate in \
"$_INTEL_REPO_ROOT/bin/vnx" \
"${VNX_HOME:+$VNX_HOME/bin/vnx}" \
"${VNX_BIN:-}" \
"${HOME:+$HOME/.vnx-system/bin/vnx}" \
"${HOME:+$HOME/.vnx-system/current/bin/vnx}"; do
if [ -n "$candidate" ] && [ -x "$candidate" ]; then
printf '%s' "$candidate"
return 0
fi
done
command -v vnx || true
}
# Runtime state: the same `vnx status --json --live` the dispatch guard reads, run
# bound to the repo root, so live_work and queues are measured at the call (OI-2268).
# A CLI older than the live measurement refuses --live; its plain answer is the
# t0_state.json snapshot, and the displays below say so. t0_brief.json is a
# presentation cache; nothing here reads it.
_runtime_status() {
local bin out
bin="$(_intel_vnx_bin)"
[ -n "$bin" ] || return 1
if out="$(cd "$_INTEL_REPO_ROOT" && VNX_PROJECT_ROOT="$_INTEL_REPO_ROOT" "$bin" status --json --live 2>/dev/null)"; then
printf '%s\n' "$out"
return 0
fi
(cd "$_INTEL_REPO_ROOT" && VNX_PROJECT_ROOT="$_INTEL_REPO_ROOT" "$bin" status --json 2>/dev/null)
}
# jq: a note for an answer whose live_work and queues are not measured live.
_INTEL_SNAPSHOT_NOTE='if (.live_measurement.mode? // "") == "live" then empty else "snapshot: cli gave no live measurement" end'
# Run a VNX python script (scripts/<name>.py) from the first install that has it, with the
# repo root as cwd so the script resolves the project the same way the guard does.
_intel_py() {
local script
script="$(_intel_locate "scripts/$1")" || { echo "Error: scripts/$1 not found in the repo or a VNX install"; return 1; }
shift
(cd "$_INTEL_REPO_ROOT" && VNX_PROJECT_ROOT="$_INTEL_REPO_ROOT" python3 "$script" "$@")
}
# Dispatches in the air (live, starting, stale, unmeasured). `vnx status --json`
# carries no per-terminal rows any more, so this replaces check_terminals.
check_live_work() {
local status
status="$(_runtime_status)" || { echo "Error: vnx status --json unavailable"; return 1; }
jq -r '((.live_work // {}) as $w | ("live", "starting", "stale", "unmeasured") as $b | ($w[$b] // [])[] | "\($b) \(.dispatch_id // "?") state=\(.state // "?") age=\(.age_seconds // 0)s"), ('"$_INTEL_SNAPSHOT_NOTE"')' <<<"$status"
}
# Check queue status. A count the answer does not carry is "unmeasured", as the
# guard reads it, never 0.
check_queue() {
local status
status="$(_runtime_status)" || { echo "Error: vnx status --json unavailable"; return 1; }
jq -r 'def count($n): if ($n | type) == "number" then $n else "unmeasured" end;
(.queues // {}) as $q
| "pending=\(count($q.pending_count)) conflicts=\(count($q.conflict_count))"
+ ([('"$_INTEL_SNAPSHOT_NOTE"')] | map(" (" + . + ")") | add // "")' <<<"$status"
}
# Check open items digest (deliverables)
check_open_items() {
_intel_py open_items_manager.py digest 2>/dev/null || echo "No open items data"
}
# Get orchestration recommendations
check_recommendations() {
_require_state_dir || return 1
if [ -f "$STATE_DIR/t0_recommendations.json" ]; then
cat "$STATE_DIR/t0_recommendations.json" | jq -r '.recommendations[] | "[\(.priority)] \(.action): \(.reason)"'
else
echo "No recommendations available"
fi
}
# Get recent receipts
recent_receipts() {
_require_state_dir || return 1
if [ -f "$STATE_DIR/t0_receipts.ndjson" ]; then
tail -n 5 "$STATE_DIR/t0_receipts.ndjson" | jq -r '"[\(.timestamp)] \(.track) \(.status): \(.dispatch_id // "unknown")"'
else
echo "No recent receipts"
fi
}
# Check active dispatches
active_dispatches() {
_require_dispatch_dir || return 1
ls -la "$DISPATCH_DIR/active/" 2>/dev/null | grep -E "\.dispatch$" | awk '{print $9}' | sed 's/\.dispatch$//'
}
# Check queued dispatches
queued_dispatches() {
_require_dispatch_dir || return 1
ls -la "$DISPATCH_DIR/queue/" 2>/dev/null | grep -E "\.dispatch$" | awk '{print $9}' | sed 's/\.dispatch$//'
}
# ============================================
# PATTERN QUERIES
# ============================================
# Orchestration patterns
orchestration_patterns() {
_intel_py gather_intelligence.py patterns "orchestration $1"
}
# Agent selection patterns
agent_patterns() {
_intel_py gather_intelligence.py patterns "agent selection $1"
}
# Open items / deliverable patterns
deliverable_patterns() {
_intel_py gather_intelligence.py patterns "open items deliverables $1"
}
# Mode selection patterns
mode_patterns() {
_intel_py gather_intelligence.py patterns "mode selection $1"
}
# Track selection patterns
track_patterns() {
_intel_py gather_intelligence.py patterns "track selection $1"
}
# ============================================
# TAG QUERIES
# ============================================
# Tag-based search
tags() {
_intel_py gather_intelligence.py tags "$1"
}
# Orchestration tags
orchestration_tags() {
_intel_py gather_intelligence.py tags "orchestration dispatch management"
}
# ============================================
# KEYWORD QUERIES
# ============================================
# Keyword search
keywords() {
_intel_py gather_intelligence.py keywords "$1"
}
# ============================================
# PREVENTION RULES
# ============================================
# Check prevention rules
prevention() {
_intel_py gather_intelligence.py prevention
}
# ============================================
# DECISION HELPERS
# ============================================
# Should we dispatch? Delegates to dispatch_guard.sh: 0 -> YES, 2 -> NO, else UNKNOWN.
can_dispatch() {
local out rc=0 reason
out="$(bash "$_INTEL_DIR/dispatch_guard.sh" 2>&1)" || rc=$?
reason="$(printf '%s\n' "$out" | head -n 1)"
case "$rc" in
0) echo "YES - ${reason#GO: }" ;;
2) echo "NO - ${reason#WAIT: }" ;;
*) echo "UNKNOWN - ${reason:-dispatch guard gave no answer}" ;;
esac
}
# Get dispatch decision
dispatch_decision() {
echo "=== Orchestration Decision ==="
echo "Live work: $(check_live_work | tr '\n' ';')"
echo "Queue: $(check_queue)"
echo "Open Items: $(check_open_items)"
echo "Can Dispatch: $(can_dispatch)"
echo "================================"
}
# ============================================
# USAGE HELP
# ============================================
echo "T0 Orchestration Intelligence Queries"
echo "======================================"
echo ""
echo "Live State Monitoring:"
echo " check_live_work - Show dispatches in the air"
echo " check_queue - Show queue status"
echo " check_open_items - Show open items digest (deliverables)"
echo " recent_receipts - Show last 5 receipts"
echo " active_dispatches - List active dispatches"
echo " queued_dispatches - List queued dispatches"
echo ""
echo "Pattern Queries:"
echo " orchestration_patterns 'dispatch timing'"
echo " agent_patterns 'debugging specialist'"
echo " deliverable_patterns 'quality gate tracking'"
echo " mode_patterns 'when to use thinking mode'"
echo " track_patterns 'parallel execution'"
echo ""
echo "Decision Helpers:"
echo " can_dispatch - Check if safe to dispatch"
echo " dispatch_decision - Full decision summary"
echo " check_recommendations - Get AI recommendations"
echo ""
echo "Prevention & Tags:"
echo " prevention - Show anti-patterns to avoid"
echo " orchestration_tags - Search orchestration patterns by tags"Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |