feat: task-006 - Update documentation

Updated three README files to document TaskMaster integration, new CLI
subcommands, and OpenCode executor support:

README.md changes:
- Added OpenCode as fourth executor option
- Updated workflow section with new CLI subcommands (run, status, list-tasks)
- Added visual progress display section with Unicode box-drawing examples
- Added TaskMaster format migration guide with prd.json → tasks.json
- Updated all examples to use new subcommand syntax
- Updated key files table to reflect tasks.json format

ralph/README.md changes:
- Added TaskMaster integration section with task format documentation
- Documented new CLI subcommands (run, status, list-tasks) with examples
- Added dependency management section (dependsOn, blockedBy)
- Added visual progress display documentation with status icons
- Updated environment variables to include OPENCODE_MODEL and TASKMASTER_URL
- Added hybrid mode documentation (file-based vs MCP)
- Expanded breaking changes section with new features list
- Updated project structure to show new modules (taskmaster_adapter, progress_display)

README-MCP.md changes:
- Added TaskMaster MCP integration section
- Documented TaskMaster MCP server setup (file-based and MCP modes)
- Added TaskMaster CLI integration instructions
- Added MCP client config example for TaskMaster
- Documented TaskMaster features in Ralph (status management, dependencies, visual progress)
- Added migration reference to main README

All quality checks passing (mypy, ruff, pytest).
🤖 Generated with [Nori](https://nori.ai)

Co-Authored-By: Nori <contact@tilework.tech>

Author: b

README-MCP.md

@@ -1,6 +1,6 @@
 # Ralph MCP Integration 🚀
 
-Ralph now supports **FastMCP 3.0** with both server and client capabilities!
+Ralph now supports **FastMCP 3.0** with both server and client capabilities, plus TaskMaster-AI integration for rich task management!
 
 ## Features
 
@@ -20,9 +20,11 @@ Ralph exposes its autonomous agent capabilities as an MCP server with:
 
 **As CLI (default):**
 ```bash
+# Using new Python CLI with subcommands
+uv run ralph run --tool codex --max-iterations 3
+
+# Or using deprecated bash wrapper
 ./ralph.sh --agent codex 3
-# or
-uv run --script ralphython.py --agent codex 3
 ```
 
 **As MCP Server (HTTP):**
@@ -77,3 +79,101 @@ Add to your MCP client settings (e.g., Claude Desktop):
 - Supports both CLI and MCP modes via `--mcp` flag
 - Model: gpt-5.2-codex (configurable via `CODEX_MODEL` env var)
 
+## TaskMaster MCP Integration
+
+Ralph now integrates with TaskMaster-AI for advanced task management via MCP protocol.
+
+### Setup TaskMaster MCP Server
+
+**Option 1: File-Based (Default)**
+
+No setup required! Ralph reads/writes `tasks.json` directly:
+
+```bash
+# Works out of the box
+uv run ralph status
+uv run ralph list-tasks
+uv run ralph run --tool amp
+```
+
+**Option 2: TaskMaster MCP Server**
+
+Connect to a TaskMaster MCP server for remote task management:
+
+```bash
+# Set TaskMaster server URL
+export TASKMASTER_URL="http://localhost:8080"
+
+# Ralph will use MCP instead of file-based access
+uv run ralph status
+uv run ralph run --tool amp
+```
+
+### TaskMaster CLI Integration
+
+Ralph also supports the TaskMaster CLI for task operations:
+
+```bash
+# Install TaskMaster CLI
+npm install -g @taskmaster-ai/cli
+
+# Ralph will detect and use it automatically
+uv run ralph status
+uv run ralph list-tasks
+```
+
+### MCP Client Config for TaskMaster
+
+Add TaskMaster to your MCP client settings (e.g., Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "taskmaster": {
+      "command": "taskmaster",
+      "args": ["mcp", "start"]
+    },
+    "ralph": {
+      "command": "uv",
+      "args": ["run", "ralph", "mcp", "start"],
+      "env": {
+        "TASKMASTER_URL": "mcp://taskmaster"
+      }
+    }
+  }
+}
+```
+
+### TaskMaster Features in Ralph
+
+1. **Task Status Management**: pending → in-progress → done
+2. **Dependency Tracking**: `dependsOn` and `blockedBy` fields
+3. **Visual Progress**: Unicode progress bars and task trees
+4. **CLI Commands**: `status`, `list-tasks` with filtering
+5. **Hybrid Mode**: File-based or MCP server
+
+### Example: Using Ralph with TaskMaster
+
+```bash
+# Check current status
+uv run ralph status
+
+# Expected output:
+# ==================================================
+# Progress: [████████████░░░░░░░░] 60.0%
+# Completed: 3/5 | In Progress: 1 | Pending: 1 | Blocked: 0
+# ==================================================
+
+# List pending tasks
+uv run ralph list-tasks --filter pending
+
+# Run autonomous loop
+uv run ralph run --tool amp --max-iterations 10
+```
+
+### Migration from prd.json to tasks.json
+
+Ralph has migrated from legacy `prd.json` format to TaskMaster's `tasks.json` format.
+
+See the main [README.md](README.md) for the complete migration guide.
+