opencode-agent-kit 1.0.2 → 1.0.5

package/README.md

@@ -50,10 +50,10 @@ This repository contains a complete OpenCode agent configuration with **Leader
   - `android-developer.md` — Android Developer (Kotlin/Compose) — `@android`
   - `flutter-developer.md` — Flutter Developer (Dart) — `@flutter`
   - `nuxt-frontend-developer-mentor.md` — Nuxt mentor (standalone)
-- Internal documentation: `.opencode/agent-docs/`
-  - Frontend Nuxt: `.opencode/agent-docs/frontend/nuxt/`
-  - Frontend React: `.opencode/agent-docs/frontend/react/`
-  - Backend Node: `.opencode/agent-docs/backend/node/`
+- Internal documentation: `.opencode/docs/`
+  - Frontend Nuxt: `.opencode/docs/frontend/nuxt/`
+  - Frontend React: `.opencode/docs/frontend/react/`
+  - Backend Node: `.opencode/docs/backend/node/`
 - Local skills: `.opencode/skills/` (62 skill playbooks)
 - Contexts: `.opencode/contexts/` (dev, research, review)
 
@@ -627,11 +627,11 @@ Agents are configured to always report:
 - No pushes unless requested by the user
 - No touching files outside the request scope
 
-Detailed SOP: `.opencode/agent-docs/frontend/nuxt/TEAM_OPERATING_GUIDE.md`
+Detailed SOP: `.opencode/docs/frontend/nuxt/TEAM_OPERATING_GUIDE.md`
 
 ## Documentation
 
-Agent documentation is available at `.opencode/agent-docs/frontend/nuxt/`:
+Agent documentation is available at `.opencode/docs/frontend/nuxt/`:
 
 | Document                  | Content                       |
 | ------------------------- | ----------------------------- |
@@ -685,9 +685,9 @@ Agent documentation is available at `.opencode/agent-docs/frontend/nuxt/`:
 - Flutter prompt: `.opencode/agents/flutter-developer.md`
 - Mobile commands: `.opencode/commands/android-build/`, `android-test/`, `flutter-build/`, `flutter-test/`, `gpc-release/`
 - Mobile rules: `.opencode/rules/android/`, `flutter/`, `mobile/`
-- Main docs: `.opencode/agent-docs/frontend/nuxt/README.md`
-- Quick start: `.opencode/agent-docs/frontend/nuxt/QUICK_START.md`
-- Docs index: `.opencode/agent-docs/frontend/nuxt/INDEX.md`
+- Main docs: `.opencode/docs/frontend/nuxt/README.md`
+- Quick start: `.opencode/docs/frontend/nuxt/QUICK_START.md`
+- Docs index: `.opencode/docs/frontend/nuxt/INDEX.md`
 
 ## Troubleshooting
 

package/bin/commands/init.mjs

