ensemble-claude 0.3.0__tar.gz

ensemble_claude-0.3.0/.gitignore

@@ -0,0 +1,27 @@
+# Ensemble queue files (transient)
+queue/tasks/*.yaml
+queue/reports/*.yaml
+queue/ack/*.ack
+queue/conductor/*.yaml
+
+# Logs (transient)
+logs/
+
+# Python
+__pycache__/
+*.pyc
+.pytest_cache/
+.coverage
+htmlcov/
+*.egg-info/
+dist/
+build/
+
+# Virtual environments
+.venv/
+venv/
+
+# IDE
+.idea/
+.vscode/
+*.swp

ensemble_claude-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Chika Kakazu
+
+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.

ensemble_claude-0.3.0/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: ensemble-claude
+Version: 0.3.0
+Summary: AI Orchestration Tool for Claude Code - Multi-agent orchestration for complex development tasks
+Project-URL: Homepage, https://github.com/ChikaKakazu/ensemble
+Project-URL: Documentation, https://github.com/ChikaKakazu/ensemble#readme
+Project-URL: Repository, https://github.com/ChikaKakazu/ensemble
+Project-URL: Issues, https://github.com/ChikaKakazu/ensemble/issues
+Author-email: Chika Kakazu <chika@example.com>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: ai,automation,claude,multi-agent,orchestration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Build Tools
+Classifier: Topic :: Software Development :: Code Generators
+Requires-Python: >=3.11
+Requires-Dist: click>=8.0
+Requires-Dist: pyyaml>=6.0
+Provides-Extra: dev
+Requires-Dist: pytest-cov>=4.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Ensemble
+
+> **"One task. Many minds. One result."**
+
+AI Orchestration Tool for Claude Code.
+
+## Overview
+
+Ensemble is an AI orchestration system that combines the best practices from:
+- **shogun** - Autonomous AI collaboration with tmux parallel execution
+- **takt** - Workflow enforcement with quality gates
+- **Boris's practices** - Effective use of skills, subagents, CLAUDE.md, and hooks
+
+## Features
+
+- **Autonomous AI Coordination**: One instruction triggers multiple AI agents working together
+- **Flexible Execution Patterns**:
+  - Pattern A: Simple tasks via subagent
+  - Pattern B: Medium tasks via tmux parallel panes
+  - Pattern C: Large tasks via git worktree separation
+- **Parallel Review**: Architecture + Security reviews run in parallel
+- **Self-Improvement**: Automatic learning and CLAUDE.md updates
+- **Compaction Recovery**: Built-in protocol to prevent role amnesia
+
+## Installation
+
+### Using uv (recommended)
+
+```bash
+# Install globally
+uv tool install ensemble-claude
+
+# Or add to your project
+uv add ensemble-claude
+```
+
+### Using pip
+
+```bash
+pip install ensemble-claude
+```
+
+### From source
+
+```bash
+git clone https://github.com/ChikaKakazu/ensemble.git
+cd ensemble
+
+# Using uv
+uv pip install -e .
+
+# Or using pip
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# 1. Initialize Ensemble in your project
+ensemble init
+
+# 2. Launch the tmux session with Conductor + Dispatch
+ensemble launch
+
+# 3. Run a task (in the Conductor pane)
+/go implement user authentication
+
+# Light workflow (minimal cost)
+/go-light fix typo in README
+```
+
+### CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `ensemble init` | Initialize Ensemble in current project |
+| `ensemble init --full` | Also copy agent/command definitions locally |
+| `ensemble launch` | Start tmux session with Conductor + Dispatch |
+| `ensemble launch --no-attach` | Start session without attaching |
+| `ensemble --version` | Show version |
+
+## Requirements
+
+- Python 3.10+
+- Claude Code CLI (`claude` command available)
+- tmux
+- git 2.20+ (for worktree support)
+- Claude Max plan recommended (for parallel execution)
+
+## Agent Architecture
+
+```
+┌─────────────┐
+│  Conductor  │ ← Orchestrator (planning, judgment, delegation)
+└──────┬──────┘
+       │
+  ┌────┴────┐
+  ▼         ▼
+┌────────┐ ┌──────────┐
+│Dispatch│ │ Learner  │
+└───┬────┘ └──────────┘
+    │        ↑ Learning records
+    ▼
+┌─────────────────────────────┐
+│  Reviewer / Security-Reviewer│ ← Parallel reviews
+└─────────────────────────────┘
+    │
+    ▼ (worktree mode)
+┌──────────┐
+│Integrator│ ← Merge & integrate
+└──────────┘
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

ensemble_claude-0.3.0/README.md

@@ -0,0 +1,116 @@
+# Ensemble
+
+> **"One task. Many minds. One result."**
+
+AI Orchestration Tool for Claude Code.
+
+## Overview
+
+Ensemble is an AI orchestration system that combines the best practices from:
+- **shogun** - Autonomous AI collaboration with tmux parallel execution
+- **takt** - Workflow enforcement with quality gates
+- **Boris's practices** - Effective use of skills, subagents, CLAUDE.md, and hooks
+
+## Features
+
+- **Autonomous AI Coordination**: One instruction triggers multiple AI agents working together
+- **Flexible Execution Patterns**:
+  - Pattern A: Simple tasks via subagent
+  - Pattern B: Medium tasks via tmux parallel panes
+  - Pattern C: Large tasks via git worktree separation
+- **Parallel Review**: Architecture + Security reviews run in parallel
+- **Self-Improvement**: Automatic learning and CLAUDE.md updates
+- **Compaction Recovery**: Built-in protocol to prevent role amnesia
+
+## Installation
+
+### Using uv (recommended)
+
+```bash
+# Install globally
+uv tool install ensemble-claude
+
+# Or add to your project
+uv add ensemble-claude
+```
+
+### Using pip
+
+```bash
+pip install ensemble-claude
+```
+
+### From source
+
+```bash
+git clone https://github.com/ChikaKakazu/ensemble.git
+cd ensemble
+
+# Using uv
+uv pip install -e .
+
+# Or using pip
+pip install -e .
+```
+
+## Quick Start
+
+```bash
+# 1. Initialize Ensemble in your project
+ensemble init
+
+# 2. Launch the tmux session with Conductor + Dispatch
+ensemble launch
+
+# 3. Run a task (in the Conductor pane)
+/go implement user authentication
+
+# Light workflow (minimal cost)
+/go-light fix typo in README
+```
+
+### CLI Commands
+
+| Command | Description |
+|---------|-------------|
+| `ensemble init` | Initialize Ensemble in current project |
+| `ensemble init --full` | Also copy agent/command definitions locally |
+| `ensemble launch` | Start tmux session with Conductor + Dispatch |
+| `ensemble launch --no-attach` | Start session without attaching |
+| `ensemble --version` | Show version |
+
+## Requirements
+
+- Python 3.10+
+- Claude Code CLI (`claude` command available)
+- tmux
+- git 2.20+ (for worktree support)
+- Claude Max plan recommended (for parallel execution)
+
+## Agent Architecture
+
+```
+┌─────────────┐
+│  Conductor  │ ← Orchestrator (planning, judgment, delegation)
+└──────┬──────┘
+       │
+  ┌────┴────┐
+  ▼         ▼
+┌────────┐ ┌──────────┐
+│Dispatch│ │ Learner  │
+└───┬────┘ └──────────┘
+    │        ↑ Learning records
+    ▼
+┌─────────────────────────────┐
+│  Reviewer / Security-Reviewer│ ← Parallel reviews
+└─────────────────────────────┘
+    │
+    ▼ (worktree mode)
+┌──────────┐
+│Integrator│ ← Merge & integrate
+└──────────┘
+```
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.

ensemble_claude-0.3.0/pyproject.toml

@@ -0,0 +1,80 @@
+[project]
+name = "ensemble-claude"
+version = "0.3.0"
+description = "AI Orchestration Tool for Claude Code - Multi-agent orchestration for complex development tasks"
+readme = "README.md"
+requires-python = ">=3.11"
+license = "MIT"
+authors = [
+    { name = "Chika Kakazu", email = "chika@example.com" },
+]
+keywords = ["ai", "orchestration", "claude", "multi-agent", "automation"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Build Tools",
+    "Topic :: Software Development :: Code Generators",
+]
+dependencies = [
+    "pyyaml>=6.0",
+    "click>=8.0",
+]
+
+[project.scripts]
+ensemble = "ensemble.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/ChikaKakazu/ensemble"
+Documentation = "https://github.com/ChikaKakazu/ensemble#readme"
+Repository = "https://github.com/ChikaKakazu/ensemble"
+Issues = "https://github.com/ChikaKakazu/ensemble/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=4.0",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/ensemble"]
+# Include non-Python template files
+artifacts = [
+    "*.md",
+    "*.yaml",
+    "*.sh",
+]
+
+[tool.hatch.build.targets.wheel.sources]
+"src" = ""
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/tests",
+    "/README.md",
+    "/LICENSE",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_functions = ["test_*"]
+addopts = "-v --cov=src/ensemble --cov-report=term-missing"
+
+[tool.coverage.run]
+source = ["src/ensemble"]
+branch = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "if __name__ == .__main__.:",
+]

ensemble_claude-0.3.0/src/ensemble/__init__.py

@@ -0,0 +1,5 @@
+"""Ensemble AI Orchestration - Multi-agent orchestration for Claude Code."""
+
+__version__ = "0.3.0"
+__author__ = "Ensemble Team"
+

ensemble_claude-0.3.0/src/ensemble/ack.py

@@ -0,0 +1,86 @@
+"""
+ACK（受領確認）機構
+
+タスク配信の確認をファイルベースで行う。
+"""
+
+from __future__ import annotations
+
+import time
+from datetime import datetime
+from pathlib import Path
+
+from ensemble.lock import atomic_write
+
+
+class AckManager:
+    """
+    ACK管理クラス
+
+    タスク配信後、エージェントからの受領確認を管理する。
+    """
+
+    def __init__(self, ack_dir: Path | None = None) -> None:
+        """
+        ACKマネージャを初期化する
+
+        Args:
+            ack_dir: ACKファイル保存ディレクトリ（デフォルト: queue/ack/）
+        """
+        self.ack_dir = ack_dir if ack_dir else Path("queue/ack")
+        self.ack_dir.mkdir(parents=True, exist_ok=True)
+
+    def send(self, task_id: str, agent: str) -> None:
+        """
+        ACKを送信する
+
+        Args:
+            task_id: タスクID
+            agent: ACKを送信したエージェント名
+        """
+        ack_file = self.ack_dir / f"{task_id}.ack"
+        content = f"{agent}\n{datetime.now().isoformat()}\n"
+        atomic_write(str(ack_file), content)
+
+    def wait(self, task_id: str, timeout: float = 30.0, interval: float = 0.1) -> bool:
+        """
+        ACKを待機する
+
+        Args:
+            task_id: タスクID
+            timeout: タイムアウト秒数
+            interval: ポーリング間隔
+
+        Returns:
+            ACK受信時True、タイムアウト時False
+        """
+        ack_file = self.ack_dir / f"{task_id}.ack"
+        elapsed = 0.0
+
+        while elapsed < timeout:
+            if ack_file.exists():
+                return True
+            time.sleep(interval)
+            elapsed += interval
+
+        return False
+
+    def check(self, task_id: str) -> bool:
+        """
+        ACKが存在するか確認する
+
+        Args:
+            task_id: タスクID
+
+        Returns:
+            ACK存在時True
+        """
+        ack_file = self.ack_dir / f"{task_id}.ack"
+        return ack_file.exists()
+
+    def cleanup(self) -> None:
+        """
+        全てのACKファイルを削除する
+        """
+        for ack_file in self.ack_dir.glob("*.ack"):
+            ack_file.unlink()

ensemble_claude-0.3.0/src/ensemble/cli.py

@@ -0,0 +1,31 @@
+"""Ensemble CLI - AI Orchestration Tool for Claude Code."""
+
+import click
+
+from ensemble import __version__
+from ensemble.commands.init import init
+from ensemble.commands.launch import launch
+
+
+@click.group()
+@click.version_option(version=__version__, prog_name="ensemble")
+def cli() -> None:
+    """Ensemble - AI Orchestration Tool for Claude Code.
+
+    Ensemble provides multi-agent orchestration for complex development tasks,
+    enabling parallel execution, automatic code review, and self-improvement.
+    """
+    pass
+
+
+cli.add_command(init)
+cli.add_command(launch)
+
+
+def main() -> None:
+    """Entry point for the CLI."""
+    cli()
+
+
+if __name__ == "__main__":
+    main()

ensemble_claude-0.3.0/src/ensemble/commands/__init__.py

@@ -0,0 +1 @@
+"""Ensemble CLI commands."""