@zalom/plastic 1.0.0-alpha.18 → 1.0.0-alpha.19

package/scripts/uninstall.rb

@@ -0,0 +1,53 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# Plastic — `uninstall` verb. Runs via `npx @zalom/plastic uninstall` (bin/plastic.js) or directly.
+# Usage: ruby scripts/uninstall.rb [--claude|--codex|--hermes|--all] [--help]
+#
+# Manifest-driven removal of installed files + legacy-plugin migration. Leaves ~/.plastic/
+# (intent store, config, and the versions.json ledger) in place — the ledger is permanent.
+
+require_relative "lib/installer_core"
+
+class Uninstall < InstallerCore
+  def cli(argv = ARGV)
+    if argv.include?("--help") || argv.include?("-h")
+      show_help
+      return 0
+    end
+
+    selected = agent_keys_from(argv)
+    selected = ["claude"] if selected.empty?
+
+    puts "\n\u{1f9e0} Plastic v#{version} — uninstall\n\n"
+    handle_uninstall(selected)
+    0
+  end
+
+  private
+
+  def show_help
+    puts <<~HELP
+
+      plastic uninstall — remove Plastic from an agent
+
+      Usage:
+        npx @zalom/plastic uninstall [options]
+
+      Agent options:
+        --claude      Uninstall from Claude Code (default)
+        --codex       Uninstall from Codex CLI
+        --hermes      Uninstall from Hermes
+        --all         Uninstall from all supported agents
+
+      Other options:
+        -h, --help    Show this help
+
+      Leaves your intent store, config, and version ledger (~/.plastic/) in place.
+
+    HELP
+  end
+end
+
+exit(Uninstall.new(package_root: ENV["PLASTIC_PACKAGE_ROOT"] || File.expand_path("..", __dir__)).cli(ARGV)) if $PROGRAM_NAME == __FILE__

package/scripts/update.rb

