Modified readme to be more representative of how businessman should work

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