docs: update Claude docs from PR review analysis

[claude]

Summary

Weekly analysis of PR comments (2026-06-22 -> 2026-06-29).
Analyzed 8 PRs with 77 review threads. Found 4 actionable insights.

Changes

agent_docs/conventions.md

• Inline code comments must be concise — added a Code style rule noting that comments should express what is non-obvious in a short phrase, not restate the code or add multi-sentence commentary.
  Source: PR fix: rewrite SDK field names in OData options for remaining services [PLT-106297] #548 — reviewer noted that Claude-generated inline comments were excessively verbose.

• Timestamp field naming: *Time suffix only, never *At — added under Standard field renames. All timestamp fields in SDK response types must use *Time (e.g., endedTime), not *At (e.g., endedAt).
  Source: PR feat: allow to emit end exchange event from client for stopping response #510 — reviewer (copilot) flagged that new Exchange.endedAt broke consistency with createdTime/updatedTime across the entire SDK.

agent_docs/rules.md

• Never use unexplained abbreviations/acronyms in JSDoc — added to JSDoc quality rules. Spell out full forms; introduce abbreviated forms with the full name first.
  Source: PR feat(agents): summary & distribution services (5/5) [PLT-103787] #535 — reviewer flagged undocumented acronyms AGU and PLTU in JSDoc comments; author expanded them.

• Never use @internal on individual fields of a public interface — added to JSDoc quality rules. TypeDoc omits the field from docs but TypeScript consumers still see it in IDE autocomplete. @internal belongs only on whole declarations.
  Source: PR feat: allow to emit end exchange event from client for stopping response #510 — reviewer noted that @internal endedAt on a field in the public Exchange interface misleads consumers who still get IDE completion for it.

No changes

• CLAUDE.md — no relevant insights found
• Agents.md — no relevant insights found
• agent_docs/architecture.md — no relevant insights found

PRs Analyzed

PR	Title	Comments
#548	fix: rewrite SDK field names in OData options for remaining services	7
#508	feat: add client-side tool support	4
#510	feat: allow to emit end exchange event from client for stopping response	12
#487	feat(maestro): add getIncidentsTimeline to MaestroProcesses and Cases	8
#478	feat(insights): add getInstanceStats to MaestroProcesses and Cases	13
#536	fix: rewrite SDK field names in OData filter/orderby/select/expand	16
#535	feat(agents): summary & distribution services (5/5)	24
#545	chore: bump version to 1.5.0	0

[claude]

✅ No issues found. Checked for bugs and CLAUDE.md compliance.