@@ -0,0 +1,142 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# Plastic — `update` verb. Runs via `npx @zalom/plastic update` (bin/plastic.js) or directly.
+# Usage: ruby scripts/update.rb [--beta|--latest|--alpha] [--claude|--codex|--hermes|--all] [--help]
+#
+# Forward-only version transitions, sourced from npm dist-tags:
+#   - no flag                = next version on the CURRENT channel (derived from VERSION)
+#   - --beta/--latest/--alpha = switch channel. Toward stability (alpha->beta->latest) is
+#                               frictionless; toward bleeding edge requires confirmation.
+# "Already up to date" is a clean no-op. Performs the switch by delegating the file-sync to
+# `install --reinstall --ledger-action update` for the chosen version via npx.
+
+require_relative "lib/installer_core"
+
+class Update < InstallerCore
+  PKG = "@zalom/plastic"
+
+  def cli(argv = ARGV)
+    if argv.include?("--help") || argv.include?("-h")
+      show_help
+      return 0
+    end
+
+    iv = installed_version
+    unless iv
+      warn "Plastic is not installed. Run: npx #{PKG} install --claude"
+      return 1
+    end
+
+    requested = requested_channel(argv)
+    tags = fetch_dist_tags
+    unless tags
+      warn "Could not query npm dist-tags. Are you online?"
+      return 1
+    end
+
+    res = compute_target(installed_version: iv, dist_tags: tags, requested_channel: requested)
+
+    case res[:status]
+    when :up_to_date
+      puts "\u{2705} Plastic v#{iv} is already up to date on the #{channel_for(iv)} channel."
+      return 0
+    when :unknown_channel
+      warn "No published version on the #{requested} channel."
+      return 1
+    when :ok
+      if res[:kind] == :cross_bleeding && !confirm_bleeding(iv, res[:target])
+        puts "Aborted."
+        return 1
+      end
+      puts "\u{2b06}\u{fe0f}  Updating Plastic #{iv} \u{2192} #{res[:target]}"
+      perform_switch(res[:target], agent_args(argv))
+    end
+  end
+
+  # Pure decision logic (hermetically testable). Returns a status hash.
+  def compute_target(installed_version:, dist_tags:, requested_channel: nil)
+    installed_ch = channel_for(installed_version)
+    target_ch = requested_channel || installed_ch
+    cand = dist_tags[target_ch]
+    return { status: :unknown_channel } unless cand
+
+    if target_ch == installed_ch
+      return { status: :up_to_date } unless semver_gt?(cand, installed_version)
+      { status: :ok, target: cand, kind: :in_channel }
+    else
+      bleeding = stability_rank(target_ch) < stability_rank(installed_ch)
+      { status: :ok, target: cand, kind: bleeding ? :cross_bleeding : :cross_stable }
+    end
+  end
+
+  def installed_version
+    path = File.join(plastic_home, "VERSION")
+    File.exist?(path) ? File.read(path).strip : nil
+  end
+
+  private
+
+  def requested_channel(argv)
+    return "alpha" if argv.include?("--alpha")
+    return "beta" if argv.include?("--beta")
+    return "latest" if argv.include?("--latest")
+    nil
+  end
+
+  # Agent flags to pass through to the delegated install (default --claude).
+  def agent_args(argv)
+    flags = agents.map { |a| a[:flag] }.select { |f| argv.include?(f) }
+    flags << "--all" if argv.include?("--all")
+    flags.empty? ? ["--claude"] : flags
+  end
+
+  def fetch_dist_tags
+    raw = `npm view #{PKG} dist-tags --json 2>/dev/null`
+    return nil if raw.nil? || raw.strip.empty?
+    JSON.parse(raw)
+  rescue JSON::ParserError, StandardError
+    nil
+  end
+
+  def confirm_bleeding(current, target)
+    return false unless $stdin.tty?
+    print "Switch from #{current} to the less-stable #{target}? [y/N]: "
+    ($stdin.gets&.strip || "").downcase.start_with?("y")
+  end
+
+  # Thin npx-exec glue (not unit-tested; the decision above is). Delegates the file-sync to
+  # the target version's install verb, recording the ledger action as `update`.
+  def perform_switch(target, agent_flags)
+    cmd = ["npx", "#{PKG}@#{target}", "install", "--reinstall", "--ledger-action", "update", *agent_flags]
+    puts "  $ #{cmd.join(" ")}"
+    system(*cmd) ? 0 : 1
+  end
+
+  def show_help
+    puts <<~HELP
+
+      plastic update — upgrade Plastic to a newer version
+
+      Usage:
+        npx @zalom/plastic update [options]
+
+      Channel options (default: stay on the current channel):
+        --latest      Switch to / advance the stable channel
+        --beta        Switch to / advance the beta channel
+        --alpha       Switch to / advance the alpha channel (bleeding edge — confirmed)
+
+      Agent options (default: --claude):
+        --claude --codex --hermes --all
+
+      Behaviour:
+        No flag advances to the next version on your current channel. Switching toward a
+        more stable channel is frictionless; switching toward bleeding edge is confirmed.
+        Use `versions` to roll back to a previously-installed version.
+
+    HELP
+  end
+end
+
+exit(Update.new(package_root: ENV["PLASTIC_PACKAGE_ROOT"] || File.expand_path("..", __dir__)).cli(ARGV)) if $PROGRAM_NAME == __FILE__

package/scripts/versions.rb

