slack-utils-channel: Instructions file for Claude Code

Claude Rules for slack-utils

このドキュメントはClaude/Cursor AIがslack-utilsプロジェクトで作業する際のルールとガイドラインを定義します。

📋 プロジェクト概要

slack-utils は Slack Deno SDK v2.x を使用したSlackアプリケーション開発テンプレートです。

• 言語: TypeScript (Deno v2互換)
• 主な用途: Slack Functions、Workflows、Triggersの管理
• デプロイ: Slack CLI を使用
• ライセンス: MIT

プロジェクト構成

slack-utils/
├── functions/         # Slack Functions（各関数にtest.tsを配置）
├── workflows/         # Slack Workflows
├── triggers/          # Slack Triggers
├── lib/              # 共通ライブラリ（i18nなど）
├── locales/          # 多言語対応（en.json, ja.json）
├── scripts/          # ビルド・デプロイスクリプト
├── docs/             # ドキュメント
├── .github/          # CI/CD設定
├── deno.jsonc        # Deno設定
├── import_map.json   # インポートマップ
└── manifest.ts       # Slackアプリマニフェスト

🔍 コードベース検索・調査のルール

必須ツールの使用

このプロジェクトでは以下のツールを必ず使用してください：

1. Serena - リポジトリ内コード検索

プロジェクト内のコード検索にはserenaを使用：

// ✅ 正しい使用例
mcp_serena_find_symbol({
  name_path: "functionName",
  relative_path: "functions/",
});

mcp_serena_search_for_pattern({
  substring_pattern: "エラーパターン",
  relative_path: "lib/",
});

使用するシーン：

• 関数やクラスの定義を探す
• 特定のパターンやキーワードを検索
• プロジェクト構造の理解
• シンボルの参照箇所を調べる

2. Context7 - モジュール・ライブラリ調査

外部モジュールやライブラリの調査にはcontext7を使用：

// ✅ 正しい使用例
// まずライブラリIDを解決
mcp_Context7_resolve - library - id({
  libraryName: "deno slack sdk",
});

// 次にドキュメントを取得
mcp_Context7_get - library - docs({
  context7CompatibleLibraryID: "/slackapi/deno-slack-sdk",
  topic: "functions",
});

主要ライブラリ：

• /slackapi/deno-slack-sdk - Slack Deno SDK
• /denoland/deno - Deno runtime
• /websites/deno - Deno公式ドキュメント

💻 技術スタック

Deno (v2.x)

• 公式ドキュメント: /websites/deno
• セキュアなランタイム
• TypeScript標準サポート
• 組み込みテストランナー

Slack Deno SDK (v2.15.1+)

• ライブラリID: /slackapi/deno-slack-sdk
• Slack Functions、Workflows、Triggersをサポート
• 最新のSlack Platform featuresに対応

📝 コーディング規約

TypeScript

• Strictモード必須: deno.jsoncでstrict: trueを設定
• 暗黙的なanyを禁止: 全ての型を明示的に定義
• JSDocコメント必須: 全ての公開関数に追加