diff --git a/CLAUDE.md b/CLAUDE.md index c0ebb87..bd34fe5 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -18,6 +18,17 @@ Optional (recommended): enable git hooks: pre-commit install ``` +## Branching Workflow + +**IMPORTANT**: Every change must be developed on a new branch using a git worktree, then merged into `main` via pull request. + +1. Create a worktree with a new branch: `git worktree add ../AgenticLoop- -b ` +2. Work in the worktree directory, commit changes there. +3. Push the branch and open a PR to merge into `main`. +4. After the PR is merged, clean up: `git worktree remove ../AgenticLoop-` + +Never commit directly to `main`. All changes go through PR review. + ## CI GitHub Actions runs `./scripts/dev.sh precommit`, `./scripts/dev.sh test -q`, and strict typecheck on PRs.