jira-claude-code-integration

## 概要 jira-integration は Claude Code 用プラグインであり、Jira 課題 1 件をブランチ作成 → アプローチ設計 → 実装 → テスト → レビュー → ローカルマージまで処理し、各段階の結果を Jira のコメント・添付・状態遷移として残す。複数課題をキューに投入して順次消費した後、合格/隔離結果を例外レポート 1 枚にまとめ、人間が隔離分のみを判断するように設計されている。 ## 動作構造 2 つのループで構成される。 - 段階ループ(`auto`): 1 タスクを start → approach → impl+test → review の順に進める。各段階は隔離された sub-agent で実行され、段階ごとに異なるモデルが割り当てられる。レビューゲートは設計-実装マッチング率と Critical 件数を構造化された値で判定し、未合格時は修正 agent が lint・typecheck・関連テストのみを実行するセンサーループ(最大 5 回)で収束させた後、全体テストと delta 再レビューを各 1 回実施する。外側ループの上限は 2 回。 - タスクループ(`loop`): `init` で構成したキューを順序どおり消費し、タスクごとに auto → ローカル `--no-ff` マージ → 残りの worktree rebase を実行する。ゲート未合格・段階失敗・マージ/rebase 衝突時は該当タスクのみ隔離し、次へ進む。認証(401/403)・MCP 接続・base 破損などのインフラ信号や、異なるタスクの連続失敗時のみ全体を停止する。 制御フローはプロンプト解釈ではなく Workflow スクリプト(`scripts/auto.workflow.js`)が決定的に実行するとドキュメントに明記されている。 ## Jira 連携 課題キー 1 つがブランチ(`feature/<KEY>`)、worktree、コンテキストファイルに対応する。メインレポジトリの `.jira-context.json` はキュー全体を保持する aggregate であり、各 worktree のものは当該タスクの状態である。コマンドごとに状態遷移(To Do→進行中→レビュー中→完了)、コメント、添付(approach/review ドキュメント、テストレポート)が発生する。隔離は Jira を変更せず、ローカル状態としてのみ記録される。 Jira 呼び出しは標準ライブラリのみを使用する `scripts/jira-cli.py`(REST)が担当し、資格情報はワークスペース単位の `.jira-context.json` の `jira` ブロックに保存され、環境変数・レガシー MCP 設定から自動移行される。MCP サーバー登録は任意である。 ## 主なコマンド - 課題作成: `epic set/show/clear`, `discover`, `create` - キュー/自動化: `init`, `loop`, `auto` - 個別段階: `start`, `approach`, `impl`, `test`, `review`, `merge`, `pr`, `done` - 参照/整理: `status`, `report`, `clean` - その他: `/jira setup`, `/jira dashboard` ## 運用ルール 作業規模を L1/L2/L3 で判定し、成果物の分量とレビューの深さを調整する。データモデル・トランザクション境界・外部 API 契約・並行性・セキュリティ境界に触れる場合は L1 でも L2 に昇格される。`start` は approach と test の 2 段階に限ってスキップを推奨できるが、impl・review・merge はスキップされない。すべての段階は `completedSteps` に記録され、再実行時は完了済み段階をスキップする。 ## 成果物とダッシュボード `docs/` 以下に requirements、approach、test、review ドキュメントと review-log・run-log(jsonl) が蓄積される。run-log と review-log はレビュー誤検知率・段階所要時間・修正頻度・隔離理由などハーネス自体の観測データとして使われる。ダッシュボードは `http://127.0.0.1:8765` で worktree ごとのカード(進行段階、ツール呼び出し、Jira 状態、blocks グラフ)を SSE でリアルタイム表示し、localhost 専用で認証はない。 ## ライセンス MIT。