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/refresh-slice-record.sh

View on GitHub
#!/usr/bin/env bash
# Refresh provenance after a branch update. Preserve status and scope.
set -euo pipefail
orbit_root=""; base=""; pr=""
while [ $# -gt 0 ]; do
  [ $# -ge 2 ] || exit 20
  case "$1" in
    --orbit-root) orbit_root="$2" ;;
    --base) base="$2" ;;
    --pr) pr="$2" ;;
    *) exit 20 ;;
  esac
  shift 2
done
[ -d "$orbit_root" ] && [ -n "$base" ] && [[ "$pr" =~ ^[0-9]+$ ]] || exit 20
root=$(git -C "$orbit_root" rev-parse --show-toplevel)
root=$(cd "$root" && pwd -P)
orbit_root=$(cd "$orbit_root" && pwd -P)
mb=$(git -C "$root" merge-base "$base" HEAD)
tmp=$(mktemp -d)
cleanup() {
  git -C "$root" worktree remove --force "$tmp/tree" >/dev/null 2>&1 || true
  rm -rf "$tmp"
}
trap cleanup EXIT
records=$( { git -C "$root" diff --name-only "$mb"; git -C "$root" ls-files --others --exclude-standard; } | sort -u)
rec=""
while IFS= read -r f; do
  case "$f" in docs/orbit/reconciliations/*.json)
    [ -f "$root/$f" ] || continue
    if jq -e --arg prefix "Slice PR: #$pr;" 'any(.observations[]?; startswith($prefix))' "$root/$f" >/dev/null; then
      [ -z "$rec" ] || { echo 'Refresh needs one PR Reconciliation.' >&2; exit 19; }
      rec="$root/$f"
    fi ;;
  esac
done <<< "$records"
[ -n "$rec" ] || exit 19
old_snapshot=$(jq -r '.projectSnapshotId' "$rec")
plan=$(jq -r '.planId' "$rec")
project=""
for f in "$orbit_root"/plans/*.json; do
  if jq -e --arg plan "$plan" 'select(.id == $plan)' "$f" >/dev/null; then project=$(jq -r '.project.id' "$f"); fi
done
[ -n "$project" ] || exit 19
# Keep the repository ID of the old snapshot, so slice basedOn keys still match.
repository="$project"
for f in "$orbit_root"/snapshots/*.json; do
  if [ "$(jq -r '.id' "$f")" = "$old_snapshot" ]; then
    repository=$(jq -r --arg d "$project" '.repositories[0].repositoryId // $d' "$f")
  fi
done
git -C "$root" worktree add --detach "$tmp/tree" "$mb" >/dev/null
"${ORBIT_BIN:-orbit}" snapshot --project "$project" --repository "$repository" --path "$tmp/tree" --output "$tmp/snapshot.json"
new_snapshot=$(jq -er '.id' "$tmp/snapshot.json")
cp "$tmp/snapshot.json" "$orbit_root/snapshots/$new_snapshot.json"
jq --arg mb "$mb" --arg pr "$pr" --arg snapshot "$new_snapshot" --arg at "$(date -u +%Y-%m-%dT%H:%M:%S.000Z)" '
  .projectSnapshotId=$snapshot | .reconciledAt=$at | .observations |= map(
    if startswith("Slice PR:") then "Slice PR: #" + $pr + "; dev merge-base " + $mb + "."
    elif test("merge-base"; "i") then gsub("(?<prefix>merge-base )[0-9a-fA-F]{40}"; "\(.prefix)\($mb)"; "i")
    else . end)' "$rec" > "$tmp/rec.json"
cp "$tmp/rec.json" "$rec"
for f in "$orbit_root"/snapshots/*.json; do
  [ "$(jq -r '.id' "$f")" = "$old_snapshot" ] || continue
  [ "$old_snapshot" != "$new_snapshot" ] || continue
  rel=${f#"$root/"}
  git -C "$root" cat-file -e "$mb:$rel" 2>/dev/null || rm "$f"
done
while IFS= read -r f; do
  case "$f" in docs/orbit/slices/*.json)
    [ -f "$root/$f" ] || continue
    git -C "$root" cat-file -e "$mb:$f" 2>/dev/null && continue
    jq --slurpfile rec "$rec" --slurpfile snapshot "$tmp/snapshot.json" --arg plan "$plan" '
      if .planId == $plan then
        .basedOn.planRevision=$rec[0].planRevision | .basedOn.reconciliationId=$rec[0].id
        | .basedOn.repositories=($snapshot[0].repositories | map({key:.repositoryId,value:.commit}) | from_entries)
      else . end' "$root/$f" > "$tmp/slice.json"
    cp "$tmp/slice.json" "$root/$f" ;;
  esac
done <<< "$records"
echo 'Refresh complete. Status and scope are unchanged.'
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