task-o-matic 0.1.3 → 0.1.5-beta.1

package/README.md

@@ -1,465 +1,840 @@
-# task-o-matic
+# ⛑️ task-o-matic CLI
 
-AI-powered task management CLI for single projects. Parse PRDs, enhance tasks with AI, and manage your development workflow from the command line.
+**Your command bunker in the post-apocalyptic development wasteland**
 
-## Overview
+---
 
-`task-o-matic` is the command-line interface for the Task-O-Matic system. It provides a complete set of commands for managing tasks, processing PRDs, and automating project workflows with AI assistance.
+## ⚠️ SURVIVAL BULLETIN
 
-## Installation
+_Citizen, the world outside has changed. The software development landscape shifted from chaos into something... darker. But your projects don't have to die in the radioactive dust of bad management._
 
-### Global Installation
+_The `task-o-matic` CLI is your bunker command system. Think of it as a wrist-mounted interface for code—organizing tasks, parsing documents, and deploying artificial intelligence to help your projects thrive when everything else has collapsed._
 
-```bash
-npm install -g task-o-matic
-```
+_[The preceding message was brought to you by the Department of Project Preservation. Remember: A prepared developer is a surviving developer.]_
+
+---
 
-### Using npx
+## 📋 COMMAND STRUCTURE
+
+The CLI is organized into command groups. Each group serves a specific survival function:
 
 ```bash
-npx task-o-matic init
+task-o-matic <command-group> <subcommand> [options]
 ```
 
-## Quick Start
+### Available Command Groups
+
+| Group | Purpose |
+|-------|---------|
+| `init` | Initialize projects, attach to existing codebases, bootstrap fresh starts |
+| `tasks` | Task CRUD, enhancement, splitting, execution, planning, documentation |
+| `prd` | Product Requirements Document management (create, parse, refine, combine) |
+| `workflow` | Guided end-to-end project setup and automation |
+| `config` | AI provider and project configuration |
+| `benchmark` | AI model performance comparison and testing |
+| `detect` | Technology stack detection and analysis |
+| `continue` | Resume work on existing projects |
+| `prompt` | Build AI prompts for external tools |
+| `install` | Install documentation and agent guides |
+
+---
 
-### Initialize Your Project
+## 🚀 QUICK START: SURVIVAL MODE
+
+### The One-Shot Approach (Fastest Survival)
 
 ```bash
-# Navigate to your project directory
+# Navigate to your project's containment zone
 cd /path/to/your/project
 
-# Initialize task-o-matic
-task-o-matic init init --project-name my-app
+# One command. The AI guides you through everything.
+task-o-matic workflow --stream
+```
 
-# Configure AI provider
-task-o-matic config set-ai-provider anthropic claude-3-5-sonnet
+**What happens:**
+1. Initialization of the command bunker (`.task-o-matic/` directory)
+2. PRD creation or loading
+3. PRD refinement with AI-generated questions
+4. Task generation from refined PRD
+5. Task splitting into manageable chunks
 
-# Create your first task
-task-o-matic tasks create --title "Implement user authentication" --ai-enhance
-```
+**Estimated time:** 5-10 minutes
 
-### Interactive Workflow (Recommended)
+### The Surgical Strike (When You Know What You're Doing)
 
 ```bash
-# Start the interactive workflow with streaming
-task-o-matic workflow --stream
-```
+# Initialize containment directory
+task-o-matic init init --ai-provider anthropic --ai-model claude-3-5-sonnet
 
-The workflow will guide you through:
-1. Project initialization
-2. PRD creation
-3. PRD refinement with AI questions
-4. Task generation
-5. Task splitting
+# Configure AI provider
+task-o-matic config set-ai-provider anthropic claude-3-5-sonnet
 
-## Commands
+# Create task with AI enhancement
+task-o-matic tasks create --title "Add survivor authentication" --ai-enhance --stream
+```
+
+---
 
-### Initialization Commands
+## 🏗️ INITIALIZATION COMMANDS
 
-#### `task-o-matic init init`
+### `task-o-matic init init`
 
-Initialize a new project with task-o-matic.
+Initialize a new project command bunker.
 
 ```bash
 # Basic initialization
 task-o-matic init init
 
-# Initialize with project name
-task-o-matic init init --project-name my-app
+# With project name and AI configuration
+task-o-matic init init --project-name my-shelter-manager \
+  --ai-provider anthropic --ai-model claude-3-5-sonnet
 
-# Initialize with AI configuration
-task-o-matic init init --project-name my-app --ai-provider openrouter --ai-model anthropic/claude-3.5-sonnet --ai-key your-api-key
-
-# Initialize without bootstrapping
+# Without bootstrapping
 task-o-matic init init --no-bootstrap
 ```
 
 **Options:**
-- `--project-name <name>`: Name of the project
 - `--ai-provider <provider>`: AI provider (openai, anthropic, openrouter, custom)
 - `--ai-model <model>`: AI model to use
 - `--ai-key <key>`: API key for the AI provider
+- `--ai-provider-url <url>`: Custom AI provider URL
+- `--max-tokens <tokens>`: Max tokens for AI responses
+- `--temperature <temp>`: AI temperature (0-1)
 - `--no-bootstrap`: Skip project bootstrapping
-
-#### `task-o-matic init bootstrap`
-
-Bootstrap a Better-T-Stack project.
+- `--project-name <name>`: Project name for bootstrap
+- `--frontend <frontends...>`: Frontend framework(s) for bootstrap
+- `--backend <backend>`: Backend framework for bootstrap
+- `--database <database>`: Database for bootstrap
+- `--auth <auth>`: Authentication for bootstrap
+- `--context7-api-key <key>`: Context7 API key for documentation fetching
+- `--directory <dir>`: Working directory for the project
+- `--package-manager <pm>`: Package manager (npm, bun, pnpm, yarn)
+- `--runtime <runtime>`: Runtime (node, bun, deno)
+- `--payment <payment>`: Payment provider
+- `--cli-deps <level>`: CLI dependency level
+
+### `task-o-matic init bootstrap <name>`
+
+Bootstrap a new project with Better-T-Stack.
 
 ```bash
-# Bootstrap with defaults (Next.js + Hono + SQLite + Auth)
-task-o-matic init bootstrap my-app
+# Full-stack web application
+task-o-matic init bootstrap vault-app --frontend next --backend hono --database postgres --auth
 
-# Bootstrap with custom options
-task-o-matic init bootstrap my-app --frontend next --backend hono --database postgres --addons pwa biome
+# CLI application
+task-o-matic init bootstrap shelter-cli --backend hono --database sqlite --no-auth
 
-# Bootstrap with authentication
-task-o-matic init bootstrap my-app --auth
+# Native mobile app
+task-o-matic init bootstrap survival-mobile --frontend react-native --auth
 ```
 
 **Options:**
