soba-cli 0.1.0

data/docs/business/workflow.md

@@ -0,0 +1,143 @@
+# soba 自動ワークフロー
+
+## 概要
+
+sobaは、GitHub Issueを起点とした自律的な開発ワークフローを実現します。Issue のラベルに基づいて自動的に計画と実装のサイクルを実行します。
+
+## ワークフローの流れ
+
+```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
+```
+
+## 計画フェーズ
+
+### 1. Issue検出
+- **対象ラベル**: `soba:todo`
+- **検出方法**: 定期的なGitHub Issue監視
+- **選定基準**: Issue番号が最も若いものを1件抽出
+- **実行主体**: **soba CLI**
+
+### 2. キューイング・計画策定
+- **【soba】** 複数の `soba:todo` から Issue番号が最も若いものを選択
+- **【soba】** ラベルを `soba:todo` → `soba:queued` → `soba:planning` に変更
+- **【soba】** Claude Codeプロセスを起動
+- **【Claude】** Issueの内容を分析し、実装計画を策定
+- **【Claude】** 策定完了後、ラベルを `soba:planning` → `soba:ready` に変更
+
+## 実装フェーズ
+
+### 1. Issue検出
+- **対象ラベル**: `soba:ready`
+- **検出方法**: 定期的なGitHub Issue監視
+- **選定基準**: Issue番号が最も若いものを1件抽出
+- **実行主体**: **soba CLI**
+
+### 2. 実装作業
+- **【soba】** ラベルを `soba:ready` → `soba:doing` に変更
+- **【soba】** Claude Codeプロセスを起動
+- **【Claude】** 以下を自動実行：
+  - Issueの実装
+  - セルフレビュー
+  - Pull Request作成
+- **【Claude】** 完了後、ラベルを `soba:doing` → `soba:review-requested` に変更
+
+## レビューフェーズ
+
+### 1. Issue検出
+- **対象ラベル**: `soba:review-requested`
+- **検出方法**: 定期的なGitHub Issue監視
+- **選定基準**: Issue番号が最も若いものを1件抽出
+- **実行主体**: **soba CLI**
+
+### 2. レビュー実施
+- **【soba】** ラベルを `soba:review-requested` → `soba:reviewing` に変更
+- **【soba】** Claude Codeプロセスを起動
+- **【Claude】** PRの内容をレビューし、以下を実行：
+  - コード品質のチェック
+  - テスト実行状況の確認
+  - セキュリティ観点でのチェック
+  - レビューコメントの投稿
+- **【Claude】** レビュー結果に応じてラベルを変更：
+  - 承認: Issueラベル `soba:reviewing` → `soba:done`、PRに `soba:lgtm` ラベル付与
+  - 修正要求: Issueラベル `soba:reviewing` → `soba:requires-changes`
+
+## 修正フェーズ
+
+### 1. Issue検出
+- **対象ラベル**: `soba:requires-changes`
+- **検出方法**: 定期的なGitHub Issue監視
+- **選定基準**: Issue番号が最も若いものを1件抽出
+- **実行主体**: **soba CLI**
+
+### 2. 修正対応
+- **【soba】** ラベルを `soba:requires-changes` → `soba:revising` に変更
+- **【soba】** Claude Codeプロセスを起動
+- **【Claude】** レビューコメントを確認し、以下を実行：
+  - 指摘事項への対応実施
+  - テストの修正・追加
+  - コードの改善
+- **【Claude】** 修正完了後、ラベルを `soba:revising` → `soba:review-requested` に変更
+
+## マージフェーズ
+
+### 1. PR検出
+- **対象ラベル**: PRの `soba:lgtm` ラベル
+- **検出方法**: 定期的なGitHub PR監視
+- **選定基準**: `soba:lgtm` ラベルが付いた全てのPR
+- **実行主体**: **soba CLI**
+
+### 2. 自動マージ実施
+- **【soba】** PRのマージ可能状態を確認：
+  - CIが全てパス
+  - コンフリクトなし
+  - マージ可能状態
+- **【soba】** 条件を満たすPRを自動的にマージ（squash merge）
+- **【soba】** マージ後の処理：
+  - 関連するIssueを自動クローズ
+  - Issueに `soba:merged` ラベルを付与
+  - 作業ブランチを削除
+
+## ラベル定義
+
+### Issueラベル（状態管理）
+
+| ラベル | 状態 | 説明 | 変更主体 |
+|--------|------|------|----------|
+| `soba:todo` | 待機 | 新規Issue、計画待ち（複数設定可） | - |
+| `soba:queued` | キュー選択 | 優先度判定で選択済み（1つのみ） | soba → |
+| `soba:planning` | 計画中 | Claude Codeが計画策定中（1つのみ） | soba → |
+| `soba:ready` | 準備完了 | 計画策定済み、実装待ち | Claude → |
+| `soba:doing` | 実装中 | Claude Codeが実装作業中（1つのみ） | soba → |
+| `soba:review-requested` | レビュー待ち | PR作成済み、レビュー待ち | Claude → |
+| `soba:reviewing` | レビュー中 | Claude Codeがレビュー実施中（1つのみ） | soba → |
+| `soba:done` | 完了 | レビュー承認、マージ可能 | Claude → |
+| `soba:requires-changes` | 修正要求 | レビューで修正が必要と判断 | Claude → |
+| `soba:revising` | 修正中 | Claude Codeが修正対応中（1つのみ） | soba → |
+| `soba:merged` | マージ済み | PRがマージされ、Issueクローズ済み | soba → |
+
+### PRラベル（マージ判定）
+
+| ラベル | 状態 | 説明 | 変更主体 |
+|--------|------|------|----------|
+| `soba:lgtm` | 承認済み | レビュー承認、自動マージ対象 | Claude → |
+
+## 自動化のメリット
+
+1. **継続的な進捗**: Issueが自動的に処理され、開発が停滞しない
+2. **一貫性**: 同じプロセスで全てのIssueを処理
+3. **効率化**: 手動でのラベル変更やプロセス起動が不要
+4. **優先順位管理**: Issue番号順による明確な処理順序
+5. **厳密な排他制御**: 常に1つのIssueのみがアクティブ処理される

