developer-email-sequences

開発者向けメールシーケンス

このスキルは、開発者が実際に読んでくれるメールシーケンスの作成を支援します。スパムも、無駄な内容もありません。適切な頻度で、役立つ情報だけを届けます。

---

始める前に

1. 開発者オーディエンスのコンテキストを読み込む：

   • .agents/developer-audience-context.md が存在するか確認します
   • 存在しない場合は、先に developer-audience-context スキルを実行します
   • 効果的なメールを作成するには、開発者の技術スタック、課題、コミュニケーションの好みを理解することが不可欠です

2. 既存のメールを監査する：

   • 現在、どのようなメールを送っていますか？
   • 開封率、クリック率、配信停止率はどのくらいですか？
   • メールについて、開発者から何かフィードバックはありましたか？

---

開発者とメールの実情

開発者はメールに対して容赦がありません：

行動	意味すること
プレビューペインで確認する	件名と最初の1行がすべてです
ためらわずに配信停止する	関係のないメールが1通届いただけで、配信停止されます
プレーンテキストを好む	HTMLよりもプレーンテキストを好む人が大勢います
コードスニペットが好き	役立つコード例はクリックされます
トランザクションメールを信頼する	「ニュースレター」ではなく、領収書を開封します

黄金律：すべてのメールで、すぐに役立つ情報を提供するか、問題を解決する必要があります。

---

メールシーケンスの種類

1. オンボーディングシーケンス

目標：開発者に初めての「Hello World」を体験してもらいます。

タイミング：

• メール1：登録直後
• メール2：24時間後（アクティベーションされていない場合）
• メール3：3日後（アクティベーションされていない場合）
• メール4：7日後（アクティベーションされていない場合）
• アクティベーションされたら停止します

構成：

メール	目的	内容
ウェルカム	登録を確認し、明確なCTAを1つ提示	クイックスタートへのリンクのみ
最初のリマインド	よくある障害に対処	「多くの開発者がつまずくのは、ここです……」
価値の再確認	何ができるかを示す	顧客事例またはコードスニペット
最後の案内	直接問いかける	「お困りですか？このメールに返信してください」

テンプレート：ウェルカムメール

Subject: Your API key is ready

Hey [NAME],

Your API key: [KEY]

Quickstart (2 minutes):
[LINK TO QUICKSTART]

That's it. Hit reply if you get stuck.

— [SENDER NAME]

テンプレート：最初のリマインド

Subject: Quick question about your setup

Hey [NAME],

Noticed you haven't made your first API call yet.

Where'd you get stuck?

[ ] Didn't have time yet
[ ] Confused about authentication
[ ] Can't find the right SDK
[ ] Something else

Just reply — I read every response.

— [SENDER NAME]

2. アクティベーションシーケンス

目標：初回利用者を継続利用者にします。

トリガー：初めてAPI呼び出しまたは統合に成功した後。

タイミング：

• メール1：初回成功直後
• メール2：3日後
• メール3：7日後
• メール4：14日後

構成：

メール	目的	内容
成功を祝う	進捗を認める	「初めての呼び出しが成功しました！」
次のステップ	自然な次の段階を示す	「次にXを行う開発者が多いです……」
詳細機能	高度な機能を紹介する	チュートリアルまたはコード例
統合	本番環境での利用を提案する	事例またはデプロイガイド

3. 変更履歴／製品アップデートのメール

目標：開発者に過剰な情報を与えず、最新情報を伝えます。

頻度：週次ダイジェストまたはリリースごと（週2回を超えないこと）。

構成：

Subject: [Product] v2.3 — Faster webhooks, TypeScript 5 support

What's new:

## Breaking changes (read first)
- Webhook signature algorithm changed (migration guide)

## New
- TypeScript 5.0 support
- Batch API for bulk operations

## Improved
- Webhook delivery 3x faster
- Better error messages for auth failures

## Fixed
- Memory leak in long-running connections

Full changelog: [LINK]

---

Need help upgrading? Reply or join #support in Discord.

ルール：

• 破壊的変更は必ず最初に記載します
• 新機能にはコード例を含めます
• メールにすべてを詰め込まず、変更履歴全体へのリンクを記載します
• マーケティング的な無駄を省き、事実だけを伝えます

