save-zklisted
Install: claude install-skill tkolleh/skills
# save-zk
Run **only** on explicit invoke: `save-zk` or `/save-zk`. No other phrases.
Phases **A → I** in order. Never skip or reorder. After Phase A, write immediately (no second confirm). Dry-run only if the user asked.
Load references on demand: `references/note-template.md`, `references/living-head.md`, `references/session-context.md`.
---
## Phase A — Note Key gate
1. Suggest candidates from branch name, open PR/issue, or session materials when present.
2. Human **supplies or confirms** the Note Key (tracker id) or a ≤8-word slug.
3. Never invent or silently pick a key. **Stop until confirmed.**
**Done when:** confirmed Note Key/slug in hand.
---
## Phase B — Gather Session Context
This session only. Fan out reads in parallel when independent.
| In | Out |
|----|-----|
| Session memories, touched markdown/allium, new/updated diagram fences or charts | Whole-repo docs crawl |
| Decisions stated in-session | Secrets, tokens, credentials |
| Branch / PR / issue metadata when available | Unrelated history |
Mark each source **present** or **unavailable**. Details: `references/session-context.md`.
**Done when:** every candidate source is present or marked unavailable.
---
## Phase C — Note Lookup
Prefer **tag** match on the issue key; filename match is fallback.
| Hits | Action |
|------|--------|
| 0 | **Create** |
| 1 | **Update** that note |
| >1 | **Update most recently modified** match — do not ask; do not merge files |
Issue-key Note Keys **must** be (