| name | maint-followup |
| description | Record progress on a maintenance followup ticket — comment on it, mark it done, or decline it. Invoke as `/zed:maint-followup <ticket-number> <update|done|nope> [comment]`. When the last open ticket of a run is closed, the run flips to Completed. |
Maintenance Followup
Update a followup ticket raised by a /zed:maintenance run. When a sweep
finishes with work that still needs a human, it leaves the run at status
Needs Followup and opens one numbered ticket per outstanding item (visible in
the observability app and via maintenance-db.sh list-followups). This skill
records progress on one of those tickets and, when the last open ticket of a run
is resolved, the run automatically graduates to Completed.
Argument
/zed:maint-followup <ticket-number> <status> [comment]
<ticket-number> (required) — the sequential ticket number the app assigned
when the followup was recorded (e.g. 7). Must be a positive integer.<status> (required) — one of:
update — record a progress comment; the ticket stays open.done — record a comment and close the ticket as completed.nope — record a comment and close the ticket as won't-do (you have
decided not to pursue this one).
[comment] (optional) — the rest of the line is the progress comment. If no
comment is given, write a single concise sentence summarizing what has happened
toward this ticket from the current session's context (what you did, found,
or decided). If the session has no relevant context, fall back to a short
status-appropriate note (e.g. for done: "Completed."; for nope: "Declining
this one."; for update: "Checked in; no change yet.").
Helper script
The observability database is written through maintenance-db.sh. Invoke it
directly by its path (do not prefix with bash):
DB="${CLAUDE_PLUGIN_ROOT}/scripts/maintenance-db.sh"
Process
1. Parse the argument
Split the argument into <ticket-number>, <status>, and the optional
remaining <comment>. Validate:
<ticket-number> is a positive integer. If not, tell the user the correct form
and stop.<status> is exactly update, done, or nope. If it is missing or
something else, explain the three valid values and stop.
2. Look up the ticket
"$DB" get-followup --id <ticket-number>
This prints a JSON object (ticket, project_name, title, detail, status,
run_id, and a comments timeline). If the command fails / prints nothing, the
ticket does not exist — report that and stop (suggest "$DB" list-followups to
see open tickets).
Note the ticket's title, project_name, and current status. If it is already
closed (done/wontdo), still proceed (a late comment or re-close is allowed),
but mention its current state in your report.
3. Determine the comment
If the user supplied a comment, use it verbatim. Otherwise, compose one concise
sentence describing what has happened toward this ticket using the current
session context — reference the concrete action/finding/decision if the session
has one; otherwise use the short status-appropriate fallback above. Keep it to a
single sentence.
4. Record it
"$DB" update-followup --id <ticket-number> --action <status> --comment "<comment>"
This appends the comment, sets the ticket's status (update leaves it open;
done→done; nope→wontdo), and, when a close resolves the last open ticket
of a needs_followup run, flips that run to completed. It prints a JSON receipt:
{"ticket":7,"status":"done","run_id":3,"open_remaining":0,"run_completed":true}
5. Report
Tell the user, concisely:
- the ticket number, its project/title, and its new status,
- the comment that was recorded,
- and, from the receipt: how many followups remain open on that run
(
open_remaining), and — if run_completed is true — that this resolved the
last one so the run is now marked Completed. Otherwise note how many remain.
Mention that the observability app reflects the change live (the ticket row and
the run status update without a refresh).
Notes
- This skill only touches a single ticket per invocation. To see all tickets for
a run, use
"$DB" list-followups --run <run-id> (or list-followups for all).
- Resolving tickets is the only thing that moves a run from Needs Followup
to Completed — there is no separate "complete the run" step.
