| name | nextsession |
| description | Use when starting or resuming a work session on the bmlib project, to load current project state and re-establish the coding rules and session workflow before doing any work. |
| disable-model-invocation | true |
| allowed-tools | Read, Edit, Bash(git add *), Bash(git commit *), Bash(git push *), Bash(git status *), Bash(git diff *), Bash(gh issue *), Bash(gh pr *), Bash(uv run pytest *), Bash(uv pip install *), Bash(ruff *), Bash(uv run ruff *) |
read HANDOVER.md and follow the instructions. Ask me if you have any questions.
Our general coding rules live in CLAUDE.md — read and honour them. On top of those, follow this session workflow:
- All tests must pass before committing, unless I explicitly give permission otherwise. Run the suite with
uv run pytest tests/ -v, and lint with ruff check . and ruff format --check ..
- Before you start working, make sure HANDOVER.md and ROADMAP.md represent the current state of progress and are up to date. If not, update them before you start.
- Avoid technical debt — if you find an error, fix it when possible; otherwise lodge it as an issue on GitHub.
- When you are done, update HANDOVER.md and ROADMAP.md to reflect the current state of development and progress. Prune both to stay concise and under 500 lines if possible: focus on what still needs doing, and summarise briefly what has already been done. If you are not sure how to do this, ask me.
- When the task is complete, commit all changes, push, and open a PR to the main branch. Link the PR to the relevant GitHub issue if applicable, and include a clear description of the changes made and any relevant context for reviewers. If you are not sure how to do this, ask me.
