---

name: add-block description: | Add new block (Discord, Slack, Notion integrations etc.) workflow. Use when adding new integration blocks or system blocks to the workflow engine.

Add New Block Workflow

新規ブロック（Discord, Slack, Notion等の外部連携）を追加する際のワークフロー。

必読ドキュメント

以下を必ず先に読むこと：

1. docs/designs/UNIFIED_BLOCK_MODEL.md - Block execution architecture
2. docs/BLOCK_REGISTRY.md - Existing block definitions
3. backend/migrations/011_unified_block_model.sql - 既存パターン確認

標準手順（Migration追加）

ほとんどのブロックはこの方式で追加する:

1. Migrationファイル作成: backend/migrations/XXX_{name}_block.sql
2. block_definitionsテーブルにINSERT
   • tenant_id = NULL でシステムブロック
   • codeにJavaScriptコード（ctx.http等を使用）
   • ui_configにアイコン・カラー・設定スキーマ
3. Migration実行: make db-reset
4. docs/BLOCK_REGISTRY.md を更新

コード例

CopyINSERT INTO block_definitions (tenant_id, slug, name, category, code, ui_config, is_system)
VALUES (
  NULL,  -- システムブロック
  'discord',
  'Discord通知',
  'integration',
  $code$
    const webhookUrl = config.webhook_url || ctx.secrets.DISCORD_WEBHOOK_URL;
    const payload = { content: renderTemplate(config.message, input) };
    return await ctx.http.post(webhookUrl, payload);
  $code$,
  '{"icon": "message-circle", "color": "#5865F2", "configSchema": {...}}',
  TRUE
);

ctx インターフェース

Go Adapterが必要な例外ケース

Go Adapter追加が必要な場合:

1. Create backend/internal/adapter/{name}.go
2. Implement Adapter interface
3. Register in registry
4. Add test {name}_test.go
5. Update docs/BACKEND.md

参考

• docs/designs/UNIFIED_BLOCK_MODEL.md
• docs/BLOCK_REGISTRY.md