opencode-agent-kit 1.0.12 → 1.0.14

package/README.md

@@ -2,21 +2,23 @@
   <img src="https://raw.githubusercontent.com/defuj/software-developer-team-agent/main/assets/og-image-2.webp" alt="Opencode Agent KIT Banner" width="100%">
 </p>
 
-# Opencode Agent KIT (Software Developer) — Setup Guide
+# Agent Kit — Setup Guide
 
-Complete setup guide for the **Opencode 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, 36 slash commands, and 6 MCP servers.
+
+```bash
+npx opencode-agent-kit init    # One command. Full team.
+```
 
 ---
 
 ## Quick Install
 
-**One command** — installs into any project:
-
 ```bash
 npx opencode-agent-kit init
 ```
 
-This copies the full agent configuration, skills, commands, and rules into your project.
+This copies the full agent configuration, skills, commands, and rules into your project. Smart merging preserves your existing setup.
 
 Global install:
 
@@ -30,6 +32,8 @@ 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.
+
 This repository contains a complete OpenCode agent configuration with **Leader → Subagent** architecture for software development teams.
 
 ### Agent Config
@@ -256,12 +260,12 @@ To **customize** a built-in agent, create an agent with the **same name** in `.o
 
 ### How It Works
 
-1. User gives requirements to the **IT Leader** (primary agent, auto-activated)
-2. IT Leader analyzes, designs architecture, and breaks into tasks
-3. IT Leader delegates tasks to the appropriate subagents
-4. IT Leader integrates results and reports to the user
+1. You describe what you need — a feature, a bug fix, a full app
+2. The **IT Leader** analyzes requirements, designs architecture, and breaks the work into tasks
+3. Tasks are delegated to the right subagents — frontend, backend, mobile, designer, reviewer
+4. The IT Leader integrates results and reports back with verification status
 
-For small tasks, mention subagents directly:
+For small tasks, mention subagents directly with `@mention`:
 
 ```text
 @frontend-nuxt Add a UButton "Save" in ProfileHeader.vue.

package/bin/commands/init.mjs

@@ -246,8 +246,13 @@ export async function init(options) {
     }
   }
 
-  // 9. Done
-  console.log(`\n  ✅ opencode-agent-kit installed!\n`);
+  // 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');
+
+  // 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`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-agent-kit",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "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": {
@@ -16,11 +16,11 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/defuj/software-developer-team-agent.git"
+    "url": "git+https://github.com/defuj/agent-kit.git"
   },
