Skip to content

docs: 0.29.0 silent-drift cleanup (post-release audit nits) - #259

Merged
padak merged 1 commit into
mainfrom
docs/0.29.0-silent-drift-cleanup
May 6, 2026
Merged

docs: 0.29.0 silent-drift cleanup (post-release audit nits)#259
padak merged 1 commit into
mainfrom
docs/0.29.0-silent-drift-cleanup

Conversation

@padak

@padak padak commented May 6, 2026

Copy link
Copy Markdown
Member

Summary

Post-release audit against CONTRIBUTING.md 'Plugin synchronization map' caught three small drift items that slipped past the v0.29.0 release. No code or behavior changes — pure documentation.

Findings

# File Fix
D-1 CLAUDE.md:198 Convention #12 said 'Default-deny since 0.28.0' — stale label from the bulk relabel sweep. Bumped to 0.29.0 (where the change actually shipped).
D-2 SKILL.md description Missing trigger keywords for the three new 0.29.0 topic areas: data-app secrets (secrets-set/list/get/remove, encrypt app secret), validate-repo (golden rule, pre-flight repo check), and the manage-token default-deny flag. Without these, description-based auto-trigger won't fire when users mention these features by name.
D-3 SKILL.md description Removed a duplicated 'local workspace, project directory, kbagent init.' line.

Why these are silent-drift

CONTRIBUTING.md flags both files as 'NO CI check'. The auto-generated SKILL.md decision table is checked, but the hand-written description: block above it isn't. CLAUDE.md isn't either. Lint passes, tests pass, but an AI agent loaded with the stale description quietly misses three feature areas at trigger time.

Caught by manual audit using the Plugin synchronization map; an explicit reminder that the per-release checklist (steps 5-8 in CONTRIBUTING.md 'Releasing a new version') is the only safety net for these surfaces.

Test plan

  • make check passes (lint + format + skill freshness + version-sync + changelog + 2620 unit tests)
  • No production-code touches; diff is +7/-3 across two markdown files

Three nits found by post-release audit against CONTRIBUTING.md
'Plugin synchronization map':

- D-1: CLAUDE.md convention #12 'Default-deny since 0.28.0' was a
  stale label from the relabel sweep (the manage-token default-deny
  shipped in 0.29.0). Bump to 0.29.0.
- D-2: SKILL.md description block missed trigger keywords for the
  three new 0.29.0 topic areas:
  * data-app secrets (secrets-set/list/get/remove, encrypt app secret)
  * data-app validate-repo (golden rule, pre-flight repo check)
  * manage-token default-deny (--allow-env-manage-token)
  Without these, description-based auto-trigger won't fire when the
  user mentions any of these features by name.
- D-3: SKILL.md had a duplicated 'local workspace, project directory,
  kbagent init.' line (two consecutive copies, one with period, one
  with comma). Kept the comma variant; trailing period correctly moves
  to the last keyword in the list.

No code or behavior changes. Pure documentation.
@padak
padak merged commit f37eb55 into main May 6, 2026
1 check passed
@padak
padak deleted the docs/0.29.0-silent-drift-cleanup branch May 6, 2026 19:19
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