Fixing how uv is being used in the base image, adding Poe the Poet to everything.

Signed-off-by: Cliff Hill <xlorep@darkhelm.org>

docs/DEVELOPMENT.md

@@ -6,14 +6,16 @@ This document outlines how to set up your development environment and work with
 
 1. [Quick Start](#quick-start)
 2. [Development Environment Setup](#development-environment-setup)
-3. [Git Workflow](#git-workflow)
-4. [Pre-commit Hooks](#pre-commit-hooks)
-5. [Manual Tool Usage](#manual-tool-usage)
-6. [CI/CD Pipeline](#cicd-pipeline)
-7. [Branch Protection and Merge Requirements](#branch-protection-and-merge-requirements)
+3. [Poe the Poet Task Runner](#poe-the-poet-task-runner)
+4. [Git Workflow](#git-workflow)
+5. [Pre-commit Hooks](#pre-commit-hooks)
+6. [Manual Tool Usage](#manual-tool-usage)
+7. [CI/CD Pipeline](#cicd-pipeline)
+8. [Branch Protection and Merge Requirements](#branch-protection-and-merge-requirements)
 
 ## Related Documentation
 
+- **[Poe Task Reference](POE_TASK_REFERENCE.md)** - Complete guide to unified development tasks
 - **[CI/CD Multi-Stage Build Architecture](CICD_MULTI_STAGE_BUILD.md)** - Technical details of the optimized build system
 - **[CI/CD Troubleshooting](GITEA_ACTIONS_TROUBLESHOOTING.md)** - Common issues and solutions
 - **[Secure Docker CI/CD](SECURE_DOCKER_CICD.md)** - Security considerations and practices
@@ -25,15 +27,19 @@ This document outlines how to set up your development environment and work with
 git clone ssh://git@dogar.darkhelm.org:2222/DarkHelm.org/plex-playlist.git
 cd plex-playlist
 
-# Start development environment
-docker compose -f compose.dev.yml up -d
+# Complete setup with Poe the Poet (recommended)
+cd backend && uv sync --dev && cd ..
+poe setup
 
-# Set up pre-commit (recommended)
-pip install pre-commit
-pre-commit install
+# OR manual setup
+docker compose -f compose.dev.yml up -d
+pip install pre-commit && pre-commit install
 
 # Create a feature branch and start developing
 git checkout -b feature/your-feature-name
+
+# Use Poe for all development tasks
+poe format lint type-check test-unit
 ```
 
 ## Development Environment Setup
@@ -68,6 +74,55 @@ docker compose -f compose.dev.yml up -d --build
 - **API Documentation**: http://localhost:8000/docs
 - **Database**: localhost:5432 (user: `plex`, password: see `secrets/postgres_password`)
 
+## Poe the Poet Task Runner
+
+This project uses **Poe the Poet** as a unified task runner to simplify and standardize development workflows. Instead of remembering different commands for backend and frontend, you can use consistent `poe` commands from anywhere in the project.
+
+### Quick Start with Poe
+
+```bash
+# Complete development setup (new developers)
+poe setup
+
+# Start development environment
+poe dev
+
+# Run all quality checks (format, lint, type-check)
+poe ci-quick
+
+# Run all tests
+poe test-all
+
+# See all available tasks
+poe --help
+```
+
+### Key Benefits
+
+- **Unified Interface**: Same commands work for backend (Python) and frontend (TypeScript)
+- **Parallel Execution**: Tasks run in parallel for better performance
+- **Smart Workflows**: Conditional and chained task execution
+- **Developer Friendly**: Interactive task selection and helpful descriptions
+- **CI Integration**: Local simulation of CI/CD pipeline
+
+### Common Workflows
+
+```bash
+# Daily development workflow
+poe format lint type-check test-unit
+
+# Pre-commit workflow (faster than full CI)
+poe ci-quick
+
+# Complete quality gate (like CI pipeline)
+poe quality-gate
+
+# Build and test Docker images locally
+poe build-cicd
+```
+
+For the complete list of tasks and detailed usage, see **[Poe Task Reference](POE_TASK_REFERENCE.md)**.
+
 ## Git Workflow
 
 ### Branch Strategy