docs: update CLAUDE.md and TASKS.md for GitHub-driven workflow and task management improvements

Author: sarg3nt

CLAUDE.md

@@ -92,30 +92,70 @@ cd gearbox-agent && make deploy
 
 See [docs/plugins.md](docs/plugins.md) for complete plugin architecture documentation.
 
-## Task Management (TASKS.md)
+## GitHub-Driven Workflow
 
-**CRITICAL**: This repository uses TASKS.md to track work items.
+**CRITICAL**: All features and bugs go through a full GitHub workflow. Claude manages this end-to-end.
 
-### Adding Tasks
+### Workflow Steps
 
-When creating tasks in TASKS.md:
+When a new feature is planned or a bug is reported:
 
-- Add them under the `## Active Tasks` section
-- Use markdown checkbox syntax: `- [ ] Task description`
-- Tasks should be clear, actionable, and specific
+1. **Create a GitHub Issue** — Use `gh issue create` with a clear title, description, and appropriate labels (`enhancement`, `bug`, etc.)
+2. **Add to Project Board** — Add the issue to the GitHub Project board using `gh project item-add`
+3. **Create a Feature Branch** — Branch from `main` using the naming convention below
+4. **Do the Work** — Implement the feature or fix on the branch
+5. **Create a PR** — Use `gh pr create` targeting `main`, linked to the issue (use `Closes #N` in the body)
+6. **Track Progress** — Keep the project board and issues in sync
+7. **Complete** — When user confirms done: merge PR, close issue, move project card to Done
 
-### Completing Tasks
+### Branch Naming Convention
 
-- Check off tasks as you complete them: `- [x] Task description`
-- Mark tasks complete immediately when work is done
-- Don't batch completions - check them off right away
+- **Features:** `feature/short-description` (e.g., `feature/dashboard-export`)
+- **Bug fixes:** `fix/short-description` (e.g., `fix/websocket-reconnect`)
+- **Always branch from `main`**
 
-### Workflow Skills
+### PR Convention
+
+- All PRs target `main`
+- PR body must include `Closes #<issue-number>` to auto-close the issue on merge
+- Use the standard PR template format (Summary, Test Plan)
+
+### Issue Labels
+
+Use these labels consistently:
+
+- `enhancement` — New features
+- `bug` — Bug fixes
+- `documentation` — Docs-only changes
+- `refactor` — Code improvements without behavior change
+
+### Project Board
+
+- **Project Number:** 3
+- **Project ID:** `PVT_kwHOADN1xs4BOB1W`
+- **Owner:** `sarg3nt`
 
-Use these skills to work with TASKS.md:
+Use `gh project` commands and the MCP GitHub Projects tool to:
+
+- Add new issues to the board
+- Move items between columns as work progresses
+- Query board status when reporting progress
+
+## TASKS.md as Scratch Pad
+
+TASKS.md is a **scratch pad only** — not a tracking system. The GitHub Project board is the source of truth for all work items.
+
+### How TASKS.md is used
+
+- User writes rough ideas, feature descriptions, or bug notes in TASKS.md
+- Claude reads TASKS.md, breaks the content into actionable GitHub issues, and adds them to the project board
+- Once issues are created, the content in TASKS.md can be cleared
+- TASKS.md is never the source of truth — the project board is
+
+### Workflow Skills
 
-- `/dowork` - Start the first unchecked task, ask questions as needed
-- `/doallwork` - Complete the first unchecked task autonomously without questions
+- `/dowork` - Read TASKS.md, create issues from it, and start working (ask questions as needed)
+- `/doallwork` - Read TASKS.md, create issues from it, and work autonomously
 
 ## User Preferences
 
@@ -213,7 +253,7 @@ Store in `docs/` directory using kebab-case naming. Include TOC after main headi
 - **[README.md](README.md)**: Project overview and quick start - SOURCE OF TRUTH
 - **[CLAUDE.md](CLAUDE.md)**: This file (development guidance)
 - **[docs/plugins.md](docs/plugins.md)**: Complete plugin architecture documentation
-- **[TASKS.md](TASKS.md)**: Active development tasks
+- **[TASKS.md](TASKS.md)**: Scratch pad for describing upcoming work
 - **[gearbox/docs/development.md](gearbox/docs/development.md)**: Local development guide
 
 **Application Documentation:**