docs: 规范 Agent 的小步提交与 PR 边界

2026-09-09 20:08:00 +00:00
parent 7782b1e75d
commit 0a14dded9d
1 changed files with 20 additions and 0 deletions
@@ -1,5 +1,25 @@
 # postgresql-tenant-operator - AI Agent Guide
 ## Human-Reviewable Changes
 - Break every feature into small, coherent changes that a human can review independently.
 - Keep each change focused on one behavior or decision; do not mix unrelated refactors,
  formatting churn, dependency updates, or cleanup into a feature change.
 - Keep the project buildable and its relevant tests passing after each change whenever
  practical. Add or update focused tests alongside the behavior they verify.
 - Present generated files together with the source API or marker change that produced them,
  and call out generated diffs explicitly instead of treating them as separate design work.
 - Prefer a sequence of narrow vertical slices over one large implementation. Summarize the
  intent, observable behavior, and verification for each slice so a human can review it
  before the next slice grows on top of it.
 - A pull request may contain multiple small commits. Align each commit with one coherent,
  independently reviewable change.
 - When a change reaches a suitable commit boundary, ask the user whether to create the
  commit before committing it. Do not accumulate unrelated completed changes merely to
  reduce the number of commits.
 - Always stop and ask the user before opening or submitting a pull request. Approval to
  create commits or push a branch does not imply approval to create a pull request.
 ## Project Structure
 **Single-group layout (default):**