Guia de Desenvolvimento Java com Assistentes de IA
gzheyts/ai-tools
Guia completo de AI coding assistants para desenvolvedores Java em produção
Ver no GitHubUm repositório estruturado com 16 capítulos cobrindo configuração de Cursor e OpenCode, técnicas de prompting, padrões MCP, subagentes, CI/CD e práticas em equipe para desenvolvimento Java. Inclui templates prontos, padrões de orquestração multi-agente e um projeto Spring Boot de referência.
Instalação
npx convez-ai gzheyts/ai-tools1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Configurar assistentes de IA (Cursor, OpenCode) alinhados com arquitetura Java
- Implementar workflows de agentes e subagentes para refatoração e CI/CD
- Estruturar comandos slash, skills e contextos de projeto para melhor assistência
Veredito

Recurso valioso para equipes Java que buscam integrar assistentes de IA de forma estruturada e escalável. O foco em padrões operacionais (AGENTS.md, orquestração de subagentes, CI/CD) o diferencia de tutoriais genéricos, apesar da curva de aprendizado ser expressiva.
README
A tradução para o português deste README ainda está na fila.
ai-tools
My personal notes on using AI coding assistants as a Java developer.
What this covers
- How the runtime actually works — agent loop, tools, context limits — so failures feel debuggable instead of mystical.
- Project-level wiring —
AGENTS.md,SKILL.md, slash commands, subagents — so the assistant shows up already aligned with my architecture and standards. - Java / Spring / DevOps reality — migrations, CI, Helm, K8s.
Stack I optimize for
| Layer | Technology |
|---|---|
| Language | Java 21+ (records, sealed classes, virtual threads) |
| Framework | Spring Boot 3.5+, Spring Data JDBC |
| Build | Maven 3.9+ |
| CI/CD | GitLab CI |
| Orchestration | Kubernetes + Helm |
| Databases | PostgreSQL, Oracle |
| Assistants | Cursor (+ CLI), OpenCode |
Templates
Ready-to-use files in templates/:
| File | Description |
|---|---|
AGENTS.md | Project context template |
SKILL.md | Skill template |
context-map.md | Context map template |
team-onboarding.md | Team onboarding guide |
command-cursor.md | Cursor slash command template |
command-opencode.md | OpenCode command template |
mcp-config-cursor.json | MCP config for Cursor |
mcp-config-opencode.json | MCP config for OpenCode |
liquibase-changelog.xml | Liquibase changelog template |
sample-project/ | Reference Maven project with skills, commands, and AGENTS.md — demo target for OpenCode workflows |
context-map.md and team-onboarding.md are canonical templates; sample-project/ holds project-specific overrides (paths, skill lists) where needed.
OpenCode agent patterns
opencode-agent-patterns/ — hands-on multi-agent orchestration with OpenCode: parallel triage, refactor pipelines, PR-ready CI fixes, doom-loop prevention.
Start at opencode-agent-patterns/README.md — concepts, workflow walkthroughs (sections 0–5), prompts, and cookbook in one file.
| Resource | Description |
|---|---|
| README.md | Full guide — primary/subagent model, execution internals, commands, skills, Java examples |
| templates/ | Copy-paste /triage, /hotfix, refactor, PR-review commands |
| playbooks/ | Red-build triage, safe refactor, pre-PR review, incident hotfix |
| tools/ | OpenCode cheat sheet, ecosystem links, example opencode.json agents |
Practice on templates/sample-project/ — includes an intentional failing test for triage exercises.
Complements 12-agents-subagents.md (assistant-agnostic concepts) with OpenCode-specific workflows.
Sections
Foundations
| # | File | Topic |
|---|---|---|
| 01 | 01-setup.md | Environment setup |
| 02 | 02-how-ai-assistants-work.md | How AI assistants work |
Prompting
| # | File | Topic |
|---|---|---|
| 03 | 03-prompting.md | Prompting fundamentals & management |
| 04 | 04-prompt-techniques.md | Prompt techniques & best practices |
| 05 | 05-llm-models.md | LLM thinking & model selection |
| 06 | 06-context.md | Context strategies & engineering |
| 07 | 07-prompt-optimization.md | Prompt optimization |
| 08 | 08-prompt-examples.md | Copy-paste Java/Spring prompt examples |
Configuration
| # | File | Topic |
|---|---|---|
| 09 | 09-agents-md.md | AGENTS.md |
| 10 | 10-skills.md | Skills |
| 11 | 11-custom-commands.md | Custom commands |
| 12 | 12-agents-subagents.md | Agents & subagents — see also opencode-agent-patterns/README.md |
| 13 | 13-agent-sessions.md | Agent sessions — lifecycle, child sessions, compaction, cross-session handoff |
| 14 | 14-mcp-servers.md | MCP architecture, tool resolution, configuration |
Java & DevOps
| # | File | Topic |
|---|---|---|
| 15 | 15-java-production-stack.md | Java / Spring Boot, database & DevOps |
Advanced
| # | File | Topic |
|---|---|---|
| 16 | 16-team-collaboration.md | Team collaboration |
| 17 | 17-security-and-privacy.md | Security & privacy |