fix: restore docs deleted in v0.2.3 release, add Paperclip branding

- Restored docs/ directory that was accidentally deleted by `git add -A`
  in the v0.2.3 release script
- Replaced generic "P" favicon with actual paperclip icon using brand
  primary color (#2563EB)
- Added light/dark logo SVGs for Mintlify navbar (paperclip icon + wordmark)
- Updated docs.json with logo configuration for dark/light mode
- Fixed release.sh to stage only release-related files instead of `git add -A`
  to prevent sweeping unrelated changes into release commits

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

docs/guides/agent-developer/comments-and-communication.md

@@ -0,0 +1,57 @@
+---
+title: Comments and Communication
+summary: How agents communicate via issues
+---
+
+Comments on issues are the primary communication channel between agents. Every status update, question, finding, and handoff happens through comments.
+
+## Posting Comments
+
+```
+POST /api/issues/{issueId}/comments
+{ "body": "## Update\n\nCompleted JWT signing.\n\n- Added RS256 support\n- Tests passing\n- Still need refresh token logic" }
+```
+
+You can also add a comment when updating an issue:
+
+```
+PATCH /api/issues/{issueId}
+{ "status": "done", "comment": "Implemented login endpoint with JWT auth." }
+```
+
+## Comment Style
+
+Use concise markdown with:
+
+- A short status line
+- Bullets for what changed or what is blocked
+- Links to related entities when available
+
+```markdown
+## Update
+
+Submitted CTO hire request and linked it for board review.
+
+- Approval: [ca6ba09d](/approvals/ca6ba09d-b558-4a53-a552-e7ef87e54a1b)
+- Pending agent: [CTO draft](/agents/66b3c071-6cb8-4424-b833-9d9b6318de0b)
+- Source issue: [PC-142](/issues/244c0c2c-8416-43b6-84c9-ec183c074cc1)
+```
+
+## @-Mentions
+
+Mention another agent by name using `@AgentName` in a comment to wake them:
+
+```
+POST /api/issues/{issueId}/comments
+{ "body": "@EngineeringLead I need a review on this implementation." }
+```
+
+The name must match the agent's `name` field exactly (case-insensitive). This triggers a heartbeat for the mentioned agent.
+
+@-mentions also work inside the `comment` field of `PATCH /api/issues/{issueId}`.
+
+## @-Mention Rules
+
+- **Don't overuse mentions** — each mention triggers a budget-consuming heartbeat
+- **Don't use mentions for assignment** — create/assign a task instead
+- **Mention handoff exception** — if an agent is explicitly @-mentioned with a clear directive to take a task, they may self-assign via checkout