@alergeek-ventures/opencode

An OpenCode plugin that provides AI-powered code review using Alergeek Ventures' coding guidelines.

What it does

This plugin adds a /av-review command to OpenCode that reviews your code changes against a curated set of guidelines. It uses a multi-agent architecture:

• Orchestrator agent - Analyzes the scope of changes and delegates review tasks
• File-level reviewer agents - Check specific files against applicable guidelines

These subagents are hidden by default, meaning - you won't select them via Tab. Meaning, it won't clutter your setup, but requires you to use the command.

The review focuses on architectural concerns, following the guidelines we have across the company. What it does not focus on is syntax / style issues (which should be handled by linters and formatters).

Installation

bunx @alergeek-ventures/opencode@latest init

This will:

1. Install the agent definitions to ~/.config/opencode/agent/
2. Install the command to ~/.config/opencode/command/
3. Prompt you to add the plugin to your OpenCode config

After running init, add the plugin to your ~/.config/opencode/config.json:

{
  "plugin": ["@alergeek-ventures/opencode"]
}

If you won't install the plugin, agents and command will work, but agent won't have access to the guidelines.

Usage

In any git repository with OpenCode:

/av-review

I decied to prefix it to not collide with built-in /review.

The command reviews:

• Unstaged changes
• Difference from main branch
• Last commit (if on main)

Guidelines

It's a distilled version of what we validate when working in AV. They were collected and modified from different places from the internet. Couple of examples of guidelines, to understand what is there:

Guideline	Focus
bulletproof-react	React patterns and architecture
building-html-interfaces	HTML/UI best practices
colocation	Keeping related code together
derived-state-vs-actual-state	State management patterns
directory-structure	Project organization
focused-changes	Change scope and PR hygiene
reduce-cognitive-load	Code complexity and readability
reducing-entropy	Fighting technical debt

You can go to src/guidelines. Guidelines are accessible via the listGuidelines and readGuideline tools exposed by the plugin. It's also possible to fork this repository, change the guidelines folder and put your own stuff there.

Possibly interesting things to test out:

• leverage Vercel's React best practices
• leverage Callstack's React Native best practices (not yet released as of time of writing)

With Bun's macros - it should be super easy to swap these out. And with opencode subagents, it's easy to validate in parallel.

How the Review Works

1. Orient - List changed files via git diff --name-only origin/main
2. Delegate - For larger changes, spawn file-level reviewer subagents
3. Collect - Gather findings, deduplicate, and produce a summary

License

MIT