Skip to content

Sync the workflow kit - #6

Merged
ryangswe merged 1 commit into
mainfrom
chore/sync-workflow-kit
Nov 7, 2026
Merged

ryangswe merged 1 commit into
mainfrom
chore/sync-workflow-kit

Conversation

@ryangswe

@ryangswe ryangswe commented Nov 7, 2026 •

Copy link
Copy Markdown
Owner

This pull request syncs the workflow kit to its current version. Every change is under .claude/ or in CLAUDE.md, and python3 .claude/workflow/check.py passes.

What changes for agent sessions here

  • The branch guard now also blocks git commit on the default branch and any push that would update it. .claude/settings.json wires it to Bash as well as the file tools. Commands that don't involve a commit or push return immediately.
  • .claude/settings.json gains a short deny list covering git push --force and -f, sudo, and reading .env files. --force-with-lease stays allowed. To drop a rule, delete it and list it under permissions_deny_opt_out in .claude/workflow.json, so that the next sync doesn't restore it.
  • The new gc skill and .claude/workflow/gc.py remove worktrees and branches whose work is already in the default branch, and list the rest for a decision. A plain run only reports.
  • The reviewer agent now chooses from the checklists in .claude/review-checklists.md, and the handoff skill takes the kit's latest wording.
  • CLAUDE.md now asks each session to size the task first. A small change takes a short lane with a branch, /checkpoint, one reviewer pass and a pull request, and it gets no plan or decisions entry. CLAUDE.md also names the gc skill, which the workflow check requires.

The commit is authored under the maintainer's identity with no AI trailer, following this repository's convention.

This takes the kit's managed files to its current version and adopts the two rules it added to
the CLAUDE.md skeletons.

The branch guard now also blocks `git commit` on the default branch and any push that would
update it, so `.claude/settings.json` wires the guard to Bash as well. The same file gains a
short deny list for force-pushes, sudo and reading `.env` files.

The new `gc` skill and `.claude/workflow/gc.py` remove worktrees and branches whose work is
already in the default branch and list the rest. The reviewer agent gains the review checklists
in `.claude/review-checklists.md`, and the handoff skill picks up the kit's latest wording.

CLAUDE.md now sizes each task first, so that a small change takes a short lane with no plan or
decisions entry, and it names the `gc` skill so that the workflow check passes.
@ryangswe
ryangswe merged commit 6233a6a into main Nov 7, 2026
4 checks passed
@ryangswe
ryangswe deleted the chore/sync-workflow-kit branch November 7, 2026 02:02
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