data/docs/development/INDEX.md

@@ -0,0 +1,10 @@
+# Development Documents
+
+## ドキュメント一覧
+
+- `architecture.md`: soba CLIのアーキテクチャ設計書（レイヤー構成、コンポーネント設計、ディレクトリ構造）
+- `implementation-guide.md`: 実装ガイド（段階的な実装手順、ベストプラクティス、サンプルコード）
+- `coding-standards.md`: コーディング規約（命名規則、スタイルガイド、Rubocop設定、レビューチェックリスト）
+- `testing-strategy.md`: テスト戦略（テストピラミッド、各種テストの実装方法、カバレッジ目標）
+- `distribution.md`: 配布戦略（配布方法は検討中）
+- `tmux-management.md`: tmux管理機能（セッション管理、ペイン操作、自動クリーンアップ）

data/docs/development/architecture.md

@@ -0,0 +1,69 @@
+# soba CLI アーキテクチャ設計書
+
+## 概要
+
+GitHub IssueとClaude Codeを連携させる自律的ワークフロー実行ツールのアーキテクチャ。
+
+## レイヤー構成
+
+```
+┌─────────────────────────────────────┐
+│   CLI (GLI)                         │ → コマンドインターフェース
+├─────────────────────────────────────┤
+│   Commands                          │ → コマンド処理
+├─────────────────────────────────────┤
+│   Services                          │ → ビジネスロジック
+├─────────────────────────────────────┤
+│   Domain                            │ → ドメインモデル
+├─────────────────────────────────────┤
+│   Infrastructure                    │ → 外部連携
+└─────────────────────────────────────┘
+```
+
+## ディレクトリ構造
+
+```
+soba/
+├── bin/soba                # 実行ファイル
+├── lib/soba/
+│   ├── cli/               # CLIコマンド定義
+│   ├── commands/          # コマンド実装
+│   ├── services/          # ビジネスロジック
+│   ├── domain/            # エンティティ、値オブジェクト
+│   └── infrastructure/    # GitHub/Claude API連携
+├── spec/                  # テスト
+└── config/               # 設定ファイル
+```
+
+## 主要コンポーネント
+
+| コンポーネント | ライブラリ | 用途 |
+|-------------|----------|------|
+| CLI | GLI | コマンドライン処理 |
+| DI | dry-container | 依存性注入 |
+| HTTP | Faraday + Octokit | API通信 |
+| 非同期 | concurrent-ruby | 並行処理 |
+| ログ | semantic_logger | ログ出力 |
+
+## データフロー
+
+```
+User → CLI → Command → Service → Domain
+                ↓
+        Infrastructure → External API
+```
+
+## 設定ファイル
+
+```yaml
+# ~/.soba/config.yml
+github:
+  token: ${GITHUB_TOKEN}
+  repository: owner/repo
+
+claude:
+  api_key: ${CLAUDE_API_KEY}
+
+workflow:
+  interval: 60
+```

data/docs/development/coding-standards.md

@@ -0,0 +1,152 @@
+# soba CLI コーディング規約
+
+## 基本原則
+
+1. **可読性優先** - シンプルで理解しやすいコード
+2. **Ruby Way** - Rubyの慣習に従う
+3. **一貫性** - プロジェクト全体で統一
+
+## 命名規則
+
+| 種類 | 規則 | 例 |
+|-----|------|-----|
+| ファイル | snake_case | `issue_monitor.rb` |
+| クラス | PascalCase | `IssueMonitor` |
+| メソッド | snake_case | `fetch_issues` |
+| 定数 | SCREAMING_SNAKE | `MAX_RETRIES` |
+| 述語メソッド | 疑問符付き | `valid?` |
+
+## ファイル構造
+
+```ruby
+# frozen_string_literal: true
+
+require 'standard_library'
+require_relative '../domain/issue'
+
+module Soba
+  class IssueMonitor
+    # クラス実装
+  end
+end
+```
+
+### require規則
+
+- **相対パス**: 同一プロジェクト内のファイルは`require_relative`を使用
+- **絶対パス禁止**: `require 'soba/services/foo'`は使わない（パスエラーの原因）
+- **外部gem**: `require 'gem_name'`を使用
+
+### GLIコマンド構造
+
+```ruby
+# bin/soba
+#!/usr/bin/env ruby
+require 'gli'
+
+include GLI::App
+
+desc 'Global option'
+flag [:c, :config]
+
+command :issue do |c|
+  c.action do |global, options, args|
+    # コマンド実装
+  end
+end
+
+exit run(ARGV)
+```
+
+## クラス設計
+
+```ruby
+class IssueMonitor
+  attr_reader :client
+
+  def initialize(client)
+    @client = client
+  end
+
+  def start
+    validate!
+    monitor_loop
+  end
+
+  private
+
+  def validate!
+    raise ConfigError unless valid?
+  end
+end
+```
+
+## メソッド設計
+
+- 10行以内を目安
+- 引数は3個まで（オプションハッシュ推奨）
+- ガード節で早期リターン
+
+```ruby
+def process(issue)
+  return unless issue.valid?
+  return if issue.closed?
+
+  perform_processing(issue)
+end
+```
+
+## エラーハンドリング
+
+```ruby
+module Soba
+  class Error < StandardError; end
+  class ConfigError < Error; end
+end
+
+def fetch_issue(id)
+  client.issue(id)
+rescue Octokit::NotFound
+  nil
+end
+```
+
+## Rubocop設定（主要項目）
+
+```yaml
+AllCops:
+  TargetRubyVersion: 3.2
+
+Layout/LineLength:
+  Max: 100
+
+Metrics/MethodLength:
+  Max: 15
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+```
+
+## テストコード
+
+```ruby
+RSpec.describe IssueMonitor do
+  let(:monitor) { described_class.new(client) }
+
+  describe '#start' do
+    context 'when valid' do
+      it 'starts monitoring' do
+        expect(monitor).to receive(:monitor_loop)
+        monitor.start
+      end
+    end
+  end
+end
+```
+
+## コードレビューチェックリスト
+
+- [ ] 命名規則に従っているか
+- [ ] 単一責任の原則を守っているか
+- [ ] テストが書かれているか
+- [ ] エラーハンドリングが適切か

data/docs/development/distribution.md

@@ -0,0 +1,26 @@
+# soba CLI 配布戦略
+
+## 概要
+
+soba CLIの配布方法は現在検討中です。
+
+## 配布方法（検討中）
+
+現在、以下の配布方法を検討しています：
+
+1. **gem配布**
+   - RubyGemsによる標準的な配布
+   - `gem install soba`でインストール可能
+
+2. **スタンドアロンバイナリ**
+   - Ruby環境不要の単一実行ファイル
+   - 各プラットフォーム向けに最適化
+
+3. **パッケージマネージャ**
+   - Homebrew（macOS/Linux）
+   - Scoop/Chocolatey（Windows）
+   - APT/YUM（Linux）
+
+## 今後の計画
+
+配布戦略の詳細は、プロジェクトの成熟度とユーザーのニーズに応じて決定される予定です。

data/docs/development/implementation-guide.md

