opencode-agent-kit 1.0.15 → 1.0.18

package/README.md

@@ -1,10 +1,10 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/defuj/ai-agent-kit/main/assets/og-image-2.webp" alt="AI Agent KIT Banner" width="100%">
+  <img src="https://raw.githubusercontent.com/defuj/opencode-agent-kit/main/assets/og-image-2.webp" alt="Opencode Agent KIT Banner" width="100%">
 </p>
 
 # Agent Kit — Setup Guide
 
-Complete setup guide for the **Agent Kit** — a portable multi-stack AI agent system for OpenCode. Includes 13 specialized agents, 62 skill playbooks, 36 slash commands, and 6 MCP servers.
+Complete setup guide for the **Agent Kit** — a portable multi-stack AI agent system for OpenCode. Includes 13 specialized agents, 62 skill playbooks, 37 slash commands, and 7 MCP servers.
 
 ```bash
 npx opencode-agent-kit init    # One command. Full team.
@@ -32,7 +32,7 @@ opencode-agent-kit init
 
 ## Overview
 
-Think of Agent Kit as an AI development team you install into any OpenCode project. An **IT Leader** orchestrates 12 specialized subagents — each one an expert in their stack. You describe what to build; the team handles the rest.
+Think of Agent Kit as an AI development team you install into any OpenCode project. An **IT Leader** orchestrates 13 specialized subagents — each one an expert in their stack. You describe what to build; the team handles the rest.
 
 This repository contains a complete OpenCode agent configuration with **Leader → Subagent** architecture for software development teams.
 
@@ -53,6 +53,7 @@ This repository contains a complete OpenCode agent configuration with **Leader
   - `seo-specialist.md` — SEO Specialist — `@seo`
   - `android-developer.md` — Android Developer (Kotlin/Compose) — `@android`
   - `flutter-developer.md` — Flutter Developer (Dart) — `@flutter`
+  - `sonarqube-quality.md` — SonarQube Quality Scanner — `@sonarqube`
   - `nuxt-frontend-developer-mentor.md` — Nuxt mentor (standalone)
 - Internal documentation: `.opencode/docs/`
   - Frontend Nuxt: `.opencode/docs/frontend/nuxt/`
@@ -112,6 +113,7 @@ Specialized agents **not available** in built-in OpenCode:
 | **SEO**               | `seo-specialist.md`           | Meta tags, structured data, Core Web Vitals    | SEO optimization             |
 | **Android**           | `android-developer.md`        | Kotlin, Jetpack Compose, Gradle, Play Store    | Android native development   |
 | **Flutter**           | `flutter-developer.md`        | Dart, Flutter SDK, Material 3, Firebase        | Cross-platform mobile        |
+| **SonarQube**         | `sonarqube-quality.md`        | Code quality scans, security, coverage         | Quality assurance            |
 
 ### Workflow
 
@@ -186,6 +188,9 @@ After installing `.opencode/`, the following slash commands are available:
 /flutter-build [target]               # Build Flutter (apk/appbundle/ios/web)
 /flutter-test [type]                  # Run Flutter tests with coverage
 /gpc-release [track]                  # Publish to Google Play
+
+# Quality
+/sonarqube-scan [options]             # SonarQube quality scan (issues, security, coverage)
 ```
 
 ## Using the `.opencode/` Folder
@@ -325,10 +330,10 @@ Skills are stored in `.opencode/skills/` (local in the repo) — no need to sear
 | Agent                      | Key Skills                                                                                                                                                                                                                                     |
 | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | IT Leader                  | coding-standards, backend-patterns, frontend-patterns                                                                                                                                                                                          |
-| Frontend Developer (Vue)   | coding-standards, frontend-patterns, frontend-design, web-design-guidelines, nuxt-ui, tdd-workflow                                                                                                                                             |
-| Frontend Developer (React) | coding-standards, frontend-patterns, frontend-design, web-design-guidelines, vercel-react-best-practices, vercel-composition-patterns, tdd-workflow                                                                                            |
+| Frontend Developer (Vue)   | coding-standards, frontend-patterns, impeccable, web-design-guidelines, nuxt-ui, tdd-workflow                                                                                                                                                  |
+| Frontend Developer (React) | coding-standards, frontend-patterns, impeccable, web-design-guidelines, vercel-react-best-practices, vercel-composition-patterns, tdd-workflow                                                                                                 |
 | Backend Developer          | coding-standards, backend-patterns, postgres-patterns, security-review                                                                                                                                                                         |
