opencode-agent-kit/template/.opencode/.agents.md

Multi-stack OpenCode agent toolkit — 33+ specialized AI agents, 200+ skills, 46 commands, 8 MCP servers (Nuxt, React, Node.js, Laravel, CI3, Android, Flutter, DevOps, SEO, SonarQube, and more)

## Goal
- Create a SonarQube quality agent that scans code via SonarQube MCP tools, generates TODOs for issues found, and delegates fixes to relevant subagents

## Constraints & Preferences
- Must use SonarQube MCP server tools (issues, quality-gates, security-hotspots, duplications, rules, measures, projects, coverage)
- Must use `todowrite` tool for task tracking (not `todo`)
- Must follow existing agent structure with Global Rules, Core Identity, What You DO, Delegation Protocol
- Must integrate with existing agent ecosystem (it-leader.md orchestrator + 13 specialized subagents)
- Full Scan mode: Issues + Security Hotspots + Duplications + Coverage + Dependencies + Quality Gate
- Trigger: Manual via `/sonarqube-scan` command or `@sonarqube` mention
- Landing page (index.html) and all documentation must reflect 13 agents, 37 commands, 7 MCP servers

## Progress
### Done
- Fetched SonarQube MCP server documentation and available toolsets
- Reviewed existing agent configurations (it-leader.md, code-reviewer.md)
- Created `.opencode/agents/sonarqube-quality.md` (406 lines) — full agent definition with scan modes, delegation matrix, issue lifecycle, output contracts
- Created `.opencode/commands/sonarqube-scan.md` (65 lines) — slash command with options (--project, --severity, --quick, --rescan)
- Updated `.opencode/agents/it-leader.md` — added `@sonarqube` to subagents table, capabilities reference, decision tree, verification policy, session subagents list
- Updated `AGENTS.md` — updated agent count (12→13), added Quality category, SonarQube to subagents list, added SonarQube to MCP servers
- Updated `index.html` — meta tags, hero badge, subtitle, stats, terminal, orbital nodes, marquee, agent cards, MCP section (all reflect 13 agents, 37 commands, 7 MCP)
- Updated `README.md` — counts, agent list, custom agents table, commands section
- Updated `package.json` — description, keywords

### In Progress
- (none)

### Blocked
- (none)

## Key Decisions
- File name: `sonarqube-quality.md` (not `sonarqube-agent.md`) to match naming convention
- Three operating modes: `quick` (issues only), `full` (all 10 toolsets), `pr` (PR scope)
- Delegation matrix routes fixes by file extension to 11 domain subagents including `@security-reviewer` for hotspots
- Issue lifecycle: OPEN → SCANNED → TODO_CREATED → DELEGATED → FIX_APPLIED → RE_SCANNED → VERIFIED/ACCEPTED
- SonarQube MCP server needs toolsets enabled: `issues,security-hotspots,duplications,coverage,dependency-risks,quality-gates,measures,projects,rules`

## Next Steps
- (all documentation updated — task complete)

## Critical Context
- SonarQube MCP tools: `search_sonar_issues_in_projects`, `search_security_hotspots`, `search_duplicated_files`, `get_duplications`, `search_files_by_coverage`, `get_file_coverage_details`, `search_dependency_risks`, `get_quality_gate_status`, `get_component_measures`, `search_my_sonarqube_projects`, `get_rule`, `get_analysis`, `change_sonar_issue_status`, `change_security_hotspot_review_status`
- Agent must NOT be a coder — only scan, report, create TODOs, and delegate
- Delegation targets: `@frontend-nuxt`, `@frontend-react`, `@node-developer`, `@ci3`, `@laravel`, `@android`, `@flutter`, `@database`, `@devops`, `@security-reviewer`
- Severity mapping: Blocker/Critical → high priority, Major → medium, Minor/Info → low
- Existing agents count updated from 12 to 13 across all documentation

## Relevant Files
- `.opencode/agents/sonarqube-quality.md`: New SonarQube quality agent definition (406 lines)
- `.opencode/commands/sonarqube-scan.md`: New slash command for triggering scans (65 lines)
- `.opencode/agents/it-leader.md`: Updated orchestrator — added `@sonarqube` to subagents, delegation tree, capabilities
- `AGENTS.md`: Updated project documentation — agent count, categories, MCP servers
- `index.html`: Landing page — updated to reflect 13 agents, SonarQube card, 37 commands, 7 MCP servers
- `README.md`: Setup guide — updated counts, agent list, custom agents table, commands
- `package.json`: NPM package metadata — updated description and keywords