calibrate

echo "=== calibration preprocessing ==="
DOCS_DIR="$(cd "${CLAUDE_SKILL_DIR}/../../docs" 2>/dev/null && pwd || echo UNKNOWN)"
BUNDLES_DIR="$(cd "${CLAUDE_SKILL_DIR}/.." 2>/dev/null && pwd || echo UNKNOWN)"
echo "DOCS_DIR=$DOCS_DIR"
echo "BUNDLES_DIR=$BUNDLES_DIR"
echo "PLUGIN_ROOT=${CLAUDE_PLUGIN_ROOT:-unknown}"
echo "PROJECT_DIR=${CLAUDE_PROJECT_DIR:-$(pwd)}"
echo "CWD=$(pwd)"
echo "TIMESTAMP=$(date +%Y%m%d-%H%M%S)"
echo "NOW_ISO=$(date -u +%Y-%m-%dT%H:%M:%SZ)"
echo "GIT_HEAD=$(git rev-parse HEAD 2>/dev/null || echo not-a-git-repo)"
echo "GIT_DIRTY_FILES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')"
echo "GITIGNORE_HAS_CALIBRATION=$(grep -qs 'calibration' .gitignore && echo yes || echo no)"
echo "--- shipped per-feature bundles ---"
if [ "$BUNDLES_DIR" != "UNKNOWN" ]; then
  for b in "$BUNDLES_DIR"/calibrate-*/; do
    [ -d "$b" ] && echo "BUNDLE=${b%/}"
  done | sort
else
  echo "(no bundles dir resolvable — subagents will fall back to docs-only rubric)"
fi
echo "--- recent calibration runs (newest first) ---"
ls -1dt .claude/calibration/*/ 2>/dev/null | head -5 || echo "(none)"
if [ -f .claude/calibration/current ]; then echo "CURRENT_RUN=$(cat .claude/calibration/current)"; else echo "CURRENT_RUN=(none)"; fi
# Cost mode: when $ARGUMENTS contains the standalone token `cost`, precompute the
# calibrate-general lint so the orchestrator's cost-mode branch (§ 0b) can format and print it
# without needing Bash itself.
if echo "$ARGUMENTS" | grep -qiE '(^|[[:space:]])cost([[:space:]]|$)'; then
  COST_LINT="$BUNDLES_DIR/calibrate-general/scripts/lint.sh"
  if [ "$BUNDLES_DIR" != "UNKNOWN" ] && { [ -x "$COST_LINT" ] || [ -f "$COST_LINT" ]; }; then
    echo "--- cost-mode lint (calibrate-general/scripts/lint.sh) ---"
    bash "$COST_LINT" "${CLAUDE_PROJECT_DIR:-$(pwd)}" 2>&1 || echo "COST_LINT_FAILED=$?"
    echo "--- end cost-mode lint ---"
  else
    echo "COST_LINT_NOT_FOUND=$COST_LINT"
  fi
fi
# Plugin filter: a CLI `--plugins <val>` flag wins; else `.claude/calibration/config.json`.
# Normalised by the shared resolver into the canonical CALIBRATION_PLUGIN_FILTER spec the bundles'
# enumerate.sh read (include:a,b | exclude:a,b | scope:global|local). Empty => audit everything.
PLUGIN_FILTER=""
if [ "$BUNDLES_DIR" != "UNKNOWN" ] && [ -f "$BUNDLES_DIR/lib/resolve-plugin-filter.sh" ]; then
  PLUGIN_FILTER="$(bash "$BUNDLES_DIR/lib/resolve-plugin-filter.sh" "$ARGUMENTS" "${CLAUDE_PROJECT_DIR:-$(pwd)}" 2>/dev/null || true)"
fi
echo "PLUGIN_FILTER=$PLUGIN_FILTER"
echo "=== end preprocessing ==="

Calibrate — orchestrator

You are the calibration orchestrator. You run on Opus and you are read-only with respect to all Claude Code configuration and repository source — you NEVER use Edit, you do NOT modify any config file, and you only use Write to create the final report inside the run folder under .claude/calibration/. Every change to the user's setup is made by the calibration-calibrator subagent, after the user approves the plan. Your job: chain three subagents, keep the user oriented with short messages, produce the final report.

The invocation arguments are: $ARGUMENTS

Use the values from the preprocessing block above: DOCS_DIR (the human-readable doc-set, used as a fallback rubric), BUNDLES_DIR (the parent dir of all calibrate-<feature>/ bundles; the primary toolkit the subagents read — each bundle has SKILL.md, reference.md, templates/, examples/, scripts/), PROJECT_DIR, TIMESTAMP (for a new run folder), NOW_ISO, GIT_HEAD, GIT_DIRTY_FILES, CURRENT_RUN. Pass both DOCS_DIR and BUNDLES_DIR to every subagent in the spawn prompt — they need them to dispatch per-feature work to the right bundle. If BUNDLES_DIR is UNKNOWN or empty, tell subagents to fall back to general Claude Code best practice and the docs/features/*.md rubric directly.