GitHub Workflow

cctelepathy (MCP server for inter-Claude-Code communication) 用の開発ワークフロー。

制約

{
  "constraints": {
    "禁止事項": [
      "gitmoji なしでコミットしない",
      "Issue 番号なしでブランチを作成しない（緊急時除く）",
      "PR 説明なしで PR を作成しない",
      "force push しない",
      "npm publish 前に必ず build と typecheck を通す"
    ]
  }
}

ラベル

{
  "labels": {
    "bug": "バグ修正",
    "enhancement": "機能追加・改善",
    "documentation": "ドキュメント",
    "mcp": "MCP関連",
    "broker": "Broker関連",
    "cli": "CLI関連",
    "breaking": "破壊的変更"
  }
}

Branch Naming

{
  "pattern": "{type}/{issue_number}-{description}",
  "types": {
    "feat": "新機能",
    "fix": "バグ修正",
    "refactor": "リファクタリング",
    "docs": "ドキュメント",
    "test": "テスト",
    "chore": "その他"
  },
  "rules": {
    "description": "ASCII only (a-z, 0-9, hyphen). Translate Japanese to English.",
    "禁止": "日本語・非ASCII文字（GitHubで警告が出る）"
  },
  "examples": [
    "feat/1-add-reconnect",
    "fix/2-socket-cleanup",
    "docs/3-usage-examples"
  ]
}

Commit Message Format

{
  "pattern": "{emoji_code} ({emoji}) {type}: {description} (#{issue_number})",
  "note": "Either :emoji_code: or the actual emoji is acceptable; both are not required",
  "gitmoji": {
    ":sparkles:": { "emoji": "✨", "type": "feat", "usage": "新機能追加" },
    ":bug:": { "emoji": "🐛", "type": "fix", "usage": "バグ修正" },
    ":memo:": { "emoji": "📝", "type": "docs", "usage": "ドキュメント" },
    ":recycle:": { "emoji": "♻️", "type": "refactor", "usage": "リファクタリング" },
    ":white_check_mark:": { "emoji": "✅", "type": "test", "usage": "テスト追加/修正" },
    ":wrench:": { "emoji": "🔧", "type": "chore", "usage": "設定変更" },
    ":zap:": { "emoji": "⚡", "type": "perf", "usage": "パフォーマンス改善" },
    ":fire:": { "emoji": "🔥", "type": "remove", "usage": "コード/ファイル削除" },
    ":rocket:": { "emoji": "🚀", "type": "release", "usage": "リリース・npm publish" },
    ":package:": { "emoji": "📦", "type": "deps", "usage": "依存関係更新" },
    ":lock:": { "emoji": "🔒", "type": "security", "usage": "セキュリティ修正" }
  },
  "examples": [
    ":sparkles: (✨) feat: add auto-reconnect to IPC client (#5)",
    ":bug: (🐛) fix: handle socket cleanup on broker shutdown (#6)",
    ":memo: (📝) docs: add usage examples to README (#7)"
  ]
}

Workflow

Issue 作成

gh issue create \
  --title "{title}" \
  --body "## 概要
{description}

## タスク
- [ ] ...

## 関連
- ..." \
  --label "{label}"

タスク開始

# Issue からブランチ作成
gh issue develop {issue_number} --checkout

# または手動
git checkout -b {type}/{issue_number}-{description}

コミット

git commit -m "$(cat <<'EOF'
{emoji_code} ({emoji}) {type}: {description} (#{issue_number})

{body}

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
EOF
)"

PR 作成

gh pr create \
  --title "{emoji_code} ({emoji}) {type}: {description} (#{issue_number})" \
  --body "$(cat <<'EOF'
## Summary
{summary}

## Changes
- {change1}
- {change2}

## Test plan
- [ ] `npm run build` passes
- [ ] `npm run typecheck` passes
- [ ] Manual test: {test}

Closes #{issue_number}

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"

検証ステップ

PR作成前・npm publish前に必ず実行：

npm run typecheck && npm run build

npm publish ワークフロー

# 1. バージョン更新
npm version {patch|minor|major}

# 2. 検証
npm run typecheck && npm run build

# 3. 公開
npm publish

# 4. タグプッシュ
git push --tags