28 lines
1.1 KiB
Markdown
28 lines
1.1 KiB
Markdown
---
|
|
name: shd-discussions
|
|
description: Use when the user asks to find, read, search, create or edit SHD discussion channels, topics, messages or attachments.
|
|
metadata: modules=discussions
|
|
---
|
|
|
|
# SHD discussions
|
|
|
|
See `references/discussion-contract.md` for the tool map and message safety
|
|
rules.
|
|
|
|
## Resolve and read
|
|
|
|
- Resolve the organization or project context before selecting a channel.
|
|
- Use `shd_list_discussion_channels` and `shd_list_discussion_topics` before
|
|
reading messages when an ID is not already known.
|
|
- Use bounded reads with `shd_list_discussion_messages` or
|
|
`shd_search_discussions`; preserve pagination and returned identifiers.
|
|
- Treat private channels and messages as server-authorized data. Do not infer
|
|
membership or quote content outside the returned scope.
|
|
|
|
## Mutations
|
|
|
|
Only create or edit a message, or upload an attachment, when the user asks for
|
|
that exact operation. Confirm the target topic, preserve the latest message
|
|
identity/version when available, and report the server result. Never delete or
|
|
rewrite discussion history by guessing a topic from its display name.
|