Skip to content

sno-ai/sno-station-skills / skills/T-delegation-and-work-orders/pl/skills/pl

MANUAL-ONLY — load solely when the human owner types `/pl`, uses `$pl`, or asks you to act as the Project Lead (PL). Supervise one project lane and its executor agents. A charter or dispatch means: you are an EXECUTOR, not the PL.

FileKindSize
SKILL.mdskill md61.7 KB
references/callsigns.txtmarkdown384 B
references/decision-rights.mdmarkdown4.8 KB
references/dispatch-template.mdmarkdown38.2 KB
references/pocket-card.mdmarkdown1.9 KB
references/progress-reporting-hooks.mdmarkdown2.3 KB
references/todo-template.mdmarkdown6.9 KB
scripts/agent-cli-help.tother1.2 KB
scripts/attempt-gate.shexecutablescript3.6 KB
scripts/attempt-gate.tother4.6 KB
scripts/callsign-transfer-e2e.shexecutablescript7.9 KB
scripts/callsign-worktree.tother1.7 KB
scripts/callsign.shexecutablescript15.2 KB
scripts/convergence-watch.shexecutablescript8.6 KB
scripts/core-structure.tother5.7 KB
scripts/docker-env-doctor.shexecutablescript19.4 KB
scripts/exec-sentinel.shexecutablescript5.8 KB
scripts/exec-sentinel.tother2.4 KB
scripts/exec-state.shexecutablescript20.8 KB
scripts/exec-state.tother23.1 KB
scripts/exec-trust.shscript5.3 KB
scripts/exec-trust.tother6.4 KB
scripts/executor-wall.shexecutablescript6.8 KB
scripts/executor-wall.texecutablescript9.5 KB
scripts/fence-check.shexecutablescript4.4 KB
scripts/general-env-doctor.shexecutablescript14.0 KB
scripts/general-env-doctor.tother5.8 KB
scripts/gpu-watch.shexecutablescript4.5 KB
scripts/gpu-watch.tother1.5 KB
scripts/lane-open.shexecutablescript4.1 KB
scripts/lane-open.tother3.9 KB
scripts/lane-resolve.shexecutablescript5.0 KB
scripts/lane-resolve.texecutablescript7.0 KB
scripts/log-watch.shexecutablescript10.9 KB
scripts/log-watch.texecutablescript6.8 KB
scripts/on-station-proof.texecutablescript1.9 KB
scripts/portable-paths.tother1.5 KB
scripts/roster-git.tother4.1 KB
scripts/roster-reach.tother2.8 KB
scripts/roster.shexecutablescript19.9 KB
scripts/script-running.shscript5.8 KB
scripts/script-running.tother3.7 KB
scripts/selftest/run-selftest.shexecutablescript1.2 KB
scripts/spawn-exec-generation-e2e.shexecutablescript1.9 KB
scripts/spawn-exec-help.tother2.8 KB
scripts/spawn-exec-interactive-e2e.shscript13.2 KB
scripts/spawn-exec-lane-resolve.tother3.5 KB
scripts/spawn-exec-mission-state-e2e.shscript1.8 KB
scripts/spawn-exec-on-station-e2e.shexecutablescript2.2 KB
scripts/spawn-exec-operate.tother9.4 KB
scripts/spawn-exec.shexecutablescript36.8 KB
scripts/todo-close-evidence.tother1.2 KB
scripts/todo.shexecutablescript35.5 KB
scripts/todo.tother27.9 KB

scripts/roster-git.t

View on GitHub
#!/usr/bin/env bash
# roster.sh --git: the repo half of the wake sweep.
#
# The output must be stable so consecutive sweeps can be diffed when a repository
# stops moving.
# The remaining rows keep one failing repository from aborting the roster.
set -Eeuo pipefail

ROSTER="${ROSTER:-$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)/roster.sh}"

root="$(mktemp -d)"
trap 'rm -rf -- "$root"' EXIT
# roster.sh reads ~/.local/state; keep the test off the real one.
export HOME="$root/home"
mkdir -p "$HOME"

tests=0
failures=0

check() { # $1 label, rest: command
  local label="$1"; shift
  tests=$((tests + 1))
  if "$@"; then
    printf 'ok %d - %s\n' "$tests" "$label"
  else
    printf 'not ok %d - %s\n' "$tests" "$label"
    failures=$((failures + 1))
  fi
}

