beeops 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 YuugouOhno
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.ja.md

@@ -0,0 +1,156 @@
+# beeops
+
+[English README](README.md)
+
+[Claude Code](https://docs.anthropic.com/en/docs/claude-code) 向け 3層マルチエージェント・オーケストレーションシステム。
+
+**Queen → Leader → Worker** — GitHub Issue を自動的にサブタスクに分解し、git worktree で隔離された環境で並列実装を行い、コードレビューを実施し、CI をチェックします。すべて tmux 上でオーケストレーションされます。
+
+## 仕組み
+
+```
+Queen (L1)                – GitHub Issue を読み込み、queue.yaml を構築、Leader をディスパッチ
+  ├─ Leader (L2)          – Issue をサブタスクに分解、Worker をディスパッチ、PR を作成
+  │    ├─ Worker (coder)  – 単一サブタスクの実装
+  │    └─ Worker (tester) – サブタスクのテスト作成
+  └─ Review Leader (L2)   – レビュー Worker をディスパッチ、結果を集約
+       ├─ Worker (code-reviewer)  – コード品質レビュー
+       ├─ Worker (security)       – セキュリティ脆弱性レビュー
+       └─ Worker (test-auditor)   – テストカバレッジ監査
+```
+
+各レイヤーは tmux 内で個別の Claude Code インスタンスとして動作します。通信は YAML レポートと `tmux wait-for` シグナルで行われます。GitHub 以外の外部サーバー・データベース・API は不要です。
+
+Worker は**多層コンテキスト注入**（ベース＋専門特化）を受け取ります：
+
+| Worker ロール | ベースコンテキスト | 専門特化 |
+|-------------|-------------|----------------|
+| `worker-coder` | `worker-base.md` | `coder.md` |
+| `worker-tester` | `worker-base.md` | `tester.md` |
+| `worker-code-reviewer` | `reviewer-base.md` | `code-reviewer.md` |
+| `worker-security` | `reviewer-base.md` | `security-reviewer.md` |
+| `worker-test-auditor` | `reviewer-base.md` | `test-auditor.md` |
+
+## 前提条件
+
+- **Node.js** >= 18
+- **git**
+- **tmux**
+- **python3**
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI (`claude`)
+- [GitHub CLI](https://cli.github.com/) (`gh`) — Issue 同期と PR 操作に使用
+
+## クイックスタート
+
+```bash
+# インストール
+npm install beeops
+
+# プロジェクトで初期化
+cd your-project
+npx beeops init
+
+# Claude Code から起動
+# Claude Code で /bo と入力
+```
+
+以下がインストールされます：
+- `/bo` スラッシュコマンド
+- 4つのスキル（dispatch, leader-dispatch, task-decomposer, issue-sync）
+- コンテキスト注入用の UserPromptSubmit フック
+
+## init オプション
+
+```bash
+npx beeops init                    # .claude/settings.local.json にフック登録（デフォルト）
+npx beeops init --shared           # .claude/settings.json にフック登録（チーム共有）
+npx beeops init --global           # ~/.claude/settings.json にフック登録（全プロジェクト）
+npx beeops init --with-contexts    # カスタマイズ用にコンテキストファイルをコピー
+npx beeops init --locale ja        # ロケールを日本語に設定
+```
+
+## 多言語サポート
+
+beeops はエージェントプロンプトの多言語ロケールに対応しています。現在利用可能：**en**（英語、デフォルト）、**ja**（日本語）。
+
+```bash
+# init 時に設定
+npx beeops init --locale ja
+
+# 実行時にオーバーライド
+BO_LOCALE=ja /bo
+```
+
+コンテキストファイルは 4段階のフォールバックで解決されます：
+1. プロジェクトローカル＋ロケール (`<project>/.claude/beeops/contexts/<locale>/<file>`)
+2. プロジェクトローカル・ルート (`<project>/.claude/beeops/contexts/<file>`)
+3. パッケージ＋ロケール (`<pkg>/contexts/<locale>/<file>`)
+4. パッケージ・ルート (`<pkg>/contexts/<file>`)
+
+## エージェント動作のカスタマイズ
+
+```bash
+# デフォルトコンテキストを編集用にコピー
+npx beeops init --with-contexts
+```
+
+プロジェクト内に `.claude/beeops/contexts/` が作成されます。任意のファイルを編集してエージェントの動作をカスタマイズできます。ファイルを削除するとパッケージのデフォルトにフォールバックします。
+
+主要ファイル：
+- `queen.md` — Queen オーケストレータープロンプト
+- `leader.md` — 実装 Leader プロンプト
+- `review-leader.md` — レビュー Leader プロンプト
+- `worker-base.md` — Worker ベース（自律ルール、レポート形式）
+- `coder.md` — コーダー特化（コーディング規約、Fail Fast、禁止パターン）
+- `tester.md` — テスター特化（テスト計画、境界値、Given-When-Then）
+- `reviewer-base.md` — レビュアーベース（レビュー手順、判定ルール）
+- `code-reviewer.md` — コードレビュー特化（設計、品質、API、パフォーマンス）
+- `security-reviewer.md` — セキュリティ特化（OWASP Top 10、インジェクション、認証）
+- `test-auditor.md` — テスト監査特化（カバレッジ、エッジケース、リグレッション）
+- `agent-modes.json` — 環境変数からコンテキストファイルへのマッピング
+
+## アーキテクチャ
+
+### ワークフロー
+
+1. **Issue 同期**: Queen が GitHub Issue を取得 → `queue.yaml` を構築
+2. **ディスパッチ**: Queen が git worktree 付きの新しい tmux ウィンドウで Leader を起動
+3. **実装**: Leader が Issue を分解 → tmux ペインで Worker を起動
+4. **PR 作成**: 最終 Worker がプルリクエストを作成
+5. **レビュー**: Queen が Review Leader をディスパッチ → レビュー Worker を起動
+6. **CI チェック**: 承認後、Queen が CI ステータスを監視
+7. **修正ループ**: レビュー/CI 失敗時、Queen が修正モードで Leader を再起動（最大3回）
+
+### tmux レイアウト
+
+```
+tmux session "bo"
+├── [queen]     👑 Queen オーケストレーター（金枠）
+├── [issue-42]  👑 Issue #42 の Leader（青枠）
+│   ├── pane 0: Leader
+│   ├── pane 1: ⚡ Worker (coder, 緑枠)
+│   └── pane 2: 🧪 Worker (tester, シアン枠)
+└── [review-42] 🔮 Issue #42 の Review Leader（マゼンタ枠）
+    ├── pane 0: Review Leader
+    ├── pane 1: 🔍 Worker (code-reviewer, 青枠)
+    ├── pane 2: 🛡 Worker (security, 赤枠)
+    └── pane 3: 🧪 Worker (test-auditor, 黄枠)
+```
+
+`tmux attach -t bo` で全エージェントの動作をリアルタイムに確認できます。
+
+## 検証
+
+```bash
+npx beeops check
+```
+
+コマンド、スキル、フック登録、パッケージ解決など、すべてのコンポーネントが正しくインストールされているか検証します。
+
+## ライセンス
+
+MIT
+
+## 作者
+
+[YuugouOhno](https://github.com/YuugouOhno)

package/README.md

@@ -0,0 +1,80 @@
+# beeops
+
+[![npm version](https://img.shields.io/npm/v/beeops)](https://www.npmjs.com/package/beeops)
+[![license](https://img.shields.io/npm/l/beeops)](https://github.com/YuugouOhno/beeops/blob/main/LICENSE)
+[![CI](https://github.com/YuugouOhno/beeops/actions/workflows/ci.yml/badge.svg)](https://github.com/YuugouOhno/beeops/actions/workflows/ci.yml)
+[![Node.js](https://img.shields.io/node/v/beeops)](https://nodejs.org)
+
+3-layer multi-agent orchestration system (Queen → Leader → Worker) for [Claude Code](https://docs.anthropic.com/en/docs/claude-code), powered by tmux.
+
+## Prerequisites
+
+- **Node.js** >= 18
+- **git**
+- **tmux**
+- **python3**
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI (`claude`)
+- [GitHub CLI](https://cli.github.com/) (`gh`)
+
+## Installation
+
+```bash
+npm install beeops
+npx beeops init
+```
+
+## Quick Start
+
+Run `/bo` in Claude Code to start the Queen. She'll sync GitHub Issues, dispatch Leaders to git worktrees, and manage the full workflow — from implementation through code review and CI checks.
+
+```
+Queen (orchestrator)
+  ├─ Leader          → decomposes issue, dispatches Workers, creates PR
+  │    ├─ Worker (coder)
+  │    └─ Worker (tester)
+  └─ Review Leader   → dispatches review Workers, aggregates findings
+       ├─ Worker (code-reviewer)
+       ├─ Worker (security)
+       └─ Worker (test-auditor)
+```
+
+Each layer runs as a separate Claude Code instance in a tmux pane. Communication flows through YAML reports and `tmux wait-for` signals. No external servers or databases required.
+
+Attach with `tmux attach -t bo` to watch all agents work in real-time.
+
+## Architecture
+
+- **Queen** (L1) — Reads GitHub Issues, builds a queue, dispatches Leaders and Review Leaders
+- **Leader** (L2) — Decomposes an issue into subtasks, launches Workers in parallel, creates PRs
+- **Review Leader** (L2) — Launches review Workers, aggregates findings, approves or requests fixes
+- **Workers** (L3) — Execute a single subtask: coding, testing, or reviewing
+
+The system includes **12 specialized skills**, **3 hooks** (UserPromptSubmit for context injection, Stop for session logging, PostToolUse for mid-session checkpoints), and **locale support** (en/ja) with a 4-step fallback chain.
+
+Workers receive multi-layer context injection (base + specialization), so each role gets tailored instructions while sharing common autonomous-operation rules.
+
+## Configuration
+
+```bash
+npx beeops init [options]
+```
+
+| Option | Description |
+|--------|-------------|
+| `--local` (default) | Register hooks in `.claude/settings.local.json` (personal use) |
+| `--shared` | Register hooks in `.claude/settings.json` (team-shared, git committed) |
+| `-g`, `--global` | Register hooks in `~/.claude/settings.json` (all projects) |
+| `--with-contexts` | Copy default context files locally for customization |
+| `--locale <lang>` | Set locale (`en` default, `ja` available) |
+
+To customize agent behavior, run `npx beeops init --with-contexts` and edit files in `.claude/beeops/contexts/`. Delete any file to fall back to the package default.
+
+To verify your installation:
+
+```bash
+npx beeops check
+```
+
+## License
+
+MIT