-| UI/UX Designer             | frontend-design, web-design-guidelines, building-components, nuxt-ui                                                                                                                                                                           |
+| UI/UX Designer             | impeccable, web-design-guidelines, building-components, nuxt-ui                                                                                                                                                                                |
 | Code Reviewer / QA         | coding-standards, security-review, tdd-workflow, web-design-guidelines                                                                                                                                                                         |
 | Database Specialist        | postgres-patterns, backend-patterns                                                                                                                                                                                                            |
 | DevOps / Infrastructure    | backend-patterns, coding-standards                                                                                                                                                                                                             |
@@ -383,7 +388,7 @@ If skills are not yet on your machine, copy them from this repo:
 mkdir -p ~/.opencode/skills
 cp -R ./.opencode/skills/coding-standards ~/.opencode/skills/
 cp -R ./.opencode/skills/frontend-patterns ~/.opencode/skills/
-cp -R ./.opencode/skills/frontend-design ~/.opencode/skills/
+cp -R ./.opencode/skills/impeccable ~/.opencode/skills/
 cp -R ./.opencode/skills/web-design-guidelines ~/.opencode/skills/
 cp -R ./.opencode/skills/nuxt-ui ~/.opencode/skills/
 cp -R ./.opencode/skills/security-review ~/.opencode/skills/

package/bin/commands/init.mjs

@@ -247,16 +247,22 @@ export async function init(options) {
   }
 
   // 9. Write .kit-version for agent update checking
-  const pkgJson = JSON.parse(readFileSync(join(PKG_ROOT, 'package.json'), 'utf-8'));
-  const versionFile = join(opencodeDir, '.kit-version');
-  writeFileSync(versionFile, pkgJson.version + '\n', 'utf-8');
+  const pkgJson = JSON.parse(
+    readFileSync(join(PKG_ROOT, "package.json"), "utf-8"),
+  );
+  const versionFile = join(opencodeDir, ".kit-version");
+  writeFileSync(versionFile, pkgJson.version + "\n", "utf-8");
 
   // 10. Done
   console.log(`\n  ✅ opencode-agent-kit v${pkgJson.version} installed!\n`);
   console.log(`     Location: ${targetDir}`);
   console.log(`     What you got:`);
-  console.log(`       • opencode.json              — 13 agents config with MCP servers`);
-  console.log(`       • opencode.example.json      — Example config for reference`);
+  console.log(
+    `       • opencode.json              — 13 agents config with MCP servers`,
+  );
+  console.log(
+    `       • opencode.example.json      — Example config for reference`,
+  );
   console.log(`       • .opencode/agents    — 14 agent prompt files`);
   console.log(`       • .opencode/skills/    — 60+ skill playbooks`);
   console.log(`       • .opencode/commands/  — 35+ slash commands`);

package/bin/init.mjs

@@ -1,21 +1,21 @@
 #!/usr/bin/env node
 
-import { Command } from 'commander';
-import { init } from './commands/init.mjs';
+import { Command } from "commander";
+import { init } from "./commands/init.mjs";
 
 const program = new Command();
 
 program
-  .name('opencode-agent-kit')
-  .description('Install OpenCode multi-agent toolkit into your project')
-  .version('1.0.0');
+  .name("opencode-agent-kit")
+  .description("Install OpenCode multi-agent toolkit into your project")
+  .version("1.0.0");
 
 program
-  .command('init')
-  .description('Initialize .opencode/ configuration in current project')
-  .option('-f, --force', 'Overwrite existing files without prompt')
-  .option('-d, --dir <path>', 'Target project directory', process.cwd())
-  .option('--skip-install', 'Skip npm/bun install step in .opencode/')
+  .command("init")
+  .description("Initialize .opencode/ configuration in current project")
+  .option("-f, --force", "Overwrite existing files without prompt")
+  .option("-d, --dir <path>", "Target project directory", process.cwd())
+  .option("--skip-install", "Skip npm/bun install step in .opencode/")
   .action(init);
 
 program.parse();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "opencode-agent-kit",
-  "version": "1.0.15",
-  "description": "Multi-stack OpenCode agent toolkit — 13 specialized AI agents (Nuxt, React, Node.js, Laravel, CI3, Android, Flutter, DevOps, SEO) with 62 skills, 36 commands, and 6 MCP servers",
+  "version": "1.0.18",
+  "description": "Multi-stack OpenCode agent toolkit — 13 specialized AI agents (Nuxt, React, Node.js, Laravel, CI3, Android, Flutter, DevOps, SEO, SonarQube) with 62 skills, 37 commands, and 7 MCP servers",
   "type": "module",
   "bin": {
     "opencode-agent-kit": "./bin/init.mjs"
@@ -16,11 +16,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/defuj/agent-kit.git"
+    "url": "git+https://github.com/defuj/opencode-agent-kit.git"
   },