-  "homepage": "https://defuj.github.io/software-developer-team-agent",
+  "homepage": "https://defuj.github.io/agent-kit",
   "bugs": {
-    "url": "https://github.com/defuj/software-developer-team-agent/issues"
+    "url": "https://github.com/defuj/agent-kit/issues"
   },
   "engines": {
     "node": ">=18"

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

@@ -884,6 +884,25 @@ When `multiple: true`, the user can select several options at once. The result r
 
 ## Session Workflow
 
+### Version Check (Session Start)
+
+At the start of every session, check if `opencode-agent-kit` has an update:
+
+1. Read `.opencode/.kit-version` — if found, this is the installed version
+2. Run `npm view opencode-agent-kit version` to get the latest version on npm
+3. Compare versions (skip check if `.opencode/.kit-version` does not exist)
+4. If the latest version is greater than the installed version, notify the user:
+   ```
+   ╭─ Update Available ─────────────────────────────────────╮
+   │                                                       │
+   │   A newer version of opencode-agent-kit is available: │
+   │   Installed: v{installed}   Latest: v{latest}        │
+   │                                                       │
+   │   Run `npx opencode-agent-kit init` to update.        │
+   │                                                       │
+   ╰───────────────────────────────────────────────────────╯
+   ```
+
 ### Starting a Session
 
 ```markdown

package/template/.opencode/agents/node-backend-developer.md

@@ -326,6 +326,12 @@ Use these prompts across services with this stack.
 
 ## Session Workflow
 
+### Version Check (Session Start)
+Before starting work, check if `opencode-agent-kit` has an update:
+1. Read `.opencode/.kit-version` if it exists
+2. Run `npm view opencode-agent-kit version` to get the latest version
+3. If the latest version > installed version, notify the user to run `npx opencode-agent-kit init`
+
 ### Starting a Session
 - Analyze project structure and identify existing patterns
 - Use question tool to ask the task type (first option marked "(Recommended)")

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

@@ -1471,6 +1471,14 @@ questions: [
 
 ## Session Workflow
 
+### Version Check (Session Start)
+
+Before starting work, check if `opencode-agent-kit` has an update:
+
+1. Read `.opencode/.kit-version` if it exists
+2. Run `npm view opencode-agent-kit version` to get the latest version
+3. If the latest version > installed version, notify the user to run `npx opencode-agent-kit init`
+
 ### Starting a Session
 
 ```markdown

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

@@ -943,6 +943,14 @@ options: [
 
 ## Session Workflow
 
+### Version Check (Session Start)
+
+Before starting work, check if `opencode-agent-kit` has an update:
+
+1. Read `.opencode/.kit-version` if it exists
+2. Run `npm view opencode-agent-kit version` to get the latest version
+3. If the latest version > installed version, notify the user to run `npx opencode-agent-kit init`
+
 ### Starting a Session
 
 ```

package/template/.opencode/instructions/INSTRUCTIONS.md

@@ -378,6 +378,19 @@ flutter analyze                          # Static analysis
 3. Integration tests — Full user flows (integration_test package)
 4. Golden tests — Visual regression (golden_toolkit, alchemist)
 
+---
+
+## opencode-agent-kit Version Check
+
+If `.opencode/.kit-version` exists, your agent toolkit has a recorded installed version.
+
+**At session start**, check for updates:
+1. Read `.opencode/.kit-version` to get the installed version
+2. Run `npm view opencode-agent-kit version` to get the latest
+3. If latest > installed, notify the user with the update command
+
+This applies to IT-Leader (primary) and frontend/backend subagents when called directly.
+
 ## Success Metrics
 
 You are successful when:

package/template/opencode.example.json

@@ -26,55 +26,6 @@
     ".opencode/skills/security-review/SKILL.md",
     ".opencode/skills/frontend-design/SKILL.md"
   ],
-  "mcp": {
-    "nuxt": {
-      "type": "remote",
-      "url": "https://nuxt.com/mcp",
-      "enabled": true,
-      "description": "Nuxt documentation, blog posts, and deployment guides"
-    },
-    "nuxt-ui": {
-      "type": "remote",
-      "url": "https://ui.nuxt.com/mcp",
-      "enabled": true,
-      "description": "Nuxt UI component documentation and examples"
-    },
-    "figma": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-figma"],
-      "env": {
-        "FIGMA_ACCESS_TOKEN": "${FIGMA_ACCESS_TOKEN}"
-      },
-      "enabled": false,
-      "description": "Figma design file access (requires FIGMA_ACCESS_TOKEN)"
-    },
-    "playwright": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-playwright"],
-      "enabled": true,
-      "description": "Browser automation and E2E testing with Playwright"
-    },
-    "stitch": {
-      "type": "remote",
-      "url": "https://stitch.googleapis.com/mcp",
-      "headers": {
-        "X-Goog-Api-Key": "${STITCH_API_KEY}"
-      },
-      "enabled": false,
-      "description": "Google Stitch AI design generation (requires STITCH_API_KEY)"
-    },
-    "postman": {
-      "type": "remote",
-      "url": "https://mcp.postman.com/mcp",
-      "headers": {
-        "Authorization": "Bearer ${POSTMAN_API_KEY}"
-      },
-      "enabled": true,
-      "description": "Postman API management for collections, requests, and documentation"
-    }
-  },
   "agent": {
     "leader": {
       "description": "IT Leader & Technical Project Manager — analyzes requirements, designs architecture, decomposes tasks, delegates to subagents, and unifies outputs",

package/template/opencode.json

@@ -23,48 +23,6 @@
     ".opencode/skills/security-review/SKILL.md",
     ".opencode/skills/frontend-design/SKILL.md"
   ],
-  "mcp": {
-    "nuxt": {
-      "type": "remote",
-      "url": "https://nuxt.com/mcp",
-      "enabled": true,
-      "description": "Nuxt documentation, blog posts, and deployment guides"
-    },
-    "nuxt-ui": {
-      "type": "remote",
-      "url": "https://ui.nuxt.com/mcp",
-      "enabled": true,
-      "description": "Nuxt UI component documentation and examples"
-    },
-    "figma": {
-      "type": "remote",
-      "url": "https://mcp.figma.com/mcp"
-    },
-    "playwright": {
-      "type": "stdio",
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-playwright"],
-      "enabled": true,
-      "description": "Browser automation and E2E testing with Playwright"
-    },
-    "stitch": {
-      "type": "remote",
-      "url": "https://stitch.googleapis.com/mcp",
-      "headers": {
-        "X-Goog-Api-Key": "${STITCH_API_KEY}"
-      },
-      "description": "Google Stitch AI design generation (requires STITCH_API_KEY)"
-    },
-    "postman": {
-      "type": "remote",
-      "url": "https://mcp.postman.com/mcp",
-      "headers": {
-        "Authorization": "Bearer ${POSTMAN_API_KEY}"
-      },
-      "enabled": true,
-      "description": "Postman API management for collections, requests, and documentation"
-    }
-  },
   "agent": {
     "leader": {
       "description": "IT Leader & Technical Project Manager — analyzes requirements, designs architecture, decomposes tasks, delegates to subagents, and unifies outputs",