@@ -0,0 +1,103 @@
+# soba CLI 実装ガイド
+
+## 実装フェーズ
+
+### Phase 1: 基盤構築（1週目）
+
+```bash
+# Gemfile作成
+bundle init
+bundle add gli dry-container dry-auto_inject faraday octokit
+bundle add --group development,test rspec webmock rubocop
+```
+
+基本ファイル:
+- `bin/soba` - 実行ファイル
+- `lib/soba.rb` - エントリポイント
+- `lib/soba/container/container.rb` - DI設定
+
+### Phase 2: CLIコマンド（2週目）
+
+```ruby
+# bin/soba
+#!/usr/bin/env ruby
+require 'gli'
+require 'soba'
+
+include GLI::App
+
+program_desc 'GitHub Issue to Claude Code workflow automation'
+version Soba::VERSION
+
+desc 'Manage issues'
+command :issue do |c|
+  c.desc 'List issues'
+  c.command :list do |list|
+    list.action do |global_options, options, args|
+      Soba::Commands::Issue::List.new.execute(args[0])
+    end
+  end
+end
+
+exit run(ARGV)
+```
+
+実装順序:
+1. `config` - 設定確認
+2. `issue list` - 一覧取得
+3. `issue watch` - 監視機能
+
+### Phase 3: ドメインモデル（3週目）
+
+```ruby
+# lib/soba/domain/entities/issue.rb
+module Soba
+  class Issue
+    attr_reader :id, :title, :state
+
+    def open?
+      state == 'open'
+    end
+  end
+end
+```
+
+### Phase 4: 外部連携（4週目）
+
+```ruby
+# lib/soba/infrastructure/github/client.rb
+module Soba
+  class GitHubClient
+    def initialize(token:)
+      @octokit = Octokit::Client.new(access_token: token)
+    end
+
+    def issues(repo)
+      @octokit.issues(repo)
+    end
+  end
+end
+```
+
+## Gem構成
+
+```ruby
+# soba.gemspec
+Gem::Specification.new do |spec|
+  spec.name = "soba"
+  spec.version = "0.1.0"
+  spec.files = Dir["lib/**/*", "bin/*"]
+  spec.executables = ["soba"]
+  spec.add_dependency "gli", "~> 2.21"
+end
+```
+
+## Docker化
+
+```dockerfile
+FROM ruby:3.2-slim
+WORKDIR /app
+COPY . .
+RUN bundle install
+ENTRYPOINT ["bin/soba"]
+```

data/docs/development/testing-strategy.md

@@ -0,0 +1,128 @@
+# soba CLI テスト戦略
+
+## テストピラミッド
+
+```
+      /\
+     /  \     E2E (5%)
+    /────\    統合テスト (20%)
+   /──────\
+  /────────\  ユニットテスト (75%)
+```
+
+## テストレベル
+
+### 1. ユニットテスト
+
+個別クラス・メソッドの動作検証。実実装を使用して正確性を確保。
+
+```ruby
+RSpec.describe Issue do
+  describe '#priority' do
+    let(:issue) { described_class.new(labels: ['critical']) }
+
+    it 'returns high for critical issues' do
+      expect(issue.priority).to eq(:high)
+    end
+  end
+end
+```
+
+### 2. 統合テスト
+
+コンポーネント間連携とAPI連携の検証。VCRでHTTP記録。
+
+```ruby
+RSpec.describe GitHubClient, :vcr do
+  it 'fetches issues from repository' do
+    issues = client.fetch_issues('owner/repo')
+    expect(issues).to be_an(Array)
+  end
+end
+```
+
+### 3. E2Eテスト
+
+CLIコマンド全体の動作確認。
+
+```ruby
+RSpec.describe 'CLI', type: :e2e do
+  it 'lists issues' do
+    output = `bin/soba issue list owner/repo`
+    expect($?).to be_success
+    expect(output).to include('Issues')
+  end
+end
+```
+
+## テスト構成
+
+```ruby
+# spec/spec_helper.rb
+require 'simplecov'
+SimpleCov.start { minimum_coverage 90 }
+
+RSpec.configure do |config|
+  config.include FactoryBot::Syntax::Methods
+  config.order = :random
+end
+```
+
+## モック戦略
+
+**重要: モックの利用は外部のAPI連携のみに限定する。それ以外のテスト時は必ず実実装を利用する。**
+
+```ruby
+# 外部API連携のみモック化
+module MockHelpers
+  def stub_github_api_response
+    stub_request(:get, /api.github.com/).
+      to_return(status: 200, body: '[]', headers: {})
+  end
+end
+```
+
+## VCR設定
+
+```ruby
+VCR.configure do |config|
+  config.cassette_library_dir = 'spec/fixtures/vcr'
+  config.hook_into :webmock
+  config.filter_sensitive_data('<TOKEN>') { ENV['GITHUB_TOKEN'] }
+end
+```
+
+## CI/CD
+
+```yaml
+# .github/workflows/test.yml
+name: Test
+on: [push, pull_request]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: ruby/setup-ruby@v1
+        with:
+          bundler-cache: true
+      - run: bundle exec rspec
+```
+
+## カバレッジ目標
+
+| レイヤー | 目標 |
+|---------|------|
+| Domain | 95%+ |
+| Services | 90%+ |
+| Infrastructure | 85%+ |
+| CLI | 80%+ |
+
+## ベストプラクティス
+
+- AAAパターン（Arrange, Act, Assert）
+- 1テスト1アサーション
+- テストの独立性確保
+- 明確なテスト名
+- 実実装の利用（外部API以外はモック化禁止）