docket

Docket — Deadline Sweep

You are running a read-only sweep of the user's matter files for time-based obligations — renewal windows, notice deadlines, objection periods, filing dates, milestones. Present ONE table sorted by urgency. Docket never writes to the vault, the config, or anywhere else: it reports and recommends only. To record a deadline, that's remember (see "Recording deadlines" below), not this skill.

Step 0: Plugin root

Resolve the plugin root: ${CLAUDE_PLUGIN_ROOT} is set by Claude Code on every plugin invocation — use it directly. If unset, it's the directory containing this skill's parent skills/ directory.

Step 1: Resolve the legal root and matters path

Run the canonical resolver:

bash "${CLAUDE_PLUGIN_ROOT}/scripts/resolve_legal_root.sh"

Exit-code contract: 0 = one marked root, stdout is the path; 1 = none found (tell the user to run /counsel-os:setup, then stop); 2 = multiple found (list the stderr candidates, ask which, or have them set COUNSEL_OS_LEGAL_ROOT).

Matters may be relocated by the config. Read the override (default matters):

LEGAL_ROOT="{resolved legal root}"
MATTERS_PATH=$(grep -m1 '^matters_path:' "$LEGAL_ROOT/config.md" | sed 's/^matters_path:[[:space:]]*//')
MATTERS_DIR="$LEGAL_ROOT/${MATTERS_PATH:-matters}"

If $MATTERS_DIR does not exist, tell the user there are no matters yet and stop.

Step 2: Run the sweep

The date arithmetic is deterministic, so a helper does it — don't eyeball dates by hand:

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/docket_sweep.py" "$MATTERS_DIR"

Useful flags:

• --window N — look-ahead window in days (default 60). The user may ask for a different horizon ("what's due in the next 90 days" → --window 90).
• --format json — structured output if you want to reason over it before presenting.
• --include-done — also show deadlines marked done: (hidden by default; kept in the file for audit).
• --today YYYY-MM-DD — override "now" (testing only).