OpenAgents

OpenAgents is a growing collection of reusable AI agent definitions for OpenCode and compatible developer workflows. Agents are organized by role and technology domain so teams can combine focused planning, implementation, and review workflows as needed.

Purpose

This repository helps teams standardize AI-assisted software engineering with practical, portable agent prompts. Each agent includes role boundaries, workflow rules, official documentation anchors, and technology-specific quality guidance.

Current Domains

The repository can grow over time. The current agent set covers:

• Next.js App Router, Server Components, and Server Actions
• JavaScript with modern ECMAScript and Node.js
• TypeScript strict mode, generics, narrowing, and utility types
• Java SE with clean architecture and modern language features
• Spring Boot REST APIs, Data JPA, Security, and Cloud patterns
• Quarkus with Panache, reactive programming, and GraalVM native builds
• HTML and CSS with semantic markup, modern layout, and WCAG accessibility

Agent Triad

Current domains use a triad pattern with three complementary roles:

• Plan Agent: designs architecture, analyzes requirements, evaluates dependencies, and writes implementation plans. It must not write or modify application source code.
• Build Agent: implements code, tests, refactors, and commands after inspecting the project and clarifying missing requirements.
• Review Agent: performs read-only code review, security auditing, performance analysis, accessibility checks, and best-practice validation.

Repository Layout

agents/
  nextjs/
    nextjs-plan.md
    nextjs-build.md
    nextjs-review.md
  javascript/
    js-plan.md
    js-build.md
    js-review.md
  typescript/
    ts-plan.md
    ts-build.md
    ts-review.md
  java/
    java-plan.md
    java-build.md
    java-review.md
  spring-boot/
    spring-plan.md
    spring-build.md
    spring-review.md
  quarkus/
    quarkus-plan.md
    quarkus-build.md
    quarkus-review.md
  html-css/
    web-plan.md
    web-build.md
    web-review.md

OpenCode Usage

OpenCode normally loads project agents from .opencode/agent/ or .opencode/agents/. This repository stores agents under category directories such as agents/nextjs/ and agents/typescript/ so the collection is easy to browse and reuse.

To use an agent in a project:

1. Copy the desired agent file into .opencode/agents/ in your project.
2. Keep the frontmatter intact.
3. Restart OpenCode so the new agent definition is loaded.
4. Use Plan agents when architecture or sequencing is unclear.
5. Use Build agents for implementation work.
6. Use Review agents before merging or releasing changes.

Official Documentation Anchors

Agents are instructed to align recommendations with official documentation:

• Next.js: https://nextjs.org/docs
• JavaScript: https://developer.mozilla.org/en-US/docs/Web/JavaScript
• TypeScript: https://www.typescriptlang.org/docs/
• Java: https://docs.oracle.com/en/java/
• Spring Boot: https://docs.spring.io/spring-boot/
• Quarkus: https://quarkus.io/guides/
• HTML: https://developer.mozilla.org/en-US/docs/Web/HTML
• CSS: https://developer.mozilla.org/en-US/docs/Web/CSS

Compatibility Notes

The markdown prompts are designed for OpenCode agent files and are also readable by tools that support reusable prompt files. Tool-specific configuration may be required outside this repository.

License

This project is licensed under the MIT License.