plan-progress

You are synthesizing a progress entry for the current branch and writing it to the configured destination. The output style is codified by the planning-tools:progress-methodology skill — one dense paragraph per branch, evidence-rich, with inline sub-markers (Piggybacked:, Verification:, Out of scope:).

This command is safe to re-run — SHA-based idempotency means a second run between phases only narrates the new commits; the existing prose is preserved.

Input: $ARGUMENTS

Parse arguments:

• --final → flip the entry to shipped state (prepend **Shipped <today> via PR #<N>.**, append ✅ to heading)
• --destination <type>:<id> → one-off destination override. Examples: markdown:<path-to-progress-file> (any path; the plugin does not assume context/ or any other directory), linear:<ticket-id> (e.g., linear:AIA-1234), github:<owner>/<repo>#<number> (e.g., github:oborchers/fractional-cto#42). Does not persist to settings.
• --style-from <path> → use the entries in this file as style exemplars instead of pulling from the destination
• --ticket <id> → explicit source-ticket override (otherwise auto-detected from branch name)

Read the planning-tools:progress-methodology skill before Step 1 if you have not seen it this session — it owns the conventions every subsequent step depends on.

---

Step 1 — Detect git context

Run one bash block. Lift from /planning-tools:plan-tick Step 1:

git rev-parse --is-inside-work-tree || { echo "ERROR: not in a git repo"; exit 1; }
ROOT="$(git rev-parse --show-toplevel)"
BRANCH="$(git branch --show-current)"
[ -z "$BRANCH" ] && { echo "ERROR: detached HEAD — /planning-tools:plan-progress requires a named branch"; exit 1; }
BASE="$(git symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null | sed 's|^origin/||')"
[ -z "$BASE" ] && git rev-parse --verify --quiet origin/main >/dev/null && BASE=main
[ -z "$BASE" ] && git rev-parse --verify --quiet origin/master >/dev/null && BASE=master
[ -z "$BASE" ] && BASE=main
MERGE_BASE="$(git merge-base HEAD "$BASE" 2>/dev/null || git merge-base HEAD "origin/$BASE" 2>/dev/null)"
echo "ROOT=$ROOT"
echo "BRANCH=$BRANCH"
echo "BASE=$BASE"
echo "MERGE_BASE=$MERGE_BASE"

If not in a git repo or BRANCH is empty (detached HEAD), error with the message above and stop.

Compute the branch slug (used as the entry-key): strip leading feature/, fix/, chore/, bugfix/, hotfix/, or <user>/ prefixes; lowercase; replace _ and / with -. Save this as BRANCH_SLUG.

---