code-author ✍️

Keyword: author | Platforms: gemini,claude,codex

Expert AI Agent Skill for Code Authoring - Best practices for creating, describing, and refining code changes based on Google's Engineering Practices.

🎯 Core Mandates (The Author's Rules)

• Small CLs Only: Keep changes focused on ONE thing. Small CLs are easier to review, faster to merge, and lower risk.
• Clear Descriptions: Always explain WHAT is changing and WHY. The "How" should be evident from the code, but the "Why" is critical context.
• Risk Areas Identification: Explicitly call out parts of the code where you are unsure or where there is a high risk of side effects.
• No Refactor + Feature Mix: Never mix refactoring with new features or bug fixes. These must be separate CLs.
• Proactive Communication: Address all reviewer comments, even if you disagree. Explain your reasoning clearly and professionally.
• Self-Audit First: Run the "Self-Audit Checklist" before sending a CL for review.

🛠 Authoring Workflows