-  "homepage": "https://defuj.github.io/agent-kit",
+  "homepage": "https://github.com/defuj/opencode-agent-kit",
   "bugs": {
-    "url": "https://github.com/defuj/agent-kit/issues"
+    "url": "https://github.com/defuj/opencode-agent-kit/issues"
   },
   "engines": {
     "node": ">=18"
@@ -42,6 +42,7 @@
     "dart",
     "devops",
     "seo",
+    "sonarqube",
     "coding-agent",
     "mcp",
     "playwright",

package/template/.opencode/.agents.md

@@ -0,0 +1,55 @@
+## 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`, `@backend`, `@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

package/template/.opencode/agents/flutter-developer.md

@@ -90,7 +90,7 @@ If user does not specify mode, infer automatically from task size and risk.
 1. **`coding-standards`** — Universal coding standards and best practices
 2. **`flutter`** — Comprehensive Flutter patterns, architecture, state management, and testing
 3. **`frontend-patterns`** — Mobile UI patterns and component architecture
-4. **`frontend-design`** — Design thinking and aesthetic implementation
+4. **`impeccable`** — Impeccable design intelligence: typography, color, layout, motion, critique, and polish
 5. **`web-design-guidelines`** — UI/UX compliance and accessibility
 
 ### Contextual Skills (Load when needed)

package/template/.opencode/agents/it-leader.md

@@ -51,6 +51,7 @@ You are a **senior IT Leader / Technical Project Manager / Solution Architect**.
 - Research external dependencies or clone repos (delegate to `@scout`)
 - Execute complex multi-step research or tasks (delegate to `@general`)
 - Run security scanning or audits (delegate to `@security-reviewer`)
+- Run SonarQube quality scans or issue triage (delegate to `@sonarqube`)
 - Fix build errors, TypeScript errors, or compilation issues (delegate to `@build-error-resolver`)
 - Run code review or quality checks (delegate to `@code-reviewer` or `@reviewer`)
 - Perform dead code cleanup or refactoring (delegate to `@refactor-cleaner`)
@@ -79,6 +80,7 @@ You are a **senior IT Leader / Technical Project Manager / Solution Architect**.
 | SEO Specialist | `@seo` | Meta tags, structured data, Core Web Vitals, content optimization |
 | Android Developer | `@android` | Kotlin, Jetpack Compose, Gradle, Material Design 3, Play Store |
 | Flutter Developer | `@flutter` | Flutter, Dart, Material Design 3, Cupertino, Firebase |
+| SonarQube Quality | `@sonarqube` | SonarQube audit, issue triage, quality gate checks, fix delegation |
 
 ### Subagent Capabilities Reference
 
@@ -155,6 +157,15 @@ You are a **senior IT Leader / Technical Project Manager / Solution Architect**.
 - Commands: `/flutter-build`, `/flutter-test`
 - Output: Reports verification status (`verified` / `partially_verified` / `not_verified`)
 
+#### `@sonarqube` (sonarqube-quality)
+- Stack: SonarQube MCP server (issues, security-hotspots, duplications, coverage, dependency-risks, quality-gates, measures, projects, rules)
+- Can: Scan code quality, triage issues by severity, detect security hotspots, find duplications, assess coverage, identify dependency risks, create structured TODOs, delegate fixes to domain subagents, re-scan to verify fixes
+- Uses: SonarQube MCP toolsets, `todowrite` for TODO tracking, domain subagents for fix delegation
+- Commands: `/sonarqube-scan`
+- Modes: `quick` (issues only), `full` (all toolsets), `pr` (PR scope)
+- Delegation: Routes fixes by file type to `@frontend-nuxt`, `@frontend-react`, `@backend`, `@ci3`, `@laravel`, `@android`, `@flutter`, `@database`, `@devops`, `@security-reviewer`
+- Output: Quality scan report, TODO list, delegation status, re-scan verification
+
 ### Built-in OpenCode Agents (Available Globally)
 
 OpenCode has **built-in agents** that are available automatically. Use these for tasks that are better served by specialized tools:
@@ -419,6 +430,7 @@ When delegating via `task` tool, always include:
 | Critical flow | E2E (Playwright) | @e2e-runner |
 | Mobile app build | Build + Unit tests | @android / @flutter |
 | Play Store release | Build + Preflight + Release | @android (via gpc) |
+| SonarQube quality scan | Full scan + Issue triage + Fix delegation | @sonarqube |
 
 ## Security Gate
 
@@ -573,6 +585,7 @@ Task received
     │   ├── SEO → @seo
     │   ├── Code review → @code-reviewer
     │   ├── Security → @security-reviewer
+    │   ├── SonarQube quality → @sonarqube
     │   ├── Build errors → @build-error-resolver
     │   ├── E2E tests → @e2e-runner
     │   └── Dead code → @refactor-cleaner
@@ -915,7 +928,7 @@ Project context:
   - Backend: Node.js + Express 5 + Prisma + PostgreSQL
   - OR: CodeIgniter 3 MVC monolith
   - OR: Laravel 10+ with Service Layer
-- Subagents: @frontend-nuxt, @frontend-react, @backend, @ci3, @laravel, @designer, @reviewer, @database, @devops, @seo, @android, @flutter
+- Subagents: @frontend-nuxt, @frontend-react, @backend, @ci3, @laravel, @designer, @reviewer, @database, @devops, @seo, @android, @flutter, @sonarqube
 
 Delegation policy:
 - ALL application code changes: Delegated to subagents (no exceptions)

package/template/.opencode/agents/nuxt-frontend-developer.md

@@ -103,7 +103,7 @@ Load these skills by default at the beginning of each session:
 
 1. **`coding-standards`** - Universal coding standards and best practices
 2. **`frontend-patterns`** - Modern Vue/Nuxt patterns and component architecture
-3. **`frontend-design`** - Design thinking and aesthetic implementation
+3. **`impeccable`** - Impeccable design intelligence: typography, color, layout, motion, critique, and polish
 4. **`web-design-guidelines`** - UI/UX compliance and accessibility
 
 For trivial edits, keep skill-loading implicit and avoid verbose announcements.
@@ -124,7 +124,7 @@ Load these skills based on the task context:
 # Session Start Protocol
 
 1. Analyze project structure
-2. Load core skills (coding-standards, frontend-patterns, frontend-design)
+2. Load core skills (coding-standards, frontend-patterns, impeccable)
 3. Connect to MCP servers (Nuxt, Nuxt UI, Playwright)
 4. Identify framework (Nuxt as primary) and load relevant skills
 5. Infer session goals from user request first; ask only when blocked
@@ -1068,7 +1068,7 @@ export function useMarketData(marketId: Ref<string>) {
 
 ## Design & Aesthetics Philosophy
 
-This project uses **Impeccable** (impeccable.style) design intelligence. Impeccable's shared design laws are automatically applied to every UI you build. The `frontend-design` skill is pre-loaded with these principles.
+This project uses **Impeccable** (impeccable.style) design intelligence. Impeccable's shared design laws are automatically applied to every UI you build. The `impeccable` skill is pre-loaded with these principles.
 
 ### Design Thinking Process
 
@@ -1487,7 +1487,7 @@ Before starting work, check if `opencode-agent-kit` has an update:
 Quick context check:
 
 - Project: [Detected framework and version]
-- Loaded skills: coding-standards, frontend-patterns, frontend-design
+- Loaded skills: coding-standards, frontend-patterns, impeccable
 - Ready to: [build components | optimize performance | implement designs | review code]
 
 What are we working on today?

package/template/.opencode/agents/react-frontend-developer.md

@@ -103,7 +103,7 @@ If user does not specify mode, infer automatically from task size and risk.
 
 1. **`coding-standards`** - Universal coding standards and best practices
 2. **`frontend-patterns`** - Modern React/Next.js patterns and component architecture
-3. **`frontend-design`** - Design thinking and aesthetic implementation
+3. **`impeccable`** - Impeccable design intelligence: typography, color, layout, motion, critique, and polish
 4. **`web-design-guidelines`** - UI/UX compliance and accessibility
 
 ### Contextual Skills (Load when needed)
@@ -121,7 +121,7 @@ If user does not specify mode, infer automatically from task size and risk.
 # Session Start Protocol
 
 1. Analyze project structure
-2. Load core skills (coding-standards, frontend-patterns, frontend-design)
+2. Load core skills (coding-standards, frontend-patterns, impeccable)
 3. Identify framework (React/Next.js) and load relevant skills
 4. Infer session goals from user request first; ask only when blocked
 5. Load additional contextual skills as needed
@@ -623,7 +623,7 @@ function LoginForm() {
 
 ## Design & Aesthetics Philosophy
 
-This project uses **Impeccable** (impeccable.style) design intelligence. Impeccable's shared design laws are automatically applied to every UI you build. The `frontend-design` skill is pre-loaded with these principles.
+This project uses **Impeccable** (impeccable.style) design intelligence. Impeccable's shared design laws are automatically applied to every UI you build. The `impeccable` skill is pre-loaded with these principles.
 
 ### Design Thinking Process
 
@@ -958,7 +958,7 @@ React Frontend Developer activated!
 
 Project context:
 - Framework: [React | Next.js | Vite]
-- Loaded skills: coding-standards, frontend-patterns, frontend-design
+- Loaded skills: coding-standards, frontend-patterns, impeccable
 - Ready to: [build components | optimize performance | implement designs | review code]
 
 What are we working on today?