Skip to content

docs(initiative-scan): the skill that owns this workflow never mentioned generations - #1480

Open
ZacxDev wants to merge 1 commit into
mainfrom
fix/initiative-scan-generations-recovery
Open

ZacxDev wants to merge 1 commit into
mainfrom
fix/initiative-scan-generations-recovery

Conversation

@ZacxDev

@ZacxDev ZacxDev commented Sep 11, 2026

Copy link
Copy Markdown
Member

Finding 5 of #1383's round-1 audit, unfixed when that PR merged — I reported four findings and fixed four; this was a fifth (🟡) I did not carry over.

#1383 shipped plan generations and prints a recovery command on stderr, but the skill that auto-loads for this workflow still described save as writing two files. Measured before the change: 0 hits for generation or restore --plan in that file. After a bad save an agent reads the skill, not scripts/README.md (which #1383 did update, and which nothing auto-loads).

Every claim in the added text was verified against the shipped code, not copied from the PR body — including --plan bypassing the staleness gate (tmux-session-restore.py:1353) and stamps being UTC. Skill-listing + tier gates: 61 passed. Body text only; the always-on description is unchanged.

…ned generations

Finding 5 of #1383's round-1 audit, left unfixed when that PR merged. Recorded
plainly: I reported four findings to the operator and fixed four, and this was a
fifth (🟡) I did not carry over.

#1383 shipped timestamped plan generations so a bad save no longer destroys the
previous one, and it printed the recovery command on stderr. But the operator-
facing doc for this workflow — the SKILL that auto-loads on trigger — still
described `save` as writing two files, with no mention of generations or
`restore --plan <generation>`. Measured before this change: zero hits for either
term in claude/skills/initiative-scan/SKILL.md.

That matters for exactly the case the feature exists for. After a bad save an
agent reads the skill, not scripts/README.md (which #1383 did update and which
nothing auto-loads), and would learn nothing about the recovery path. On
2026-09-07 a continuum autosave overwrote a 47-entry plan with the 10-entry
post-crash workspace and 20 windows had to be identified by hand.

Every claim in the added text was verified against the SHIPPED code rather than
copied from the PR body:

  KEEP_GENERATIONS = 192, GENERATIONS_DIRNAME = "restore-plans"  (192 x 15min = 48h)
  `--plan` bypasses the staleness gate — tmux-session-restore.py:1353,
      `if staleness_hours is not None and plan_path is None:`
  stamps are UTC — `time.gmtime` in generation_stamp
  live sample on this host: restore-plan_20260910T012436.json

Skill-listing and tier gates re-run: 61 passed. This adds body text only, which
costs nothing until the skill is invoked; the always-on `description` is
unchanged.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013jdbmhCKa6edhTmiADsziR
Claude-Session-Id: 097b404c-db17-4472-bd37-dc90cf8fa675
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant