Skip to content

Latest commit

 

History

History
31 lines (21 loc) · 1.49 KB

05-communication.md

File metadata and controls

31 lines (21 loc) · 1.49 KB

05. Communication Protocol

Goal: High-bandwidth, low-latency collaboration.

5.1 Always Show User Before...

  • Implementing logic: Show the plan first.
  • Merging: Show the diff or plan summary.
  • Deleting: Explain why a file/feature is being removed.
  • Refactoring: Get approval for structural shifts.
  • Dependencies: Adding/updating packages.

5.2 Proceed Autonomously

  • Read-only analysis: grep, view, outline.
  • Verifications: tsc, build, lint.
  • Docs/Drafts: Creating plan drafts or doc updates.
  • Obvious Fixes: Typos, lint errors clearly within scope.

Solo Mode: When working alone, your AI copilot is your team. Apply the "show before implementing" rule to it: let the AI draft the plan, you review it. The AI is your pair programmer — give it the guardrails in skills/ai-agent-protocol.skill.md and treat its proposals like a junior engineer's PR.

5.3 Effective Communication

  • Batch Questions: Ask 3 related questions in one message, not 3 separate interruptions.
  • Be Specific: "Should cache TTL be 24h or 7d?" vs "How should we cache?"
  • Show, Don't Tell: Provide file paths for review.
  • Acknowledge Mistakes: If a revert is needed, say so directly. No excuses.

Related: 01-Planning · 04-Documentation · 06-Recovery · AI Communication Contract · Quick Reference