opencode-agent-kit 1.0.0 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +374 -404
- package/package.json +39 -3
- package/template/opencode.json +0 -50
package/README.md
CHANGED
|
@@ -1,24 +1,24 @@
|
|
|
1
1
|
<p align="center">
|
|
2
|
-
<img src="assets/banner.png" alt="
|
|
2
|
+
<img src="https://raw.githubusercontent.com/defuj/software-developer-team-agent/main/assets/banner.png" alt="Opencode Agent KIT Banner" width="100%">
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
|
-
#
|
|
5
|
+
# Opencode Agent KIT (Software Developer) — Setup Guide
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
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.
|
|
8
8
|
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
##
|
|
11
|
+
## Quick Install
|
|
12
12
|
|
|
13
|
-
**
|
|
13
|
+
**One command** — installs into any project:
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
16
|
npx opencode-agent-kit init
|
|
17
17
|
```
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
This copies the full agent configuration, skills, commands, and rules into your project.
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
Global install:
|
|
22
22
|
|
|
23
23
|
```bash
|
|
24
24
|
npm install -g opencode-agent-kit
|
|
@@ -28,13 +28,13 @@ opencode-agent-kit init
|
|
|
28
28
|
|
|
29
29
|
---
|
|
30
30
|
|
|
31
|
-
##
|
|
31
|
+
## Overview
|
|
32
32
|
|
|
33
|
-
|
|
33
|
+
This repository contains a complete OpenCode agent configuration with **Leader → Subagent** architecture for software development teams.
|
|
34
34
|
|
|
35
35
|
### Agent Config
|
|
36
36
|
|
|
37
|
-
- **Active config**:
|
|
37
|
+
- **Active config**: `opencode.json` (source of truth)
|
|
38
38
|
- Agent prompts: `.opencode/agents/`
|
|
39
39
|
- `it-leader.md` — IT Leader & Technical Project Manager (primary)
|
|
40
40
|
- `nuxt-frontend-developer.md` — Frontend Developer (Nuxt/Vue) — `@frontend-nuxt`
|
|
@@ -50,67 +50,66 @@ Repo ini berisi konfigurasi OpenCode untuk tim IT lengkap dengan arsitektur **Le
|
|
|
50
50
|
- `android-developer.md` — Android Developer (Kotlin/Compose) — `@android`
|
|
51
51
|
- `flutter-developer.md` — Flutter Developer (Dart) — `@flutter`
|
|
52
52
|
- `nuxt-frontend-developer-mentor.md` — Nuxt mentor (standalone)
|
|
53
|
-
-
|
|
53
|
+
- Internal documentation: `.opencode/agent-docs/`
|
|
54
54
|
- Frontend Nuxt: `.opencode/agent-docs/frontend/nuxt/`
|
|
55
55
|
- Frontend React: `.opencode/agent-docs/frontend/react/`
|
|
56
56
|
- Backend Node: `.opencode/agent-docs/backend/node/`
|
|
57
|
-
-
|
|
57
|
+
- Local skills: `.opencode/skills/` (62 skill playbooks)
|
|
58
58
|
- Contexts: `.opencode/contexts/` (dev, research, review)
|
|
59
59
|
|
|
60
|
-
|
|
60
|
+
Designed for:
|
|
61
61
|
|
|
62
62
|
- **Frontend (Vue)**: Nuxt 4 + Nuxt UI + Vue 3 Composition API + TypeScript
|
|
63
63
|
- **Frontend (React)**: React 19 + Next.js 15 (App Router) + TypeScript + shadcn/ui
|
|
64
|
-
- **Backend**: Node.js + Express 5 + Prisma + PostgreSQL —
|
|
65
|
-
- **Mobile**: Android (Kotlin + Jetpack Compose) —
|
|
66
|
-
-
|
|
67
|
-
-
|
|
64
|
+
- **Backend**: Node.js + Express 5 + Prisma + PostgreSQL — or — Laravel 10+ / CodeIgniter 3
|
|
65
|
+
- **Mobile**: Android (Kotlin + Jetpack Compose) — or — Flutter (Dart)
|
|
66
|
+
- Operational workflow (scope-safe, verification status, commit/PR policy)
|
|
67
|
+
- Structured 30-day mentoring for Nuxt stack transition
|
|
68
68
|
|
|
69
|
-
##
|
|
69
|
+
## Prerequisites
|
|
70
70
|
|
|
71
|
-
- OpenCode CLI
|
|
72
|
-
-
|
|
73
|
-
- Node.js + npm/pnpm/yarn/bun sesuai kebutuhan proyek
|
|
71
|
+
- OpenCode CLI installed
|
|
72
|
+
- Node.js + npm/pnpm/yarn/bun
|
|
74
73
|
|
|
75
|
-
##
|
|
74
|
+
## Integration with Built-in Agents
|
|
76
75
|
|
|
77
|
-
OpenCode
|
|
76
|
+
OpenCode has **built-in agents** available globally. This KIT **does not redefine** existing agents — it focuses on **specialized agents** for each development stack.
|
|
78
77
|
|
|
79
78
|
### Built-in Agents (Global)
|
|
80
79
|
|
|
81
|
-
| Built-in Agent
|
|
82
|
-
|
|
83
|
-
| `planner`
|
|
84
|
-
| `architect`
|
|
85
|
-
| `code-reviewer`
|
|
86
|
-
| `security-reviewer`
|
|
87
|
-
| `tdd-guide`
|
|
88
|
-
| `build-error-resolver` | opus-4.5 | Fix TypeScript/build errors
|
|
89
|
-
| `e2e-runner`
|
|
90
|
-
| `refactor-cleaner`
|
|
91
|
-
| `database-reviewer`
|
|
92
|
-
|
|
93
|
-
### Custom Agents (
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
| Agent
|
|
98
|
-
|
|
99
|
-
| **IT Leader**
|
|
100
|
-
| **Frontend (Vue)**
|
|
101
|
-
| **Frontend (React)**
|
|
102
|
-
| **Backend (Node)**
|
|
103
|
-
| **Backend (Laravel)** | `laravel-advanced.md`
|
|
104
|
-
| **Backend (CI3)**
|
|
105
|
-
| **Designer**
|
|
106
|
-
| **Reviewer**
|
|
107
|
-
| **Database**
|
|
108
|
-
| **DevOps**
|
|
109
|
-
| **SEO**
|
|
110
|
-
| **Android**
|
|
111
|
-
| **Flutter**
|
|
112
|
-
|
|
113
|
-
###
|
|
80
|
+
| Built-in Agent | Model | Role | Usage |
|
|
81
|
+
| ---------------------- | -------- | ------------------------------------------------------ | ---------------------------------------- |
|
|
82
|
+
| `planner` | opus-4.5 | Detailed planning, architectural decisions | `/plan` or `@planner` |
|
|
83
|
+
| `architect` | opus-4.5 | System design, scalability analysis | `@architect` |
|
|
84
|
+
| `code-reviewer` | opus-4.5 | Quality, security, maintainability review | `/code-review` or `@code-reviewer` |
|
|
85
|
+
| `security-reviewer` | opus-4.5 | Vulnerability detection | `/security` or `@security-reviewer` |
|
|
86
|
+
| `tdd-guide` | opus-4.5 | TDD workflow, 80%+ coverage enforcement | `/tdd` or `@tdd-guide` |
|
|
87
|
+
| `build-error-resolver` | opus-4.5 | Fix TypeScript/build errors | `/build-fix` or `@build-error-resolver` |
|
|
88
|
+
| `e2e-runner` | opus-4.5 | Playwright E2E test generation & execution | `/e2e` or `@e2e-runner` |
|
|
89
|
+
| `refactor-cleaner` | opus-4.5 | Dead code removal, consolidation | `/refactor-clean` or `@refactor-cleaner` |
|
|
90
|
+
| `database-reviewer` | opus-4.5 | PostgreSQL query optimization, Supabase best practices | `@database-reviewer` |
|
|
91
|
+
|
|
92
|
+
### Custom Agents (KIT-specific)
|
|
93
|
+
|
|
94
|
+
Specialized agents **not available** in built-in OpenCode:
|
|
95
|
+
|
|
96
|
+
| Agent | File | Role | When to Use |
|
|
97
|
+
| --------------------- | ----------------------------- | ---------------------------------------------- | ---------------------------- |
|
|
98
|
+
| **IT Leader** | `it-leader.md` | Orchestration, task decomposition, integration | All complex requests |
|
|
99
|
+
| **Frontend (Vue)** | `nuxt-frontend-developer.md` | Nuxt/Vue implementation + MCP integration | Vue/Nuxt implementation |
|
|
100
|
+
| **Frontend (React)** | `react-frontend-developer.md` | React/Next.js implementation | React/Next.js implementation |
|
|
101
|
+
| **Backend (Node)** | `node-backend-developer.md` | Node/Express/Prisma implementation | Node.js API implementation |
|
|
102
|
+
| **Backend (Laravel)** | `laravel-advanced.md` | Laravel full-stack (Blade, Livewire, API) | Laravel implementation |
|
|
103
|
+
| **Backend (CI3)** | `code-igniter-3-fullstack.md` | CodeIgniter 3 MVC monolith | CI3 implementation |
|
|
104
|
+
| **Designer** | `ui-ux-designer.md` | Design system, Stitch, Figma, DESIGN.md | Design tasks |
|
|
105
|
+
| **Reviewer** | `code-reviewer.md` | Code quality, security audit, testing | Review tasks |
|
|
106
|
+
| **Database** | `database-specialist.md` | PostgreSQL, schema, Prisma, migrations | Database tasks |
|
|
107
|
+
| **DevOps** | `devops-specialist.md` | CI/CD, Docker, monitoring, infrastructure | Deployment tasks |
|
|
108
|
+
| **SEO** | `seo-specialist.md` | Meta tags, structured data, Core Web Vitals | SEO optimization |
|
|
109
|
+
| **Android** | `android-developer.md` | Kotlin, Jetpack Compose, Gradle, Play Store | Android native development |
|
|
110
|
+
| **Flutter** | `flutter-developer.md` | Dart, Flutter SDK, Material 3, Firebase | Cross-platform mobile |
|
|
111
|
+
|
|
112
|
+
### Workflow
|
|
114
113
|
|
|
115
114
|
```
|
|
116
115
|
User Request
|
|
@@ -148,9 +147,9 @@ User Request
|
|
|
148
147
|
└──────────────────────────────────────────┘
|
|
149
148
|
```
|
|
150
149
|
|
|
151
|
-
###
|
|
150
|
+
### Available Commands
|
|
152
151
|
|
|
153
|
-
|
|
152
|
+
After installing `.opencode/`, the following slash commands are available:
|
|
154
153
|
|
|
155
154
|
```bash
|
|
156
155
|
# Planning & Architecture
|
|
@@ -175,61 +174,57 @@ Setelah copy `.opencode/` ke project, command berikut tersedia:
|
|
|
175
174
|
/update-codemaps # Update code references
|
|
176
175
|
|
|
177
176
|
# Database
|
|
178
|
-
|
|
177
|
+
@database-reviewer # Query optimization
|
|
179
178
|
|
|
180
179
|
# Mobile
|
|
181
180
|
/android-build [variant] # Build Android (debug/release/bundle)
|
|
182
181
|
/android-test [type] # Run Android tests (unit/instrumented)
|
|
183
182
|
/flutter-build [target] # Build Flutter (apk/appbundle/ios/web)
|
|
184
183
|
/flutter-test [type] # Run Flutter tests with coverage
|
|
185
|
-
/gpc-release [track] # Publish to Google Play
|
|
184
|
+
/gpc-release [track] # Publish to Google Play
|
|
186
185
|
```
|
|
187
186
|
|
|
188
|
-
##
|
|
187
|
+
## Using the `.opencode/` Folder
|
|
189
188
|
|
|
190
|
-
###
|
|
191
|
-
|
|
192
|
-
Cara termudah adalah menggunakan npm package:
|
|
189
|
+
### New Project (NPM Package — Recommended)
|
|
193
190
|
|
|
194
191
|
```bash
|
|
195
192
|
cd /path/to/your-project
|
|
196
193
|
npx opencode-agent-kit init
|
|
197
194
|
```
|
|
198
195
|
|
|
199
|
-
|
|
196
|
+
This automatically copies `opencode.json`, `.opencode/`, and `AGENTS.md` with smart merging.
|
|
200
197
|
|
|
201
198
|
### Manual Copy
|
|
202
199
|
|
|
203
|
-
Atau copy langsung dari repo ini:
|
|
204
|
-
|
|
205
200
|
```bash
|
|
206
201
|
cp -R .opencode/ /path/to/your-project/
|
|
207
202
|
```
|
|
208
203
|
|
|
209
|
-
|
|
204
|
+
Or just the config:
|
|
210
205
|
|
|
211
206
|
```bash
|
|
212
207
|
cp .opencode/config.json /path/to/your-project/.opencode/config.json
|
|
213
208
|
```
|
|
214
209
|
|
|
215
|
-
###
|
|
210
|
+
### What Gets Copied
|
|
216
211
|
|
|
217
|
-
| File/Folder
|
|
218
|
-
|
|
219
|
-
| `
|
|
220
|
-
|
|
|
221
|
-
|
|
|
222
|
-
|
|
|
223
|
-
|
|
|
224
|
-
|
|
|
225
|
-
|
|
|
226
|
-
|
|
|
212
|
+
| File/Folder | Content | Required |
|
|
213
|
+
| ------------------------- | ------------------------------- | ----------- |
|
|
214
|
+
| `opencode.json` | Agent definitions, MCP settings | Yes |
|
|
215
|
+
| `.opencode/agents/` | Custom agent prompts | Yes |
|
|
216
|
+
| `.opencode/instructions/` | Global rules for all agents | Yes |
|
|
217
|
+
| `.opencode/skills/` | Domain-specific skills | Recommended |
|
|
218
|
+
| `.opencode/contexts/` | Project context | Optional |
|
|
219
|
+
| `.opencode/commands/` | Custom slash commands | Optional |
|
|
220
|
+
| `.opencode/rules/` | Coding rules | Optional |
|
|
221
|
+
| `.opencode/hooks/` | Automation hooks | Optional |
|
|
227
222
|
|
|
228
|
-
###
|
|
223
|
+
### Integration with Global OpenCode
|
|
229
224
|
|
|
230
|
-
|
|
225
|
+
This project config **does not modify** your global configuration. Just copy `.opencode/` to your project and all agents + commands become available.
|
|
231
226
|
|
|
232
|
-
|
|
227
|
+
To use a global agent instead of the project one, rename the file:
|
|
233
228
|
|
|
234
229
|
```bash
|
|
235
230
|
mv .opencode/agents/code-reviewer.md .opencode/agents/code-reviewer-custom.md
|
|
@@ -237,116 +232,109 @@ mv .opencode/agents/code-reviewer.md .opencode/agents/code-reviewer-custom.md
|
|
|
237
232
|
|
|
238
233
|
### Override Built-in Agents
|
|
239
234
|
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
Contoh override `code-reviewer` untuk fokus Nuxt:
|
|
243
|
-
|
|
244
|
-
```markdown
|
|
245
|
-
# .opencode/agents/code-reviewer.md
|
|
246
|
-
# Override built-in code-reviewer untuk Nuxt-specific review
|
|
247
|
-
```
|
|
235
|
+
To **customize** a built-in agent, create an agent with the **same name** in `.opencode/agents/`. Project-level agents override built-in ones.
|
|
248
236
|
|
|
249
|
-
##
|
|
237
|
+
## Available Agents
|
|
250
238
|
|
|
251
|
-
|
|
239
|
+
13 agents (13 registered in config) with **Leader → Subagent** architecture:
|
|
252
240
|
|
|
253
|
-
| Agent
|
|
254
|
-
|
|
255
|
-
| **IT Leader**
|
|
256
|
-
| Frontend Developer (Vue/Nuxt)
|
|
257
|
-
| Frontend Developer (React/Next) | `react-frontend-developer.md` | subagent
|
|
258
|
-
| Backend Developer (Node.js)
|
|
259
|
-
| Backend Developer (Laravel)
|
|
260
|
-
| CodeIgniter 3 Fullstack
|
|
261
|
-
| UI/UX Designer
|
|
262
|
-
| Code Reviewer / QA
|
|
263
|
-
| Database Specialist
|
|
264
|
-
| DevOps / Infrastructure
|
|
265
|
-
| SEO Specialist
|
|
266
|
-
| Android Developer
|
|
267
|
-
| Flutter Developer
|
|
241
|
+
| Agent | File | Mode | Role |
|
|
242
|
+
| ------------------------------- | ----------------------------- | ----------- | -------------------------------------------------------------------- |
|
|
243
|
+
| **IT Leader** | `it-leader.md` | **primary** | Requirements analysis, architecture, task decomposition, integration |
|
|
244
|
+
| Frontend Developer (Vue/Nuxt) | `nuxt-frontend-developer.md` | subagent | Vue/Nuxt implementation (components, composables, Nuxt UI, E2E) |
|
|
245
|
+
| Frontend Developer (React/Next) | `react-frontend-developer.md` | subagent | React/Next.js implementation (Server Components, shadcn/ui, E2E) |
|
|
246
|
+
| Backend Developer (Node.js) | `node-backend-developer.md` | subagent | Node.js API (Express, Prisma, DTO, auth) |
|
|
247
|
+
| Backend Developer (Laravel) | `laravel-advanced.md` | subagent | Laravel (Blade, Livewire, REST API, Service Layer) |
|
|
248
|
+
| CodeIgniter 3 Fullstack | `code-igniter-3-fullstack.md` | subagent | CI3 MVC, REST API, JWT |
|
|
249
|
+
| UI/UX Designer | `ui-ux-designer.md` | subagent | Design system, Figma, Stitch, accessibility, DESIGN.md |
|
|
250
|
+
| Code Reviewer / QA | `code-reviewer.md` | subagent | Code quality review, security audit, testing strategy, verification |
|
|
251
|
+
| Database Specialist | `database-specialist.md` | subagent | PostgreSQL schema, query optimization, Prisma, migrations |
|
|
252
|
+
| DevOps / Infrastructure | `devops-specialist.md` | subagent | CI/CD, deployment, Docker, monitoring, infrastructure |
|
|
253
|
+
| SEO Specialist | `seo-specialist.md` | subagent | Meta tags, structured data, Core Web Vitals, content optimization |
|
|
254
|
+
| Android Developer | `android-developer.md` | subagent | Kotlin, Jetpack Compose, Material 3, Gradle, Play Store |
|
|
255
|
+
| Flutter Developer | `flutter-developer.md` | subagent | Dart, Flutter SDK, Material 3, Firebase, cross-platform |
|
|
268
256
|
|
|
269
|
-
###
|
|
257
|
+
### How It Works
|
|
270
258
|
|
|
271
|
-
1. User
|
|
272
|
-
2. IT Leader
|
|
273
|
-
3. IT Leader
|
|
274
|
-
4. IT Leader
|
|
259
|
+
1. User gives requirements to the **IT Leader** (primary agent, auto-activated)
|
|
260
|
+
2. IT Leader analyzes, designs architecture, and breaks into tasks
|
|
261
|
+
3. IT Leader delegates tasks to the appropriate subagents
|
|
262
|
+
4. IT Leader integrates results and reports to the user
|
|
275
263
|
|
|
276
|
-
|
|
264
|
+
For small tasks, mention subagents directly:
|
|
277
265
|
|
|
278
266
|
```text
|
|
279
|
-
@frontend-nuxt
|
|
280
|
-
@frontend-react
|
|
281
|
-
@backend Add endpoint POST /api/markets
|
|
282
|
-
@laravel
|
|
283
|
-
@ci3
|
|
284
|
-
@designer Review UX flow
|
|
285
|
-
@reviewer Audit security
|
|
286
|
-
@database
|
|
287
|
-
@devops Setup CI/CD pipeline
|
|
288
|
-
@seo
|
|
289
|
-
@android
|
|
290
|
-
@flutter
|
|
291
|
-
```
|
|
292
|
-
|
|
293
|
-
##
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
| Agent
|
|
298
|
-
|
|
299
|
-
| **IT Leader** | Orchestration,
|
|
300
|
-
| **Frontend**
|
|
301
|
-
| **Backend**
|
|
302
|
-
| **Designer**
|
|
303
|
-
| **Reviewer**
|
|
304
|
-
| **Database**
|
|
305
|
-
| **DevOps**
|
|
306
|
-
| **Android**
|
|
307
|
-
| **Flutter**
|
|
308
|
-
| **SEO**
|
|
309
|
-
|
|
310
|
-
###
|
|
311
|
-
|
|
312
|
-
| Tier
|
|
313
|
-
|
|
314
|
-
| **Tier 1** (Premium)
|
|
315
|
-
| **Tier 2** (Balanced)
|
|
316
|
-
| **Tier 3** (Efficient) | `claude-haiku-4.5`, `gpt-4.1-mini`
|
|
317
|
-
| **Tier 4** (Fast)
|
|
318
|
-
|
|
319
|
-
###
|
|
320
|
-
|
|
321
|
-
1. **
|
|
322
|
-
2. **Per agent** — set `model`
|
|
323
|
-
3. **Quick override** —
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
##
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
###
|
|
332
|
-
|
|
333
|
-
| Agent
|
|
334
|
-
|
|
335
|
-
| IT Leader
|
|
336
|
-
| Frontend Developer (Vue)
|
|
337
|
-
| Frontend Developer (React) | coding-standards, frontend-patterns, frontend-design, web-design-guidelines, vercel-react-best-practices, vercel-composition-patterns, tdd-workflow
|
|
338
|
-
| Backend Developer
|
|
339
|
-
| UI/UX Designer
|
|
340
|
-
| Code Reviewer / QA
|
|
341
|
-
| Database Specialist
|
|
342
|
-
| DevOps / Infrastructure
|
|
343
|
-
| SEO Specialist
|
|
344
|
-
| **Android Developer**
|
|
345
|
-
| **Flutter Developer**
|
|
346
|
-
|
|
347
|
-
###
|
|
348
|
-
|
|
349
|
-
|
|
267
|
+
@frontend-nuxt Add a UButton "Save" in ProfileHeader.vue.
|
|
268
|
+
@frontend-react Create a server component ProductList with API fetch.
|
|
269
|
+
@backend Add endpoint POST /api/markets with DTO validation.
|
|
270
|
+
@laravel Build a CRUD product page with Blade + Livewire.
|
|
271
|
+
@ci3 Build a REST API for products with JWT auth.
|
|
272
|
+
@designer Review UX flow for checkout page and generate DESIGN.md.
|
|
273
|
+
@reviewer Audit security for the authentication module.
|
|
274
|
+
@database Optimize query for market listing with pagination.
|
|
275
|
+
@devops Setup CI/CD pipeline for Vercel deployment.
|
|
276
|
+
@seo Implement meta tags and structured data for product pages.
|
|
277
|
+
@android Build a login screen with Jetpack Compose + ViewModel.
|
|
278
|
+
@flutter Build a product list screen with Bloc pattern.
|
|
279
|
+
```
|
|
280
|
+
|
|
281
|
+
## Recommended Models
|
|
282
|
+
|
|
283
|
+
Each agent can use a different model based on task complexity. Subagents **inherit the model** from the primary agent if not set.
|
|
284
|
+
|
|
285
|
+
| Agent | Role | Recommended Model | Alternative Model | Rationale |
|
|
286
|
+
| ------------- | ------------------------------------------ | ---------------------------- | ---------------------------- | ------------------------------------------------------------- |
|
|
287
|
+
| **IT Leader** | Orchestration, architecture, planning | `opencode/claude-opus-4.7` | `opencode/claude-opus-4.5` | Deep reasoning, complex analysis, multi-subagent coordination |
|
|
288
|
+
| **Frontend** | Component implementation, pages, logic | `opencode/claude-sonnet-4.5` | `opencode/claude-sonnet-4.6` | Balanced reasoning & efficiency for coding |
|
|
289
|
+
| **Backend** | API, DTO, controller, database operations | `opencode/claude-sonnet-4.5` | `opencode/claude-sonnet-4.6` | Balanced reasoning & efficiency for coding |
|
|
290
|
+
| **Designer** | Design system, visual exploration, handoff | `opencode/claude-sonnet-4` | `openai/gpt-5` | Creativity with sufficient reasoning |
|
|
291
|
+
| **Reviewer** | Security audit, detailed code review | `opencode/claude-opus-4.5` | `openai/o3` | Deep analysis, subtle pattern detection |
|
|
292
|
+
| **Database** | Schema design, query optimization | `opencode/claude-sonnet-4.5` | `opencode/claude-sonnet-4` | Moderate reasoning, precision-focused |
|
|
293
|
+
| **DevOps** | CI/CD config, scripts, monitoring | `opencode/claude-haiku-4.5` | `openai/gpt-4.1-mini` | Straightforward tasks, high efficiency |
|
|
294
|
+
| **Android** | Kotlin, Compose, Gradle, Play Store | `opencode/claude-sonnet-4.5` | `opencode/claude-haiku-4.5` | Balanced reasoning & efficiency |
|
|
295
|
+
| **Flutter** | Dart, Flutter SDK, cross-platform | `opencode/claude-sonnet-4.5` | `opencode/claude-haiku-4.5` | Balanced reasoning & efficiency |
|
|
296
|
+
| **SEO** | Research, meta tags, structured data | `openai/gpt-5.1-codex-mini` | `openai/gpt-5-nano` | Research-focused, no deep coding needed |
|
|
297
|
+
|
|
298
|
+
### Model Tiers
|
|
299
|
+
|
|
300
|
+
| Tier | Models | Use Case |
|
|
301
|
+
| ---------------------- | ------------------------------------------ | -------------------------------------------- |
|
|
302
|
+
| **Tier 1** (Premium) | `claude-opus-4.7`, `claude-opus-4.5` | Orchestration, deep analysis, security audit |
|
|
303
|
+
| **Tier 2** (Balanced) | `claude-sonnet-4.5/4.6`, `claude-sonnet-4` | Complex implementation, design, database |
|
|
304
|
+
| **Tier 3** (Efficient) | `claude-haiku-4.5`, `gpt-4.1-mini` | Direct tasks, scripts, config files |
|
|
305
|
+
| **Tier 4** (Fast) | `gpt-5-nano`, `gpt-5.1-codex-mini` | Research, content, cost optimization |
|
|
306
|
+
|
|
307
|
+
### Changing Models
|
|
308
|
+
|
|
309
|
+
1. **All agents** — set `model` at the primary agent (IT Leader) level
|
|
310
|
+
2. **Per agent** — set `model` in each agent's config
|
|
311
|
+
3. **Quick override** — use `--model` flag when running opencode
|
|
312
|
+
|
|
313
|
+
See `.opencode/config.example.json` for a complete per-model configuration example.
|
|
314
|
+
|
|
315
|
+
## Skills
|
|
316
|
+
|
|
317
|
+
Skills are stored in `.opencode/skills/` (local in the repo) — no need to search for them individually.
|
|
318
|
+
|
|
319
|
+
### Skills per Agent
|
|
320
|
+
|
|
321
|
+
| Agent | Key Skills |
|
|
322
|
+
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
323
|
+
| IT Leader | coding-standards, backend-patterns, frontend-patterns |
|
|
324
|
+
| Frontend Developer (Vue) | coding-standards, frontend-patterns, frontend-design, web-design-guidelines, nuxt-ui, tdd-workflow |
|
|
325
|
+
| Frontend Developer (React) | coding-standards, frontend-patterns, frontend-design, web-design-guidelines, vercel-react-best-practices, vercel-composition-patterns, tdd-workflow |
|
|
326
|
+
| Backend Developer | coding-standards, backend-patterns, postgres-patterns, security-review |
|
|
327
|
+
| UI/UX Designer | frontend-design, web-design-guidelines, building-components, nuxt-ui |
|
|
328
|
+
| Code Reviewer / QA | coding-standards, security-review, tdd-workflow, web-design-guidelines |
|
|
329
|
+
| Database Specialist | postgres-patterns, backend-patterns |
|
|
330
|
+
| DevOps / Infrastructure | backend-patterns, coding-standards |
|
|
331
|
+
| SEO Specialist | frontend-patterns, web-design-guidelines, nuxt-ui |
|
|
332
|
+
| **Android Developer** | coding-standards, android-jetpack-compose, edge-to-edge, navigation-3, firebase-basics, play-billing, camera1-to-camerax, r8-analyzer, migrate-xml-views-to-jetpack-compose, gpc-setup, gpc-release-flow, gpc-preflight, gpc-vitals-monitoring |
|
|
333
|
+
| **Flutter Developer** | coding-standards, flutter (patterns), 10 Flutter skills, 9 Dart skills, firebase-basics |
|
|
334
|
+
|
|
335
|
+
### Skills Not Required for Core Stack
|
|
336
|
+
|
|
337
|
+
The following cross-language skills are not needed for the primary Nuxt + Node.js stack:
|
|
350
338
|
|
|
351
339
|
- `springboot-*`, `java-*`, `jpa-patterns`
|
|
352
340
|
- `django-*`
|
|
@@ -354,28 +342,28 @@ Skill backend/lintas bahasa di bawah tidak diperlukan untuk stack utama Nuxt + N
|
|
|
354
342
|
- `python-*`
|
|
355
343
|
- `clickhouse-io`
|
|
356
344
|
|
|
357
|
-
|
|
345
|
+
These can be kept if your team uses multi-stack, but are optional.
|
|
358
346
|
|
|
359
|
-
###
|
|
347
|
+
### Other Skills Available
|
|
360
348
|
|
|
361
|
-
- `configure-ecc` —
|
|
362
|
-
- `continuous-learning` / `continuous-learning-v2` — pattern learning
|
|
363
|
-
- `eval-harness` —
|
|
364
|
-
- `iterative-retrieval` —
|
|
365
|
-
- `strategic-compact` —
|
|
366
|
-
- `verification-loop` — verification cycle
|
|
367
|
-
- `nutrient-document-processing` —
|
|
368
|
-
- `project-guidelines-example` —
|
|
349
|
+
- `configure-ecc` — Everything Claude Code installer
|
|
350
|
+
- `continuous-learning` / `continuous-learning-v2` — Session pattern learning
|
|
351
|
+
- `eval-harness` — Formal evaluation framework
|
|
352
|
+
- `iterative-retrieval` — Context retrieval pattern
|
|
353
|
+
- `strategic-compact` — Manual context compaction
|
|
354
|
+
- `verification-loop` — Agent verification cycle
|
|
355
|
+
- `nutrient-document-processing` — Document processing API
|
|
356
|
+
- `project-guidelines-example` — Project guidelines example
|
|
369
357
|
|
|
370
|
-
##
|
|
358
|
+
## Skill Locations
|
|
371
359
|
|
|
372
|
-
OpenCode
|
|
360
|
+
OpenCode reads skills from:
|
|
373
361
|
|
|
374
362
|
- `~/.opencode/skills/`
|
|
375
363
|
- `~/.agents/skills/`
|
|
376
|
-
- `.opencode/skills/` (
|
|
364
|
+
- `.opencode/skills/` (local in the repo)
|
|
377
365
|
|
|
378
|
-
|
|
366
|
+
Quick verification:
|
|
379
367
|
|
|
380
368
|
```bash
|
|
381
369
|
ls ~/.opencode/skills
|
|
@@ -383,11 +371,9 @@ ls ~/.agents/skills
|
|
|
383
371
|
ls .opencode/skills
|
|
384
372
|
```
|
|
385
373
|
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
## Cara Install Skill dari Folder `.opencode/skills/` Repo
|
|
374
|
+
## Installing Skills from `.opencode/skills/`
|
|
389
375
|
|
|
390
|
-
|
|
376
|
+
If skills are not yet on your machine, copy them from this repo:
|
|
391
377
|
|
|
392
378
|
```bash
|
|
393
379
|
mkdir -p ~/.opencode/skills
|
|
@@ -400,7 +386,7 @@ cp -R ./.opencode/skills/security-review ~/.opencode/skills/
|
|
|
400
386
|
cp -R ./.opencode/skills/tdd-workflow ~/.opencode/skills/
|
|
401
387
|
```
|
|
402
388
|
|
|
403
|
-
|
|
389
|
+
Optional:
|
|
404
390
|
|
|
405
391
|
```bash
|
|
406
392
|
cp -R ./.opencode/skills/building-components ~/.opencode/skills/
|
|
@@ -409,7 +395,7 @@ cp -R ./.opencode/skills/vercel-composition-patterns ~/.opencode/skills/
|
|
|
409
395
|
|
|
410
396
|
### Mobile Skills
|
|
411
397
|
|
|
412
|
-
|
|
398
|
+
For mobile development:
|
|
413
399
|
|
|
414
400
|
```bash
|
|
415
401
|
# Flutter patterns & task skills
|
|
@@ -426,64 +412,56 @@ cp -R ./.opencode/skills/jetpack-compose ~/.opencode/skills/
|
|
|
426
412
|
cp -R ./.opencode/skills/firebase-basics ~/.opencode/skills/
|
|
427
413
|
```
|
|
428
414
|
|
|
429
|
-
## MCP
|
|
415
|
+
## MCP Servers
|
|
430
416
|
|
|
431
|
-
|
|
417
|
+
From `.opencode/config.json`, agents use the following MCP servers:
|
|
432
418
|
|
|
433
|
-
| MCP
|
|
434
|
-
|
|
435
|
-
| `nuxt`
|
|
436
|
-
| `nuxt-ui`
|
|
437
|
-
| `playwright` | stdio
|
|
438
|
-
| `postman`
|
|
439
|
-
| `figma`
|
|
440
|
-
| `stitch`
|
|
419
|
+
| MCP | Type | Status | Description |
|
|
420
|
+
| ------------ | ------ | -------- | ---------------------------------------------------- |
|
|
421
|
+
| `nuxt` | remote | enabled | Nuxt documentation, blog, deployment guide |
|
|
422
|
+
| `nuxt-ui` | remote | enabled | Nuxt UI component docs & examples |
|
|
423
|
+
| `playwright` | stdio | enabled | Browser automation & E2E testing |
|
|
424
|
+
| `postman` | remote | enabled | Postman API management (collections, requests, docs) |
|
|
425
|
+
| `figma` | stdio | disabled | Figma design file access (optional) |
|
|
426
|
+
| `stitch` | remote | disabled | Google Stitch AI design generation (optional) |
|
|
441
427
|
|
|
442
|
-
|
|
428
|
+
To enable Figma MCP:
|
|
443
429
|
|
|
444
430
|
```bash
|
|
445
431
|
export FIGMA_ACCESS_TOKEN="your-token"
|
|
446
432
|
```
|
|
447
433
|
|
|
448
|
-
|
|
434
|
+
To enable Google Stitch MCP:
|
|
449
435
|
|
|
450
436
|
```bash
|
|
451
437
|
# Get API key from https://stitch.withgoogle.com/settings/api-keys
|
|
452
438
|
export STITCH_API_KEY="your-api-key"
|
|
453
439
|
```
|
|
454
440
|
|
|
455
|
-
##
|
|
441
|
+
## Global Config Setup
|
|
456
442
|
|
|
457
|
-
|
|
443
|
+
To make agents, skills, commands, and rules available across all projects, copy to the global OpenCode directory.
|
|
458
444
|
|
|
459
|
-
### macOS & Linux
|
|
445
|
+
### macOS & Linux
|
|
460
446
|
|
|
461
|
-
|
|
447
|
+
Global path: `~/.opencode/`
|
|
462
448
|
|
|
463
449
|
```bash
|
|
464
|
-
# Buat direktori global jika belum ada
|
|
465
450
|
mkdir -p ~/.opencode/skills ~/.opencode/commands ~/.opencode/rules ~/.opencode/contexts
|
|
466
|
-
|
|
467
|
-
|
|
468
|
-
cp -R .opencode/
|
|
469
|
-
cp -R .opencode/
|
|
470
|
-
cp -R .opencode/
|
|
471
|
-
cp -R .opencode/rules/* ~/.opencode/rules/ # Rules
|
|
472
|
-
cp -R .opencode/contexts/* ~/.opencode/contexts/ # Contexts
|
|
451
|
+
cp -R .opencode/config.json ~/.opencode/opencode.json
|
|
452
|
+
cp -R .opencode/skills/* ~/.opencode/skills/
|
|
453
|
+
cp -R .opencode/commands/* ~/.opencode/commands/
|
|
454
|
+
cp -R .opencode/rules/* ~/.opencode/rules/
|
|
455
|
+
cp -R .opencode/contexts/* ~/.opencode/contexts/
|
|
473
456
|
```
|
|
474
457
|
|
|
475
458
|
### Windows (PowerShell)
|
|
476
459
|
|
|
477
|
-
Path global: `$env:USERPROFILE\.opencode\`
|
|
478
|
-
|
|
479
460
|
```powershell
|
|
480
|
-
# Buat direktori global jika belum ada
|
|
481
461
|
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.opencode\skills"
|
|
482
462
|
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.opencode\commands"
|
|
483
463
|
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.opencode\rules"
|
|
484
464
|
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.opencode\contexts"
|
|
485
|
-
|
|
486
|
-
# Copy dari project ke global
|
|
487
465
|
Copy-Item -Recurse .opencode\config.json "$env:USERPROFILE\.opencode\opencode.json"
|
|
488
466
|
Copy-Item -Recurse .opencode\skills\* "$env:USERPROFILE\.opencode\skills\"
|
|
489
467
|
Copy-Item -Recurse .opencode\commands\* "$env:USERPROFILE\.opencode\commands\"
|
|
@@ -491,7 +469,7 @@ Copy-Item -Recurse .opencode\rules\* "$env:USERPROFILE\.opencode\rules\"
|
|
|
491
469
|
Copy-Item -Recurse .opencode\contexts\* "$env:USERPROFILE\.opencode\contexts\"
|
|
492
470
|
```
|
|
493
471
|
|
|
494
|
-
### Windows (
|
|
472
|
+
### Windows (CMD)
|
|
495
473
|
|
|
496
474
|
```cmd
|
|
497
475
|
mkdir "%USERPROFILE%\.opencode\skills"
|
|
@@ -508,40 +486,40 @@ xcopy /E /I /Y .opencode\contexts "%USERPROFILE%\.opencode\contexts\"
|
|
|
508
486
|
### Verify Setup
|
|
509
487
|
|
|
510
488
|
```bash
|
|
511
|
-
opencode doctor
|
|
512
|
-
ls ~/.opencode/
|
|
489
|
+
opencode doctor
|
|
490
|
+
ls ~/.opencode/
|
|
513
491
|
```
|
|
514
492
|
|
|
515
|
-
### Priority
|
|
493
|
+
### Config Priority
|
|
516
494
|
|
|
517
495
|
```
|
|
518
496
|
User Session
|
|
519
497
|
│
|
|
520
498
|
▼
|
|
521
|
-
Project-level config (.opencode/config.json) ←
|
|
499
|
+
Project-level config (.opencode/config.json) ← Highest
|
|
522
500
|
│
|
|
523
501
|
▼
|
|
524
502
|
Global config (~/.opencode/opencode.json)
|
|
525
503
|
│
|
|
526
504
|
▼
|
|
527
|
-
OpenCode defaults ←
|
|
505
|
+
OpenCode defaults ← Lowest
|
|
528
506
|
```
|
|
529
507
|
|
|
530
|
-
Project config
|
|
508
|
+
Project config overrides global, global overrides defaults. Instructions are merged from all levels.
|
|
531
509
|
|
|
532
|
-
##
|
|
510
|
+
## Using Supporting Folders
|
|
533
511
|
|
|
534
512
|
### `.opencode/contexts/`
|
|
535
513
|
|
|
536
|
-
|
|
514
|
+
Reusable project contexts:
|
|
537
515
|
|
|
538
|
-
- `dev.md` —
|
|
539
|
-
- `research.md` —
|
|
540
|
-
- `review.md` —
|
|
516
|
+
- `dev.md` — Development context
|
|
517
|
+
- `research.md` — Research context
|
|
518
|
+
- `review.md` — Code review context
|
|
541
519
|
|
|
542
|
-
|
|
520
|
+
Reference these contexts when prompting to keep agents focused. Update when requirements change.
|
|
543
521
|
|
|
544
|
-
|
|
522
|
+
Install locally for cross-repo reuse:
|
|
545
523
|
|
|
546
524
|
```bash
|
|
547
525
|
mkdir -p ~/.opencode/contexts
|
|
@@ -550,247 +528,239 @@ cp -R ./.opencode/contexts/* ~/.opencode/contexts/
|
|
|
550
528
|
|
|
551
529
|
### `.opencode/commands/`, `.opencode/rules/`, `.opencode/hooks/`
|
|
552
530
|
|
|
553
|
-
|
|
531
|
+
These folders contain:
|
|
554
532
|
|
|
555
|
-
- **`commands/`** —
|
|
556
|
-
- **`rules/`** —
|
|
557
|
-
- **`hooks/`** —
|
|
533
|
+
- **`commands/`** — Ready-to-use prompt commands (team slash commands)
|
|
534
|
+
- **`rules/`** — Operational/coding rules
|
|
535
|
+
- **`hooks/`** — Lifecycle automation (pre-task/post-task, validation)
|
|
558
536
|
|
|
559
|
-
|
|
537
|
+
These are **not** auto-activated. Developers need to copy/sync to their local environment.
|
|
560
538
|
|
|
561
|
-
|
|
539
|
+
Install commands:
|
|
562
540
|
|
|
563
541
|
```bash
|
|
564
542
|
mkdir -p ~/.opencode/commands
|
|
565
543
|
cp -R ./.opencode/commands/* ~/.opencode/commands/
|
|
566
544
|
```
|
|
567
545
|
|
|
568
|
-
|
|
546
|
+
Install rules (follow README in `rules/` — copy per directory, don't flatten).
|
|
569
547
|
|
|
570
|
-
Hooks:
|
|
548
|
+
Hooks: only activate if your local environment supports the dependencies. `hooks/hooks.json` calls scripts via `CLAUDE_PLUGIN_ROOT`.
|
|
571
549
|
|
|
572
|
-
###
|
|
550
|
+
### Recommended Practices
|
|
573
551
|
|
|
574
|
-
-
|
|
575
|
-
-
|
|
576
|
-
-
|
|
577
|
-
-
|
|
552
|
+
- Use `commands/` for routine work
|
|
553
|
+
- Use `rules/` as mandatory standards during implementation and review
|
|
554
|
+
- Use `contexts/` for more precise prompting
|
|
555
|
+
- Treat `hooks/` as team-shared configuration (changes need sync)
|
|
578
556
|
|
|
579
|
-
##
|
|
557
|
+
## Usage
|
|
580
558
|
|
|
581
|
-
### Workflow
|
|
559
|
+
### Main Workflow (via IT Leader)
|
|
582
560
|
|
|
583
|
-
IT Leader
|
|
561
|
+
The IT Leader is the **primary agent** — auto-activated when a session starts. Give it your requirements:
|
|
584
562
|
|
|
585
563
|
```text
|
|
586
|
-
|
|
587
|
-
Backend API
|
|
588
|
-
Setup CI/CD pipeline
|
|
564
|
+
Build a marketplace feature with listing, detail, and create pages.
|
|
565
|
+
Backend API for CRUD markets with pagination and filters.
|
|
566
|
+
Setup CI/CD pipeline and SEO optimization.
|
|
589
567
|
```
|
|
590
568
|
|
|
591
|
-
IT Leader
|
|
592
|
-
|
|
593
|
-
|
|
594
|
-
|
|
595
|
-
|
|
569
|
+
The IT Leader will:
|
|
570
|
+
|
|
571
|
+
1. Analyze requirements and define scope
|
|
572
|
+
2. Design architecture (data flow, API contract, component structure)
|
|
573
|
+
3. Break into tasks and delegate to the right subagents
|
|
574
|
+
4. Integrate results and report status
|
|
596
575
|
|
|
597
|
-
### Direct
|
|
576
|
+
### Direct Subagent Calls (small tasks)
|
|
598
577
|
|
|
599
|
-
|
|
578
|
+
For small tasks, mention subagents directly:
|
|
600
579
|
|
|
601
580
|
```text
|
|
602
|
-
@frontend-nuxt
|
|
603
|
-
Task tiny, minimal diff,
|
|
581
|
+
@frontend-nuxt Add a UButton "Save" in app/components/profile/ProfileHeader.vue.
|
|
582
|
+
Task tiny, minimal diff, don't touch other files.
|
|
604
583
|
```
|
|
605
584
|
|
|
606
585
|
```text
|
|
607
|
-
@frontend-nuxt
|
|
608
|
-
|
|
586
|
+
@frontend-nuxt Implement status filters on the markets page.
|
|
587
|
+
Use the existing useApi pattern and report verification status.
|
|
609
588
|
```
|
|
610
589
|
|
|
611
590
|
```text
|
|
612
|
-
@backend Add endpoint POST /api/markets
|
|
591
|
+
@backend Add endpoint POST /api/markets with DTO validation.
|
|
613
592
|
```
|
|
614
593
|
|
|
615
594
|
```text
|
|
616
|
-
@designer
|
|
595
|
+
@designer Create a design system for the product page with Nuxt UI.
|
|
617
596
|
```
|
|
618
597
|
|
|
619
598
|
```text
|
|
620
|
-
@reviewer Audit security
|
|
599
|
+
@reviewer Audit security for the authentication module.
|
|
621
600
|
```
|
|
622
601
|
|
|
623
602
|
```text
|
|
624
|
-
@database
|
|
603
|
+
@database Optimize query for market listing with pagination.
|
|
625
604
|
```
|
|
626
605
|
|
|
627
606
|
```text
|
|
628
|
-
@devops Setup CI/CD pipeline
|
|
607
|
+
@devops Setup CI/CD pipeline for Vercel deployment.
|
|
629
608
|
```
|
|
630
609
|
|
|
631
610
|
```text
|
|
632
|
-
@seo
|
|
633
|
-
```
|
|
634
|
-
|
|
635
|
-
##
|
|
636
|
-
|
|
637
|
-
|
|
638
|
-
|
|
639
|
-
-
|
|
640
|
-
-
|
|
641
|
-
- status
|
|
642
|
-
-
|
|
643
|
-
|
|
644
|
-
##
|
|
645
|
-
|
|
646
|
-
-
|
|
647
|
-
-
|
|
648
|
-
-
|
|
649
|
-
-
|
|
650
|
-
|
|
651
|
-
|
|
652
|
-
|
|
653
|
-
##
|
|
654
|
-
|
|
655
|
-
|
|
656
|
-
|
|
657
|
-
|
|
|
658
|
-
|
|
659
|
-
| `INDEX.md`
|
|
660
|
-
| `README.md`
|
|
661
|
-
| `QUICK_START.md`
|
|
662
|
-
| `EXAMPLES.md`
|
|
663
|
-
| `API_PATTERNS.md`
|
|
664
|
-
| `WORKFLOWS.md`
|
|
665
|
-
| `CHEATSHEET.md`
|
|
666
|
-
| `MCP_GUIDE.md`
|
|
667
|
-
| `TESTING_GUIDE.md`
|
|
668
|
-
| `TEAM_OPERATING_GUIDE.md` | SOP
|
|
669
|
-
| `SUMMARY.md`
|
|
670
|
-
| `COMPLETION_REPORT.md`
|
|
671
|
-
| `README_AGENTS.md`
|
|
672
|
-
| `README_DOCS.md`
|
|
673
|
-
|
|
674
|
-
###
|
|
675
|
-
|
|
676
|
-
|
|
|
677
|
-
|
|
678
|
-
| `MENTOR_CURRICULUM_30_DAYS.md`
|
|
679
|
-
| `MENTOR_CURRICULUM_CHECKLIST.md` |
|
|
680
|
-
| `MENTOR_WEEKLY_ASSIGNMENTS.md`
|
|
681
|
-
|
|
682
|
-
###
|
|
683
|
-
|
|
684
|
-
|
|
|
685
|
-
|
|
686
|
-
| `backend/README.md`
|
|
687
|
-
| `backend/node/BACKEND_QUICK_START.md` |
|
|
688
|
-
| `backend/node/BACKEND_PATTERNS.md`
|
|
689
|
-
|
|
690
|
-
##
|
|
691
|
-
|
|
692
|
-
-
|
|
693
|
-
-
|
|
694
|
-
-
|
|
695
|
-
-
|
|
696
|
-
-
|
|
697
|
-
-
|
|
698
|
-
-
|
|
699
|
-
-
|
|
700
|
-
-
|
|
701
|
-
-
|
|
702
|
-
-
|
|
703
|
-
-
|
|
704
|
-
-
|
|
705
|
-
-
|
|
706
|
-
-
|
|
707
|
-
-
|
|
708
|
-
-
|
|
709
|
-
-
|
|
611
|
+
@seo Implement meta tags and structured data for product pages.
|
|
612
|
+
```
|
|
613
|
+
|
|
614
|
+
## Agent Output Standards
|
|
615
|
+
|
|
616
|
+
Agents are configured to always report:
|
|
617
|
+
|
|
618
|
+
- Changes made
|
|
619
|
+
- Files touched
|
|
620
|
+
- Verification status: `verified` / `partially_verified` / `not_verified`
|
|
621
|
+
- Manual commands if full verification cannot be run
|
|
622
|
+
|
|
623
|
+
## Operational Policies
|
|
624
|
+
|
|
625
|
+
- No commits unless requested by the user
|
|
626
|
+
- No PRs unless requested by the user
|
|
627
|
+
- No pushes unless requested by the user
|
|
628
|
+
- No touching files outside the request scope
|
|
629
|
+
|
|
630
|
+
Detailed SOP: `.opencode/agent-docs/frontend/nuxt/TEAM_OPERATING_GUIDE.md`
|
|
631
|
+
|
|
632
|
+
## Documentation
|
|
633
|
+
|
|
634
|
+
Agent documentation is available at `.opencode/agent-docs/frontend/nuxt/`:
|
|
635
|
+
|
|
636
|
+
| Document | Content |
|
|
637
|
+
| ------------------------- | ----------------------------- |
|
|
638
|
+
| `INDEX.md` | Full documentation navigation |
|
|
639
|
+
| `README.md` | Complete user guide |
|
|
640
|
+
| `QUICK_START.md` | Start in 5 minutes |
|
|
641
|
+
| `EXAMPLES.md` | 50+ practical examples |
|
|
642
|
+
| `API_PATTERNS.md` | useApi composable guide |
|
|
643
|
+
| `WORKFLOWS.md` | 8 detailed workflows |
|
|
644
|
+
| `CHEATSHEET.md` | Quick reference |
|
|
645
|
+
| `MCP_GUIDE.md` | MCP integration guide |
|
|
646
|
+
| `TESTING_GUIDE.md` | Testing & validation |
|
|
647
|
+
| `TEAM_OPERATING_GUIDE.md` | Team SOP |
|
|
648
|
+
| `SUMMARY.md` | Installation summary |
|
|
649
|
+
| `COMPLETION_REPORT.md` | Completion report |
|
|
650
|
+
| `README_AGENTS.md` | Agent overview |
|
|
651
|
+
| `README_DOCS.md` | Documentation overview |
|
|
652
|
+
|
|
653
|
+
### Mentor Documentation
|
|
654
|
+
|
|
655
|
+
| Document | Content |
|
|
656
|
+
| -------------------------------- | ----------------------- |
|
|
657
|
+
| `MENTOR_CURRICULUM_30_DAYS.md` | 30-day learning roadmap |
|
|
658
|
+
| `MENTOR_CURRICULUM_CHECKLIST.md` | Daily checklist |
|
|
659
|
+
| `MENTOR_WEEKLY_ASSIGNMENTS.md` | Weekly tasks + rubric |
|
|
660
|
+
|
|
661
|
+
### Backend Documentation
|
|
662
|
+
|
|
663
|
+
| Document | Content |
|
|
664
|
+
| ------------------------------------- | ------------------- |
|
|
665
|
+
| `backend/README.md` | Backend overview |
|
|
666
|
+
| `backend/node/BACKEND_QUICK_START.md` | Backend quick start |
|
|
667
|
+
| `backend/node/BACKEND_PATTERNS.md` | Backend patterns |
|
|
668
|
+
|
|
669
|
+
## Quick Reference
|
|
670
|
+
|
|
671
|
+
- Active config: `opencode.json`
|
|
672
|
+
- Example config (per-model): `.opencode/config.example.json`
|
|
673
|
+
- IT Leader prompt (primary): `.opencode/agents/it-leader.md`
|
|
674
|
+
- Frontend (Nuxt) prompt: `.opencode/agents/nuxt-frontend-developer.md`
|
|
675
|
+
- Frontend (React) prompt: `.opencode/agents/react-frontend-developer.md`
|
|
676
|
+
- Backend (Node) prompt: `.opencode/agents/node-backend-developer.md`
|
|
677
|
+
- Backend (Laravel) prompt: `.opencode/agents/laravel-advanced.md`
|
|
678
|
+
- Backend (CI3) prompt: `.opencode/agents/code-igniter-3-fullstack.md`
|
|
679
|
+
- Designer prompt: `.opencode/agents/ui-ux-designer.md`
|
|
680
|
+
- Reviewer prompt: `.opencode/agents/code-reviewer.md`
|
|
681
|
+
- Database prompt: `.opencode/agents/database-specialist.md`
|
|
682
|
+
- DevOps prompt: `.opencode/agents/devops-specialist.md`
|
|
683
|
+
- SEO prompt: `.opencode/agents/seo-specialist.md`
|
|
684
|
+
- Android prompt: `.opencode/agents/android-developer.md`
|
|
685
|
+
- Flutter prompt: `.opencode/agents/flutter-developer.md`
|
|
686
|
+
- Mobile commands: `.opencode/commands/android-build/`, `android-test/`, `flutter-build/`, `flutter-test/`, `gpc-release/`
|
|
687
|
+
- Mobile rules: `.opencode/rules/android/`, `flutter/`, `mobile/`
|
|
688
|
+
- Main docs: `.opencode/agent-docs/frontend/nuxt/README.md`
|
|
710
689
|
- Quick start: `.opencode/agent-docs/frontend/nuxt/QUICK_START.md`
|
|
711
|
-
-
|
|
690
|
+
- Docs index: `.opencode/agent-docs/frontend/nuxt/INDEX.md`
|
|
712
691
|
|
|
713
|
-
## Troubleshooting
|
|
692
|
+
## Troubleshooting
|
|
714
693
|
|
|
715
|
-
### 1)
|
|
694
|
+
### 1) Skills not found
|
|
716
695
|
|
|
717
|
-
**
|
|
696
|
+
**Symptom:** skill name not visible when running `ls ~/.opencode/skills` or `ls ~/.agents/skills`.
|
|
718
697
|
|
|
719
|
-
**
|
|
720
|
-
|
|
721
|
-
1. Pastikan path home benar:
|
|
698
|
+
**Fix:**
|
|
722
699
|
|
|
723
700
|
```bash
|
|
724
701
|
echo $HOME
|
|
725
|
-
```
|
|
726
|
-
|
|
727
|
-
2. Cek direktori skill:
|
|
728
|
-
|
|
729
|
-
```bash
|
|
730
702
|
ls ~/.opencode/skills
|
|
731
703
|
ls ~/.agents/skills
|
|
732
704
|
ls .opencode/skills
|
|
733
705
|
```
|
|
734
706
|
|
|
735
|
-
|
|
707
|
+
If missing, copy skills to one of those directories.
|
|
736
708
|
|
|
737
|
-
### 2) Skill
|
|
709
|
+
### 2) Skill exists but agent doesn't use it
|
|
738
710
|
|
|
739
|
-
**
|
|
711
|
+
**Symptom:** agent doesn't load the expected skill.
|
|
740
712
|
|
|
741
|
-
**
|
|
713
|
+
**Fix:**
|
|
742
714
|
|
|
743
|
-
1.
|
|
715
|
+
1. Call the skill explicitly in the prompt:
|
|
744
716
|
|
|
745
717
|
```text
|
|
746
|
-
@frontend Load skill `nuxt-ui`
|
|
718
|
+
@frontend Load skill `nuxt-ui` then implement this form.
|
|
747
719
|
```
|
|
748
720
|
|
|
749
|
-
2.
|
|
750
|
-
3.
|
|
721
|
+
2. Start a new OpenCode session after updating skills/config.
|
|
722
|
+
3. Ensure the skill name matches the skill folder exactly.
|
|
751
723
|
|
|
752
|
-
### 3)
|
|
724
|
+
### 3) Command permission blocked
|
|
753
725
|
|
|
754
|
-
**
|
|
726
|
+
**Symptom:** agent can't run certain commands (test/build/lint).
|
|
755
727
|
|
|
756
|
-
**
|
|
728
|
+
**Fix:**
|
|
757
729
|
|
|
758
|
-
1.
|
|
759
|
-
2.
|
|
760
|
-
3.
|
|
730
|
+
1. Check policy in `opencode.json` under `agent.<name>.permission`.
|
|
731
|
+
2. Allow required commands (e.g., `pnpm *`, `npm *`, or specific commands).
|
|
732
|
+
3. Re-run the task; the agent will report verification status.
|
|
761
733
|
|
|
762
|
-
### 4) MCP
|
|
734
|
+
### 4) MCP not available
|
|
763
735
|
|
|
764
|
-
**
|
|
736
|
+
**Symptom:** Nuxt/Nuxt UI docs lookup fails.
|
|
765
737
|
|
|
766
|
-
**
|
|
738
|
+
**Fix:**
|
|
767
739
|
|
|
768
|
-
1.
|
|
769
|
-
2.
|
|
770
|
-
3.
|
|
740
|
+
1. Check `mcp` in `opencode.json` — ensure `enabled: true` for `nuxt` and `nuxt-ui`.
|
|
741
|
+
2. Ensure internet connection is active (remote MCP).
|
|
742
|
+
3. For Figma MCP, set the token:
|
|
771
743
|
|
|
772
744
|
```bash
|
|
773
745
|
export FIGMA_ACCESS_TOKEN="your-token"
|
|
774
746
|
```
|
|
775
747
|
|
|
776
|
-
### 5)
|
|
777
|
-
|
|
778
|
-
**Gejala:** perubahan melebar atau penjelasan terlalu panjang.
|
|
748
|
+
### 5) Agent output too verbose
|
|
779
749
|
|
|
780
|
-
**
|
|
750
|
+
**Symptom:** changes spill over or explanations are too long.
|
|
781
751
|
|
|
782
|
-
|
|
752
|
+
**Fix:** Add constraints directly in the prompt:
|
|
783
753
|
|
|
784
754
|
```text
|
|
785
|
-
Task tiny. Minimal diff.
|
|
755
|
+
Task tiny. Minimal diff. Change 1 file only. Brief answer.
|
|
786
756
|
```
|
|
787
757
|
|
|
788
|
-
### 6)
|
|
758
|
+
### 6) Project conventions not followed
|
|
789
759
|
|
|
790
|
-
**
|
|
760
|
+
**Symptom:** style/patterns don't match existing code.
|
|
791
761
|
|
|
792
|
-
**
|
|
762
|
+
**Fix:**
|
|
793
763
|
|
|
794
|
-
1.
|
|
795
|
-
2.
|
|
796
|
-
3.
|
|
764
|
+
1. State conventions explicitly in the prompt (e.g., "use useApi", "don't change naming").
|
|
765
|
+
2. Reference example files to follow.
|
|
766
|
+
3. Ask the agent to revise with a narrow scope on related files.
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "opencode-agent-kit",
|
|
3
|
-
"version": "1.0.
|
|
4
|
-
"description": "Multi-stack OpenCode agent toolkit —
|
|
3
|
+
"version": "1.0.2",
|
|
4
|
+
"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",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"bin": {
|
|
7
7
|
"opencode-agent-kit": "./bin/init.mjs"
|
|
@@ -11,9 +11,45 @@
|
|
|
11
11
|
"template/"
|
|
12
12
|
],
|
|
13
13
|
"license": "MIT",
|
|
14
|
+
"author": {
|
|
15
|
+
"name": "defuj"
|
|
16
|
+
},
|
|
14
17
|
"repository": {
|
|
15
18
|
"type": "git",
|
|
16
|
-
"url": "https://github.com/defuj/
|
|
19
|
+
"url": "git+https://github.com/defuj/software-developer-team-agent.git"
|
|
20
|
+
},
|
|
21
|
+
"homepage": "https://github.com/defuj/software-developer-team-agent#readme",
|
|
22
|
+
"bugs": {
|
|
23
|
+
"url": "https://github.com/defuj/software-developer-team-agent/issues"
|
|
24
|
+
},
|
|
25
|
+
"engines": {
|
|
26
|
+
"node": ">=18"
|
|
27
|
+
},
|
|
28
|
+
"keywords": [
|
|
29
|
+
"opencode",
|
|
30
|
+
"ai-agent",
|
|
31
|
+
"software-development",
|
|
32
|
+
"nuxt",
|
|
33
|
+
"vue",
|
|
34
|
+
"react",
|
|
35
|
+
"nextjs",
|
|
36
|
+
"nodejs",
|
|
37
|
+
"laravel",
|
|
38
|
+
"codeigniter",
|
|
39
|
+
"android",
|
|
40
|
+
"kotlin",
|
|
41
|
+
"flutter",
|
|
42
|
+
"dart",
|
|
43
|
+
"devops",
|
|
44
|
+
"seo",
|
|
45
|
+
"coding-agent",
|
|
46
|
+
"mcp",
|
|
47
|
+
"playwright",
|
|
48
|
+
"postman",
|
|
49
|
+
"multi-stack"
|
|
50
|
+
],
|
|
51
|
+
"publishConfig": {
|
|
52
|
+
"access": "public"
|
|
17
53
|
},
|
|
18
54
|
"dependencies": {
|
|
19
55
|
"commander": "^13.0.0",
|
package/template/opencode.json
CHANGED
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
{
|
|
2
2
|
"$schema": "https://opencode.ai/config.json",
|
|
3
|
-
"formatter": true,
|
|
4
3
|
"permission": {
|
|
5
4
|
"read": {
|
|
6
5
|
"*": "allow",
|
|
@@ -31,55 +30,6 @@
|
|
|
31
30
|
".opencode/skills/security-review/SKILL.md",
|
|
32
31
|
".opencode/skills/frontend-design/SKILL.md"
|
|
33
32
|
],
|
|
34
|
-
"mcp": {
|
|
35
|
-
"nuxt": {
|
|
36
|
-
"type": "remote",
|
|
37
|
-
"url": "https://nuxt.com/mcp",
|
|
38
|
-
"enabled": true,
|
|
39
|
-
"description": "Nuxt documentation, blog posts, and deployment guides"
|
|
40
|
-
},
|
|
41
|
-
"nuxt-ui": {
|
|
42
|
-
"type": "remote",
|
|
43
|
-
"url": "https://ui.nuxt.com/mcp",
|
|
44
|
-
"enabled": true,
|
|
45
|
-
"description": "Nuxt UI component documentation and examples"
|
|
46
|
-
},
|
|
47
|
-
"figma": {
|
|
48
|
-
"type": "stdio",
|
|
49
|
-
"command": "npx",
|
|
50
|
-
"args": ["-y", "@modelcontextprotocol/server-figma"],
|
|
51
|
-
"env": {
|
|
52
|
-
"FIGMA_ACCESS_TOKEN": "${FIGMA_ACCESS_TOKEN}"
|
|
53
|
-
},
|
|
54
|
-
"enabled": false,
|
|
55
|
-
"description": "Figma design file access (requires FIGMA_ACCESS_TOKEN)"
|
|
56
|
-
},
|
|
57
|
-
"playwright": {
|
|
58
|
-
"type": "stdio",
|
|
59
|
-
"command": "npx",
|
|
60
|
-
"args": ["-y", "@modelcontextprotocol/server-playwright"],
|
|
61
|
-
"enabled": true,
|
|
62
|
-
"description": "Browser automation and E2E testing with Playwright"
|
|
63
|
-
},
|
|
64
|
-
"stitch": {
|
|
65
|
-
"type": "remote",
|
|
66
|
-
"url": "https://stitch.googleapis.com/mcp",
|
|
67
|
-
"headers": {
|
|
68
|
-
"X-Goog-Api-Key": "${STITCH_API_KEY}"
|
|
69
|
-
},
|
|
70
|
-
"enabled": false,
|
|
71
|
-
"description": "Google Stitch AI design generation (requires STITCH_API_KEY)"
|
|
72
|
-
},
|
|
73
|
-
"postman": {
|
|
74
|
-
"type": "remote",
|
|
75
|
-
"url": "https://mcp.postman.com/mcp",
|
|
76
|
-
"headers": {
|
|
77
|
-
"Authorization": "Bearer ${POSTMAN_API_KEY}"
|
|
78
|
-
},
|
|
79
|
-
"enabled": true,
|
|
80
|
-
"description": "Postman API management for collections, requests, and documentation"
|
|
81
|
-
}
|
|
82
|
-
},
|
|
83
33
|
"agent": {
|
|
84
34
|
"leader": {
|
|
85
35
|
"description": "IT Leader & Technical Project Manager — analyzes requirements, designs architecture, decomposes tasks, delegates to subagents, and unifies outputs",
|