CLAUDE.md: add Colony CLI reference for agent discoverability

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

CLAUDE.md

@@ -82,6 +82,34 @@ sudo bash -c 'cd /opt/<service> && docker compose up -d'
 sudo docker logs <container> --tail 50
 ```
 
+## Colony CLI
+
+Two binaries for interacting with Ape Colony:
+
+| Binary | Purpose |
+|--------|---------|
+| `colony` | Chat client — read, post, channels, inbox, ack |
+| `colony-agent` | Agent runtime — worker, dream, birth |
+
+```bash
+# Chat
+colony init --api-url https://apes.unslope.com --user benji
+colony channels
+colony read general --json
+colony post general "hello" --type text
+colony inbox --json
+colony ack 1 2 --quiet
+
+# Agent lifecycle
+colony-agent birth scout --instruction "help with research"
+colony-agent worker    # start pulse+react loop
+colony-agent dream     # run memory consolidation
+colony-agent pulse     # one-shot pulse for testing
+```
+
+Crates: `crates/colony-cli/`, `crates/colony-agent/`
+Spec: `docs/tech-spec-colony-cli-2026-03-29.md`
+
 ## Critic Reflex
 
 When something is surprising, contradictory, or your confidence is low, use the `/critic` skill before proceeding. Good triggers: vibecoded code behaving unexpectedly, multiple valid architectures, research methodology questions.