Skip to content

me2resh/apexyard / .claude/skills/orbit

Run the opt-in ORBIT planning lifecycle for one managed project without replacing ApexYard governance.

FileKindSize
SKILL.mdskill md27.5 KB
lib/handoff-preflight.shexecutablescript9.2 KB
lib/record-check.shexecutablescript3.5 KB
lib/records-lint.shexecutablescript14.5 KB
lib/refresh-slice-record.shexecutablescript3.4 KB
lib/resolve-project-repo.shexecutablescript2.1 KB
lib/slice-pr-lint.shscript10.6 KB
lib/status-live.shexecutablescript3.4 KB
lib/warn-criterion-shape.shexecutablescript3.3 KB
lib/warn-uncovered-outcomes.shexecutablescript8.2 KB
tests/_lib-fixtures.shexecutablescript8.0 KB
tests/_lib-slice-fixtures.shscript1.8 KB
tests/smoke.shexecutablescript1.3 KB
tests/test_criterion_shape.shexecutablescript3.5 KB
tests/test_handoff_allows_duplicate_prefix_match.shexecutablescript1.9 KB
tests/test_handoff_preflight_happy_path.shexecutablescript1.9 KB
tests/test_handoff_refusal_cli_absent.shexecutablescript1.6 KB
tests/test_handoff_refusal_duplicate_search_fails.shexecutablescript1.5 KB
tests/test_handoff_refusal_duplicate_search_truncated.shexecutablescript2.1 KB
tests/test_handoff_refusal_duplicate_slice.shexecutablescript1.8 KB
tests/test_handoff_refusal_leak_scrub.shexecutablescript4.8 KB
tests/test_handoff_refusal_missing_option_value.shexecutablescript2.4 KB
tests/test_handoff_refusal_slice_id_double_quote.shexecutablescript2.9 KB
tests/test_handoff_refusal_slice_id_newline.shexecutablescript2.8 KB
tests/test_handoff_refusal_validate_fails.shexecutablescript1.4 KB
tests/test_record_check_blank_line.shexecutablescript4.1 KB
tests/test_record_check_change_only.shexecutablescript3.7 KB
tests/test_records_lint_changed_fields.shexecutablescript4.8 KB
tests/test_records_lint_faults.shexecutablescript6.1 KB
tests/test_records_lint_slice_evidence.shscript1.2 KB
tests/test_records_lint_slice_merge_base_drift.shexecutablescript7.2 KB
tests/test_records_lint_slice_provenance.shscript532 B
tests/test_records_lint_slice_scope.shscript1.8 KB
tests/test_records_lint_slice_warn.shscript324 B
tests/test_records_lint_upstream_skip.shscript3.0 KB
tests/test_refresh_slice_record.shscript3.4 KB
tests/test_resolve_project_repo_registry.shexecutablescript4.2 KB
tests/test_slice_pr_proposal.shscript2.9 KB
tests/test_slice_ticket_workflow.shscript1.4 KB
tests/test_status_live_squash_commit.shscript858 B
tests/test_status_live_writes_nothing.shexecutablescript1.9 KB
tests/test_uncovered_outcomes.shscript11.0 KB

lib/warn-uncovered-outcomes.sh

View on GitHub
#!/usr/bin/env bash
# Print advisory warnings for unfinished Plan outcomes without a slice.
# A missing assessment is not evidence that a criterion was achieved.
# This helper never changes the exit status of an ORBIT CLI operation.

set -u
set -o pipefail
LC_COLLATE=C
export LC_COLLATE

orbit_root=""
plan_file=""
reconciliation_file=""

while [ "$#" -gt 0 ]; do
  case "$1" in
    --orbit-root|--plan|--reconciliation)
      key="$1"
      if [ "$#" -lt 2 ]; then
        echo "ORBIT coverage check skipped: $key needs a value." >&2
        exit 0
      fi
      case "$key" in
        --orbit-root) orbit_root="$2" ;;
        --plan) plan_file="$2" ;;
        --reconciliation) reconciliation_file="$2" ;;
      esac
      shift 2
      ;;
    *)
      echo "ORBIT coverage check skipped: unknown option $1." >&2
      exit 0
      ;;
  esac
done

