Dev Workflow

Create a pull request based on a GitHub issue with analysis, implementation, QA, and PR creation

Check that all code has appropriate documentation and fix gaps

Lint, format, and optionally commit changes

Run tests iteratively fixing code or tests until all pass, then commit

Create a well-structured commit with conventional format and proper git identity

Perform a code review with linting, standards checking, and priority-ranked findings

Open a tmux split running diffview.nvim so the user can review the agent's recent changes. Use proactively after non-trivial edits, or when the user asks to "show the diff", "open a diff viewer", or similar.

Review and update project dependencies safely with incremental testing

Plan a patch release from recent issues. Triages what belongs in a patch, proposes a batch for approval, then opens a tracking issue with the version number, draft release notes and a checklist. Use when asked to plan or scope a patch release, cut a bugfix release, or work out what should go into the next x.y.Z.

Run the full pre-PR verification routine (format, lint, tests, type/package checks, coverage) in an isolated subagent so the main thread stays clean. Invoke this after a gh pr create is blocked by the pre-tool-use hook; report ready or unready back to the main thread.

Improve test coverage by identifying gaps and generating meaningful tests

Expert guidance for setting up and organizing research software projects following established patterns for R packages, Julia packages, and research projects