Skip to main content

GOV 03 COMMUNICATION

This page embeds the canonical rule text and adds commentary after each section to explain why the section exists.

Governance: Communication

Commentary: Makes delivery communication actionable, concise, and consistent.

Default Style

  • concise, direct, professional
  • decision-oriented over status-noise
  • explicit about assumptions, risks, and blockers

Commentary: Captures a specific delivery control so contributors and agents apply this rule consistently.

Required Communication Events

Communicate clearly when:

  1. starting scoped work,
  2. changing scope/approach,
  3. hitting a blocker,
  4. completing verification,
  5. handing off.

Commentary: Makes delivery communication actionable, concise, and consistent.

Good Update Format

Use compact, auditable updates:

  • Intent: what outcome is being pursued
  • Change: what was modified
  • Evidence: what proves it works
  • Risk/Gap: what remains uncertain
  • Next: recommended follow-up

Commentary: Captures a specific delivery control so contributors and agents apply this rule consistently.

Escalation Communication

Escalate immediately when blocked by missing decisions, credentials, environment access, or conflicting requirements.

Escalation must include:

  • blocker summary
  • impact
  • concrete decision/options needed

Commentary: Makes delivery communication actionable, concise, and consistent.

Anti-Patterns to Avoid

  • vague "done" claims without evidence
  • hidden scope expansion
  • silent behavior changes not reflected in docs/specs
  • repetitive low-value chatter

Commentary: Captures a specific delivery control so contributors and agents apply this rule consistently.

Documentation Communication

When changing governance/project docs:

  • explain the intent shift
  • link related files changed
  • note migration or compatibility impact

Commentary: Makes delivery communication actionable, concise, and consistent.