if [ -z "$orbit_root" ] || [ ! -d "$orbit_root" ]; then
  echo "ORBIT coverage check skipped: record directory is missing." >&2
  exit 0
fi
if ! command -v jq >/dev/null 2>&1; then
  echo "ORBIT coverage check skipped: jq is unavailable." >&2
  exit 0
fi

if [ -n "$plan_file" ]; then
  plans=("$plan_file")
else
  plans=("$orbit_root"/plans/*.json)
fi
if [ ! -f "${plans[0]}" ]; then
  echo "ORBIT coverage check skipped: no Plan record found." >&2
  exit 0
fi

selected_plans=()
selected_ids=()
selected_revisions=()
selected_ties=()
for candidate_plan in "${plans[@]}"; do
  if ! jq -e '(.id | type == "string") and (.revision | type == "number") and
    (.outcomes | type == "array") and (.acceptanceCriteria | type == "array") and
    all(.outcomes[]; .id | type == "string") and
    all(.acceptanceCriteria[]; (.id | type == "string") and (.outcomeId | type == "string"))' \
    "$candidate_plan" >/dev/null 2>&1; then
    echo "ORBIT coverage check skipped: invalid Plan record: $candidate_plan." >&2
    continue
  fi

  candidate_id=$(jq -r '.id' "$candidate_plan")
  candidate_revision=$(jq -r '.revision' "$candidate_plan")
  selected_index=${#selected_plans[@]}
  for ((index=0; index<${#selected_plans[@]}; index++)); do
    if [ "${selected_ids[index]}" = "$candidate_id" ]; then
      selected_index=$index
      break
    fi
  done
  if [ "$selected_index" -eq "${#selected_plans[@]}" ]; then
    selected_plans+=("$candidate_plan")
    selected_ids+=("$candidate_id")
    selected_revisions+=("$candidate_revision")
    selected_ties+=(0)
  elif [ -z "$plan_file" ]; then
    if jq -n -e --argjson candidate "$candidate_revision" \
      --argjson selected "${selected_revisions[selected_index]}" \
      '$candidate >= $selected' >/dev/null; then
      if [ "$candidate_revision" = "${selected_revisions[selected_index]}" ]; then
        selected_ties[selected_index]=1
      else
        selected_ties[selected_index]=0
      fi
      selected_plans[selected_index]="$candidate_plan"
      selected_revisions[selected_index]="$candidate_revision"
    fi
  fi
done

for ((index=0; index<${#selected_plans[@]}; index++)); do
  if [ "${selected_ties[index]}" -eq 1 ]; then
    echo "ORBIT coverage check: tied Plan ${selected_ids[index]} revision ${selected_revisions[index]}; using ${selected_plans[index]} (filename order)." >&2
  fi
done

# Validate each slice once so one bad file cannot suppress another slice.
# Keep one empty element: Bash 3.2 treats an empty array as unset under set -u.
valid_slices=("")
for current_slice in "$orbit_root"/slices/*.json; do
  [ -f "$current_slice" ] || continue
  if jq -e 'type == "object" and (.planId | type == "string") and
    (.basedOn.planRevision | type == "number") and
    ((.contributesTo // [] | type) as $type | $type == "array" or $type == "string")' \
    "$current_slice" >/dev/null 2>&1; then
    valid_slices+=("$current_slice")
  else
    echo "ORBIT coverage check skipped invalid slice record: $current_slice." >&2
  fi
done

# Bash 3.2 treats an empty array as unset under set -u; no valid Plan means
# nothing to check.
[ "${#selected_plans[@]}" -gt 0 ] || exit 0

for current_plan in "${selected_plans[@]}"; do

  if [ -n "$reconciliation_file" ]; then
    current_reconciliation="$reconciliation_file"
  else
    current_reconciliation=""
    latest_seconds=""
    latest_fraction=""
    tied_latest=0
    for candidate in "$orbit_root"/reconciliations/*.json; do
      [ -f "$candidate" ] || continue
      if jq -e --slurpfile plan "$current_plan" \
        '.planId == $plan[0].id and .planRevision == $plan[0].revision' \
        "$candidate" >/dev/null 2>&1; then
        candidate_timestamp=$(jq -r '
          (.reconciledAt // "") as $timestamp |
          if ($timestamp | type) == "string" then
            try ($timestamp | capture(
              "^(?<date>[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2})(?:\\.(?<fraction>[0-9]+))?(?<zone>Z|[+-][0-9]{2}:[0-9]{2})$"
            ) | . as $parts |
              (($parts.date + "Z" | fromdateiso8601) -
              (if $parts.zone == "Z" then 0 else
                ($parts.zone[1:3] | tonumber) * 3600 +
                ($parts.zone[4:6] | tonumber) * 60 |
                if $parts.zone[0:1] == "+" then . else -. end
              end) | tostring) + " " +
              (($parts.fraction // "") | sub("0+$"; ""))
            ) catch ""
          else "" end
        ' "$candidate" 2>/dev/null)
        candidate_seconds=${candidate_timestamp%% *}
        candidate_fraction=${candidate_timestamp#* }
        if [ -z "$current_reconciliation" ] || \
           { [ -n "$candidate_timestamp" ] && \
             { [ -z "$latest_seconds" ] || [ "$candidate_seconds" -gt "$latest_seconds" ] || \
               { [ "$candidate_seconds" -eq "$latest_seconds" ] && \
                 [[ "$candidate_fraction" > "$latest_fraction" ]]; }; }; }; then
          current_reconciliation="$candidate"
          latest_seconds="$candidate_seconds"
          latest_fraction="$candidate_fraction"
          tied_latest=0
        elif [ "$candidate_timestamp" = "$latest_seconds $latest_fraction" ] || \
             { [ -z "$candidate_timestamp" ] && [ -z "$latest_seconds" ]; }; then
          if [ -n "$candidate_timestamp" ]; then
            tied_latest=1
          fi
          # The glob is in filename order; the last equal-time file wins.
          current_reconciliation="$candidate"
        fi
      fi
    done
    if [ "$tied_latest" -eq 1 ]; then
      echo "ORBIT coverage check: tied Reconciliations at $latest_seconds.$latest_fraction for $current_plan; using $current_reconciliation (filename order)." >&2
    fi
  fi
  if [ ! -f "$current_reconciliation" ]; then
    echo "ORBIT coverage check skipped: no Reconciliation for $current_plan." >&2
    continue
  fi
  if ! jq -e --slurpfile plan "$current_plan" \
    '.planId == $plan[0].id and .planRevision == $plan[0].revision and
    (.criterionAssessments | type == "array") and
    all(.criterionAssessments[]; (.criterionId | type == "string") and (.status | type == "string"))' \
    "$current_reconciliation" >/dev/null 2>&1; then
    echo "ORBIT coverage check skipped: invalid Reconciliation: $current_reconciliation." >&2
    continue
  fi

  if ! warnings=$({
    cat "$current_plan" "$current_reconciliation" || exit 1
    for current_slice in "${valid_slices[@]}"; do
      [ -n "$current_slice" ] || continue
      cat "$current_slice" || exit 1
    done
  } | jq -r -s '
    .[0] as $plan | .[1] as $reconciliation | .[2:] as $slices |
    def achieved($id): any($reconciliation.criterionAssessments[];
      .criterionId == $id and .status == "achieved");
    $plan.outcomes[] as $outcome |
    [$plan.acceptanceCriteria[] | select(.outcomeId == $outcome.id)] as $criteria |
    select(any($criteria[]; achieved(.id) | not)) |
    select(any($slices[];
      .planId == $plan.id and .basedOn.planRevision == $plan.revision and
      ((.contributesTo // []) as $refs |
        (if ($refs | type) == "string" then [$refs] else $refs end) as $ids |
        (($ids | index($outcome.id)) != null or
         any($criteria[]; .id as $id | ($ids | index($id)) != null)))) | not) |
    "WARNING: ORBIT outcome \($outcome.id) has unmet criteria and no slice (Plan \($plan.id) revision \($plan.revision))."
  ' 2>/dev/null); then
    echo "ORBIT coverage check skipped: invalid slice record or unreadable records under $orbit_root." >&2
    continue
  fi
  [ -z "$warnings" ] || printf '%s\n' "$warnings" >&2
done

exit 0
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall