chore: move to new agents tooling

[Gorkowski]

Target Branch: main

Summary

Moves the repository's ADW/opencode configuration to the new agents tooling layout. This broad tooling migration updates agent definitions, tool wrappers, workflow definitions, and supporting guides so future automation uses the new .opencode/tools and permission-based agent contracts.

What Changed

New Components

• .opencode/tools/ - New focused tool-wrapper implementations, tests, and documentation replacing the older .opencode/tool layout.
• .opencode/agent/forge-issue-*.md - New forge issue drafting, review, creation, verification, and manifest agents.
• .opencode/agent/plan-*.md - New planning-system agents for intake, orchestration, phase splitting, review, revision, and plan section drafting.
• .opencode/guides/ - Consolidated guide set for agents, workflows, tools, setup, troubleshooting, and architecture references.
• .opencode/plans/ - Plan schemas, templates, and configuration for epic, feature, maintenance, and research plans.
• .github/ISSUE_TEMPLATE/planner.md - Structured planner intake issue template.

Modified Components

• Existing .opencode/agent/*.md definitions now use explicit permission blocks instead of the older tools map and reference .opencode/guides paths.
• Workflow definitions under .opencode/workflow/ add auto-mode, forge/generate, planner, review-auto, ship-auto, and plan-fix flows.
• Platform, git, ADW spec, notes, workflow-builder, notebook, pytest, linter, and move wrappers are migrated/expanded under .opencode/tools.
• .opencode/opencode.json and plugin paths are updated for the new opencode structure.
• .gitignore now excludes adforge_local/ local state.

Removed/Replaced Components

• Older issue-generator agents and dev-plan/docs-specific agents are replaced by forge/planning/docs-family agents.
• Legacy .opencode/tool wrappers and their tests are replaced by the new .opencode/tools wrappers and contract tests.

How It Works

The migration separates agent behavior, workflow orchestration, and tool access into explicit contracts:

User / Workflow
    │
    ├──▶ .opencode/workflow/*.json
    │        └──▶ selects primary agent + phases
    │
    ├──▶ .opencode/agent/*.md
    │        ├──▶ declares explicit permissions
    │        └──▶ delegates to specialized subagents
    │
    └──▶ .opencode/tools/*
             ├──▶ focused read/write wrappers
             ├──▶ ADW state, plan, notes, git, and platform tools
             └──▶ contract tests under __tests__/

This keeps automation capabilities auditable: agents declare only the tools they need, workflows compose the phases, and wrapper-specific tests validate behavior.

Implementation Notes

• Why this approach: The new layout makes tool permissions explicit and breaks broad wrappers into narrower, easier-to-test interfaces.
• Migration scope: This is intentionally a tooling/configuration migration; it does not modify the particula/ simulation package.
• Review focus: Reviewers should focus on agent permission correctness, workflow wiring, and whether references consistently point to .opencode/guides and .opencode/tools.

Testing

• Repository state: Current branch update-opencode is clean and pushed.
• Diff validation: Compared against origin/main; migration includes 525 changed files with new tooling, guides, workflows, and tests.
• Tooling tests: New wrapper contract tests are included under .opencode/tools/__tests__/ for ADW spec/read/write/messages, plans, git wrappers, platform wrappers, ripgrep/search, pytest/linters, and workflow validation.

[Copilot]

Copilot wasn't able to review this pull request because it exceeds the maximum number of files (300). Try reducing the number of changed files and requesting a review from Copilot again.