diff --git a/README.md b/README.md index c84c2bd..5ea5ae4 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,31 @@ A CLI tool that spawns a tmux session with Claude Code and Ralph, designed for i The tool fetches available models from a [llama-swap](https://github.com/dotcross/llama-swap) API endpoint, lets you select a model, and configures Claude Code with appropriate context window settings based on the model's capabilities. +## The Businessman Skill + +The Businessman skill is a collaborative design assistant that works with Claude Code to break down tasks and spawn Ralph when needed. It does **not** require you to interact with Ralph directly unless you want to. + +### What the Businessman Skill Provides + +| Feature | Description | +|---------|-------------| +| **Collaborative Design** | Engages in back-and-forth discussion to clarify requirements and design the approach | +| **Prompt Generation** | Creates versioned prompt files (e.g., `prompt1.md`, `prompt2.md`) based on your design discussion | +| **Ralph Orchestration** | Spawns Ralph in Pane 1 with the correct prompt file and agent settings | +| **Status Monitoring** | Lets you check Ralph's progress on demand via tmux commands | + +### How It Works + +When you initialize the Businessman skill, you enter a collaborative workflow: + +1. **You propose a task** - "Let's build a CLI tool that manages todos" +2. **Skill asks clarifying questions** - "What commands should it support? How should it store data?" +3. **You approve the design** - After discussion, you confirm the approach +4. **Skill spawns Ralph** - The skill automatically starts Ralph in Pane 1 with a properly formatted prompt file +5. **You monitor/interact** - You can check Ralph's status or add context as needed + +**You do not need to manually run Ralph commands.** The skill handles Ralph spawning and orchestration. If you prefer to run Ralph yourself directly in Pane 1, that's also possible - the skill just makes it easier. + ## Requirements - [Claude Code CLI](https://claude.ai/download) (`claude` command) @@ -95,24 +120,20 @@ If the selected model has a context length: If no context length is available: - `CLAUDE_CODE_DISABLE_1M_CONTEXT=1` -## The Businessman Skill +## Using the Businessman Skill -This tmux session is initialized with the Businessman skill, which provides: +The skill is automatically initialized when you run `businessman`. To use it manually after the session is running: -- Interactive model selection via llama-swap -- Automatic tmux pane setup for Claude + Ralph workflows -- Context-aware Claude Code configuration -- Integration with Ralph for autonomous coding tasks - -To use the skill manually, run: ``` claude "Use the businessman skill to initialize our session" ``` +The skill will then guide you through collaborative task design and automatically spawn Ralph in Pane 1 when you're ready to execute. + ## Tmux Session Management - **Pane 0**: Claude Code (model selected during startup) -- **Pane 1**: Bash shell - ready to run Ralph commands +- **Pane 1**: Bash shell - can run Ralph directly or be orchestrated by the Businessman skill To detach from the tmux session: `Ctrl+b` then `d` @@ -122,14 +143,29 @@ To list sessions: `tmux ls` ## Ralph Integration -Once Ralph is installed, you can run autonomous tasks in Pane 1: +Ralph runs in Pane 1 and can be used in two ways: +### Via the Businessman Skill (Recommended) +The skill automatically spawns Ralph for you during collaborative design sessions. When you and the skill agree on a task design, the skill writes a prompt file and starts Ralph with the appropriate settings. You can check status with: +```bash +tmux capture-pane -pt :0.1 +``` + +### Direct Usage +You can also run Ralph manually in Pane 1: ```bash ralph --prompt-file ./prompt1.md --max-iterations 5 --agent claude-code ``` Use `ralph --status` to check progress, and `ralph --add-context "..."` to inject hints if needed. +## Summary + +| Approach | When to Use | +|----------|-------------| +| Businessman skill + Ralph | Collaborative design with interactive clarification and automatic task breakdown | +| Direct Ralph usage | When you already have a specific prompt file and want to run it directly | + ## License MIT diff --git a/businessman b/businessman index 5c24239..5457955 100755 --- a/businessman +++ b/businessman @@ -7,7 +7,7 @@ set -e LLAMA_SWAP_API="${LLAMA_SWAP_API:-http://192.168.50.21:6901}" -echo "🔧 Fetching models from llama-swap..." +echo "Fetching models from llama-swap..." MODELS_JSON=$(curl -s "$LLAMA_SWAP_API/v1/models") if [ $? -ne 0 ]; then @@ -26,7 +26,7 @@ if [ ${#MODEL_IDS[@]} -eq 0 ]; then fi echo "" -echo "🔍 Available models:" +echo "Available models:" for i in "${!MODEL_IDS[@]}"; do printf "%2d) %s" "$((i+1))" "${MODEL_IDS[$i]}" if [ "${MODEL_CTXS[$i]}" != "unknown" ] && [ -n "${MODEL_CTXS[$i]}" ]; then