@@ -0,0 +1,141 @@
+#!/usr/bin/env ruby
+# encoding: UTF-8
+# frozen_string_literal: true
+
+# Plastic — `versions` verb. Runs via `npx @zalom/plastic versions` (bin/plastic.js) or directly.
+# Usage: ruby scripts/versions.rb [--downgrade [--version <v>] | --upgrade] [--help]
+#
+# Local time-machine over the append-only versions.json ledger. Navigates ONLY versions you
+# have actually run (the ledger), never npm's full list — fetching brand-new versions is
+# `update`'s job. Lets you roll back to a known-good build after a bad release.
+#   - no flag                  print the ledger table (and offer to continue a rollback)
+#   - --downgrade              step back one version in your history
+#   - --downgrade --version V  jump to a specific previously-run version
+#   - --upgrade                step forward one version (after a rollback)
+
+require_relative "lib/installer_core"
+
+class Versions < InstallerCore
+  PKG = "@zalom/plastic"
+
+  def cli(argv = ARGV)
+    if argv.include?("--help") || argv.include?("-h")
+      show_help
+      return 0
+    end
+
+    ledger = ledger_read
+    if ledger.empty?
+      puts "No version history yet (versions.json is empty). Install or update first."
+      return 0
+    end
+
+    timeline = version_timeline(ledger)
+    current = installed_version || timeline.last
+
+    if argv.include?("--downgrade")
+      explicit = flag_value(argv, "--version")
+      target = explicit || step_target(timeline, current, :back)
+      return no_target("No earlier version in your history.") unless target
+      unless timeline.include?(target)
+        warn "#{target} is not in your version history. Choose one of: #{timeline.join(", ")}"
+        return 1
+      end
+      return switch_to(target, current)
+    elsif argv.include?("--upgrade")
+      target = step_target(timeline, current, :forward)
+      return no_target("No later version in your history. Use `update` for new releases.") unless target
+      return switch_to(target, current)
+    end
+
+    # No flag: show the table, and detect an in-progress rollback.
+    print_table(ledger, current)
+    if ledger.last && ledger.last["action"] == "downgrade"
+      prev = step_target(timeline, current, :back)
+      if prev && $stdin.tty?
+        print "\nYou recently rolled back. Go back further to #{prev}? [y/N]: "
+        return switch_to(prev, current) if ($stdin.gets&.strip || "").downcase.start_with?("y")
+      end
+    end
+    0
+  end
+
+  # Unique versions in first-seen (chronological) order — the user's personal timeline.
+  def version_timeline(ledger)
+    ledger.map { |e| e["version"] }.compact.uniq
+  end
+
+  # Neighbour of `current` in the timeline. direction :back (older) or :forward (newer).
+  def step_target(timeline, current, direction)
+    i = timeline.index(current)
+    return nil if i.nil?
+    j = direction == :back ? i - 1 : i + 1
+    return nil if j < 0 || j >= timeline.length
+    timeline[j]
+  end
+
+  # Direction-derived ledger action for moving current -> target.
+  def action_for(target, current)
+    cmp = semver_compare(target, current)
+    cmp == -1 ? "downgrade" : "update"
+  end
+
+  def installed_version
+    path = File.join(plastic_home, "VERSION")
+    File.exist?(path) ? File.read(path).strip : nil
+  end
+
+  private
+
+  def flag_value(argv, name)
+    i = argv.index(name)
+    return nil unless i && argv[i + 1]
+    argv[i + 1]
+  end
+
+  def no_target(msg)
+    puts msg
+    0
+  end
+
+  def switch_to(target, current)
+    action = action_for(target, current)
+    puts "#{action == "downgrade" ? "\u{23ea}" : "\u{23e9}"}  #{current} \u{2192} #{target} (#{action})"
+    cmd = ["npx", "#{PKG}@#{target}", "install", "--reinstall", "--ledger-action", action, "--claude"]
+    puts "  $ #{cmd.join(" ")}"
+    system(*cmd) ? 0 : 1
+  end
+
+  def print_table(ledger, current)
+    puts "\nPlastic version history (versions.json — append-only):\n\n"
+    puts "    %-22s %-10s %s" % ["version", "action", "at"]
+    ledger.each do |e|
+      marker = e["version"] == current ? "\u{2192} " : "  "
+      puts "  #{marker}%-22s %-10s %s" % [e["version"], e["action"], e["at"]]
+    end
+    puts "\n  \u{2192} = currently installed (v#{current})\n\n"
+  end
+
+  def show_help
+    puts <<~HELP
+
+      plastic versions — manage and roll back your local Plastic versions
+
+      Usage:
+        npx @zalom/plastic versions [options]
+
+      Options:
+        (none)                  Show the version-history table
+        --downgrade             Roll back one version in your history
+        --downgrade --version V Roll back to a specific previously-run version
+        --upgrade               Step forward one version in your history
+        -h, --help              Show this help
+
+      Navigates only versions you have already run (the append-only ledger). To move to a
+      brand-new release, use `update`.
+
+    HELP
+  end
+end
+
+exit(Versions.new(package_root: ENV["PLASTIC_PACKAGE_ROOT"] || File.expand_path("..", __dir__)).cli(ARGV)) if $PROGRAM_NAME == __FILE__

package/skills/brainstorming/SKILL.md

