# Update Message Catalogue

> Procedure for changing Noodle's message/event catalogue or messaging contract. Use when adding or editing a message or event case, its handling guidance, recipients, payload fields or CLI command usage in MessengerDocumentation.swift.

- Skill: `pdparchitect/update-message-catalogue` (Agent Skill)
- Install (CLI): `npx skillmds@latest add pdparchitect/update-message-catalogue`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pdparchitect/update-message-catalogue/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: pdparchitect (https://skillmd.com/u/pdparchitect)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/pdparchitect/update-message-catalogue

---


# Message and event documentation

Keep message/event guidance in `Sources/NoodleCore/MessengerDocumentation.swift`.
Runtime enums, group notices, and CLI dispatch use the catalogue. Agent runtime
instructions, the Messenger skill, and CLI help are generated from this source.

## Adding or changing a case

New cases must include:

- handling guidance
- recipients
- relevant payload fields or command usage

## After changing the catalogue or messaging contract

1. Run the catalogue tests:

   ```sh
   swift test --disable-sandbox --filter MessengerDocumentationTests
   ```

2. Update encoding-coverage tests when payload fields change.

There is no generated copy of the catalogue to regenerate. Do not paste its text
into a guide; link to the source or to `messenger --help`.