Repository navigation
feat: add braid-housekeeping skill and PR-based git workflow - #26
Merged
Merged
Conversation
The skill runs periodic chores from the `cargo xtask housekeeping` report and finishes with one PR for human review. It checks the lockfile before building, because building runs new dependency code, and holds samod and automerge back from routine bumps. It only runs when explicitly invoked, since invoking it authorizes a push. A drift test keeps it in step with the report's checks. `main` now requires PRs, so CLAUDE.md allows pushing fresh branches and opening PRs, while merges, tags, force-pushes and remote branch deletion still need asking. braid-release now goes through a PR too. Strand: br-housekeeping-skill-bcsrqdwa Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Agent instructions should keep working as the project gains maintainers. Also, agents can now push branches themselves, so `cargo xtask ci` is simply what to run before pushing. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Adds the
braid-housekeepingskill, which runs periodic chores from thecargo xtask housekeepingreport and finishes with one PR for you to review. Sincemainnow requires PRs, this also updates the git rules.Please check closely
These change what agents are allowed to do:
CLAUDE.md: pushing fresh non-default branches and opening PRs no longer needs asking. Merging, creating or pushing tags, force-pushing and deleting remote branches still do, and pushing directly tomainis out.housekeeping/<date>branch and one PR. It hasdisable-model-invocation: true, so it only runs when explicitly invoked.braid-release: a release now goes through arelease/vX.Y.ZPR, with the tag pushed after it merges. Step 6 used to push tomain, which the ruleset now blocks.How the skill works
samodandautomerge: held back from routine bumps, because they can affect stored data and the sync format.braid-viewer, whichcargo xtask ciskips but which shares the lockfile.Testing
cargo xtask cipasses.Not safe for unattended runs yet
This suits a run you're watching. Before unattended runs, the plan lists a separate identity, a sandbox, a
v*tag ruleset, and moving the signing key into a protected environment. At 0 required approvals with your token, only the skill's instructions keep it from merging.Strand:
br-housekeeping-skill-bcsrqdwa. Plan:claude-notes/plans/2026/11/01/housekeeping-skill.md.🤖 Generated with Claude Code