Merge pull request 'docs(claude): file an issue for what you find outside the task' (#99) from docs/claude-md-report-findings into main

Reviewed-on: #99 Reviewed-by: Zayin_Admin <[email protected]>
2026-10-14 04:23:04 +00:00
parent 63fda0f8d6 0552442c7c
commit 9bef1d9ef2
1 changed files with 7 additions and 0 deletions
@@ -108,6 +108,13 @@ your own memory of a prior session** — treat stale assumptions as a bug to cat
 - Never run a database migration automatically (on import, on startup, in a test that isn't
  explicitly a migration test, or as a side effect of an unrelated command). Migrations are always
  an explicit, operator-invoked action.
 - Report what you find. A defect, flaky test, documentation/ADR conflict, or CI problem outside the
  task at hand gets an issue in the repository it belongs to, as soon as you find it. Search for an
  existing issue first; something fixed in the same PR goes in that PR's description instead. Be
  descriptive: what you saw, the evidence (run and job links, commit, file and line), how to
  reproduce it, the impact, and options, and never a secret. Label it `found-by-claude` (an agent
  that cannot apply labels ends the body with a line saying so), leave it unassigned, and list what
  you filed when you report back.
 ## Canonical verification commands