Watch exactly one Codex session through one target-skill lens and emit only decision-relevant deltas. Use Tune's passive Seq skill-decision evidence definition for `$shadow $tune`; use for shadow/tail/follow/monitor one session, missed or contrary skill decisions, validation/outcome changes, worker decisions, or goal-cycle status. Do not scan broad history, inspect raw JSONL, create a second continual controller, or repeat full analysis when the cursor contains no new decision evidence.
Watch exactly one Codex session through one target-skill lens and emit only decision-relevant deltas. Use Tune's passive Seq skill-decision evidence definition for `$shadow $tune`; use for shadow/tail/follow/monitor one session, missed or contrary skill decisions, validation/outcome changes, worker decisions, or goal-cycle status. Do not scan broad history, inspect raw JSONL, create a second continual controller, or repeat full analysis when the cursor contains no new decision evidence.
Shadow
Mission
$shadow is a one-session decision-delta filter.
No decision-relevant delta, no full report.
/goal owns continuation.
$shadow owns one current-cycle decision.
Required inputs
watched session id or path
target skill
mode: observe | propose | apply
watch objective
include workers: yes | no
prior cursor
Default:
mode = propose
include workers = no
Do not default the target skill to $tune.
Self-shadow guard
Bare:
$shadow $tune
with no distinct watched session or target concern is partial activation.
Emit one compact stop record.
Do not recursively shadow the current session.
Evidence source
Monitor the watched session only through $seq.
Preferred when target lens is $tune or when decision influence matters:
Compare stable source-event and line positions with the prior cursor. Include
worker sessions only through an explicit parent/worker path from
seq session-graph.
Narrow physical follow-ups:
session-detail
turns
tool-lifecycle
session-graph
Use the smallest set required.
Do not inspect raw watched-session JSONL with shell, Python, jq, rg, cat, or tail.
If the passive definition cannot expose the required fact:
tooling_gap
seq_tuning_gap
state_unknown
and produce a bounded definition/operator-gap handoff when concrete.
Target skill contract
Read the target skill package outside the watched session evidence boundary:
Do not infer historical recurrence from one watched session.
Modes
observe
Report evidence only.
propose
Default. Emit a tune packet or brief when the decision delta justifies it.
apply
Only when explicitly requested.
$shadow still does not edit the watched session or steer it.
Any target-skill edit follows that skill’s own apply boundary.
Worker sessions
Include workers only when:
the user requests them;
target decisions were delegated;
the target skill requires worker evidence.
Require a parent/worker proof path.
Do not sweep corpus-wide workers.
Stop conditions
Stop the current cycle when:
no decision-relevant delta
watched session stopped
state unknown after one bounded follow-up
action requires approval
evidence insufficient
finding retired/transferred
