CRM Lifecycle Ops

crm-lifecycle-ops

Braze、Klaviyo、Iterable 向けの配信前 QA です。 すべてのメール、テキスト、プッシュ通知、アプリ内メッセージを、あらゆる種類の顧客としてコードでチェックしてから配信します。さらに、ライブアカウントで、変更によって何が壊れるか、どう構築するかを確認できます。

80 秒のデモ（音声をオンにしてください）：

https://github.com/user-attachments/assets/dc4e632c-f71e-43d5-8451-6e2a67b6471e

手作業でキャンペーンを作成するライフサイクル、CRM、マーケティングオペレーションチーム向けの Claude Code プラグイン（および CI 用 CLI）です。 メッセージのチェック機能は現在すべて利用できます。ライブアカウント機能は初期アルファ段階です（下のステータス欄を参照）。 読み取り専用で、何かを送信したり編集したりすることはありません。

30 秒で試す

アカウントも Claude Code も必要ありません。Node.js 20+ だけで、パッケージに同梱されているサンプルメール 4 件をチェックできます。

npx crm-lifecycle-ops check --demo

次に、自分のテンプレートを指定します：npx crm-lifecycle-ops check path/to/emails。これでメールをチェックできます。下記のプラグインでは、残りの機能も利用できます。すべてのチャネル、ライブアカウント、変更によって何が壊れるか、構築手順を確認できます。

できること

クイックスタート

Claude Code と Node.js 20+ が必要です。

/plugin marketplace add har5h98/crm-lifecycle-ops
/plugin install crm-lifecycle-ops@crm-lifecycle-ops

まずは組み込みのデモアカウントで試してみましょう。プラットフォームへのアクセスは必要ありません。

1. /refresh demo で架空のブランドの Braze ワークスペースを読み込みます。
2. /check-campaign Price Drop Alert でキャンペーン全体をチェックします。
3. /what-breaks loyalty_tier で変更による影響を確認します。

ご自身のアカウントを使う準備ができたら、次の操作を行います。

• /setup でチームのルールを登録します（約5分かかります。気に入っているメールを貼り付けると、そこから学習させることもできます）。
• /connect で読み取り専用キーを追加します。キーはプラグインの設定とシステムのセキュアストレージに保存され、チャットには保存されません。

{
  "mcpServers": {
    "crm-lifecycle-ops": {
      "command": "npx",
      "args": ["-y", "crm-lifecycle-ops"],
      "env": { "CLO_BRAZE_API_KEY": "…", "CLO_BRAZE_REST_ENDPOINT": "https://rest.iad-01.braze.com" }
    }
  }
}

npx crm-lifecycle-ops check emails/ --rules team-rules.json

# .github/workflows/email-qa.yml
on: pull_request
jobs:
  email-qa:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npx -y [email protected] check emails/ # pin a version so new checks don't change your build

アルファ版（初期段階）です。 デモアカウントとモック API レスポンスを使った動作はすべて確認済みです。実際のアカウントでの実地テストはまだ行っていません。結果に誤りがある場合は、/report-problem でテストと修正を作成できます。

使用例

デモアカウントでの実際の出力：

/check-campaign Price Drop Alert          🔴 Don't send. 1 blocking problem

fail  links.non-production-host        "See items" points at staging.fernbrook.example
warn  personalization.dangling-punct.  Someone with no first name on file sees "Hi ,"
warn  html.img-missing-alt             1 image has no alt text
warn  a11y.no-lang                     No lang attribute, so screen readers guess the language

/check-sms Flash Sale Text                🟡 Fix before sending

warn  sms.unicode            "’" and "—" switch the text to Unicode: 70 characters per segment, not 160.
                             Swap ’ → ' and — → -
warn  sms.too-many-segments  Up to 3 billed segments; house limit is 2
warn  sms.no-opt-out         No "Reply STOP to opt out"

合否の判定はすべてコードが行い、AI は一切関与しません。 Claude はその上に、ラベル付きの参考レビュー（件名、CTA、トーン）を追加します。ローンチチケット用の記録が必要ですか？ /check-campaign に QA 承認レポートを依頼してください。すべての指摘事項、検証できなかった項目、レビュアーの承認をまとめた Markdown ファイルが作成され、Jira、Slack、Notion にそのまま貼り付けられます。

すべてのコマンド

✅ 現時点ですべての機能が動作します · 🧪 デモアカウントとモック API では動作しますが、実アカウントではまだ実地テストされていません

詳細

メッセージの送信やアカウントの編集は行いません。顧客プロフィールを読み取ることもありません（架空の顧客を使ってテストします）。作者や第三者に情報を送信することもありません。

API キーはプラグインの設定（セキュアストレージ）からのみ読み取ります。SECURITY.md と プライバシーポリシーをご覧ください。

詳しくはこちら

• オペレーターガイド：セットアップ、ビルドの各ステップ、週次レビューのための1ページの手順書です。
• 仕組み：アーキテクチャ、データフロー、設計上の判断を平易な言葉で説明します。

改善の仕組み

1. 問題を報告します： /report-problem を使うと、誤った結果を編集済みの GitHub Issue にできます（投稿前に確認を求めます）。
2. テストに追加されます： 確認済みの各報告は tests/corpus/ に追加され、以降は必ずテストに合格する必要があります。
3. 修正案を自動で作成します： Claude がテストと修正案を作成し、人間がレビューするプルリクエストとして提出します。
4. ベンダーの変更を監視します： 週次ジョブで Braze、Klaviyo、Iterable の API の変更を確認し、月次ジョブでチェックリストを作成して、ベンダーのドキュメントに照らしてビルド手順と編集ガイドを再確認します。各プランには手順を最後に検証した日付が記載され、90日以上経過すると警告が表示されます。

誤った結果を報告することが、最も価値のある貢献になります。CONTRIBUTING.mdをご覧ください。

ライセンス

MIT。Braze、Klaviyo、Iterable とは提携しておらず、各社からの推奨も受けていません。製品名は各所有者の商標です。