feat(ci): add OpenCode PR review workflow and manual docs deploy trigger

[Million-mo]

What This PR Adds

1. Automated PR Review Workflow ()

A non-blocking PR review system using OpenCode with a three-agent architecture powered by DeepSeek:

Agent	Role	What It Checks
	Orchestrator	Analyzes diff, delegates to specialists, synthesizes findings
	Code specialist	Type safety, testing, telemetry, architecture consistency
	Docs specialist	Doc placement, archival detection, AGENTS.md consistency, link integrity, nav consistency

How it works:

• Triggers on , , ,
• Skips draft PRs
• Posts a structured review comment (LGTM / NEEDS CHANGES / DISCUSS)
• Uses secret (configurable — any OpenCode-supported model works)

2. Manual Docs Deploy Trigger ()

Adds to the existing documentation workflow, allowing manual rebuilds without pushing to main.

3. OpenCode Agent Definitions ()

Three agent definition files that configure the review behavior:

• — Primary agent, delegates to subagents
• — Code review rules (type safety, testing, telemetry)
• — Enhanced docs review with 9 check categories including document placement validation and archival detection

Setup

To use this in your fork:

1. Add (or any supported model API key) to repo secrets
2. The workflow runs automatically on PRs
3. Review comments appear as GitHub PR comments

Tested

This workflow has been validated on the Million-mo/agentpool fork with a test PR containing intentional issues. The review-docs agent successfully detected:

• Documents placed in wrong directories
• Stale references to non-existent files
• Missing AGENTS.md for new subsystems
• Missing mkdocs.yml nav entries

Example review output: Million-mo#11