docs: move WORKFLOW.md to root and add prominence in agent docs

- Move docs/WORKFLOW.md to root for visibility
- Add prominent callout in AGENTS.md and CLAUDE.md to read WORKFLOW.md first
- Update all references to new location

Ensures AI agents follow proper workflow (branches, commits, PRs) before starting work.

Author: prosdev

AGENTS.md

@@ -2,6 +2,8 @@
 
 This file provides guidance to AI agents (Claude, Cursor, etc.) when working with the dev-agent codebase.
 
+> **⚠️ IMPORTANT: Before starting any implementation work, read [`WORKFLOW.md`](./WORKFLOW.md) for the development workflow, including branch naming, commit format, PR process, and testing standards.**
+
 ## Project Overview
 
 **Dev-Agent** is a local-first repository context provider for AI tools. It provides semantic code search, GitHub integration, and development planning capabilities through the Model Context Protocol (MCP).
@@ -360,7 +362,7 @@ pnpm build
 ## Resources
 
 - **Architecture:** See `ARCHITECTURE.md`
-- **Workflow:** See `docs/WORKFLOW.md`
+- **Workflow:** See `WORKFLOW.md`
 - **Examples:** See `examples/` directory
 - **Troubleshooting:** See `TROUBLESHOOTING.md` (coming soon)
 - **Contributing:** See `CONTRIBUTING.md`

CLAUDE.md

@@ -2,6 +2,8 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
+> **⚠️ IMPORTANT: Before starting any implementation work, read [`WORKFLOW.md`](./WORKFLOW.md) for the development workflow, including branch naming, commit format, PR process, and testing standards.**
+
 ## Project Overview
 
 Dev-Agent is a local-first repository context provider for AI tools like Claude Code. It helps AI tools understand codebases without hallucinations by providing semantic search, code analysis, and GitHub integration through a monorepo architecture.

docs/WORKFLOW.md WORKFLOW.mddocs/WORKFLOW.md renamed to WORKFLOW.md

@@ -359,7 +359,7 @@ No need to reinstall MCP integration - it automatically uses the latest version.
 ## Next Steps
 
 - See [README.md](./README.md) for MCP server architecture
-- See [../../docs/WORKFLOW.md](../../docs/WORKFLOW.md) for development workflow
+- See [../../WORKFLOW.md](../../WORKFLOW.md) for development workflow
 - See [TROUBLESHOOTING.md](../../TROUBLESHOOTING.md) for detailed troubleshooting
 
 ## Need Help?

packages/mcp-server/CLAUDE_CODE_SETUP.md

@@ -338,7 +338,7 @@ No need to reinstall MCP integration - it automatically uses the latest version.
 ## Next Steps
 
 - See [README.md](./README.md) for MCP server architecture
-- See [../../docs/WORKFLOW.md](../../docs/WORKFLOW.md) for development workflow
+- See [../../WORKFLOW.md](../../WORKFLOW.md) for development workflow
 - See [TROUBLESHOOTING.md](../../TROUBLESHOOTING.md) for detailed troubleshooting
 
 ## Need Help?