matthewwong525/WongStack / .agents/plugins/loop/skills/save
save
Verified/save
/save authorizes branch creation, record upkeep, spec reconciliation, commit, push, PR updates and CI fixes; ask for anything else. Never force push, bypass hooks, amend merged commits or merge: /ship owns archive/merge, and the gate is never a local check.
/save [note]: a Status value sets Status; other notes seed the Decision log. Cold-resume context belongs in pushed files with repo-relative paths: another computer reads it.
1. Protect credentials and select the route
Keep every credential supplied, rotated, read or written this session out of tracked files, changes, messages, PR text and reports. Values stay in working memory and their intended ignored live file; record only names and sources.
Load each matching procedure before its actions; conditions combine:
| Condition | Procedure |
|---|---|
| User supplied or rotated an explicitly named secret | Named-secret persistence, before writing records |
| Code or a code plan needs a new change | New-plan fallback |
| The exact selected handoff is archived | The archived handoff |
Check preconditions, then fetch main (not on local); errors stop.
git fetch origin main
openspec context --json
openspec list --json
bash "$(git rev-parse --show-toplevel)/.claude/skills/save/scripts/change-candidates.sh" --json
Save the change this work touched, found by the rungs, never a plan merely because it is the only one open. Keep BRANCH, NAME, CHANGE_ROOT separate; never rename or duplicate a change to match its branch.
Work that changed no repo file → there is nothing to save in the repo; say so and stop. Nothing learned, decided, or changed → report and stop.
2. Maintain the handoff and capture context
Keep the feature branch. On default/detached HEAD, git checkout -b "$SLUG": change/topic name, else worktree name for an unreadable session; append a short SHA on collision. Create required plan artifacts before checkpointing.
Maintain the living handoff:
- Proposal header: current
**Status:**, actual**Branch:**, and**Open questions:**(nonewhen empty). - Plan sections: the current intent from the latest agreed plan and diff, self-contained, edited in place under existing headings. Tasks: true checked state and agreed additions.
## Decision log: append one dated entry; never change earlier ones: a cold reader inherits the why from them.
For an active change, reconcile its deltas. Read artifact and task progress from the CLI.
The archived handoff
Keep exact CHANGE_ROOT; infer NAME from its dated folder only if absent. Retain actual Branch and append a dated archive-checkpoint entry. The archive is the record: never rebuild the plan or recreate an active folder; archive already reconciled deltas. Stage archive, tracked removals and implementation; pass --mode archive and report its path.
3. Stage, exclude values, and commit
Stage intended implementation, handoff and removals, never git add .; check for unrelated staged work. A plan-only save commits its artifacts. Write, outside the repo, a one-line repo-style commit message ending Co-Authored-By: Claude, and the PR summary.
4. Publish and wait for the gate
One command runs the gate, review page to preview:
node "$(git rev-parse --show-toplevel)/.claude/skills/save/scripts/checkpoint.mjs" \
--message-file "$MESSAGE" --summary-file "$SUMMARY" \
--change-root "$CHANGE_ROOT" --mode active --scan-keys "$KEYS"
--scan-keys names every credential handled this session; a match stops the save. No change → omit --change-root and --mode. Use the host's longest wait and wait again, silently, until it ends; then follow its NEXT: line.
5. Report
Report outcome and one link in plain words. Inside a verb or on request, include branch/commit, PR, change/archive Status, CI fixes/uncertainty and preview/absence. Return the command's SAVE_HEAD, RECEIPT and SAVE_GATE_RESULT lines; always print the last inside a verb. Explicit errors; continue command only for active changes.
Direct invocation asks next steps with the question tool: continue, publish or stop; failed/unverified gates offer repairs.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |