Skip to content

docs(skill): add audit-clerk-skill for drift detection#156

Draft
wyattjoh wants to merge 1 commit intofeat/clerk-cli-skill-pinnedfrom
wyattjoh/skill-update
Draft

docs(skill): add audit-clerk-skill for drift detection#156
wyattjoh wants to merge 1 commit intofeat/clerk-cli-skill-pinnedfrom
wyattjoh/skill-update

Conversation

@wyattjoh
Copy link
Copy Markdown
Contributor

@wyattjoh wyattjoh commented Apr 14, 2026

Summary

New user-invocable skill that cross-checks skills/clerk/ against packages/cli-core/src/commands/** and proposes targeted edits when the two drift.

Reads per-command README.md files as a secondary source (to flag mocked or hidden surfaces), prefers --help over enumerating flags, and routes proposals between SKILL.md, references/agent-mode.md, references/auth.md, and references/recipes.md based on content type.

Configured with effort: high, disable-model-invocation: true (manual maintenance task), and an optional --apply argument to write changes rather than just proposing them.

Stacked on #126.

Test plan

  • Manual: invoke /audit-clerk-skill and confirm it produces the documented output shape (bucketed proposals, source citations, severity tags)
  • Manual: run with --apply on a synthetic drift case and confirm it writes only drift and gap edits, leaving polish suggestions for review

@wyattjoh wyattjoh changed the base branch from feat/clerk-cli-skill-pinned to feat/clerk-cli-skill-local-debug April 14, 2026 22:34
@wyattjoh wyattjoh marked this pull request as draft April 14, 2026 22:34
@wyattjoh
Copy link
Copy Markdown
Contributor Author

wyattjoh commented Apr 14, 2026

@wyattjoh wyattjoh force-pushed the wyattjoh/skill-update branch from fd4e18e to 0ac582c Compare April 14, 2026 22:36
@wyattjoh wyattjoh changed the title feat(skill): add CLERK_CLI_SKILL_SOURCE override and audit-clerk-cli-skill docs(skill): add audit-clerk-cli-skill for drift detection Apr 14, 2026
@wyattjoh wyattjoh changed the base branch from feat/clerk-cli-skill-local-debug to feat/clerk-cli-skill-pinned April 14, 2026 22:36
@wyattjoh wyattjoh force-pushed the wyattjoh/skill-update branch from 0ac582c to 93a54b9 Compare April 15, 2026 16:50
@wyattjoh wyattjoh force-pushed the feat/clerk-cli-skill-pinned branch from 97cadfd to 9255b9a Compare April 15, 2026 16:50
@wyattjoh wyattjoh force-pushed the wyattjoh/skill-update branch from 93a54b9 to 140f8d1 Compare April 15, 2026 17:26
@wyattjoh wyattjoh force-pushed the feat/clerk-cli-skill-pinned branch from 998207f to 71e2f9f Compare April 15, 2026 20:06
@wyattjoh wyattjoh force-pushed the wyattjoh/skill-update branch from 140f8d1 to 51a17d9 Compare April 15, 2026 20:06
@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Apr 15, 2026

⚠️ No Changeset found

Latest commit: 6f1b78f

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@wyattjoh wyattjoh force-pushed the wyattjoh/skill-update branch from 51a17d9 to b6a5d82 Compare April 15, 2026 21:13
@wyattjoh wyattjoh force-pushed the feat/clerk-cli-skill-pinned branch from 71e2f9f to 8078ef6 Compare April 15, 2026 21:13
@wyattjoh wyattjoh force-pushed the wyattjoh/skill-update branch from b6a5d82 to 6745d77 Compare April 15, 2026 22:23
@wyattjoh wyattjoh force-pushed the feat/clerk-cli-skill-pinned branch from 8078ef6 to 7a2025d Compare April 15, 2026 22:23
@wyattjoh wyattjoh force-pushed the wyattjoh/skill-update branch from 6745d77 to ac7474c Compare April 15, 2026 22:48
@wyattjoh wyattjoh force-pushed the feat/clerk-cli-skill-pinned branch from 7a2025d to 61ddd30 Compare April 15, 2026 22:48
@wyattjoh wyattjoh force-pushed the wyattjoh/skill-update branch from ac7474c to 84a4ce1 Compare April 15, 2026 23:14
@wyattjoh wyattjoh changed the title docs(skill): add audit-clerk-cli-skill for drift detection docs(skill): add audit-clerk-skill for drift detection Apr 15, 2026
Adds a user-invocable skill that cross-checks skills/clerk/ against the
CLI source tree (packages/cli-core/src/commands/**) and proposes targeted
edits when the two drift. Reads per-command README.md files as a secondary
source, prefers --help over enumerating flags, and routes proposals between
SKILL.md and references/*.md based on content type.

Configured with effort: high and disable-model-invocation: true so it is a
manual maintenance task, with an optional --apply argument to write changes
rather than just proposing them.
@wyattjoh wyattjoh force-pushed the wyattjoh/skill-update branch from 84a4ce1 to 6f1b78f Compare April 16, 2026 00:41
@wyattjoh wyattjoh force-pushed the feat/clerk-cli-skill-pinned branch from 9c7d911 to 61a2b63 Compare April 16, 2026 00:41
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