4. 再エンゲージメントシーケンス

目標：利用が途絶えた開発者を呼び戻します。

トリガー：30／60／90日間、利用がない場合。

タイミング：

• メール1：利用停止から30日目
• メール2：45日目
• メール3：60日目
• メール4：90日目（利用停止の警告）

構成：

メール	目的	内容
様子伺い	控えめに連絡する	「お変わりありませんか？」
新機能のお知らせ	進捗を伝える	見逃した最近の機能
直接問いかける	利用が途絶えた理由を把握する	アンケートまたは返信の依頼
利用停止	アカウントについて警告する	「アカウントを一時停止します……」

テンプレート：様子伺い

Subject: Did something break?

Hey [NAME],

Haven't seen you in a while.

Quick check:

- Did you run into a problem? (Reply and I'll help)
- Building something else? (Totally fine)
- Found a better solution? (Genuinely curious what)

No hard feelings either way — just want to make sure
you're not stuck on something we can fix.

— [SENDER NAME]

テンプレート：利用停止の警告

Subject: Pausing your account in 14 days

Hey [NAME],

Your [PRODUCT] account has been inactive for 90 days.

To keep things tidy, we'll pause your account on [DATE].

What this means:
- Your API keys will stop working
- Your data stays safe (we don't delete anything)
- You can reactivate anytime by logging in

If you're still using [PRODUCT], just log in once to keep
your account active: [LOGIN LINK]

No action needed if you've moved on.

— [SENDER NAME]

---

頻度のガイドライン

メールの種類	最大頻度	備考
トランザクション	必要に応じて	領収書、パスワードのリセット、使用状況のアラート
オンボーディング	7 日間で 4 通	有効化されたら停止
変更履歴	週 1 回まで	リリースごとの配信よりダイジェストを推奨
再エンゲージメント	60 日間で 4 通	その後は停止
マーケティング／ニュースレター	月 2 回まで	真に価値のある内容を提供する必要があります

配信停止テスト：この種類のメールの配信を停止して開発者がほっとするなら、送りすぎです。

---

メール内の技術コンテンツ

コードスニペット

推奨事項：

• スニペットは 10 行未満にする
• 構文ハイライトを使う（HTML メールの場合）
• コードが実際に動作することをテストする
• 言語／フレームワークのバージョンを記載する

避けること：

• 特定の環境を前提とする
• シークレットや実在しそうな API キーを含める
• 古い構文を使う

コードスニペットの例：良い例

# Python 3.8+
import yourapi

client = yourapi.Client("your-api-key")
result = client.analyze("Hello, world!")
print(result.sentiment)  # "positive"

API の更新

API の変更を告知する場合：

## New endpoint: POST /v2/batch

Process up to 100 items in a single request.

```python
client.batch([
    {"text": "First item"},
    {"text": "Second item"},
    # ... up to 100 items
])

レート制限：1 分あたり 10 件のバッチリクエスト ドキュメント：[LINK]

---

## Transactional vs Marketing Emails

| Transactional | Marketing |
|---------------|-----------|
| Triggered by user action | Sent on schedule |
| Expected and wanted | Needs opt-in |
| Higher deliverability | More spam filtering |
| No unsubscribe required | Must have unsubscribe |
| CAN-SPAM exempt (mostly) | Full CAN-SPAM compliance |

**Examples**:

| Transactional | Marketing |
|---------------|-----------|
| Password reset | Newsletter |
| Payment receipt | Product announcement |
| Usage alert (95% quota) | Case study promotion |
| API key rotation reminder | Webinar invitation |
| Security notification | Feature highlight |

**Gray area**: Onboarding emails can be transactional (user signed up) but should still have easy unsubscribe.

---

## Measuring Email Effectiveness

### Metrics That Matter

| Metric | Good | Warning | Action |
|--------|------|---------|--------|
| Open rate | >40% | <25% | Fix subject lines |
| Click rate | >10% | <3% | Fix content/CTA |
| Unsubscribe rate | <0.2% | >0.5% | Reduce frequency or improve targeting |
| Reply rate | >1% | N/A | Celebrate! |
| Activation (onboarding) | >30% | <15% | Rethink sequence |

### What to Track

1. **Onboarding sequence**: % who activate within 7 days
2. **Changelog emails**: Click-through to docs/release notes
3. **Re-engagement**: % who return to product
4. **All emails**: Unsubscribe rate by email type

### A/B Testing Priorities

1. Subject lines (biggest impact)
2. Send time
3. Email length
4. Plain text vs HTML
5. CTA wording

---

## Unsubscribe Handling

### Preference Center

Let developers control what they get:

[EMAIL] のメール設定

[ ] 製品の更新（新機能、変更履歴） [ ] セキュリティアラート（常に推奨） [ ] コミュニティニュース（イベント、ミートアップ） [ ] ヒントとチュートリアル

または：すべてのマーケティングメールの配信を停止 （領収書やセキュリティアラートなどのトランザクションメールは引き続き届きます）

### Graceful Unsubscribe

When someone unsubscribes, confirm simply:

件名：配信を停止しました

[EMAIL TYPE] のメールの配信を停止しました。

引き続き届くメール：

• セキュリティアラート
• 支払いの領収書
• 使用状況の通知

配信設定を変更しますか？ 設定を更新：[LINK]

### Re-subscribe Flow

After unsubscribe, don't:
- Send "We miss you" emails
- Ask them to reconsider
- Add them back to other lists

Do:
- Make it easy to re-subscribe from your site
- Remember their preference if they return

---

## Email Templates Library

### Account Security

件名：対応が必要です：通常とは異なるログインを検知しました

新しい場所からのログインを検知しました：

場所：[CITY, COUNTRY] デバイス：[BROWSER/OS] 時刻：[TIMESTAMP]

ご自身によるログインの場合、対応は不要です。

ご自身によるログインでない場合：

1. ただちにパスワードを変更してください：[LINK]
2. API キーをローテーションしてください：[LINK]
3. 最近の API アクティビティを確認してください：[LINK]

ご質問は、このメールに返信してください。

— [PRODUCT] セキュリティチーム

### Usage Alert

件名：お知らせ：API の使用量がクォータの 80% に達しました

今月の使用量：[CURRENT] / [LIMIT] リクエスト

現在のペースでは、[DATE] 頃に上限に達する見込みです。

選択肢：

• プランをアップグレードする：[LINK]
• 使用量を最適化する：[DOCS LINK]
• [RESET DATE] のリセットまで待つ

95% に達した時点で、再度アラートをお送りします。

— [PRODUCT]

### Payment Failed

件名：お支払いに失敗しました — 利用を中断しないため、カード情報を更新してください

末尾が [LAST4] のカードに請求できませんでした。

お支払い方法を更新してください：[LINK]

3 日後に再試行します。再試行に失敗した場合、[DATE] にお客様のアカウントは無料プランに ダウングレードされます。

それまでは API を引き続きご利用いただけます。

請求についてご質問がある場合は、このメールに返信してください。

— [PRODUCT]

---

## Common Mistakes

| Mistake | Why it fails | Fix |
|---------|--------------|-----|
| "Just checking in" | No value, wastes time | Every email needs a purpose |
| Weekly newsletter with nothing new | Trains devs to ignore you | Only send when you have content |
| HTML-heavy design | Looks like marketing spam | Plain text or minimal HTML |
| Multiple CTAs | Confuses, reduces clicks | One clear action per email |
| Fake personalization | "Hi [FNAME]" feels robotic | Use personalization meaningfully or not at all |
| Celebrating your milestones | Developers don't care about your funding | Focus on what matters to them |

---

## Tools

| Tool | Use Case |
|------|----------|
| **[Octolens](https://octolens.com)** | Monitor developer sentiment about your emails — see if people complain about frequency or praise specific updates on Twitter, Reddit, Hacker News |
| **Customer.io** | Sophisticated automation for developer-focused email |
| **Postmark** | High deliverability transactional email |
| **Buttondown** | Developer-friendly newsletter platform |
| **Resend** | Modern email API built for developers |
| **Loops** | Email for SaaS with good segmentation |

---

## Related Skills

- `developer-audience-context` — Foundation for knowing what content resonates
- `developer-churn` — Re-engagement strategies for at-risk users
- `changelog-updates` — Structuring product updates
- `developer-onboarding` — Full onboarding strategy beyond just email