docs(claude): file an issue for what you find outside the task #99

Merged
Zayin_Admin merged 1 commits from docs/claude-md-report-findings into main 2026-10-14 04:23:04 +00:00
Member

Adds one bullet to CLAUDE.md → Working conventions: when an agent finds a defect, flaky test, doc/ADR conflict, or CI problem outside its task, it opens a descriptive issue in the repository the problem belongs to and keeps working. It searches for an existing issue first, marks the issue found-by-claude, leaves it unassigned, and lists what it filed when it reports back.

Requested by the maintainer so findings are tracked where everyone can see them, not lost in chat. The first three are #97, #98, and Zayin/Signage#19. A matching PR goes to Zayin/Signage.

Docs only; no code or tests change.

Note: ekklesia-bot can open issues and create labels but gets "write permission is required" when applying a label to an issue. Until its team has issue write access, agents mark issues with a footer line instead.

🤖 Generated with Claude Code

Adds one bullet to `CLAUDE.md` → **Working conventions**: when an agent finds a defect, flaky test, doc/ADR conflict, or CI problem outside its task, it opens a descriptive issue in the repository the problem belongs to and keeps working. It searches for an existing issue first, marks the issue `found-by-claude`, leaves it unassigned, and lists what it filed when it reports back. Requested by the maintainer so findings are tracked where everyone can see them, not lost in chat. The first three are #97, #98, and Zayin/Signage#19. A matching PR goes to Zayin/Signage. Docs only; no code or tests change. Note: `ekklesia-bot` can open issues and create labels but gets "write permission is required" when applying a label to an issue. Until its team has issue write access, agents mark issues with a footer line instead. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
ekklesia-bot added 1 commit 2026-10-14 03:58:19 +00:00
docs(claude): file an issue for what you find outside the task
CI / verify (pull_request) Successful in 1m12s
CI / infrastructure-smoke (pull_request) Successful in 28s
CI / package-release (pull_request) Successful in 53s
CI / package-publication (pull_request) Successful in 1m3s
CI / image-build (pull_request) Successful in 1m1s
CI / deploy-smoke (same-origin) (pull_request) Successful in 59s
CI / deploy-smoke (split) (pull_request) Successful in 2m35s
CI / migration-smoke (pull_request) Successful in 2m9s
0552442c7c
Findings that only live in a chat reply get lost. Agents now open a
descriptive issue in the repository a problem belongs to (after
searching for an existing one), mark it found-by-claude, leave it
unassigned, and list what they filed when they report back.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Zayin_Admin merged commit 9bef1d9ef2 into main 2026-10-14 04:23:04 +00:00
Zayin_Admin deleted branch docs/claude-md-report-findings 2026-10-14 04:23:04 +00:00
Sign in to join this conversation.
No Reviewers
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Zayin/Ekklesia#99