mirror of
https://github.com/block/buzz.git
synced 2026-08-18 06:50:31 +02:00
docs(sprout-acp): add communication discipline rules to base prompt + deprecate --mention flag (#883)
This commit is contained in:
@@ -55,19 +55,14 @@ Write commands are unaffected. `--format json` (default) returns full fields.
|
||||
|
||||
## Communication Patterns
|
||||
|
||||
**Mentions that notify:** Always include `--mention <hex_pubkey>` for each person you `@`-mention in content. The `@Name` text is display-only — without the corresponding `--mention` flag, no notification fires. Look up pubkeys with `sprout users get --name <display_name>`.
|
||||
**Mentions that notify:** Use `@Name` directly in message content — the CLI auto-resolves channel members by name and adds the required p-tags. No `--mention` flag exists or is needed.
|
||||
|
||||
```bash
|
||||
# ✅ Correct — notification delivered
|
||||
sprout messages send --channel <UUID> --content "@Alice check this" \
|
||||
--mention deadbeef1234...
|
||||
|
||||
# ❌ Wrong — mention is cosmetic only, no notification
|
||||
# ✅ Correct — notification delivered automatically
|
||||
sprout messages send --channel <UUID> --content "@Alice check this"
|
||||
|
||||
# Multiple mentions
|
||||
sprout messages send --channel <UUID> --content "@Alice @Bob review please" \
|
||||
--mention <alice_hex> --mention <bob_hex>
|
||||
# Multiple mentions — same pattern
|
||||
sprout messages send --channel <UUID> --content "@Alice @Bob review please"
|
||||
```
|
||||
|
||||
## DM Management
|
||||
|
||||
Reference in New Issue
Block a user