genflow-teams

genflow-teams

Lightweight plugin for sending Teams messages with AI-assisted drafting and fail-closed AI review.

Works with both Copilot CLI and Claude Code (same plugin structure).

v1 scope: self-send only — messages are sent to your own "Notes to Self" chat via Teams MCP. You review and manually forward to the intended recipient.

Flow

User context → AI draft (recipient + HTML message + reason) → AI review (fail-closed) → Send to self via Teams MCP

Quick Start

# Invoke the skill:
/genflow-teams:send remind Alice that tomorrow's standup is moved to 10am

# With more context:
/genflow-teams:send tell Alice the PR feedback has been addressed, ask for re-review

Prerequisites

1. Teams MCP (required)

Add to ~/.copilot/mcp-config.json (Copilot CLI) or .vscode/mcp.json (VS Code):

{
  "mcpServers": {
    "microsoft-teams": {
      "url": "https://agent365.svc.cloud.microsoft/agents/tenants/72f988bf-86f1-41af-91ab-2d7cd011db47/servers/mcp_TeamsServer",
      "type": "http"
    }
  }
}

Auth uses your Microsoft tenant identity automatically. The tenant ID 72f988bf-... is Microsoft's public tenant — this is the correct value for Microsoft corp accounts.

See Microsoft MCP documentation for setup details.

2. Copilot CLI or Codex CLI (at least one required)

The review gate uses Copilot CLI (copilot -p -s) if available, falls back to Codex CLI (codex exec). If neither is found, the skill will NOT send the message.

• Copilot CLI: comes with GitHub Copilot (preferred — same tool that runs this plugin)
• Codex CLI fallback: npm install -g @openai/codex

Structure

├── .claude-plugin/plugin.json   # Plugin metadata
├── commands/send.md             # /genflow-teams:send command entry
├── skills/teams-send/SKILL.md   # Core skill (flow: draft → review → send)
├── scripts/
│   ├── review-message.sh        # AI review gate (Copilot CLI → Codex fallback)
│   └── review-message.cmd       # Windows launcher
├── config/
│   └── default_config.json      # Defaults (tone, codex model)
└── .genflow/teams/
    ├── drafts/                  # Message drafts (md files)
    ├── history/                 # Audit trail (JSON per invocation)
    └── reviews/                 # Review results

Review Gate

The review gate is fail-closed (uses Copilot CLI, falls back to Codex):

• APPROVED → send to self
• REVISION_NEEDED: <suggestions> → revise and retry (max 2 retries)
• REJECT: <reason> → stop, do not send
• Any error / timeout / invalid output → stop, do not send

There is no auto-approve. If both Copilot CLI and Codex are down, the message is not sent.

Audit Trail

Every invocation (sent, rejected, or failed) produces a JSON file in .genflow/teams/history/ with: run_id, timestamp, intended_recipient, message_html, reason, review_result, status, teams_message_id.

Plugin vs Skill

• Plugin = this installable package
• Skill = teams-send, the single capability within this plugin
• Compare: Humanize = 1 plugin + ~5 skills. This = 1 plugin + 1 skill.