Env Adoption

Environment Adoption — Centralized Capability Registry

Overview

Single source of truth for tool detection, version tracking, and capability routing. Two-tier state model: persistent inventory (what is installed) and volatile session state (runtime connectivity, auth). Replaces scattered inline probing across forge, codex-orchestration, and other skills.

When to Use

• Session start — probe environment, report tier
• Before delegating to Codex/agy — check tools.codex.installed / capabilities.agy_analyst
• When a skill needs to branch on tool availability — use get subcommand
• After installing a new tool — run probe.sh check --force to update inventory

When NOT to Use

• Do not re-probe on every skill invocation (read the manifest instead)
• Do not use for Codex session management (use codex-orchestration)

Operations

check flags

get paths

# Inventory (persistent)
probe.sh get tools.codex.installed    # true/false
probe.sh get tools.codex.version      # "0.120.0" or null
probe.sh get tier                     # 0, 1, or 2
probe.sh get tier_label               # minimal, standard, full

# Session state (volatile)
probe.sh get capabilities.triple_model     # true/false
probe.sh get capabilities.codex_challenger # true/false
probe.sh get capabilities.agy_analyst      # true/false

# Orchestration capabilities (S055 — workflow-adoption keystone)
probe.sh get capabilities.workflow_tool    # true/false  (Workflow tool surface, Q2)
probe.sh get capabilities.native_teams     # true/false  (experimental, env-gated)
probe.sh get capabilities.agent_spawn      # true/false  (Agent/subagent surface)
probe.sh get harness.workflow_tool         # true/false  (Q1 host capability, inventory)

Orchestration decision rule (restate verbatim in every consumer): can_orchestrate = capabilities.<surface> AND context == main-loop. capabilities.* alone NEVER authorizes orchestration — session files are shared with subagents (children inherit CLAUDE_CODE_SESSION_ID), so the probe.sh context conjunct is mandatory. probe.sh get capabilities.<name> is the ONLY capability read API — no raw jq on inventory.json, no inline claude --version. See references/context-detection.md.

Tier Model

State Files

Integration

Other skills consume the manifest instead of inline probing:

# Shell: via get subcommand
CODEX_OK=$(bash ~/.claude/skills/env-adoption/scripts/probe.sh get tools.codex.installed)

# Shell: via direct jq (faster, for hot paths)
CODEX_OK=$(jq -r '.tools.codex.installed' ~/.claude/state/inventory.json 2>/dev/null || echo false)

# Skill YAML/markdown: read ~/.claude/state/inventory.json
# Session routing: read $XDG_RUNTIME_DIR/env-adoption/session-*.json

See references/integration.md for full patterns.

Anti-Patterns