soba-cli 0.1.0

data/README_ja.md

@@ -0,0 +1,384 @@
+# soba CLI
+
+[![GitHub Release](https://img.shields.io/github/v/release/douhashi/soba-cli)](https://github.com/douhashi/soba-cli/releases)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Ruby Version](https://img.shields.io/badge/ruby-%3E%3D%203.0-red)](https://www.ruby-lang.org/)
+
+[English version](README.md)
+
+GitHub IssueとClaude Codeを連携させる自律的ワークフロー実行CLIツール。AI駆動の開発サイクルを実現します。
+
+## 概要
+
+soba CLIは、Issueの作成からプルリクエストのマージまで、開発ワークフロー全体を自動化します。GitHub Issueを監視し、Claude Code AIの支援により計画、実装、レビュー、マージの各フェーズを自動的に処理します。
+
+## 主な機能
+
+- 🤖 **自律ワークフロー**: Issue作成からマージまで完全自動化
+- 🏷️ **ラベル駆動の状態管理**: GitHubラベルによる進捗追跡
+- 🔄 **継続的処理**: 自動ポーリングとフェーズ遷移
+- 🎯 **優先順位管理**: Issue番号による順次処理
+- 🪟 **Tmux統合**: AIプロセスの可視化監視
+- 🔀 **Git Worktreeサポート**: 独立したブランチ管理
+- 🚀 **自動マージ**: 承認後の自動PRマージ
+
+## ワークフロー
+
+```mermaid
+graph TD
+    A[複数のsoba:todo] -->|soba: 優先度判定| B[1つをsoba:queued]
+    B -->|soba: 即座に| C[soba:planning]
+    C -->|Claude: 計画策定| D[soba:ready]
+    D -->|soba: 自動検出| E[soba:doing]
+    E -->|Claude: 実装・PR作成| F[soba:review-requested]
+    F -->|soba: 自動検出| G[soba:reviewing]
+    G -->|Claude: レビュー承認| H[soba:done + PR:soba:lgtm]
+    G -->|Claude: 修正要求| I[soba:requires-changes]
+    I -->|soba: 自動検出| K[soba:revising]
+    K -->|Claude: 修正対応| F
+    H -->|soba: 自動マージ| J[soba:merged]
+    J -->|次のキューイング| A
+```
+
+## インストール
+
+### Ruby Gemとして
+
+```bash
+gem install soba-cli
+```
+
+### ソースから
+
+```bash
+# リポジトリのクローン
+git clone https://github.com/douhashi/soba-cli.git
+cd soba-cli
+
+# 依存関係のインストール
+bundle install
+
+# ソースから実行
+bin/soba --help
+```
+
+## クイックスタート
+
+### ⚠ 重要な注意 ⚠
+
+soba はAIによる自律的な開発を支援するため、デフォルトの設定で `--dangerously-skip-permissions` を使用します。(設定ファイルで無効化することができます)
+
+デフォルト設定で利用する場合、devcontainerの利用や外部アクセスの制限など、可能な限りの保全作業を行ったうえで使用してください。
+
+---
+
+1. **設定の初期化**
+   ```bash
+   soba init
+   ```
+
+2. **設定ファイルの編集**
+   `.soba/config.yml`を編集:
+   ```yaml
+   github:
+     token: ${GITHUB_TOKEN}
+     repository: owner/repo
+   ```
+
+3. **自動化の開始**
+   ```bash
+   soba start
+   ```
+
+4. **ラベル付きIssueの作成**
+   GitHub Issueに`soba:todo`ラベルを付けて自動処理を開始。
+
+## 設定
+
+設定ファイルの場所: `.soba/config.yml`（プロジェクトルート）
+
+### 完全な設定例
+
+```yaml
+# GitHub設定
+github:
+  # Personal Access Token（環境変数可）
+  token: ${GITHUB_TOKEN}
+  # ターゲットリポジトリ（形式: owner/repo）
+  repository: douhashi/soba-cli
+
+# ワークフロー設定
+workflow:
+  # Issueポーリング間隔（秒）（デフォルト: 20）
+  interval: 20
+  # Claude実行にtmuxを使用（デフォルト: true）
+  use_tmux: true
+  # 自動PRマージ有効化（デフォルト: true）
+  auto_merge_enabled: true
+  # クローズ済みIssueのtmuxウィンドウクリーンアップ（デフォルト: true）
+  closed_issue_cleanup_enabled: true
+  # クリーンアップ間隔（秒）（デフォルト: 300）
+  closed_issue_cleanup_interval: 300
+  # tmuxペインへのコマンド遅延（秒）（デフォルト: 3）
+  tmux_command_delay: 3
+
+# Slack通知設定
+slack:
+  # Slack通知用のWebhook URL
+  # Webhook URLの取得方法: https://api.slack.com/messaging/webhooks
+  webhook_url: ${SLACK_WEBHOOK_URL}
+  # フェーズ開始時の通知を有効化（デフォルト: false）
+  notifications_enabled: false
+
+# Git設定
+git:
+  # git worktreeのベースパス
+  worktree_base_path: .git/soba/worktrees
+  # フェーズ開始時の自動ワークスペース設定（デフォルト: true）
+  setup_workspace: true
+
+# フェーズコマンド（オプション - カスタムClaudeコマンド用）
+phase:
+  plan:
+    command: claude
+    options:
+      - --dangerously-skip-permissions
+    parameter: '/soba:plan {{issue-number}}'
+  implement:
+    command: claude
+    options:
+      - --dangerously-skip-permissions
+    parameter: '/soba:implement {{issue-number}}'
+  review:
+    command: claude
+    options:
+      - --dangerously-skip-permissions
+    parameter: '/soba:review {{issue-number}}'
+  revise:
+    command: claude
+    options:
+      - --dangerously-skip-permissions
+    parameter: '/soba:revise {{issue-number}}'
+```
+
+### 環境変数
+
+| 変数名 | 説明 | 必須 |
+|--------|------|------|
+| `GITHUB_TOKEN` | repo/read:org/write:discussion スコープを持つGitHub Personal Access Token | はい |
+| `SLACK_WEBHOOK_URL` | SlackのWebhookURL | いいえ |
+
+### Claudeコマンドテンプレート
+
+Sobaは初期化時に自動的にClaudeコマンドテンプレートを `.claude/commands/soba/` に展開します。これらのテンプレートは各フェーズのワークフロー自動化コマンドを定義します：
+
+
+- **plan.md** - Issue計画フェーズテンプレート
+- **implement.md** - 実装フェーズテンプレート
+- **review.md** - PRレビューフェーズテンプレート
+- **revise.md** - 修正フェーズテンプレート
+
+これらのテンプレートはgemパッケージに含まれており、以下で確認できます：
+[lib/soba/templates/claude_commands/](lib/soba/templates/claude_commands/)
+
+## コマンド
+
+### `soba init`
+現在のプロジェクトでsoba設定を初期化。
+
+```bash
+# 基本的な初期化
+soba init
+
+# インタラクティブモード
+soba init --interactive
+```
+
+### `soba start`
+ワークフロー自動化デーモンを開始。
+
+```bash
+# デーモンモード（バックグラウンド）で開始
+soba start
+
+# デーモンモードで開始
+soba start --daemon
+
+# 特定のIssueを指定して開始
+soba start 123
+
+# tmuxなしで開始
+soba start --no-tmux
+```
+
+### `soba status`
+デーモンのステータスと最近のログを表示。
+
+```bash
+# 基本ステータス
+soba status
+
+# より多くのログ行を表示
+soba status --log 50
+
+# JSON形式で出力
+soba status --json
+```
+
+### `soba stop`
+実行中のデーモンを停止。
+
+```bash
+# 正常停止
+soba stop
+
+# 即座に強制停止
+soba stop --force
+
+# カスタムタイムアウト
+soba stop --timeout 60
+```
+
+### `soba open`
+タスクのtmuxセッションを開くまたは一覧表示。
+
+```bash
+# tmuxセッションを開く
+soba open
+
+# すべてのアクティブなセッションを一覧表示
+soba open --list
+```
+
+### `soba config`
+現在の設定を表示。
+
+```bash
+# 設定を表示
+soba config
+
+# 特定の設定ファイルを使用
+soba --config /path/to/config.yml config
+```
+
+## ラベルシステム
+
+### Issueラベル（状態管理）
+
+| ラベル | 状態 | 説明 |
+|--------|------|------|
+| `soba:todo` | 待機 | 新規Issue、処理待ち |
+| `soba:queued` | キュー選択 | 処理対象として選択済み |
+| `soba:planning` | 計画中 | Claudeが実装計画を策定中 |
+| `soba:ready` | 準備完了 | 計画完了、実装待ち |
+| `soba:doing` | 実装中 | Claudeが実装作業中 |
+| `soba:review-requested` | レビュー待ち | PR作成済み、レビュー待ち |
+| `soba:reviewing` | レビュー中 | ClaudeがPRをレビュー中 |
+| `soba:done` | 完了 | レビュー承認済み、マージ可能 |
+| `soba:requires-changes` | 修正要求 | レビューで修正が必要と判断 |
+| `soba:revising` | 修正中 | Claudeが修正対応中 |
+| `soba:merged` | マージ済み | PRマージ済み、Issueクローズ済み |
+
+### PRラベル
+
+| ラベル | 説明 |
+|--------|------|
+| `soba:lgtm` | レビュー承認済み、自動マージ対象 |
+
+## 開発
+
+### ディレクトリ構造
+
+```
+lib/
+├── soba/
+│   ├── cli/              # CLIフレームワーク設定
+│   ├── commands/         # コマンド実装
+│   ├── domain/           # ドメインモデル
+│   ├── services/         # ビジネスロジック
+│   └── infrastructure/   # 外部連携
+```
+
+### テストの実行
+
+```bash
+# 全テスト実行
+bundle exec rspec
+
+# カバレッジ付きテスト
+bundle exec rake coverage
+
+# 特定のテストスイート実行
+bundle exec rspec spec/unit/
+```
+
+### コード品質
+
+```bash
+# Rubocop実行（Airbnbスタイル）
+bundle exec rubocop
+
+# 自動修正
+bundle exec rubocop -a
+
+# セキュリティ監査
+bundle exec bundler-audit
+```
+
+### Gitフック
+
+プロジェクトはコード品質のためのpre-commitフックを使用：
+- 自動的なRubocop修正
+- 自動修正後の再ステージング
+- 手動修正が必要な場合のコミットブロック
+
+フックのセットアップ：
+```bash
+./scripts/setup-hooks.sh
+```
+
+## 要件
+
+- Ruby >= 3.0
+- Git
+- tmux（オプション、推奨）
+- GitHub Personal Access Token
+- Claude Code CLI（`claude`コマンド）
+
+## アーキテクチャ
+
+soba CLIはレイヤードアーキテクチャに従っています：
+- **Commandsレイヤー**: CLIコマンド定義と解析
+- **Domainレイヤー**: コアビジネスモデルとロジック
+- **Servicesレイヤー**: ワークフローオーケストレーションと状態管理
+- **Infrastructureレイヤー**: GitHub APIと外部ツール統合
+
+詳細なアーキテクチャドキュメントは[docs/development/architecture.md](docs/development/architecture.md)を参照。
+
+## コントリビューション
+
+1. リポジトリをフォーク
+2. フィーチャーブランチを作成（`git checkout -b feature/amazing-feature`）
+3. 変更をコミット（`git commit -m 'Add amazing feature'`）
+4. ブランチにプッシュ（`git push origin feature/amazing-feature`）
+5. プルリクエストを開く
+
+以下を確認してください：
+- すべてのテストがパス（`bundle exec rspec`）
+- Rubocopチェックがパス（`bundle exec rubocop`）
+- 高いコードカバレッジを維持
+
+## ライセンス
+
+このプロジェクトはMITライセンスの下でライセンスされています - 詳細は[LICENSE](LICENSE)ファイルを参照。
+
+## サポート
+
+- **Issues**: [GitHub Issues](https://github.com/douhashi/soba-cli/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/douhashi/soba-cli/discussions)
+
+## 謝辞
+
+- AI駆動開発を実現する[Claude Code](https://claude.ai/code)
+- CLIフレームワーク[GLI](https://github.com/davetron5000/gli)
+- [Airbnb Ruby Style Guide](https://github.com/airbnb/ruby)によるスタイリング

data/Rakefile

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+require "rspec/core/rake_task"
+require "rubocop/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+RuboCop::RakeTask.new
+
+# Load custom rake tasks
+Dir.glob('lib/tasks/*.rake').each { |r| import r }
+
+task default: [:rubocop, :spec]
+
+desc "Run tests with coverage"
+task :coverage do
+  ENV["COVERAGE"] = "true"
+  Rake::Task["spec"].invoke
+end

data/bin/soba

@@ -0,0 +1,120 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "bundler/setup"
+require "gli"
+require_relative "../lib/soba"
+
+include GLI::App
+
+program_desc "GitHub to Claude Code workflow automation"
+version Soba::VERSION
+
+desc "Configuration file path"
+flag [:c, :config]
+
+desc "Verbose output"
+switch [:v, :verbose]
+
+desc "Initialize soba configuration"
+command :init do |c|
+  c.desc "Interactive mode for configuration"
+  c.switch [:i, :interactive]
+
+  c.action do |global_options, options, _args|
+    require_relative "../lib/soba/commands/init"
+    Soba::Commands::Init.new(interactive: options[:interactive]).execute
+  end
+end
+
+desc "Show configuration"
+command :config do |c|
+  c.action do |global_options, _options, _args|
+    require_relative "../lib/soba/commands/config/show"
+    Soba::Commands::Config::Show.new.execute(
+      config_path: global_options[:config],
+    )
+  end
+end
+
+desc "Start workflow automation"
+command :start do |c|
+  c.desc "Issue number to process (optional)"
+  c.arg_name "[issue_number]"
+
+  c.desc "Disable tmux execution"
+  c.switch ["no-tmux"]
+
+  c.desc "Run in daemon mode (default is foreground mode)"
+  c.switch [:d, :daemon]
+
+  c.desc "[DEPRECATED] Run in foreground mode (now default)"
+  c.switch [:f, :foreground]
+
+  c.action do |global_options, options, args|
+    require_relative "../lib/soba/commands/start"
+    result = Soba::Commands::Start.new.execute(global_options, options, args)
+    if result.is_a?(Integer) && result != 0
+      exit(result)
+    end
+  end
+end
+
+desc "Show daemon status"
+command :status do |c|
+  c.flag [:l, :log], desc: "Number of log lines to display", type: Integer, default_value: 10
+  c.switch [:j, :json], desc: "Output in JSON format", negatable: false
+
+  c.action do |global_options, options, args|
+    require_relative "../lib/soba/commands/status"
+    result = Soba::Commands::Status.new.execute(global_options, options, args)
+    if result.is_a?(Integer) && result != 0
+      exit(result)
+    end
+  end
+end
+
+desc "Stop daemon"
+command :stop do |c|
+  c.switch [:f, :force], desc: "Force kill immediately without waiting", negatable: false
+  c.flag [:t, :timeout], desc: "Timeout in seconds", type: Integer, default_value: 30
+
+  c.action do |global_options, options, args|
+    require_relative "../lib/soba/commands/stop"
+    result = Soba::Commands::Stop.new.execute(global_options, options, args)
+    if result.is_a?(Integer) && result != 0
+      exit(result)
+    end
+  end
+end
+
+desc "Open tmux session for a task"
+command :open do |c|
+  c.desc "Task number to open"
+  c.arg_name "[task_number]"
+
+  c.desc "List active task sessions"
+  c.switch [:l, :list]
+
+  c.action do |global_options, options, args|
+    require_relative "../lib/soba/commands/open"
+    command = Soba::Commands::Open.new
+    issue_number = args[0] unless args.empty?
+    command.execute(issue_number, list: options[:list])
+  end
+end
+
+pre do |global, _command, _options, _args|
+  if global[:verbose]
+    Soba.logger.level = :debug
+  end
+  true
+end
+
+on_error do |exception|
+  Soba.logger.error(exception.message)
+  Soba.logger.debug(exception.backtrace.join("\n")) if Soba.logger.debug?
+  false
+end
+
+exit run(ARGV)

data/config/config.yml.example

@@ -0,0 +1,36 @@
+# soba CLI configuration example
+github:
+  # GitHub Personal Access Token
+  # Generate at: https://github.com/settings/tokens
+  token: ${GITHUB_TOKEN}
+
+  # Default repository to monitor (owner/repo format)
+  repository: owner/repo
+
+claude:
+  # Claude API Key
+  api_key: ${CLAUDE_API_KEY}
+
+  # Model to use (optional)
+  model: claude-3-opus-20240229
+
+workflow:
+  # Polling interval in seconds
+  interval: 60
+
+  # Use tmux for Claude execution (default: true)
+  # Set to false for CI/CD environments or debugging
+  use_tmux: true
+
+  # Maximum concurrent workflows
+  max_concurrent: 3
+
+  # Workflow timeout in seconds
+  timeout: 3600
+
+logging:
+  # Log level: debug, info, warn, error
+  level: info
+
+  # Log file path (optional)
+  file: ~/.soba/logs/soba.log

data/docs/business/INDEX.md

@@ -0,0 +1,6 @@
+# Business Documents
+
+## ドキュメント一覧
+
+- `overview.md`: プロジェクトの概要と提供価値
+- `workflow.md`: sobaの自動ワークフロー（計画・実装フェーズ、ラベル管理）

data/docs/business/overview.md

@@ -0,0 +1,42 @@
+# soba CLI プロジェクト概要
+
+## プロジェクトの目的
+
+soba CLIは、GitHub IssueをデータソースとしてClaude Codeによる自律的なワークフローを実現するコマンドラインツールです。開発者の作業を自動化し、効率的なイシュー管理とコード生成を支援します。
+
+## 主要機能
+
+### 1. Issue監視機能
+- GitHub Issueの定期的な監視
+- 新規・更新Issueの自動検出
+- カスタマイズ可能な監視間隔
+
+### 2. 自律的ワークフロー実行
+- Issue検出時のClaude Code自動起動
+- Issueコンテンツに基づいた適切な処理実行
+- コード生成、修正、テスト実行の自動化
+
+### 3. Claude Code最適化
+- 専用コマンド群の提供
+- AIエージェントテンプレート
+- ワークフロー最適化ツール
+
+## ターゲットユーザー
+
+- 個人開発者
+- 小規模開発チーム
+- AIアシスタントを活用した開発プロセスの自動化を求める組織
+
+## 提供価値
+
+1. **開発効率の向上**: 繰り返し作業の自動化
+2. **品質向上**: 一貫性のあるコード生成
+3. **迅速な対応**: Issue検出から実装までの時間短縮
+4. **柔軟性**: カスタマイズ可能なワークフロー
+
+## 技術スタック
+
+- **実装言語**: Ruby
+- **配布方式**: Tebako（スタンドアロンバイナリ）
+- **対象プラットフォーム**: Linux, macOS, Windows
+- **依存関係**: GitHub API, Claude Code API