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

Merged
Zayin_Admin merged 1 commits from docs/claude-md-report-findings into main 2026-10-14 04:18:43 +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 #19 here and Zayin/Ekklesia#97 and #98. The matching platform PR is Zayin/Ekklesia#99.

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 #19 here and Zayin/Ekklesia#97 and #98. The matching platform PR is Zayin/Ekklesia#99. 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:33 +00:00
docs(claude): file an issue for what you find outside the task
CI / lint (pull_request) Successful in 20s
CI / typecheck (pull_request) Successful in 20s
CI / test (pull_request) Successful in 31s
CI / build (pull_request) Successful in 24s
CI / package (pull_request) Successful in 28s
CI / integration (pull_request) Successful in 8m46s
41dbefe552
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 ba4821ec63 into main 2026-10-14 04:18:43 +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/Signage#20