@@ -107,7 +107,7 @@ digraph brainstorming {
 
 ## After the Design
 **Documentation:**
-- Write the validated design (spec) to `{intent_dir}/spec.md`
+- Write the validated design (spec) to `{intent_dir}/spec.md` using the `${CLAUDE_PLUGIN_ROOT}/templates/spec.md` form
 - Use elements-of-style:writing-clearly-and-concisely skill if available
 - Commit to the store repo:
   ```

package/skills/executing-plan/SKILL.md

@@ -70,7 +70,7 @@ After all tasks complete, dispatch a final reviewer for the entire implementatio
 ### Step 4: Update Intent and Complete
 Capture observations in `## Insights`. When ALL checklist items are checked:
 
-1. Write `outcome.md` with detailed results in the intent directory
+1. Write `outcome.md` with detailed results in the intent directory, using the `${CLAUDE_PLUGIN_ROOT}/templates/outcome.md` form
 2. Write `## Outcome` summary in the intent file (1-2 sentences)
 3. Move intent from `## Active` to `## Completed` in INDEX.md (with today's date)
 4. Update cluster entries to show `_(completed)_`
@@ -95,7 +95,7 @@ For each task:
 ### Step 3: Update Intent and Complete
 Capture observations in `## Insights`. When ALL checklist items are checked:
 
-1. Write `outcome.md` with detailed results in the intent directory
+1. Write `outcome.md` with detailed results in the intent directory, using the `${CLAUDE_PLUGIN_ROOT}/templates/outcome.md` form
 2. Write `## Outcome` summary in the intent file (1-2 sentences)
 3. Move intent from `## Active` to `## Completed` in INDEX.md (with today's date)
 4. Update cluster entries to show `_(completed)_`

package/skills/install/SKILL.md

@@ -5,7 +5,7 @@ description: Use when initializing Plastic globally (~/.plastic/) or locally in
 
 # Install Plastic
 
-> **Recommended path:** for a first install, run `npx @zalom/plastic@latest --claude`
+> **Recommended path:** for a first install, run `npx @zalom/plastic@latest install --claude`
 > in your shell (or `bunx @zalom/plastic@latest --claude` if you use Bun). This skill
 > exists to **re-install or repair** an existing setup from inside the agent, and to
 > drive interactive global configuration. Whenever this skill performs an install or
@@ -18,7 +18,7 @@ firing, leftover legacy plugin), re-run the installer — it is idempotent, prun
 files that no longer ship, and removes any legacy plugin/marketplace layout:
 
 ```bash
-npx @zalom/plastic@latest --claude     # or @beta / @alpha to match your channel
+npx @zalom/plastic@latest install --reinstall --claude   # or @beta / @alpha to match your channel
 ```
 
 Then **run `/plastic-doctor`** and report what it found.
@@ -36,13 +36,13 @@ runs the appropriate npx command:
 
 ```bash
 # Stable (default)
-npx @zalom/plastic --claude
+npx @zalom/plastic install --claude
 
 # Beta
-npx @zalom/plastic@beta --claude
+npx @zalom/plastic@beta install --claude
 
 # Alpha
-npx @zalom/plastic@alpha --claude
+npx @zalom/plastic@alpha install --claude
 ```
 
 The installed version and channel are recorded in `~/.plastic/VERSION`.

package/skills/uninstall/SKILL.md

@@ -14,7 +14,7 @@ underlying uninstaller and adds reporting + verification.
 ### Step 1: Run the uninstaller
 
 ```bash
-npx @zalom/plastic@latest --uninstall --claude
+npx @zalom/plastic@latest uninstall --claude
 ```
 
 (Use `--codex` / `--hermes` / `--all` to target other agents. `bunx` works too.)
@@ -55,5 +55,5 @@ Delete it too?
   b) Delete everything now — removes ~/.plastic/ entirely (irreversible)
 ```
 
-- **Keep:** "Your data is at ~/.plastic/. Re-install anytime with `npx @zalom/plastic@latest --claude`."
+- **Keep:** "Your data is at ~/.plastic/. Re-install anytime with `npx @zalom/plastic@latest install --claude`."
 - **Delete:** run `rm -rf ~/.plastic/` and confirm.

package/skills/update/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: plastic-update
-description: Use when updating Plastic. Queries npm for available versions across all channels, presents options interactively, or accepts --alpha/--beta/--latest flags for direct update.
+description: Use when updating Plastic. Runs the `update` verb, which reads the installed VERSION, derives its channel, queries npm dist-tags, and advances to the next version on that channel (or switches channel with a flag).
 ---
 
 # Update Plastic
@@ -8,123 +8,67 @@ description: Use when updating Plastic. Queries npm for available versions acros
 ## When to Use
 - User says "update plastic", "sync plastic", or "upgrade plastic"
 - Statusline shows "Plastic update available"
-- After a version bump notification
+- After a version-bump notification
+
+## What it does
+
+`update` is a single deterministic command. It reads `~/.plastic/VERSION`, derives the
+channel from the version string (`-alpha`/`-beta`/none → stable), queries `npm` dist-tags,
+and advances to the **next version on the current channel**. "Already up to date" is a
+clean no-op. You do not compute the target yourself — the script does.
 
 ## Flags
 
-| Flag | Behavior |
-|------|----------|
-| `--alpha` | Update to latest alpha, skip interactive prompt |
-| `--beta` | Update to latest beta, skip interactive prompt |
-| `--latest` | Update to latest stable, skip interactive prompt |
+| Flag | Behaviour |
+|------|-----------|
+| (none) | Advance to the next version on the **current** channel |
+| `--latest` | Switch to / advance the **stable** channel (toward stability — frictionless) |
+| `--beta` | Switch to / advance the **beta** channel |
+| `--alpha` | Switch to / advance the **alpha** channel (bleeding edge — confirmed if moving down in stability) |
 
-No flag = interactive mode (show all available versions).
+Switching toward a more stable channel is frictionless; switching toward bleeding edge is
+confirmed. To roll **back** to a previously-installed version, use `plastic-versions`.
 
 ## Prerequisites
 
-Global install must exist (`~/.plastic/INDEX.md` present). If not, tell the
-user to run `npx @zalom/plastic@alpha --claude` first.
+Plastic must be installed (`~/.plastic/VERSION` present). If not, run
+`npx @zalom/plastic install --claude` first.
 
 ## Procedure
 
-### Step 1: Read current version
-
-```bash
-cat ~/.plastic/VERSION
-```
-
-Parse the version string to determine the current channel:
-- Contains `-alpha` → alpha channel
-- Contains `-beta` → beta channel
-- No pre-release suffix → stable/latest channel
-
-### Step 2: Query npm for available versions
-
-```bash
-npm view @zalom/plastic dist-tags --json
-```
-
-This returns a JSON object like:
-```json
-{
-  "latest": "0.0.1",
-  "alpha": "1.0.0-alpha.14",
-  "beta": "1.0.0-beta.2"
-}
-```
-
-A missing dist-tag means no release exists on that channel.
-
-### Step 3: Present options or act on flag
-
-**If a channel flag was provided** (`--alpha`, `--beta`, `--latest`):
-
-Skip the interactive prompt. Install the flagged channel directly. Go to Step 4.
-
-**If no flag (interactive mode):**
-
-Present the available updates to the user:
-
-```
-Currently installed: 1.0.0-alpha.11 (alpha channel)
-
-Available updates:
-  alpha:  1.0.0-alpha.14  ← your channel
-  beta:   1.0.0-beta.2
-  stable: (no stable release yet)
-
-Which channel do you want to install?
-```
-
-Use AskUserQuestion with the available channels as options. Mark the user's
-current channel with "← your channel". If a dist-tag points to the same
-version as currently installed, show "(up to date)" instead of the version.
-If a dist-tag doesn't exist, show "(no release yet)".
-
-Wait for user selection.
-
-### Step 4: Run the installer
+### Step 1: Run the update
 
 ```bash
-npx @zalom/plastic@{selected-tag} --claude
+npx @zalom/plastic update            # next version on the current channel
+# or: npx @zalom/plastic update --beta   /   --latest   /   --alpha
 ```
 
-Replace `{selected-tag}` with `alpha`, `beta`, or `latest` based on the
-user's selection or the flag provided. Replace `--claude` with the appropriate
-agent flag(s) — detect current agents from `~/.claude/`, `~/.agents/`,
-`~/.hermes/` directories.
+Append the agent flag(s) if not just Claude (`--codex`, `--hermes`, `--all`).
+The command prints the transition (`vX → vY`) or "already up to date", and records the
+move in the append-only `~/.plastic/versions.json` ledger.
 
-### Step 5: Announce key changes
+### Step 2: Announce key changes
 
-After the installer completes, read `~/.plastic/PLASTIC.md` and announce any
-convention changes that affect the current session.
+After it completes, read `~/.plastic/PLASTIC.md` and announce convention changes that
+affect the current session:
 
-Format:
 ```
 Plastic updated to vX.Y.Z (channel).
 
-Key changes in this version:
-- [list notable convention changes if any]
+Key changes:
+- [notable convention changes, if any]
 
 Recommendation: run /clear for a clean session with all new conventions loaded.
 ```
 
-### Step 6: Run health check
-
-Invoke `plastic-doctor` to verify the installation is healthy after the update.
-
-If all checks pass, show: **"Health check: all clear."**
+### Step 3: Health check
 
-If issues are found, show the full doctor report and offer to fix.
-
-### Step 7: Commit
-
-```bash
-cd ~/.plastic && git add PLASTIC.md scripts/ AGENTS.md VERSION 2>/dev/null && git commit -m "chore: update Plastic to $(cat ~/.plastic/VERSION)" --allow-empty
-```
+Invoke `plastic-doctor`. If all checks pass: **"Health check: all clear."** Otherwise show
+the report and offer to fix.
 
-### Step 8: Clear update cache
+### Step 4: Commit + clear update cache
 
 ```bash
+cd ~/.plastic && git add PLASTIC.md scripts/ AGENTS.md VERSION versions.json 2>/dev/null && git commit -m "chore: update Plastic to $(cat ~/.plastic/VERSION)" --allow-empty
 rm -f ~/.plastic/.cache/update-check.json
 ```

package/skills/versions/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: plastic-versions
+description: Use when the user wants to see their Plastic version history or roll back to a previously-installed version after a bad release. Manages the local, append-only versions.json ledger and steps between versions the user has actually run. For moving to a brand-new release, use plastic-update instead.
+---
+
+# Plastic Versions — local version time-machine
+
+## When to Use
+- "show plastic versions", "version history", "what versions have I run"
+- "roll back plastic", "downgrade", "go back to the version that worked", "revert plastic"
+- A new version broke something and the user wants their last known-good build
+
+For upgrading to a **new** release, use `plastic-update`. This skill only navigates
+versions you have **already installed** — the ones recorded in the ledger.
+
+## The ledger
+
+`~/.plastic/versions.json` is an **append-only JSONL** ledger — one line per version
+change, never modified or deleted:
+
+```json
+{"version":"1.0.0-alpha.17","action":"install","at":"..."}
+{"version":"1.0.0-alpha.18","action":"update","at":"..."}
+```
+
+`action` ∈ `install | reinstall | update | downgrade` (derived from version direction; the
+channel is derived from the version string, never stored). It is a troubleshooting record.
+
+## Procedure
+
+### Show history
+
+```bash
+npx @zalom/plastic versions
+```
+
+Prints the table with the currently-installed version marked. If the most recent action was
+a `downgrade`, it asks whether to keep rolling back.
+
+### Roll back
+
+```bash
+npx @zalom/plastic versions --downgrade                    # one step back
+npx @zalom/plastic versions --downgrade --version 1.0.0-alpha.15   # to a specific run
+```
+
+Rollback targets are restricted to versions in the ledger (only builds you have actually
+run, so you only ever return to something known-good for you). The chosen version is
+re-fetched from npm and re-synced; your intent store, config, and the ledger are untouched.
+
+### Step forward (after a rollback)
+
+```bash
+npx @zalom/plastic versions --upgrade                      # one step forward in your history
+```
+
+### After any change
+
+Run `plastic-doctor` to confirm health, and suggest `/clear` so the session picks up the
+swapped conventions.
+
+## Notes
+- The ledger is **never** edited or pruned — it is the audit trail.
+- Downgrades cannot un-migrate a store-format change; if a warning appears, surface it to
+  the user rather than forcing the rollback.

package/templates/outcome.md

@@ -0,0 +1,13 @@
+# Outcome: <intent name>
+
+## Summary
+(what was delivered)
+
+## Delivered
+- ...
+
+## Verification
+- <acceptance criterion> — verified by ... → result
+
+## Follow-ups
+None