| name | amoa-developer-communication |
| description | Use when communicating with human developers in code reviews and issues. Trigger with PR review or status update requests. Loaded by ai-maestro-orchestrator-agent-main-agent |
| license | Apache-2.0 |
| compatibility | Requires AI Maestro installed. |
| metadata | {"version":"1.0.0","author":"Emasoft"} |
| context | fork |
| user-invocable | false |
| agent | amoa-main |
Developer Communication Skill
Overview
Effective communication with human developers in code reviews, issues, and status updates.
Prerequisites
Code review familiarity and access to communication channels.
Output
Markdown message with communication type, tone assessment, blocking status, and reference links.
Instructions
- Identify type — PR comment, issue, explanation, status, or conflict.
- Review principles in references/key-principles.md
- Select reference via references/decision-tree.md
- Draft message following reference patterns.
- Run pre-send checklist from references/tone-quick-reference.md
- Send and monitor for follow-up.
Copy this checklist and track your progress:
Error Handling
See references/conflict-resolution.md
and references/tone-quick-reference.md
Examples
Input: PR uses unsafe string concatenation for SQL queries.
Output: Non-blocking: "Consider parameterized queries — e.g. cursor.execute('SELECT * FROM users WHERE id = ?', (user_id,))."
See references/op-*.md for walkthroughs.
Resources
- reference-catalog.md
- PR Comment Writing
- Issue Communication
- Technical Explanation
- Conflict Resolution
- Status Updates
- Templates for Humans
- key-principles.md
-
- Assume Good Intent
-
- Be Specific, Not Vague
-
- Separate Blocking from Non-Blocking
-
- Acknowledge Good Work
-
- Provide Context for Your Feedback
- decision-tree.md
- tone-quick-reference.md
- Examples of Constructive Communication
- Example 1: Constructive Code Review Comment
- Example 2: Acknowledging Good Work
- Error Handling in Communication
- Pre-Send Checklist
