- Each body of work must begin in a new git worktree created with
git worktree, not a branch in the main checkout. - Create each worktree inside the repository root under
worktrees/<body-of-work>. - Run ALL commands from inside the worktree directory, never from the root checkout.
- When work is complete and merged, remove only the specific
worktrees/<body-of-work>directory created for that body of work. - Do not delete, prune, or modify any other directories under
worktrees/. - Use
fff-mcpto find files. - Use the git-commit skill for creating commits. Always use -sS
- Use context7 to search for documentation and verify implementation
- MOST IMPORTANT — At the end of EVERY change, BEFORE informing the user to run the pipeline, ALWAYS run:
cargo fmt && cargo check && cargo clippy --all-targets --all-features -- -D warningscargo test --all-targets --all-features
- NEVER tell the user to run the Opal pipeline without first verifying that ALL checks AND ALL tests pass.
- If clippy/check/tests fail, fix ALL errors before proceeding.
- This is the highest priority rule. Do not skip this step.
- The CI pipeline uses
rust:1.88image. To catch all CI clippy errors locally, ensure the project'sclippy.tomlis present and run clippy with the same flags as CI:cargo clippy --all-targets --all-features -- -D warnings