Require review fix commits and push follow-up replies

Author: nickmoreton

AGENTS.md

@@ -62,6 +62,7 @@ This file guides coding agents working in this repository. Keep it operational a
 - Update the PR title whenever the branch scope changes materially and the current title no longer describes the work accurately.
 - Update the PR description whenever behavior, tooling, documentation, or test coverage changes materially from the current summary.
 - The maintained PR body should cover the behavior change, docs or tooling updates, and verification performed.
+- When handling pull request review suggestions that require code changes, commit the fix, push the branch, and update the review reply after the branch reflects the final change set.
 - Treat the PR title, PR summary, and `CHANGELOG` entry as required closing steps before the branch is ready.
 
 ## Branch Workflow

CHANGELOG

@@ -6,6 +6,7 @@ All notable changes to this project will be documented in this file.
 
 - Document the `release` branch workflow and require merge requests to target `release`
 - Add agent instructions to keep pull request titles and summaries current and update the changelog on every PR
+- Require review-driven code changes to be committed, pushed, and followed by an updated review reply
 - Adopt `uv` as the default contributor workflow and lock the local development environment
 - Replace Black, isort, Flake8, and pyupgrade with Ruff for Python formatting and linting
 - Add Makefile help output plus dedicated `lint` and `format` targets

docs/developer.md

@@ -8,11 +8,6 @@ Pin or install the default contributor Python version:
 
 ```bash
 uv python install 3.12
-```
-
-Create and sync the project environment:
-
-```bash
 uv sync
 ```
 
@@ -24,17 +19,7 @@ Setup the app:
 
 ```bash
 uv run python manage.py migrate
-```
-
-Optional:
-
-```bash
 uv run python manage.py createsuperuser
-```
-
-Or use:
-
-```bash
 make superuser
 ```