-- `--frontend <framework>`: Frontend framework (next, react, vue, svelte, none)
-- `--backend <framework>`: Backend framework (hono, express, fastify, none)
-- `--database <db>`: Database (sqlite, postgres, mysql, mongodb, none)
-- `--auth`: Enable authentication
-- `--addons <addons>`: Additional addons (comma-separated: pwa, biome, testing, etc.)
-
-### Configuration Commands
-
-#### `task-o-matic config set-ai-provider`
-
-Set the AI provider and model.
+- `--frontend <frontends...>`: Frontend framework(s) (next, react, vue, svelte, react-native, none)
+- `--backend <backend>`: Backend framework (hono, express, fastify, none)
+- `--database <database>`: Database (sqlite, postgres, mysql, mongodb, none)
+- `--orm <orm>`: ORM (prisma, drizzle, typeorm)
+- `--auth <auth>`: Authentication (better-auth, clerk, nextauth, auth0, none)
+- `--no-auth`: Exclude authentication
+- `--addons <addons...>`: Addons (pwa, biome, testing, etc.)
+- `--examples <examples...>`: Examples to include
+- `--template <template>`: Use a predefined template
+- `--no-git`: Skip git initialization
+- `--package-manager <pm>`: Package manager
+- `--no-install`: Skip installing dependencies
+- `--db-setup <setup>`: Database setup
+- `--runtime <runtime>`: Runtime
+- `--api <type>`: API type
+- `--payment <payment>`: Payment provider
+- `--cli-deps <level>`: CLI dependency level
+
+### `task-o-matic init attach`
+
+Attach the command bunker to an existing project.
 
 ```bash
-# Set Anthropic provider
-task-o-matic config set-ai-provider anthropic claude-3-5-sonnet
+# Auto-detect stack
+task-o-matic init attach --analyze --create-prd
 
-# Set OpenAI provider
-task-o-matic config set-ai-provider openai gpt-4
-
-# Set OpenRouter provider
-task-o-matic config set-ai-provider openrouter anthropic/claude-3.5-sonnet
+# Just detect without creating files
+task-o-matic init attach --dry-run
 
-# Set custom provider
-task-o-matic config set-ai-provider custom custom-model --api-url https://api.custom.com/v1
+# Force re-detection
+task-o-matic init attach --redetect
 ```
 
-#### `task-o-matic config show-ai`
-
-Display current AI configuration.
+**Options:**
+- `--analyze`: Run full project analysis including TODOs and features
+- `--create-prd`: Auto-generate a PRD from codebase analysis
+- `--dry-run`: Just detect, don't create files
+- `--redetect`: Force re-detection of stack
+- `--ai-provider <provider>`: AI provider
+- `--ai-model <model>`: AI model
+- `--ai-key <key>`: AI API key
+- `--ai-provider-url <url>`: AI provider URL
+- `--max-tokens <tokens>`: Max tokens for AI
+- `--temperature <temp>`: AI temperature
+- `--context7-api-key <key>`: Context7 API key
 
-```bash
-task-o-matic config show-ai
-```
+---
 
-### Task Commands
+## 📝 TASK COMMANDS
 
-#### `task-o-matic tasks create`
+### `task-o-matic tasks create`
 
-Create a new task.
+Create a new task with AI enhancement.
 
 ```bash
-# Create a basic task
-task-o-matic tasks create --title "Implement user authentication"
-
-# Create task with content
-task-o-matic tasks create --title "Add payment integration" --content "Integrate Stripe for payment processing"
-
-# Create task with AI enhancement
-task-o-matic tasks create --title "Implement user authentication" --ai-enhance
+# Basic task
+task-o-matic tasks create --title "Fix water filtration system"
 
-# Create task with streaming AI output
-task-o-matic tasks create --title "Add payment integration" --ai-enhance --stream
+# With content and enhancement
+task-o-matic tasks create --title "Add survivor tracking" \
+  --content "Implement tracking system for all bunker residents" \
+  --ai-enhance --stream
 
-# Create task with priority and tags
-task-o-matic tasks create --title "Fix critical bug" --priority high --tags bug,urgent
+# With parent task
+task-o-matic tasks create --title "Install sensor hardware" \
+  --parent-id 1 --effort 2h
 ```
 
 **Options:**
 - `--title <title>`: Task title (required)
 - `--content <content>`: Task description
+- `--effort <effort>`: Estimated effort (e.g., 2h, 4h, 1d)
+- `--parent-id <id>`: Parent task ID for subtasks
 - `--ai-enhance`: Enhance task with AI
-- `--stream`: Enable streaming output
-- `--priority <priority>`: Task priority (low, medium, high)
-- `--tags <tags>`: Comma-separated tags
+- `--stream`: Show streaming AI output
+- `--ai-provider <provider>`: AI provider override
+- `--ai-model <model>`: AI model override
+- `--ai-key <key>`: AI API key override
+- `--ai-provider-url <url>`: AI provider URL override
+- `--reasoning <tokens>`: Enable reasoning for OpenRouter models
 
-#### `task-o-matic tasks list`
+### `task-o-matic tasks list`
 
-List all tasks.
+List tasks with filtering.
 
 ```bash
 # List all tasks
 task-o-matic tasks list
 
-# List tasks by status
+# Filter by status
 task-o-matic tasks list --status todo
 task-o-matic tasks list --status in-progress
 task-o-matic tasks list --status completed
 
-# List tasks with raw JSON output
-task-o-matic tasks list --raw
-
-# List tasks with tree view
-task-o-matic tasks list --tree
+# Filter by tag
+task-o-matic tasks list --tag security
 ```
 
 **Options:**
 - `--status <status>`: Filter by status (todo, in-progress, completed)
-- `--raw`: Output raw JSON
-- `--tree`: Show task tree with subtasks
+- `--tag <tag>`: Filter by tag
 
-#### `task-o-matic tasks show`
+### `task-o-matic tasks show`
 
-Display details of a specific task.
+Display detailed information about a task.
 
 ```bash
-task-o-matic tasks show <task-id>
+task-o-matic tasks show --id 7
 ```
 
-#### `task-o-matic tasks update`
-
-Update a task.
+**Options:**
+- `--id <id>`: Task ID to show (required)
 
-```bash
-# Update task status
-task-o-matic tasks update <task-id> --status in-progress
+### `task-o-matic tasks update`
 
-# Update task title
-task-o-matic tasks update <task-id> --title "New title"
+Update an existing task.
 
-# Update task content
-task-o-matic tasks update <task-id> --content "New description"
+```bash
+# Update status
+task-o-matic tasks update --id 7 --status in-progress
 
-# Update task priority
-task-o-matic tasks update <task-id> --priority high
+# Update title and description
+task-o-matic tasks update --id 7 --title "New title" --description "New description"
 
-# Update task tags
-task-o-matic tasks update <task-id> --tags updated,important
+# Update effort and tags
+task-o-matic tasks update --id 7 --effort 4h --tags critical,backend
 ```
 
 **Options:**
+- `--id <id>`: Task ID to update (required)
+- `--title <title>`: New task title
+- `--description <description>`: New task description
 - `--status <status>`: New status (todo, in-progress, completed)
-- `--title <title>`: New title
-- `--content <content>`: New content
-- `--priority <priority>`: New priority (low, medium, high)
-- `--tags <tags>`: Comma-separated tags
+- `--effort <effort>`: New estimated effort
+- `--tags <tags>`: New tags (comma-separated)
 
-#### `task-o-matic tasks delete`
+### `task-o-matic tasks delete`
 
 Delete a task.
 
 ```bash
-task-o-matic tasks delete <task-id>
+# Delete with confirmation
+task-o-matic tasks delete --id 7
+
+# Force delete without confirmation
+task-o-matic tasks delete --id 7 --force
+
+# Delete task and all subtasks
+task-o-matic tasks delete --id 7 --cascade
 ```
 
-#### `task-o-matic tasks split`
+**Options:**
+- `--id <id>`: Task ID to delete (required)
+- `--force`: Skip confirmation prompt
+- `--cascade`: Delete all subtasks
 
-Split a complex task into subtasks.
+### `task-o-matic tasks enhance`
+
+Enhance an existing task with AI using Context7 documentation.
 
 ```bash
-# Split a specific task
-task-o-matic tasks split <task-id>
+# Enhance single task
+task-o-matic tasks enhance --task-id 7 --stream
 
-# Split with streaming output
-task-o-matic tasks split <task-id> --stream
+# Enhance all tasks
+task-o-matic tasks enhance --all --force --stream
 
-# Split with custom instructions
-task-o-matic tasks split <task-id> --instructions "Break into 2-4 hour chunks"
+# Enhance specific status/tag
+task-o-matic tasks enhance --status todo --tag critical --dry
 ```
 
 **Options:**
-- `--stream`: Enable streaming output
-- `--instructions <instructions>`: Custom instructions for AI
+- `--task-id <id>`: Task ID to enhance
+- `--all`: Enhance all existing tasks
+- `--status <status>`: Filter tasks by status
+- `--tag <tag>`: Filter tasks by tag
+- `--dry`: Preview what would be enhanced
+- `--force`: Skip confirmation prompt
+- `--stream`: Show streaming AI output
+- `--ai-provider <provider>`: AI provider override
+- `--ai-model <model>`: AI model override
+- `--ai-key <key>`: AI API key override
+- `--ai-provider-url <url>`: AI provider URL override
+- `--reasoning <tokens>`: Enable reasoning
+
+### `task-o-matic tasks split`
+
+Split a task into smaller subtasks using AI.
 
-#### `task-o-matic tasks enhance`
+```bash
+# Split single task (works even if it already has subtasks)
+task-o-matic tasks split --task-id 7 --stream
 
-Enhance a task with AI.
+# Split all tasks
+task-o-matic tasks split --all --force --stream
 
-```bash
-# Enhance task
-task-o-matic tasks enhance <task-id>
+# Multi-AI splitting
+task-o-matic tasks split --task-id 7 \
+  --ai "anthropic:claude-3.5-sonnet,openai:gpt-4o" \
+  --combine-ai anthropic:claude-3.5-sonnet \
+  --stream
+```
 
-# Enhance with streaming
-task-o-matic tasks enhance <task-id> --stream
+**Options:**
+- `--task-id <id>`: Task ID to split
+- `--all`: Split all existing tasks
+- `--status <status>`: Filter tasks by status
+- `--tag <tag>`: Filter tasks by tag
+- `--dry`: Preview what would be split
+- `--force`: Skip confirmation prompt
+- `--stream`: Show streaming AI output
+- `--ai-provider <provider>`: AI provider override
+- `--ai-key <key>`: AI API key override
+- `--ai-provider-url <url>`: AI provider URL override
+- `--ai <models...>`: AI model(s) to use (comma-separated)
+- `--combine-ai <provider:model>`: AI model to combine results
+- `--reasoning <tokens>`: Enable reasoning
+- `--tools`: Enable filesystem tools
+
+### `task-o-matic tasks execute`
+
+Execute a task using an external coding assistant.
+
+```bash
+# Execute with planning and review
+task-o-matic tasks execute --id 7 \
+  --tool opencode \
+  --plan --review \
+  --verify "bun test" \
+  --max-retries 3
+
+# Progressive model retry
+task-o-matic tasks execute --id 7 \
+  --try-models "gpt-4o-mini,gpt-4o,claude:sonnet-4" \
+  --verify "bun run build" \
+  --auto-commit
 ```
 
 **Options:**
-- `--stream`: Enable streaming output
+- `--id <id>`: Task ID to execute (required)
+- `--tool <tool>`: External tool (opencode, claude, gemini, codex)
+- `--message <message>`: Custom message to send
+- `--model <model>`: Model to use
+- `--continue-session`: Continue last session
+- `--dry`: Show what would be executed
+- `--verify <command>`: Verification command (alias: `--validate`)
+- `--max-retries <number>`: Maximum number of retries
+- `--try-models <models>`: Progressive model/executor configs
+- `--plan`: Generate implementation plan
+- `--plan-model <model>`: Model for planning
+- `--plan-tool <tool>`: Tool for planning
+- `--review-plan`: Pause for human review
+- `--review`: Run AI review after execution
+- `--review-model <model>`: Model for review
+- `--auto-commit`: Automatically commit changes
+- `--include-prd`: Include PRD content
+
+### `task-o-matic tasks execute-loop`
+
+Execute multiple tasks in a loop with retry logic.
+
+```bash
+# Execute all TODO tasks
+task-o-matic tasks execute-loop --status todo \
+  --tool opencode \
+  --verify "bun test" \
+  --max-retries 3
+
+# Execute specific tasks
+task-o-matic tasks execute-loop --ids 7,8,9 \
+  --plan --review \
+  --auto-commit
+```
 
-#### `task-o-matic tasks execute`
+**Options:**
+- `--status <status>`: Filter tasks by status
+- `--tag <tag>`: Filter tasks by tag
+- `--ids <ids>`: Comma-separated list of task IDs
+- `--tool <tool>`: External tool to use
+- `--max-retries <number>`: Maximum retries per task
+- `--try-models <models>`: Progressive model/executor configs
+- `--model <model>`: Model to force
+- `--verify <command>`: Verification command (alias: `--validate`)
+- `--message <message>`: Custom message
+- `--continue-session`: Continue last session
+- `--auto-commit`: Automatically commit changes
+- `--plan`: Generate implementation plan
+- `--plan-model <model>`: Model for planning
+- `--plan-tool <tool>`: Tool for planning
+- `--review-plan`: Pause for human review
+- `--review`: Run AI review after execution
+- `--review-model <model>`: Model for review
+- `--include-completed`: Include completed tasks
+- `--include-prd`: Include PRD content
+- `--notify <target>`: Notify on completion
+- `--dry`: Show what would be executed
+
+### `task-o-matic tasks get-next`
 
-Execute a task with AI assistance.
+Get the next task to work on.
 
 ```bash
-# Execute task
-task-o-matic tasks execute <task-id>
+# Get next TODO task
+task-o-matic tasks get-next --status todo
 
-# Execute with streaming
-task-o-matic tasks execute <task-id> --stream
+# Get next critical priority task
+task-o-matic tasks get-next --tag critical
 
-# Execute in loop mode
-task-o-matic tasks execute <task-id> --loop
+# Get shortest task
+task-o-matic tasks get-next --priority effort
 ```
 
 **Options:**
-- `--stream`: Enable streaming output
-- `--loop`: Execute in loop mode (continue until completion)
+- `--status <status>`: Filter by status
+- `--tag <tag>`: Filter by tag
+- `--effort <effort>`: Filter by effort
+- `--priority <priority>`: Sort priority (newest, oldest, effort)
 
-#### `task-o-matic tasks next`
+### `task-o-matic tasks status`
 
-Get the next task to work on.
+Set task status.
 
 ```bash
-task-o-matic tasks next
+task-o-matic tasks status --id 7 --status in-progress
 ```
 
-#### `task-o-matic tasks status`
+**Options:**
+- `--id <id>`: Task ID (required)
+- `--status <status>`: New status (todo, in-progress, completed)
+
+### `task-o-matic tasks tree`
 
-Show task status summary.
+Display hierarchical task tree.
 
 ```bash
-task-o-matic tasks status
+# Show full tree
+task-o-matic tasks tree
+
+# Show subtree starting from task 7
+task-o-matic tasks tree --id 7
 ```
 
-#### `task-o-matic tasks tree`
+**Options:**
+- `--id <id>`: Root task ID (optional - shows full tree if not specified)
+
+### `task-o-matic tasks subtasks`
 
-Display task hierarchy as a tree.
+List subtasks for a task.
 
 ```bash
-task-o-matic tasks tree
+task-o-matic tasks subtasks --id 7
 ```
 
-#### `task-o-matic tasks tags`
+**Options:**
+- `--id <id>`: Parent task ID (required)
+
+### `task-o-matic tasks add-tags` / `tasks remove-tags`
 
-List all tags used across tasks.
+Add or remove tags from a task.
 
 ```bash
-task-o-matic tasks tags
+# Add tags
+task-o-matic tasks add-tags --id 7 --tags critical,security
+
+# Remove tags
+task-o-matic tasks remove-tags --id 7 --tags deprecated
 ```
 
-#### `task-o-matic tasks subtasks`
+**Options:**
+- `--id <id>`: Task ID (required)
+- `--tags <tags>`: Tags to add/remove (comma-separated)
+
+---
+
+## 📋 TASK PLAN COMMANDS
 
-Show subtasks for a task.
+### `task-o-matic tasks plan`
+
+Create detailed implementation plan for a task.
 
 ```bash
-task-o-matic tasks subtasks <task-id>
+task-o-matic tasks plan --id 7 --stream
 ```
 
-### Task Document Commands
+**Options:**
+- `--id <id>`: Task or subtask ID (required)
+- `--stream`: Show streaming AI output
+- `--ai-provider <provider>`: AI provider override
+- `--ai-model <model>`: AI model override
+- `--ai-key <key>`: AI API key override
+- `--ai-provider-url <url>`: AI provider URL override
+- `--reasoning <tokens>`: Enable reasoning
 
-#### `task-o-matic tasks document add`
+### `task-o-matic tasks list-plan`
 
-Add documentation to a task.
+List all available implementation plans.
 
 ```bash
-task-o-matic tasks document add <task-id> --file ./docs/implementation.md
+task-o-matic tasks list-plan
+```
+
+### `task-o-matic tasks get-plan`
+
+View existing implementation plan.
+
+```bash
+task-o-matic tasks get-plan --id 7
 ```
 
 **Options:**
-- `--file <file>`: Documentation file to add
+- `--id <id>`: Task or subtask ID (required)
 
-#### `task-o-matic tasks document get`
+### `task-o-matic tasks set-plan`
 
-Get documentation for a task.
+Set implementation plan for a task.
 
 ```bash
-task-o-matic tasks document get <task-id>
+# Set from text
+task-o-matic tasks set-plan --id 7 --plan "Step 1: Setup\nStep 2: Implement\nStep 3: Test"
+
+# Set from file
+task-o-matic tasks set-plan --id 7 --plan-file ./plans/implementation.md
 ```
 
-#### `task-o-matic tasks document analyze`
+**Options:**
+- `--id <id>`: Task ID (required)
+- `--plan <text>`: Plan content
+- `--plan-file <path>`: Path to file containing plan
 
-Analyze task documentation with AI.
+### `task-o-matic tasks delete-plan`
 
-```bash
-task-o-matic tasks document analyze <task-id>
+Delete implementation plan.
 
-# Analyze with streaming
-task-o-matic tasks document analyze <task-id> --stream
+```bash
+task-o-matic tasks delete-plan --id 7
 ```
 
 **Options:**
-- `--stream`: Enable streaming output
+- `--id <id>`: Task ID (required)
+
+---
 
-### Task Plan Commands
+## 📄 TASK DOCUMENTATION COMMANDS
 
-#### `task-o-matic tasks plan create`
+### `task-o-matic tasks document`
 
-Create a plan for a task.
+Analyze and fetch documentation for a task using AI with Context7.
 
 ```bash
-task-o-matic tasks plan create <task-id> --instructions "Break down into steps"
+task-o-matic tasks document --task-id 7 --force --stream
 ```
 
 **Options:**
-- `--instructions <instructions>`: Planning instructions
+- `--task-id <id>`: Task ID (required)
+- `--force`: Force refresh documentation even if recent
+- `--stream`: Show streaming AI output
+- `--ai-provider <provider>`: AI provider override
+- `--ai-model <model>`: AI model override
+- `--ai-key <key>`: AI API key override
+- `--ai-provider-url <url>`: AI provider URL override
+- `--reasoning <tokens>`: Enable reasoning
 
-#### `task-o-matic tasks plan get`
+### `task-o-matic tasks add-documentation`
 
-Get the plan for a task.
+Add documentation to a task from a file.
 
 ```bash
-task-o-matic tasks plan get <task-id>
+task-o-matic tasks add-documentation --id 7 --doc-file ./docs/api.md
 ```
 
-#### `task-o-matic tasks plan set`
+**Options:**
+- `--id <id>`: Task ID (required)
+- `--doc-file <path>`: Path to documentation file (required)
+- `--overwrite`: Overwrite existing documentation
+
+### `task-o-matic tasks get-documentation`
 
-Set a plan for a task.
+Get existing documentation for a task.
 
 ```bash
-task-o-matic tasks plan set <task-id> --plan "Step 1: Setup\nStep 2: Implement\nStep 3: Test"
+task-o-matic tasks get-documentation --id 7
 ```
 
 **Options:**
-- `--plan <plan>`: Plan content
+- `--id <id>`: Task ID (required)
+
+---
 
-#### `task-o-matic tasks plan delete`
+## 📋 PRD COMMANDS
 
-Delete the plan for a task.
+### `task-o-matic prd create <description>`
+
+Generate PRD(s) from a product description.
 
 ```bash
-task-o-matic tasks plan delete <task-id>
+# Single PRD generation
+task-o-matic prd create "Build a vault management system" --stream
+
+# Multi-AI PRD generation
+task-o-matic prd create "Build a vault manager" \
+  --ai "anthropic:claude-3.5-sonnet,openai:gpt-4o,openrouter:qwen-2.5" \
+  --combine-ai anthropic:claude-3.5-sonnet \
+  --stream
+
+# Custom output directory
+task-o-matic prd create "Survival tracking app" \
+  --output-dir ./prds \
+  --ai-reasoning 5000
 ```
 
-#### `task-o-matic tasks plan list`
+**Options:**
+- `<description>`: Product description (required)
+- `--ai <models...>`: AI model(s) to use
+- `--combine-ai <provider:model>`: AI model to combine multiple PRDs
+- `--output-dir <path>`: Directory to save PRDs
+- `--ai-reasoning <tokens>`: Enable reasoning for OpenRouter models
+- `--stream`: Enable streaming output
+
+### `task-o-matic prd combine`
 
-List all tasks with plans.
+Combine multiple PRD files into a master PRD.
 
 ```bash
-task-o-matic tasks plan list
+task-o-matic prd combine \
+  --files ./prds/prd1.md,./prds/prd2.md \
+  --description "Original vault manager description" \
+  --output ./prd-master.md \
+  --stream
 ```
 
-### PRD Commands
+**Options:**
+- `--files <paths...>`: PRD files to combine (required)
+- `--description <text>`: Original product description
+- `--ai <provider:model>`: AI model to use
+- `--output <path>`: Output file path
+- `--ai-reasoning <tokens>`: Enable reasoning
+- `--stream`: Enable streaming
 
-#### `task-o-matic prd parse`
+### `task-o-matic prd parse`
 
-Parse a PRD file into tasks.
+Parse a PRD file into structured tasks.
 
 ```bash
-# Parse PRD file
-task-o-matic prd parse --file requirements.md
-
-# Parse with streaming output
+# Basic parsing
 task-o-matic prd parse --file requirements.md --stream
 
-# Parse with custom instructions
-task-o-matic prd parse --file requirements.md --instructions "Focus on MVP features"
+# Multi-AI parsing
+task-o-matic prd parse --file requirements.md \
+  --ai "anthropic:claude-3.5-sonnet,openai:gpt-4o" \
+  --combine-ai anthropic:claude-3.5-sonnet \
+  --stream
+
+# With custom prompt
+task-o-matic prd parse --file requirements.md \
+  --prompt "Focus on security features" \
+  --tools
 ```
 
 **Options:**
-- `--file <file>`: PRD file to parse (required)
-- `--stream`: Enable streaming output
-- `--instructions <instructions>`: Custom instructions for AI
+- `--file <path>`: Path to PRD file (required)
+- `--ai <models...>`: AI model(s) to use
+- `--combine-ai <provider:model>`: AI model to combine results
+- `--prompt <prompt>`: Override prompt
+- `--message <message>`: User message
+- `--ai-provider <provider>`: AI provider override
+- `--ai-model <model>`: AI model override
+- `--ai-key <key>`: AI API key override
+- `--ai-provider-url <url>`: AI provider URL override
+- `--ai-reasoning <tokens>`: Enable reasoning
+- `--stream`: Show streaming AI output
+- `--tools`: Enable filesystem tools
+
+### `task-o-matic prd rework`
+
+Rework a PRD based on user feedback.
+
+```bash
+task-o-matic prd rework \
+  --file requirements.md \
+  --feedback "Add more security protocols and emergency procedures" \
+  --output ./reworked-prd.md \
+  --stream
+```
 
-#### `task-o-matic prd rework`
+**Options:**
+- `--file <path>`: Path to PRD file (required)
+- `--feedback <feedback>`: User feedback (required)
+- `--output <path>`: Output file path
+- `--prompt <prompt>`: Override prompt
+- `--message <message>`: User message
+- `--ai-provider <provider>`: AI provider override
+- `--ai-model <model>`: AI model override
+- `--ai-key <key>`: AI API key override
+- `--ai-provider-url <url>`: AI provider URL override
+- `--ai-reasoning <tokens>`: Enable reasoning
+- `--stream`: Show streaming AI output
+- `--tools`: Enable filesystem tools
+
+### `task-o-matic prd question`
+
+Generate clarifying questions for a PRD.
 
-Rework a PRD with AI feedback.
+```bash
+task-o-matic prd question --file requirements.md --output ./questions.json --stream
+```
+
+**Options:**
+- `--file <path>`: Path to PRD file (required)
+- `--output <path>`: Output JSON file path
+- `--prompt <prompt>`: Override prompt
+- `--message <message>`: User message
+- `--ai-provider <provider>`: AI provider override
+- `--ai-model <model>`: AI model override
+- `--ai-key <key>`: AI API key override
+- `--ai-provider-url <url>`: AI provider URL override
+- `--ai-reasoning <tokens>`: Enable reasoning
+- `--stream`: Show streaming AI output
+- `--tools`: Enable filesystem tools
+
+### `task-o-matic prd refine`
+
+Refine PRD by answering clarifying questions.
 
 ```bash
-# Rework PRD
-task-o-matic prd rework --file requirements.md --feedback "Add more security details"
+# AI answers questions
+task-o-matic prd refine --file requirements.md --question-mode ai --stream
 
-# Rework with streaming
-task-o-matic prd rework --file requirements.md --feedback "Focus on scalability" --stream
+# User answers questions
+task-o-matic prd refine --file requirements.md \
+  --questions ./questions.json \
+  --question-mode user \
+  --stream
 ```
 
 **Options:**
-- `--file <file>`: PRD file to rework (required)
-- `--feedback <feedback>`: Feedback for AI (required)
-- `--stream`: Enable streaming output
+- `--file <path>`: Path to PRD file (required)
+- `--questions <path>`: Path to questions JSON file
+- `--output <path>`: Output file path
+- `--prompt <prompt>`: Override prompt
+- `--message <message>`: User message
+- `--ai-provider <provider>`: AI provider override
+- `--ai-model <model>`: AI model override
+- `--ai-key <key>`: AI API key override
+- `--ai-provider-url <url>`: AI provider URL override
+- `--ai-reasoning <tokens>`: Enable reasoning
+- `--stream`: Show streaming AI output
+- `--tools`: Enable filesystem tools
+
+### `task-o-matic prd get-stack`
+
+Suggest optimal technology stack based on PRD analysis.
 
-### Workflow Commands
+```bash
+# Analyze from file
+task-o-matic prd get-stack --file requirements.md --save --json
 
-#### `task-o-matic workflow`
+# Analyze from content
+task-o-matic prd get-stack --content "Vault management system" --project-name vault-manager
+```
 
-Interactive workflow for complete project setup.
+**Options:**
+- `--file <path>`: Path to PRD file
+- `--content <text>`: PRD content as string
+- `--project-name <name>`: Project name
+- `--save`: Save suggested stack to .task-o-matic/stack.json
+- `--output <path>`: Custom output path
+- `--json`: Output result as JSON
+- `--prompt <prompt>`: Override prompt
+- `--message <message>`: User message
+- `--ai-provider <provider>`: AI provider override
+- `--ai-model <model>`: AI model override
+- `--ai-key <key>`: AI API key override
+- `--ai-provider-url <url>`: AI provider URL override
+- `--ai-reasoning <tokens>`: Enable reasoning
+- `--stream`: Show streaming AI output
+- `--tools`: Enable filesystem tools
+
+### `task-o-matic prd generate`
+
+Generate a PRD from an existing codebase (reverse-engineering).
 
 ```bash
-# Start interactive workflow
-task-o-matic workflow
+task-o-matic prd generate --output ./generated-prd.md --stream --tools
+```
+
+**Options:**
+- `--output <filename>`: Output filename
+- `--ai <provider:model>`: AI model to use
+- `--ai-reasoning <tokens>`: Enable reasoning
+- `--stream`: Enable streaming output
+- `--tools`: Enable filesystem tools for deeper analysis
+- `--json`: Output result as JSON
+
+---
+
+## 🔄 WORKFLOW COMMAND
 
-# Start with streaming output
+### `task-o-matic workflow`
+
+Interactive workflow for complete project setup and task management.
+
+```bash
+# Interactive with streaming
 task-o-matic workflow --stream
 
-# Automated workflow with all options
+# Fully automated
 task-o-matic workflow \
   --project-name my-saas-app \
   --project-description "Team collaboration platform" \
@@ -473,35 +848,119 @@ task-o-matic workflow \
   --stream
 ```
 
-**Options:**
+**Major Options:**
+
+**Initialization:**
+- `--stream`: Show streaming AI output
+- `--auto-accept`: Auto-accept all AI suggestions
+- `--skip-all`: Skip all optional steps
+- `--skip-init`: Skip initialization step
 - `--project-name <name>`: Project name
-- `--project-description <description>`: Project description
 - `--init-method <method>`: Initialization method (quick, custom, ai)
+- `--project-description <desc>`: Project description
+- `--use-existing-config`: Use existing configuration
+
+**Bootstrap:**
 - `--frontend <framework>`: Frontend framework
 - `--backend <framework>`: Backend framework
-- `--database <db>`: Database
-- `--auth/--no-auth`: Enable/disable authentication
-- `--prd-method <method>`: PRD creation method (file, manual, ai)
-- `--prd-file <file>`: PRD file path
-- `--prd-content <content>`: PRD content
-- `--prd-description <description>`: PRD description (for AI method)
-- `--refine-feedback <feedback>`: Feedback for PRD refinement
-- `--generate-instructions <instructions>`: Instructions for task generation
-- `--split-tasks/--no-split-tasks`: Enable/disable task splitting
-- `--split-all`: Split all complex tasks
-- `--split-instructions <instructions>`: Instructions for task splitting
-- `--skip-init`: Skip initialization step
-- `--skip-prd`: Skip PRD step
-- `--skip-refine`: Skip PRD refinement step
-- `--skip-generate`: Skip task generation step
-- `--skip-split`: Skip task splitting step
-- `--auto-accept`: Auto-accept all prompts
-- `--stream`: Enable streaming output
-- `--config-file <file>`: Load workflow from config file
+- `--database <db>`: Database choice
+- `--auth/--no-auth`: Include/exclude authentication
+- `--bootstrap/--no-bootstrap`: Bootstrap project
+
+**PRD:**
+- `--skip-prd`: Skip PRD definition
+- `--prd-method <method>`: PRD method (file, manual, ai)
+- `--prd-file <path>`: Path to existing PRD
+- `--prd-description <desc>`: Product description
+- `--prd-content <content>`: Direct PRD content
+- `--prd-multi-generation`: Generate multiple PRDs
+- `--skip-prd-multi-generation`: Skip multi-generation
+- `--prd-multi-generation-models <models>`: Models for multi-generation
+- `--prd-combine/--skip-prd-combine`: Combine generated PRDs
+- `--prd-combine-model <model>`: Model for combining
+
+**Stack Suggestion:**
+- `--skip-stack-suggestion`: Skip stack suggestion
+- `--suggest-stack-from-prd [path]`: Get stack from PRD
+
+**PRD Refinement:**
+- `--skip-prd-question-refine`: Skip PRD question/refine
+- `--prd-question-refine`: Use question-based refinement
+- `--prd-answer-mode <mode>`: Who answers questions
+- `--prd-answer-ai-provider <provider>`: AI provider for answering
+- `--prd-answer-ai-model <model>`: AI model for answering
+- `--prd-answer-ai-reasoning`: Enable reasoning for AI answering
+
+**Task Generation:**
+- `--skip-generate`: Skip task generation
+- `--generate-method <method>`: Generation method
+- `--generate-instructions <instructions>`: Custom task generation instructions
+
+**Task Splitting:**
+- `--skip-split`: Skip task splitting
+- `--split-tasks <ids>`: Task IDs to split
+- `--split-all`: Split all tasks
+- `--split-method <method>`: Split method
+- `--split-instructions <instructions>`: Custom split instructions
+
+**Execution:**
+- `--execute`: Execute generated tasks
+- `--execute-concurrency <number>`: Number of concurrent tasks
+- `--no-auto-commit`: Disable auto-commit
+- `--execute-tool <tool>`: Executor tool
+- `--execute-model <model>`: Model override for execution
+- `--execute-max-retries <number>`: Max retries per task
+- `--execute-plan`: Enable planning phase
+- `--execute-plan-model <model>`: Model for planning
+- `--execute-review`: Enable review phase
+- `--execute-review-model <model>`: Model for review
+- `--verify <command>`: Verification command
+- `--validate <command>`: Alias for --verify
+- `--try-models <models>`: Progressive model/executor configs
+
+---
+
+## ⚙️ CONFIGURATION COMMANDS
+
+### `task-o-matic config get-ai-config`
 
-### Benchmark Commands
+Get the current AI configuration.
 
-#### `task-o-matic benchmark run`
+```bash
+task-o-matic config get-ai-config
+```
+
+### `task-o-matic config set-ai-provider <provider> [model]`
+
+Set the AI provider and model.
+
+```bash
+# Set Anthropic
+task-o-matic config set-ai-provider anthropic claude-3-5-sonnet
+
+# Set OpenAI
+task-o-matic config set-ai-provider openai gpt-4
+
+# Set OpenRouter
+task-o-matic config set-ai-provider openrouter anthropic/claude-3.5-sonnet
+
+# Set custom
+task-o-matic config set-ai-provider custom custom-model --api-url https://api.custom.com/v1
+```
+
+### `task-o-matic config info`
+
+Get information about the current task-o-matic project.
+
+```bash
+task-o-matic config info
+```
+
+---
+
+## 🧪 BENCHMARK COMMANDS
+
+### `task-o-matic benchmark run <operation>`
 
 Run a benchmark on specific operations.
 
@@ -514,45 +973,78 @@ task-o-matic benchmark run prd-parse \
 
 # Benchmark task breakdown
 task-o-matic benchmark run task-breakdown \
-  --task-id <task-id> \
+  --task-id 7 \
   --models "openai:gpt-4o,anthropic:claude-3-5-sonnet" \
   --concurrency 2
 ```
 
 **Options:**
-- `--models <models>`: Comma-separated model list (required)
-- `--concurrency <number>`: Max parallel requests (default: 3)
-- `--delay <ms>`: Delay between requests (default: 1000ms)
+- `--models <list>`: Comma-separated list of models (required)
+- `--concurrency <number>`: Max concurrent requests (default: 3)
+- `--delay <number>`: Delay between requests in ms
+- Additional options specific to each operation
 
-#### `task-o-matic benchmark workflow`
+### `task-o-matic benchmark execution`
 
-Benchmark complete workflow across multiple AI models.
+Run execution benchmark with Git branch isolation.
 
 ```bash
-# Interactive workflow benchmark
-task-o-matic benchmark workflow \
-  --models "openai:gpt-4o,anthropic:claude-3-5-sonnet,openrouter:qwen/qwen-2.5-72b-instruct"
+task-o-matic benchmark execution \
+  --task-id 7 \
+  --models "openai:gpt-4o,anthropic:claude-3-5-sonnet" \
+  --verify "bun test" \
+  --max-retries 3
+```
 
-# Automated workflow benchmark
+**Options:**
+- `--task-id <id>`: Task ID to benchmark (required)
+- `--models <list>`: Comma-separated list of models (required)
+- `--verify <command>`: Verification command
+- `--max-retries <number>`: Maximum retries per model
+- `--no-keep-branches`: Delete benchmark branches
+
+### `task-o-matic benchmark execute-loop`
+
+Benchmark task loop execution across models.
+
+```bash
+task-o-matic benchmark execute-loop \
+  --status todo \
+  --models "openai:gpt-4o,anthropic:claude-3-5-sonnet" \
+  --verify "bun test" \
+  --max-retries 3
+```
+
+**Options:**
+- `--status <status>`: Filter tasks by status
+- `--tag <tag>`: Filter tasks by tag
+- `--ids <ids>`: Comma-separated list of task IDs
+- `--models <list>`: Comma-separated list of models (required)
+- `--verify <command>`: Verification command
+- `--max-retries <number>`: Maximum retries per task
+- `--try-models <models>`: Progressive model/executor configs
+- `--no-keep-branches`: Delete benchmark branches
+
+### `task-o-matic benchmark workflow`
+
+Benchmark complete workflow execution across multiple models.
+
+```bash
 task-o-matic benchmark workflow \
   --models "openai:gpt-4o,anthropic:claude-3-5-sonnet" \
-  --project-name "my-saas-app" \
-  --project-description "Team collaboration platform" \
-  --init-method ai \
-  --prd-method ai \
-  --auto-accept \
-  --split-all \
   --concurrency 2 \
-  --delay 2000
+  --delay 2000 \
+  --execute \
+  --skip-all
 ```
 
 **Options:**
-All workflow options are supported, plus:
-- `--models <models>`: Comma-separated model list (required)
-- `--concurrency <number>`: Max parallel requests (default: 3)
-- `--delay <ms>`: Delay between requests (default: 1000ms)
+All workflow options plus:
+- `--models <list>`: Comma-separated list of models (required)
+- `--concurrency <number>`: Max concurrent requests (default: 3)
+- `--delay <number>`: Delay between requests (default: 1000)
 
-#### `task-o-matic benchmark list`
+### `task-o-matic benchmark list`
 
 List all benchmark runs.
 
@@ -560,7 +1052,7 @@ List all benchmark runs.
 task-o-matic benchmark list
 ```
 
-#### `task-o-matic benchmark show`
+### `task-o-matic benchmark show <id>`
 
 Show details of a benchmark run.
 
@@ -568,7 +1060,7 @@ Show details of a benchmark run.
 task-o-matic benchmark show <run-id>
 ```
 
-#### `task-o-matic benchmark compare`
+### `task-o-matic benchmark compare <id>`
 
 Compare benchmark results.
 
@@ -576,130 +1068,250 @@ Compare benchmark results.
 task-o-matic benchmark compare <run-id>
 ```
 
-### Prompt Commands
-
-#### `task-o-matic prompt`
+### `task-o-matic benchmark operations`
 
-Run an AI prompt with context.
+List all available benchmark operations.
 
 ```bash
-# Run a simple prompt
-task-o-matic prompt "How do I implement authentication?"
+task-o-matic benchmark operations
+```
+
+---
+
+## 🔍 DETECT COMMAND
 
-# Run prompt with streaming
-task-o-matic prompt "Explain the architecture" --stream
+### `task-o-matic detect`
 
-# Run prompt with file context
-task-o-matic prompt "Review this code" --file ./src/auth.ts
+Detect technology stack of the current project.
+
+```bash
+# Auto-detect and save
+task-o-matic detect --save
+
+# Output as JSON
+task-o-matic detect --json
 ```
 
 **Options:**
-- `--stream`: Enable streaming output
-- `--file <file>`: Add file context to prompt
+- `--save`: Save detected stack to .task-o-matic/stack.json
+- `--json`: Output result as JSON
 
-### Install Commands
+---
 
-#### `task-o-matic install`
+## 📈 CONTINUE COMMAND
 
-Install shell completions.
+### `task-o-matic continue`
+
+Continue working on an existing project.
 
 ```bash
-# Install bash completions
-task-o-matic install --shell bash
+# Show project status
+task-o-matic continue --status
+
+# Add new feature to PRD
+task-o-matic continue --add-feature "Emergency notification system"
 
-# Install zsh completions
-task-o-matic install --shell zsh
+# Update PRD with progress
+task-o-matic continue --update-prd
 
-# Install fish completions
-task-o-matic install --shell fish
+# Generate tasks for unimplemented features
+task-o-matic continue --generate-tasks
+
+# Generate implementation plan for remaining work
+task-o-matic continue --generate-plan
 ```
 
 **Options:**
-- `--shell <shell>`: Shell type (bash, zsh, fish)
+- `--status`: Show project status overview
+- `--add-feature <feature>`: Add a new feature to the PRD
+- `--update-prd`: Update PRD with implementation progress
+- `--generate-tasks`: Generate tasks for unimplemented features
+- `--generate-plan`: Generate implementation plan for remaining work
+
+---
+
+## 💬 PROMPT COMMAND
 
-## Common Workflows
+### `task-o-matic prompt <name>`
 
-### Workflow 1: Complete Project Setup
+Build AI service prompts with variable replacement for external tools.
 
 ```bash
-# One command to initialize everything
-task-o-matic workflow --stream
+# List available prompts
+task-o-matic prompt --list
+
+# Get PRD parsing prompt
+task-o-matic prompt prd-parsing --prd-file ./requirements.md
+
+# Get task enhancement prompt with full context
+task-o-matic prompt task-enhancement \
+  --task-file ./tasks/7.md \
+  --full-context \
+  --executor opencode
 
-# The workflow will guide you through:
-# 1. Project initialization
-# 2. PRD creation
-# 3. PRD refinement
-# 4. Task generation
-# 5. Task breakdown
+# Get prompt metadata
+task-o-matic prompt --metadata prd-parsing
 ```
 
-### Workflow 2: From PRD to Tasks
+**Options:**
+- `<name>`: Prompt name (e.g., prd-parsing, task-enhancement)
+- `--type <type>`: Prompt type (system or user, default: user)
+- `--list`: List all available prompts
+- `--metadata <name>`: Show metadata for a specific prompt
+- `--prd-content <content>`: PRD content
+- `--prd-file <filepath>`: Load PRD content from file
+- `--task-title <title>`: Task title
+- `--task-description <description>`: Task description
+- `--task-file <filepath>`: Load task description from file
+- `--stack-info <info>`: Technology stack information
+- `--context-info <info>`: Additional context information
+- `--user-feedback <feedback>`: User feedback
+- `--var <key=value>`: Custom variable
+- `--full-context`: Include comprehensive project context
+- `--executor <type>`: Format output for specific executor (opencode, claude, gemini, codex)
 
-```bash
-# 1. Initialize project
-task-o-matic init init --project-name my-app
+---
 
-# 2. Configure AI provider
-task-o-matic config set-ai-provider anthropic claude-3-5-sonnet
+## 📦 INSTALL COMMAND
 
-# 3. Parse PRD with streaming
-task-o-matic prd parse --file requirements.md --stream
+### `task-o-matic install <target>`
+
+Install task-o-matic documentation and agent guides into current project.
+
+```bash
+# Install project documentation
+task-o-matic install doc --force
 
-# 4. Review and enhance tasks
-task-o-matic tasks list --tree
+# Install Claude Desktop agent guide
+task-o-matic install claude
 
-# 5. Split complex tasks
-task-o-matic tasks split <complex-task-id> --stream
+# Install generic agent guides
+task-o-matic install agents --force
 ```
 
-### Workflow 3: Task Enhancement
+**Options:**
+- `<target>`: Installation target (doc, claude, or agents) (required)
+- `--force`: Overwrite existing files
+
+---
+
+## 🤖 AI PROVIDERS: CHOOSE YOUR MACHINE SPIRITS
+
+| Provider | Strengths | Recommended For |
+|----------|-----------|-----------------|
+| **anthropic** | Strong reasoning, great with complexity | PRD parsing, task breakdown |
+| **openai** | Balanced, fast | Task enhancement, code generation |
+| **openrouter** | Access to many models, supports reasoning | Multi-model testing, finding optimal performer |
+| **custom** | Any OpenAI-compatible endpoint | Proprietary or local models |
+
+### Model Recommendations
+
+- **PRD Parsing**: `anthropic:claude-3.5-sonnet` or `openai:gpt-4o`
+- **Task Enhancement**: `openai:gpt-4o-mini` or `anthropic:claude-3-haiku`
+- **Task Breakdown**: `anthropic:claude-3.5-sonnet`
+- **Workflow Testing**: Use benchmarking. Let the data decide.
+
+### Multi-AI Generation
+
+Let multiple AI models compete and produce the best results together:
 
 ```bash
-# 1. Create basic task
-task-o-matic tasks create --title "Add payment system"
+# For PRD creation
+task-o-matic prd create "Build a vault manager" \
+  --ai "anthropic:claude-3.5-sonnet,openai:gpt-4o,openrouter:qwen-2.5" \
+  --combine-ai anthropic:claude-3.5-sonnet \
+  --stream
 
-# 2. Enhance with AI and streaming
-task-o-matic tasks create --title "Add payment system" --ai-enhance --stream
+# For PRD parsing
+task-o-matic prd parse --file requirements.md \
+  --ai "anthropic:claude-3.5-sonnet,openai:gpt-4o" \
+  --combine-ai anthropic:claude-3.5-sonnet \
+  --stream
 
-# 3. Break down into subtasks
-task-o-matic tasks split <task-id> --stream
+# For task splitting
+task-o-matic tasks split --task-id 7 \
+  --ai "anthropic:claude-3.5-sonnet,openai:gpt-4o" \
+  --stream
 ```
 
-### Workflow 4: AI Model Comparison
+Competition among AI models produces superior results. Multiple models approach the same problem from different angles. The combination model synthesizes the best of all worlds.
+
+---
+
+## 🗺️ COMMON WORKFLOWS
+
+### Workflow Alpha: From PRD to Tasks
 
 ```bash
-# Benchmark workflow across multiple models
-task-o-matic benchmark workflow \
-  --models "openai:gpt-4o,anthropic:claude-3-5-sonnet,openrouter:qwen/qwen-2.5-72b-instruct" \
-  --project-description "E-commerce platform with AI recommendations"
+# Initialize
+task-o-matic init init
+
+# Parse PRD
+task-o-matic prd parse --file requirements.md --stream
+
+# Review task tree
+task-o-matic tasks tree
+
+# Split large tasks
+task-o-matic tasks split --all --stream
 
-# The benchmark will:
-# 1. Collect workflow questions once
-# 2. Execute identical workflows in parallel
-# 3. Show comprehensive comparison
-# 4. Allow you to select the best model
+# Get next task
+task-o-matic tasks get-next
 ```
 
-### Workflow 5: Daily Task Management
+### Workflow Beta: Project Bootstrapping
 
 ```bash
-# Get next task
-task-o-matic tasks next
+# Initialize AND bootstrap
+task-o-matic init init --project-name my-shelter-manager \
+  --ai-provider openrouter --ai-model anthropic/claude-3.5-sonnet \
+  --frontend next --backend hono --database postgres --auth
+```
+
+### Workflow Gamma: Existing Project Adoption
+
+```bash
+# Attach with analysis
+task-o-matic init attach --analyze --create-prd
+
+# Review detected stack
+cat .task-o-matic/stack.json
 
-# Update task status
-task-o-matic tasks update <task-id> --status in-progress
+# Generate tasks for new features
+task-o-matic tasks create --title "Add emergency alerts" --ai-enhance --stream
+```
+
+### Workflow Delta: AI Model Comparison
+
+```bash
+# Benchmark PRD parsing
+task-o-matic benchmark run prd-parse \
+  --file requirements.md \
+  --models "openai:gpt-4o,anthropic:claude-3-5-sonnet" \
+  --concurrency 2
 
-# Execute task with AI assistance
-task-o-matic tasks execute <task-id> --loop
+# Benchmark entire workflow
+task-o-matic benchmark workflow \
+  --models "openai:gpt-4o,anthropic:claude-3-5-sonnet" \
+  --execute --skip-all
+```
 
-# Mark as completed
-task-o-matic tasks update <task-id> --status completed
+### Workflow Epsilon: Task Execution with Retry
 
-# Check progress
-task-o-matic tasks status
+```bash
+# Execute with progressive model retry
+task-o-matic tasks execute --id 7 \
+  --tool opencode \
+  --plan --review \
+  --verify "bun test" \
+  --max-retries 3 \
+  --try-models "gpt-4o-mini,gpt-4o,claude:sonnet-4" \
+  --auto-commit
 ```
 
-## Environment Variables
+---
+
+## ⚙️ ENVIRONMENT VARIABLES
 
 ```bash
 # AI Provider API Keys
@@ -708,92 +1320,108 @@ export ANTHROPIC_API_KEY="your_anthropic_key"
 export OPENROUTER_API_KEY="your_openrouter_key"
 export CUSTOM_API_KEY="your_custom_key"
 export CUSTOM_API_URL="https://api.custom.com/v1"
+export CONTEXT7_API_KEY="your_context7_key"
 
 # Default AI Configuration
 export AI_PROVIDER="anthropic"
 export AI_MODEL="claude-3-5-sonnet"
 export AI_MAX_TOKENS="4000"
-export AI_TEMPERATURE="0.7"
+export AI_TEMPERATURE="0.5"
 ```
 
-## AI Providers
-
-### Supported Providers
-
-- **OpenAI**: GPT models with full feature support
-- **Anthropic**: Claude models with enhanced reasoning
-- **OpenRouter**: Access to multiple models through one API
-- **Custom**: Any OpenAI-compatible API endpoint
-
-### Model Recommendations
-
-- **PRD Parsing**: `claude-3.5-sonnet` or `gpt-4`
-- **Task Enhancement**: `claude-3-haiku` or `gpt-3.5-turbo`
-- **Task Breakdown**: `claude-3.5-sonnet` for complex tasks
-- **Workflow Testing**: Use benchmarking to find optimal performance
+---
 
-## Storage Structure
+## 📁 STORAGE STRUCTURE
 
-All data is stored locally in the `.task-o-matic/` directory:
+Everything lives in `.task-o-matic/`:
 
 ```
 your-project/
 ├── .task-o-matic/
-│   ├── config.json          # AI configuration
-│   ├── bts-config.json      # Better-T-Stack configuration (if bootstrapped)
-│   ├── tasks/              # Task JSON files
-│   │   ├── {task-id}.json
-│   │   └── ...
-│   ├── prd/                # PRD versions and logs
+│   ├── config.json              # AI configuration
+│   ├── stack.json              # Detected technology stack
+│   ├── bts-config.json         # Better-T-Stack configuration
+│   ├── mcp.json               # Context7/MCP configuration
+│   ├── tasks.json             # Main tasks database
+│   ├── ai-metadata.json       # AI metadata for all tasks
+│   │
+│   ├── tasks/                # Task content files
+│   │   ├── {task-id}.md
+│   │   └── enhanced/
+│   │       └── {task-id}.md
+│   │
+│   ├── plans/                # Implementation plans
+│   │   └── {task-id}.json
+│   │
+│   ├── docs/                 # Documentation
+│   │   ├── tasks/           # Task-specific documentation
+│   │   └── {library-name}/  # Context7 library docs
+│   │
+│   ├── prd/                 # PRD versions and logs
+│   │   ├── versions/        # PRD versioning history
 │   │   ├── parsed-prd.json
-│   │   └── ...
-│   └── logs/               # Operation logs
-│       └── ...
+│   │   └── (user prd files)
+│   │
+│   └── logs/                # Operation logs
 └── your-project-files...
 ```
 
-## Shell Completions
+---
 
-Install shell completions for better command-line experience:
+## ❓ FREQUENTLY ASKED QUESTIONS FROM THE FIELD
 
-```bash
-# Bash
-task-o-matic install --shell bash
-source ~/.bashrc
+**Q: Can I skip the PRD phase?**
 
-# Zsh
-task-o-matic install --shell zsh
-source ~/.zshrc
+A: Technically, yes. But also, citizen, have you SEEN the results of "just starting coding"? It's not pretty. An unclear plan is worse than no plan. At least with no plan, you know you're doomed.
 
-# Fish
-task-o-matic install --shell fish
-```
+**Q: Do I really need to split ALL tasks?**
+
+A: No, but remember: a task too large to finish in one sitting is a task that won't BE finished. Procrastination kills more projects than burnout.
+
+**Q: What AI provider should I use?**
+
+A: We recommend OpenRouter with `claude-4.5-sonnet` for quality, or `z-ai/glm-4.7` for economy. The AI doesn't care about your survival preferences. It just wants to help organize your bunker.
 
-## Documentation
+**Q: Can I add tasks manually?**
 
-For more detailed documentation, see:
+A: Absolutely. Use `tasks create` with or without `--ai-enhance`.
 
-- [Configuration](../../docs/configuration.md) - AI providers and settings
-- [Task Management](../../docs/tasks.md) - Full task lifecycle with AI features
-- [PRD Processing](../../docs/prd.md) - Parse and rework Product Requirements Documents
-- [Interactive Workflow](../../docs/workflow-command.md) - Guided setup with AI assistance
-- [AI Integration](../../docs/ai-integration.md) - AI providers and prompt engineering
-- [Project Initialization](../../docs/projects.md) - Project setup and bootstrapping
-- [Streaming Output](../../docs/streaming.md) - Real-time AI streaming capabilities
-- [Model Benchmarking](../../docs/benchmarking.md) - Compare AI models and workflow performance
+**Q: What if my project changes direction?**
+
+A: Common occurrence, citizen. Use `prd rework` to update your PRD, then regenerate tasks. Flexibility is a survival trait.
+
+**Q: How does task-o-matic handle dependencies?**
+
+A: Tasks can specify parent-child relationships. The system tracks hierarchy and prevents circular dependencies. A project where everything depends on everything is a project that never completes.
+
+---
+
+## 📚 FURTHER READING: SURVIVAL MANUALS
+
+For detailed information:
+- [Configuration Guide](../../docs/configuration.md)
+- [Task Management Guide](../../docs/tasks.md)
+- [PRD Processing Guide](../../docs/prd.md)
+- [Workflow Command Guide](../../docs/workflow-command.md)
+- [AI Integration Guide](../../docs/ai-integration.md)
+- [Project Initialization Guide](../../docs/projects.md)
+- [Streaming Output Guide](../../docs/streaming.md)
+- [Model Benchmarking Guide](../../docs/benchmarking.md)
+- [Core Library API](../core/README.md)
+
+---
 
-## License
+## 🏁 FINAL REMINDER
 
-MIT License - see LICENSE file for details.
+**Remember:** A well-planned project is like a well-stocked bunker—both give you peace of mind when the world outside gets chaotic.
 
-## Contributing
+You now have everything you need to manage your projects in the post-apocalyptic development landscape. Go forth, citizen. Your code is counting on you.
 
-1. Fork the repository
-2. Create a feature branch
-3. Make your changes
-4. Add tests if applicable
-5. Submit a pull request
+[Stay organized. Stay safe. Survive.]
 
 ---
 
-**Built with ❤️ using Vercel AI SDK and modern TypeScript**
+**DOCUMENT CONTROL:**
+- **Version:** 1.0
+- **Clearance:** All Personnel
+- **Classification:** For Citizens' Eyes Only