@@ -1,19 +1,26 @@
-import { readFileSync, existsSync, copyFileSync, mkdirSync, writeFileSync, readdirSync, statSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { execSync } from 'child_process';
+import {
+  readFileSync,
+  existsSync,
+  copyFileSync,
+  mkdirSync,
+  writeFileSync,
+  readdirSync,
+} from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+import { execSync } from "child_process";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-const PKG_ROOT = join(__dirname, '..', '..');
-const TEMPLATE_DIR = join(PKG_ROOT, 'template');
+const PKG_ROOT = join(__dirname, "..", "..");
+const TEMPLATE_DIR = join(PKG_ROOT, "template");
 
 function copyRecursive(src, dest) {
   if (!existsSync(src)) return;
   const entries = readdirSync(src, { withFileTypes: true });
   mkdirSync(dest, { recursive: true });
   for (const entry of entries) {
-    if (entry.name === '.DS_Store') continue;
+    if (entry.name === ".DS_Store") continue;
     const srcPath = join(src, entry.name);
     const destPath = join(dest, entry.name);
     if (entry.isDirectory()) {
@@ -25,10 +32,10 @@ function copyRecursive(src, dest) {
 }
 
 function detectPackageManager(cwd) {
-  if (existsSync(join(cwd, 'bun.lock'))) return 'bun';
-  if (existsSync(join(cwd, 'pnpm-lock.yaml'))) return 'pnpm';
-  if (existsSync(join(cwd, 'yarn.lock'))) return 'yarn';
-  return 'npm';
+  if (existsSync(join(cwd, "bun.lock"))) return "bun";
+  if (existsSync(join(cwd, "pnpm-lock.yaml"))) return "pnpm";
+  if (existsSync(join(cwd, "yarn.lock"))) return "yarn";
+  return "npm";
 }
 
 function mergeJson(target, source, strategy = {}) {
@@ -40,19 +47,19 @@ function mergeJson(target, source, strategy = {}) {
       continue;
     }
 
-    const rule = strategy[key] || 'default';
+    const rule = strategy[key] || "default";
 
-    if (rule === 'keep-target') {
+    if (rule === "keep-target") {
       // Keep user's existing value
       continue;
     }
 
-    if (rule === 'source-wins') {
+    if (rule === "source-wins") {
       merged[key] = JSON.parse(JSON.stringify(value));
       continue;
     }
 
-    if (rule === 'merge-agents') {
+    if (rule === "merge-agents") {
       merged[key] = merged[key] || {};
       for (const [agentKey, agentVal] of Object.entries(value)) {
         if (!(agentKey in merged[key])) {
@@ -63,7 +70,7 @@ function mergeJson(target, source, strategy = {}) {
       continue;
     }
 
-    if (rule === 'merge-mcp') {
+    if (rule === "merge-mcp") {
       merged[key] = merged[key] || {};
       for (const [mcpKey, mcpVal] of Object.entries(value)) {
         if (!(mcpKey in merged[key])) {
@@ -73,7 +80,7 @@ function mergeJson(target, source, strategy = {}) {
       continue;
     }
 
-    if (rule === 'merge-instructions') {
+    if (rule === "merge-instructions") {
       const existing = merged[key] || [];
       const srcArr = Array.isArray(value) ? value : [value];
       for (const item of srcArr) {
@@ -85,7 +92,7 @@ function mergeJson(target, source, strategy = {}) {
       continue;
     }
 
-    if (rule === 'merge-permissions') {
+    if (rule === "merge-permissions") {
       merged[key] = merged[key] || {};
       for (const [permKey, permVal] of Object.entries(value)) {
         if (!(permKey in merged[key])) {
@@ -96,8 +103,14 @@ function mergeJson(target, source, strategy = {}) {
     }
 
     // default: source wins for top-level, but merge nested objects
-    if (typeof value === 'object' && value !== null && !Array.isArray(value) &&
-        typeof merged[key] === 'object' && merged[key] !== null && !Array.isArray(merged[key])) {
+    if (
+      typeof value === "object" &&
+      value !== null &&
+      !Array.isArray(value) &&
+      typeof merged[key] === "object" &&
+      merged[key] !== null &&
+      !Array.isArray(merged[key])
+    ) {
       merged[key] = { ...merged[key], ...value };
     } else {
       merged[key] = value;
@@ -108,19 +121,19 @@ function mergeJson(target, source, strategy = {}) {
 }
 
 function mergeOencodeConfig(templateConfigPath, userConfigPath, force) {
-  const templateConfig = JSON.parse(readFileSync(templateConfigPath, 'utf-8'));
+  const templateConfig = JSON.parse(readFileSync(templateConfigPath, "utf-8"));
   const userConfig = existsSync(userConfigPath)
-    ? JSON.parse(readFileSync(userConfigPath, 'utf-8'))
+    ? JSON.parse(readFileSync(userConfigPath, "utf-8"))
     : {};
 
   const strategy = {
-    '$schema': 'source-wins',
-    'formatter': 'keep-target',
-    'permission': 'keep-target',
-    'instructions': 'merge-instructions',
-    'mcp': 'merge-mcp',
-    'agent': force ? 'source-wins' : 'merge-agents',
-    'plugin': 'merge-instructions',
+    $schema: "source-wins",
+    formatter: "keep-target",
+    permission: "keep-target",
+    instructions: "merge-instructions",
+    mcp: "merge-mcp",
+    agent: force ? "source-wins" : "merge-agents",
+    plugin: "merge-instructions",
   };
 
   const merged = mergeJson(userConfig, templateConfig, strategy);
@@ -141,16 +154,21 @@ export async function init(options) {
   }
 
   // 2. Check if .opencode already exists
-  const opencodeDir = join(targetDir, '.opencode');
-  const userConfigPath = join(targetDir, 'opencode.json');
+  const opencodeDir = join(targetDir, ".opencode");
+  const userConfigPath = join(targetDir, "opencode.json");
 
   if (existsSync(opencodeDir) && !force) {
     console.log(`  \n  ⚠  .opencode/ already exists in ${targetDir}`);
-    const rl = await import('readline/promises');
-    const readline = rl.createInterface({ input: process.stdin, output: process.stdout });
-    const answer = await readline.question(`  ? Overwrite existing files? [y/N] `);
+    const rl = await import("readline/promises");
+    const readline = rl.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+    });
+    const answer = await readline.question(
+      `  ? Overwrite existing files? [y/N] `,
+    );
     readline.close();
-    if (answer.toLowerCase() !== 'y') {
+    if (answer.toLowerCase() !== "y") {
       console.log(`  ✗ Aborted.`);
       process.exit(0);
     }
@@ -165,56 +183,49 @@ export async function init(options) {
 
   // 4. Copy .opencode/ from template
   console.log(`  \n  📁 Copying .opencode/ configuration...`);
-  copyRecursive(join(TEMPLATE_DIR, '.opencode'), opencodeDir);
+  copyRecursive(join(TEMPLATE_DIR, ".opencode"), opencodeDir);
 
   // 5. Merge opencode.json
-  const templateConfigPath = join(TEMPLATE_DIR, 'opencode.json');
+  const templateConfigPath = join(TEMPLATE_DIR, "opencode.json");
   if (existsSync(templateConfigPath)) {
     console.log(`  📝 Merging opencode.json...`);
-    const merged = mergeOencodeConfig(templateConfigPath, userConfigPath, force);
-    writeFileSync(userConfigPath, JSON.stringify(merged, null, 2) + '\n', 'utf-8');
+    const merged = mergeOencodeConfig(
+      templateConfigPath,
+      userConfigPath,
+      force,
+    );
+    writeFileSync(
+      userConfigPath,
+      JSON.stringify(merged, null, 2) + "\n",
+      "utf-8",
+    );
   }
 
-  // 6. Handle AGENTS.md (append)
-  const templateAgentsPath = join(TEMPLATE_DIR, 'AGENTS.md');
-  const userAgentsPath = join(targetDir, 'AGENTS.md');
-  if (existsSync(templateAgentsPath)) {
-    const templateContent = readFileSync(templateAgentsPath, 'utf-8');
-    if (existsSync(userAgentsPath) && !force) {
-      const existingContent = readFileSync(userAgentsPath, 'utf-8');
-      if (!existingContent.includes('# opencode-agent-kit')) {
-        console.log(`  📄 Appending to existing AGENTS.md...`);
-        writeFileSync(userAgentsPath, existingContent.trimEnd() + '\n\n' + templateContent, 'utf-8');
-      }
-    } else {
-      console.log(`  📄 Writing AGENTS.md...`);
-      writeFileSync(userAgentsPath, templateContent, 'utf-8');
-    }
-  }
-
-  // 7. Install dependencies
+  // 6. Install dependencies
   if (!skipInstall) {
     const pm = detectPackageManager(opencodeDir);
     console.log(`  📦 Installing .opencode/ dependencies with ${pm}...`);
     try {
-      execSync(`${pm} install`, { cwd: opencodeDir, stdio: 'pipe' });
+      execSync(`${pm} install`, { cwd: opencodeDir, stdio: "pipe" });
     } catch (err) {
       console.error(`  ⚠  Dependency install failed: ${err.message}`);
       console.error(`    You can run "${pm} install" manually in .opencode/`);
     }
   }
 
-  // 8. Done
+  // 7. Done
   console.log(`\n  ✅ opencode-agent-kit installed!\n`);
   console.log(`     Location: ${targetDir}`);
   console.log(`     What you got:`);
-  console.log(`       • opencode.json        — 13 agents config with MCP servers`);
-  console.log(`       • .opencode/agents/    — 14 agent prompt files`);
+  console.log(
+    `       • opencode.json        — 13 agents config with MCP servers`,
+  );
+  console.log(`       • .opencode/agents    — 14 agent prompt files`);
   console.log(`       • .opencode/skills/    — 60+ skill playbooks`);
   console.log(`       • .opencode/commands/  — 35+ slash commands`);
   console.log(`       • .opencode/rules/     — Scoped coding rules`);
   console.log(`       • .opencode/contexts/  — Dev/review/research contexts`);
-  console.log(`       • .opencode/agent-docs/— Agent documentation`);
+  console.log(`       • .opencode/docs/— Agent documentation`);
   console.log(`\n     Next steps:`);
   console.log(`       cd ${targetDir}`);
   console.log(`       opencode\n`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-agent-kit",
-  "version": "1.0.2",
+  "version": "1.0.5",
   "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",
   "type": "module",
   "bin": {

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

@@ -13,16 +13,16 @@ You are a **senior frontend developer** with deep expertise in modern web techno
 
 ## 📚 Documentation
 
-Complete documentation available in `.opencode/agent-docs/frontend/nuxt/`:
-
-- **Quick Start**: `.opencode/agent-docs/frontend/nuxt/QUICK_START.md` - Get started in 5 minutes
-- **Examples**: `.opencode/agent-docs/frontend/nuxt/EXAMPLES.md` - 50+ practical examples
-- **API Patterns**: `.opencode/agent-docs/frontend/nuxt/API_PATTERNS.md` - useApi composable guide
-- **Workflows**: `.opencode/agent-docs/frontend/nuxt/WORKFLOWS.md` - 8 detailed workflows
-- **Cheatsheet**: `.opencode/agent-docs/frontend/nuxt/CHEATSHEET.md` - Quick reference
-- **MCP Guide**: `.opencode/agent-docs/frontend/nuxt/MCP_GUIDE.md` - MCP integration
-- **Testing**: `.opencode/agent-docs/frontend/nuxt/TESTING_GUIDE.md` - Testing & validation
-- **Navigation**: `.opencode/agent-docs/frontend/nuxt/INDEX.md` - Full documentation index
+Complete documentation available in `.opencode/docs/frontend/nuxt/`:
+
+- **Quick Start**: `.opencode/docs/frontend/nuxt/QUICK_START.md` - Get started in 5 minutes
+- **Examples**: `.opencode/docs/frontend/nuxt/EXAMPLES.md` - 50+ practical examples
+- **API Patterns**: `.opencode/docs/frontend/nuxt/API_PATTERNS.md` - useApi composable guide
+- **Workflows**: `.opencode/docs/frontend/nuxt/WORKFLOWS.md` - 8 detailed workflows
+- **Cheatsheet**: `.opencode/docs/frontend/nuxt/CHEATSHEET.md` - Quick reference
+- **MCP Guide**: `.opencode/docs/frontend/nuxt/MCP_GUIDE.md` - MCP integration
+- **Testing**: `.opencode/docs/frontend/nuxt/TESTING_GUIDE.md` - Testing & validation
+- **Navigation**: `.opencode/docs/frontend/nuxt/INDEX.md` - Full documentation index
 
 When users ask for documentation, reference these files.
 

package/template/opencode.json

@@ -34,7 +34,6 @@
     "leader": {
       "description": "IT Leader & Technical Project Manager — analyzes requirements, designs architecture, decomposes tasks, delegates to subagents, and unifies outputs",
       "mode": "primary",
-      "model": "opencode/claude-opus-4.5",
       "prompt": "{file:.opencode/agents/it-leader.md}",
       "temperature": 0.4,
       "color": "#8b5cf6",
@@ -61,7 +60,6 @@
     "frontend-nuxt": {
       "description": "Expert Vue/Nuxt frontend developer for Nuxt.js, Vue 3, Nuxt UI, and modern web technologies with MCP integration (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/nuxt-frontend-developer.md}",
       "color": "#3b82f6",
       "permission": {
@@ -85,7 +83,6 @@
     "frontend-react": {
       "description": "Expert React/Next.js frontend developer for React 19, Next.js 15, Vite, shadcn/ui, and modern web technologies (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/react-frontend-developer.md}",
       "color": "#06b6d4",
       "permission": {
@@ -107,7 +104,6 @@
     "backend": {
       "description": "Expert backend developer for Node.js, Express, Prisma, and PostgreSQL (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/node-backend-developer.md}",
       "color": "#10b981",
       "permission": {
@@ -127,7 +123,6 @@
     "ci3": {
       "description": "CodeIgniter 3 MVC fullstack developer for REST API, JWT, MySQL/PostgreSQL (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/code-igniter-3-fullstack.md}",
       "color": "#84cc16",
       "permission": {
@@ -146,7 +141,6 @@
     "laravel": {
       "description": "Laravel backend engineer for REST API, Service/Repository, JWT, MySQL/PostgreSQL (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/laravel-advanced.md}",
       "color": "#f97316",
       "permission": {
@@ -165,7 +159,6 @@
     "designer": {
       "description": "UI/UX Designer specializing in design systems, Google Stitch, Figma, accessibility, and design-to-code handoff (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4",
       "prompt": "{file:.opencode/agents/ui-ux-designer.md}",
       "color": "#f59e0b",
       "permission": {
@@ -186,7 +179,6 @@
     "reviewer": {
       "description": "Code Reviewer & QA Engineer specializing in code quality, security audit, testing strategy, and verification (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-opus-4.5",
       "prompt": "{file:.opencode/agents/code-reviewer.md}",
       "color": "#ef4444",
       "permission": {
@@ -207,7 +199,6 @@
     "database": {
       "description": "Database Specialist specializing in PostgreSQL schema design, query optimization, Prisma ORM, and migrations (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/database-specialist.md}",
       "color": "#06b6d4",
       "permission": {
@@ -226,7 +217,6 @@
     "devops": {
       "description": "DevOps Engineer specializing in CI/CD, deployment, Docker, monitoring, and infrastructure (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-haiku-4.5",
       "prompt": "{file:.opencode/agents/devops-specialist.md}",
       "color": "#6366f1",
       "permission": {
@@ -246,7 +236,6 @@
     "seo": {
       "description": "SEO Specialist specializing in meta tags, structured data, Core Web Vitals, and content optimization (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/gpt-5.1-codex-mini",
       "prompt": "{file:.opencode/agents/seo-specialist.md}",
       "color": "#84cc16",
       "permission": {
@@ -265,7 +254,6 @@
     "android": {
       "description": "Expert Android developer for Kotlin, Jetpack Compose, XML, Material Design 3, and Google Play (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/android-developer.md}",
       "color": "#22c55e",
       "permission": {
@@ -284,7 +272,6 @@
     "flutter": {
       "description": "Expert Flutter developer for Dart, Flutter SDK, Material Design 3, Firebase, and cross-platform mobile apps (subagent of IT Leader)",
       "mode": "subagent",
-      "model": "opencode/claude-sonnet-4.5",
       "prompt": "{file:.opencode/agents/flutter-developer.md}",
       "color": "#0284c7",
       "permission": {

package/template/AGENTS.md

@@ -1,32 +0,0 @@
-# opencode-agent-kit
-
-Multi-stack agent toolkit installed by `opencode-agent-kit`.
-
-## Agents
-
-| Agent | Type | Description |
-|-------|------|-------------|
-| `leader` | primary | IT Leader — orchestrates subagents via task tool |
-| `@frontend-nuxt` | subagent | Nuxt 4 + Vue 3 + TypeScript |
-| `@frontend-react` | subagent | React 19 + Next.js 15 + shadcn/ui |
-| `@backend` | subagent | Node.js + Express + Prisma + PostgreSQL |
-| `@ci3` | subagent | CodeIgniter 3 MVC monolith |
-| `@laravel` | subagent | Laravel 10+ REST API + Service Layer |
-| `@designer` | subagent | UI/UX — design system, Figma, Stitch |
-| `@reviewer` | subagent | Code quality, security audit, testing |
-| `@database` | subagent | PostgreSQL, Prisma, migrations |
-| `@devops` | subagent | CI/CD, Docker, monitoring |
-| `@seo` | subagent | Meta tags, Core Web Vitals, structured data |
-| `@android` | subagent | Kotlin, Jetpack Compose, Google Play |
-| `@flutter` | subagent | Dart, Flutter SDK, Firebase |
-
-## Slash Commands
-
-`/plan`, `/tdd`, `/code-review`, `/security`, `/build-fix`, `/e2e`, `/refactor-clean`
-`/orchestrate`, `/update-docs`, `/test-coverage`
-`/android-build`, `/android-test`, `/gpc-release`
-`/flutter-build`, `/flutter-test`
-
-## MCP Servers
-
-Nuxt docs, Nuxt UI, Playwright, Postman (enabled). Figma, Stitch (disabled, set env vars to enable).