v3.1.0: Community feedback & local improvements
Community release: 7 merged pull requests and 27 issues resolved, all from the week after v3.0.0, plus my own improvements based on this week's local observations. Thanks to @notbucki, @YeQiuApex, @y4r4i, @theocannac, @dispather, @kmoussly, @certen59, @zaBees, @josuejuniorba-web, @karol-f, @ethads, @minorum, @rlucho, @adamwmusial, @Nikhiltogadiya and @aritamoseti59-dev for your contributions.
Snippets that hold up in more shells:
The session-start scan exits 0 on success, enumerates with find (no zsh nomatch abort on an empty log), keeps its guard counter out of the output stream (piping the loop no longer trips "SCAN COMMAND BROKEN"), and every runnable snippet takes the pinned [ABSOLUTE PATH] instead of a relative path that reports a clean backlog from the wrong directory. The id snippet strips zero-padding before arithmetic (octal ids), folds the archival sweep into the same command, refuses an existing target path and creates under noclobber. The example session-start hook counts status: open files, not files.
Scripts:
migrate-log.py accepts scoped plugin:skill names, raises one flag per malformed token instead of two, and survives any console encoding. validate-skill-bundle.py rejects edit residue (literal backreferences, conflict markers, unresolved slots) in every text file and a duplicated frontmatter block.
Activation and anchoring:
An install-time verification step (verify in a new session, by evidence of invocation) and the external diagnostic for a never-activated install, in the docs and the README. The activation block pins the workspace root and lists every derived path. The scope rule for the workspace matches installation scope. Blocked hook installs and dotfile-managed skills directories are covered.
Review procedure:
Flush triggers defined as a property rather than a command list; deferral criteria must be able to occur; premises behind disposition options verified before offering; the manifest never carries follow-up work; same-day second rounds get a discriminated anchor; the feedback pre-flight has a call site; keep-two prunes staged copies only; scheduler detection named per platform; the -extras companion is the one allowed new skill in a review.
New reference file:
references/starter-principles.md, an optional provenance-stripped seed set of cross-cutting principles offered once at first run.
Full detail in the commit history; each commit names its issue and reporter.
