awiki Group Skill

CRITICAL — Read ../awiki-shared/SKILL.md first.

Use This Skill For

• creating a group
• joining or leaving a group
• adding or removing members
• updating group profile or policy fields
• inspecting members or group messages

Core Concepts

• group: first-class resource with its own DID and policy
• membership: who is in the group and with what role
• discoverability: visibility and discovery policy
• admission mode: how members enter the group
• group messages: read path for group content; sending still uses msg send --group

Resource Model

• Identity -> Group -> Members
• Group -> Policy Fields
• Group -> Group Messages

Decision Rules

• need to create a group -> group create
• need to inspect metadata or policy -> group get
• need to join an existing open group -> group join
• need to add or remove one member -> group add / group remove
• need to change name, description, or policy -> group update
• need to send text into the group -> route to ../awiki-msg/SKILL.md

Canonical Commands

• awiki-cli group create --name "Agent War Room" [...]
• awiki-cli group get --group <group_did>
• awiki-cli group join --group <group_did> [--reason "..."]
• awiki-cli group add --group <group_did> --member <did|handle> [--role ...] [--reason "..."]
• awiki-cli group remove --group <group_did> --member <did|handle> [--reason "..."]
• awiki-cli group leave --group <group_did>
• awiki-cli group update --group <group_did> [--name ...] [--description ...] [...]
• awiki-cli group members --group <group_did> [--limit <n>]
• awiki-cli group messages --group <group_did> [--limit <n>] [--cursor <cursor>]

Common Patterns

Create with dry run first

1. awiki-cli group create --name "Agent War Room" --dry-run
2. awiki-cli group create --name "Agent War Room"

Review before membership mutation

1. awiki-cli group get --group <group_did>
2. awiki-cli group members --group <group_did>
3. awiki-cli group add --group <group_did> --member <did> --dry-run
4. awiki-cli group add --group <group_did> --member <did>

Side Effects and Confirmation

Command family	Effect	Confirmation rule
group create	creates a new group resource	explicit confirmation
group join	mutates membership state	explicit confirmation
group add / group remove	mutates membership state	explicit confirmation
group leave	removes the active identity from membership	explicit confirmation
group update	mutates group metadata or policy	explicit confirmation

Error Handling

• missing or malformed group identifier -> inspect awiki-cli schema group <subcommand>
• access or role issue -> inspect group get and group members first
• transport or auth issue -> route to runtime or identity skill as needed

Implementation Notes

• group is a standalone domain in the current repo.
• group messages is read-only inspection; sending remains in msg send --group.

References

• docs/architecture/awiki-v2-architecture.md
• docs/architecture/awiki-command-v2.md