# a repo with a watch config, one commit, one dirty src file, one dirty protected file
repo="$root/withconf"
mkdir -p "$repo/src" "$repo/.pl"
git init -q "$repo"
printf 'src: src\nprotected: BASELINE\n' > "$repo/.pl/watch.paths"
printf 'v1\n' > "$repo/BASELINE"
git -C "$repo" add -A
git -C "$repo" -c user.email=t@t -c user.name=t commit -q -m "seed BASELINE"
printf 'work\n' > "$repo/src/a.txt"
printf 'v2\n' > "$repo/BASELINE"

block() { bash "$ROSTER" --git "$1" 2>/dev/null | sed -n '/^=== GIT/,$p'; }

# 1. byte-stable for unchanged repo state — the whole reason this exists
same_twice() {
  local a b
  a="$(block "$repo")"; b="$(block "$repo")"
  [[ "$a" == "$b" && -n "$a" ]]
}
check "identical output across two runs (diffable sweeps)" same_twice

# 1b. --git-only is what a PL actually diffs: the fleet table carries relative
#     ages that change every run, so leaving it in makes every sweep differ and
#     buries the repo block the diff exists to expose.
git_only_is_whole_stdout() {
  local a b
  a="$(bash "$ROSTER" --git-only --git "$repo" 2>/dev/null)"
  b="$(bash "$ROSTER" --git-only --git "$repo" 2>/dev/null)"
  [[ -n "$a" && "$a" == "$b" ]] || return 1
  [[ "$a" == "=== GIT "* ]] || return 1          # no fleet table above it
  [[ "$a" != *"last heartbeat"* ]]               # no heartbeat ages inside it
}
check "--git-only: stdout is the git blocks alone, identical twice" git_only_is_whole_stdout

# 2. src and protected are read from .pl/watch.paths, not from the script
reads_config() {
  local out; out="$(block "$repo")"
  [[ "$out" == *"DIRTY    M BASELINE"* ]] && return 1   # BASELINE is not under src:
  # untracked dirs stay collapsed (git's default) — same view the sweep had before
  [[ "$out" == *"DIRTY   ?? src/"*      ]] || return 1
  [[ "$out" == *"PROT     M BASELINE"*  ]] || return 1
  [[ "$out" == *"PROTLOG"*              ]] || return 1
}
check "src/protected come from .pl/watch.paths" reads_config

# 3. no config: src degrades to the whole tree, protected says so instead of
#    silently reporting every file as protected
plain="$root/plain"
git init -q "$plain"
git -C "$plain" -c user.email=t@t -c user.name=t commit -q --allow-empty -m first
printf 'x\n' > "$plain/loose.txt"
no_config() {
  local out; out="$(block "$plain")"
  [[ "$out" == *"DIRTY   ?? loose.txt"* ]] || return 1
  [[ "$out" == *"PROT    (undefined"*   ]] || return 1
}
check "no watch.paths: DIRTY covers the tree, PROT reports undefined" no_config

# 4. a non-repo path degrades to one stderr line and MUST NOT abort the roster
#    (the fleet table above it is what the PL actually wakes for)
notgit="$root/notgit"; mkdir -p "$notgit"
survives_nonrepo() {
  local rc=0
  bash "$ROSTER" --git "$notgit" >/dev/null 2>"$root/err" || rc=$?
  [[ "$rc" -eq 0 ]] || return 1
  grep -q 'not a git repository' "$root/err"
}
check "non-repo path: stderr warning, exit still 0" survives_nonrepo

# 5. malformed input is rejected before any output
rejects() { # $@ = args that must exit 2
  local rc=0
  bash "$ROSTER" "$@" >/dev/null 2>&1 || rc=$?
  [[ "$rc" -eq 2 ]]
}
check "--git with no value exits 2"        rejects --git
check "--git with a missing path exits 2"  rejects --git "$root/does-not-exist"
check "--git-only without --git exits 2"   rejects --git-only

printf '1..%d\n' "$tests"
[[ "$failures" -eq 0 ]] || { printf '%d failure(s)\n' "$failures" >&2; exit 1; }
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall