docs(quickstart): prioritize project-local usage and separate contributor clone path

Author: T72

README.md

@@ -42,21 +42,26 @@ Every task delegation includes THREE elements:
 ## ⚡ Quick Start (60 Seconds)
 
 ```bash
-# 1. Setup
-git clone https://github.com/T72/task-orchestrator.git
-cd task-orchestrator
+# 1. In YOUR project root
+cd /path/to/your-project
+
+# 2. Add tm from a release artifact or local install
+cp /path/to/task-orchestrator/tm ./tm
+chmod +x ./tm
+
+# 3. Initialize Task Orchestrator in this project
 ./tm init
 
-# 2. Set agent identity (required for coordination)
+# 4. Set agent identity (required for coordination)
 export TM_AGENT_ID="orchestrator_agent"
 
-# 3. Create AI Agent Workflow with Commander's Intent
+# 5. Create AI Agent Workflow with Commander's Intent
 BACKEND=$(./tm add "Build auth API" --assignee backend_agent \
   -d "WHY: Secure foundation, WHAT: OAuth2/JWT/sessions, DONE: Users can login safely" | grep -o '[a-f0-9]\{8\}')
 
 FRONTEND=$(./tm add "Create login UI" --assignee frontend_agent --depends-on $BACKEND | grep -o '[a-f0-9]\{8\}')
 
-# 4. Watch Real-Time Orchestration
+# 6. Watch Real-Time Orchestration
 ./tm watch  # See instant updates as agents work
 
 # When backend completes, frontend auto-unblocks!
@@ -118,7 +123,15 @@ python3 docs/examples/multi_agent_workflow.py  # Team coordination
 ## 🚀 Installation
 
 ```bash
-# Requirements: Python 3.8+, 10MB disk space
+# Use in your own project
+cd /path/to/your-project
+cp /path/to/task-orchestrator/tm ./tm
+chmod +x ./tm
+./tm init
+```
+
+```bash
+# Contributor path (develop task-orchestrator itself)
 git clone https://github.com/T72/task-orchestrator.git
 cd task-orchestrator
 ./tm init

docs/guides/getting-started.md

@@ -6,6 +6,17 @@ Start orchestrating AI agents in under 5 minutes.
 
 ### Quick Install
 ```bash
+# In your own project root
+cd /your/project
+
+# Add tm from release artifact or local install
+cp /path/to/task-orchestrator/tm ./tm
+chmod +x tm
+./tm init
+```
+
+### Contributor Install (for developing task-orchestrator itself)
+```bash
 git clone https://github.com/T72/task-orchestrator.git
 cd task-orchestrator
 chmod +x tm
@@ -109,4 +120,4 @@ Watch for task updates:
 | `./tm watch` | Monitor changes |
 
 ---
-*Getting started takes 5 minutes. Master orchestration in 30.*
+*Getting started takes 5 minutes. Master orchestration in 30.*

docs/guides/quickstart-claude-code.md

@@ -3,11 +3,11 @@
 ## 🚀 30-Second Setup
 
 ```bash
-# 1. Clone the repository
-git clone https://github.com/T72/task-orchestrator.git
-cd task-orchestrator
+# 1. Go to your project
+cd /your/project
 
-# 2. Make executable and initialize
+# 2. Add tm from release artifact or local install
+cp /path/to/task-orchestrator/tm ./tm
 chmod +x tm
 ./tm init
 
@@ -16,7 +16,7 @@ export TM_AGENT_ID="orchestrator_agent"
 ./tm add "My first task"
 ```
 
-**That's it!** Task Orchestrator is now ready for use with Claude Code.
+**That's it!** Task Orchestrator is now ready in your project for use with Claude Code.
 
 ## 🤖 Claude Code Integration
 

docs/guides/user-guide.md

@@ -2,6 +2,9 @@
 
 Welcome to Task Orchestrator - the tool that transforms meta-agents into orchestration engines.
 
+> Use Task Orchestrator inside your own project repository.  
+> Cloning `T72/task-orchestrator` is only required when contributing to Task Orchestrator itself.
+
 ## 📚 Documentation Structure
 
 ### Quick Navigation