Skip to content

Address recurring AI review findings in policy and agent snippets - #774

Merged
kesselb merged 1 commit into
masterfrom
docs/noid/ai-policy--code-quality-refinement
Aug 10, 2026
Merged

Address recurring AI review findings in policy and agent snippets#774
kesselb merged 1 commit into
masterfrom
docs/noid/ai-policy--code-quality-refinement

Conversation

@AndyScherzinger

Copy link
Copy Markdown
Member

Incorporate the code comment conventions from nextcloud/notes#1982 and generalize recurring review feedback on AI-assisted PRs:

  • Code comments must document the code, never the process that produced it; keep them brief and matching surrounding density
  • Reuse existing helpers instead of duplicating logic, and fix every occurrence of a flawed pattern
  • Run permission/access-control checks before the guarded operation
  • Wire up and test features in every reachable context (public shares, Smart Picker/reference widgets), not only the default authenticated view
  • Remove malformed/garbled characters from generated output

Assisted-by: Claude Code:claude-fable-5

🤖 AI (if applicable)

  • The content of this PR was partly or fully generated using AI

Incorporate the code comment conventions from nextcloud/notes#1982 and
generalize recurring review feedback on AI-assisted PRs:

- Code comments must document the code, never the process that
  produced it; keep them brief and matching surrounding density
- Reuse existing helpers instead of duplicating logic, and fix every
  occurrence of a flawed pattern
- Run permission/access-control checks before the guarded operation
- Wire up and test features in every reachable context (public
  shares, Smart Picker/reference widgets), not only the default
  authenticated view
- Remove malformed/garbled characters from generated output

Assisted-by: Claude Code:claude-fable-5
Signed-off-by: Andy Scherzinger <info@andy-scherzinger.de>
@AndyScherzinger AndyScherzinger added 3. to review Waiting for reviews documentation Improvements or additions to documentation AI assisted This PR contains AI-assisted commits labels Aug 10, 2026
@kesselb
kesselb merged commit c009c81 into master Aug 10, 2026
6 checks passed
@kesselb
kesselb deleted the docs/noid/ai-policy--code-quality-refinement branch August 10, 2026 12:28
AndyScherzinger added a commit to nextcloud/files_mindmap that referenced this pull request Aug 10, 2026
AsherBond pushed a commit to AsherBond/talk-android that referenced this pull request Aug 14, 2026
…#774

Incorporate the updated agent policy snippet: code comments must
document the code rather than the process that produced it, existing
helpers must be reused and flawed patterns fixed everywhere, permission
checks must run before the guarded operation, user-facing changes must
be wired up in every reachable context, and garbled characters must be
cleaned up before submission.

Assisted-by: Claude Code:claude-fable-5
Signed-off-by: Andy Scherzinger <info@andy-scherzinger.de>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3. to review Waiting for reviews AI assisted This PR contains AI-assisted commits documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants