create-vasvibe 1.0.2 → 1.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-vasvibe",
-  "version": "1.0.2",
+  "version": "1.2.0",
   "description": "Scaffold a new project with VasVibe agents, prompts, and workflows preconfigured (Claude, OpenCode, GitHub Copilot).",
   "type": "module",
   "bin": {

package/src/index.mjs

@@ -7,6 +7,7 @@ import { runPrompts } from './prompts.mjs';
 import { scaffold } from './scaffold.mjs';
 import { initRepo } from './git.mjs';
 import { log, pathExists, isDirEmpty, isValidProjectName } from './utils.mjs';
+import { isVasvibeProject, runUpgrade } from './upgrade.mjs';
 import pc from 'picocolors';
 
 const HELP = `
@@ -14,29 +15,33 @@ ${pc.bold('create-vasvibe')} — scaffold a project with VasVibe agents preconfi
 
 ${pc.bold('Usage:')}
   npx create-vasvibe <project-name> [options]
+  npx create-vasvibe upgrade [path]         Upgrade agent files in an existing project
 
 ${pc.bold('Options:')}
   -y, --yes          Skip prompts and use defaults
-  -u, --update       Update an existing project (overwrites template files, keeps user files)
       --no-git       Do not initialize a git repository
       --no-opencode  Exclude .opencode/ (commands, skills)
       --no-claude    Exclude .claude/ and .agents/
       --no-github    Exclude .github/prompts/
       --no-workflows Exclude agent/workflows/
+      --depth=<level> Set default work depth: fast | standard | deep (default: standard)
+      --dry-run      (upgrade only) Show what would change without writing files
   -h, --help         Show this help
   -v, --version      Print version
 
 ${pc.bold('Examples:')}
   npx create-vasvibe my-app
-  npx create-vasvibe my-app --yes
   npx create-vasvibe my-app --yes --no-claude --no-github
+  npx create-vasvibe my-app --depth=fast  Scaffold with fast work depth (prototype mode)
+  npx create-vasvibe upgrade              Upgrade current directory
+  npx create-vasvibe upgrade ./my-app     Upgrade specific project
+  npx create-vasvibe upgrade --dry-run    Preview upgrade without writing
 `;
 
 function parseArgs(argv) {
   const args = argv.slice(2);
   const flags = {
     yes: false,
-    update: false,
     git: true,
     opencode: true,
     claude: true,
@@ -44,6 +49,8 @@ function parseArgs(argv) {
     workflows: true,
     help: false,
     version: false,
+    dryRun: false,
+    depth: null,
   };
   const positional = [];
 
@@ -53,9 +60,8 @@ function parseArgs(argv) {
       case '--yes':
         flags.yes = true;
         break;
-      case '-u':
-      case '--update':
-        flags.update = true;
+      case '--dry-run':
+        flags.dryRun = true;
         break;
       case '--no-git':
         flags.git = false;
@@ -81,6 +87,15 @@ function parseArgs(argv) {
         flags.version = true;
         break;
       default:
+        if (a.startsWith('--depth=')) {
+          const val = a.slice('--depth='.length);
+          if (!['fast', 'standard', 'deep'].includes(val)) {
+            log.error(`Invalid depth value "${val}". Use: fast | standard | deep`);
+            process.exit(1);
+          }
+          flags.depth = val;
+          break;
+        }
         if (a.startsWith('-')) {
           log.error(`Unknown flag: ${a}`);
           console.log(HELP);
@@ -112,6 +127,30 @@ export async function main(argv) {
     return;
   }
 
+  // --- Upgrade subcommand ---
+  if (positional[0] === 'upgrade') {
+    const pkg = await readPkg();
+    const targetDir = positional[1]
+      ? path.resolve(process.cwd(), positional[1])
+      : process.cwd();
+
+    if (!(await isVasvibeProject(targetDir))) {
+      log.error(`No vasvibe project found at ${targetDir}`);
+      log.step('Run this command from inside a vasvibe project directory.');
+      process.exit(1);
+    }
+
+    log.title('\n  create-vasvibe upgrade\n');
+    try {
+      await runUpgrade({ targetDir, newVersion: pkg.version, dryRun: flags.dryRun });
+    } catch (err) {
+      log.error(`Upgrade failed: ${err.message}`);
+      process.exit(1);
+    }
+    return;
+  }
+
+  // --- Scaffold subcommand (default) ---
   const argInput = positional[0];
   // The arg may be a path (e.g. /tmp/foo or ./foo); use its basename as the
   // logical project name, and resolve the full path as the target directory.
@@ -131,14 +170,17 @@ export async function main(argv) {
     ? path.resolve(process.cwd(), argInput)
     : path.resolve(process.cwd(), projectName);
 
-  // Safety: target must not exist or must be empty, unless --update is passed.
-  if (!flags.update && await pathExists(targetDir)) {
+  // Safety: target must not exist or must be empty.
+  if (await pathExists(targetDir)) {
     if (!(await isDirEmpty(targetDir))) {
-      log.error(`Target directory "${projectName}" already exists and is not empty. Use --update to overwrite agent files.`);
+      log.error(`Target directory "${projectName}" already exists and is not empty.`);
+      log.step(`To update agent files in an existing project, use: ${pc.cyan('npx create-vasvibe upgrade')}`);
       process.exit(1);
     }
   }
 
+  const pkg = await readPkg();
+
   log.blank();
   log.step(`Scaffolding into ${pc.cyan(targetDir)}`);
 
@@ -146,6 +188,8 @@ export async function main(argv) {
     await scaffold({
       targetDir,
       projectName,
+      version: pkg.version,
+      workDepth: answers.workDepth,
       includeOpencode: answers.includeOpencode,
       includeClaude: answers.includeClaude,
       includeGithub: answers.includeGithub,

package/src/prompts.mjs

@@ -13,6 +13,7 @@ export async function runPrompts({ argName, flags }) {
       includeGithub: flags.github !== false,
       includeWorkflows: flags.workflows !== false,
       initGit: flags.git !== false,
+      workDepth: flags.depth || 'standard',
     };
   }
 
@@ -72,6 +73,30 @@ export async function runPrompts({ argName, flags }) {
         active: 'yes',
         inactive: 'no',
       },
+      {
+        type: flags.depth ? null : 'select',
+        name: 'workDepth',
+        message: 'Default work depth for all agents?',
+        hint: 'Can be changed anytime in project_overview.md → ## 7. Project Settings',
+        choices: [
+          {
+            title: 'standard (recommended)',
+            description: 'Full spec, unit tests, code review — the default for everyday production development.',
+            value: 'standard',
+          },
+          {
+            title: 'fast',
+            description: 'Core feature only, skip optional steps (unit tests, full docs, edge cases) — good for prototypes and MVPs.',
+            value: 'fast',
+          },
+          {
+            title: 'deep',
+            description: 'Maximum thoroughness — full security review, all edge cases, strict validation — for critical systems.',
+            value: 'deep',
+          },
+        ],
+        initial: 0,
+      },
     ],
     { onCancel },
   );
@@ -83,5 +108,6 @@ export async function runPrompts({ argName, flags }) {
     includeGithub: flags.github === false ? false : answers.includeGithub ?? true,
     includeWorkflows: flags.workflows === false ? false : answers.includeWorkflows ?? true,
     initGit: flags.git === false ? false : answers.initGit ?? true,
+    workDepth: flags.depth || answers.workDepth || 'standard',
   };
 }

package/src/scaffold.mjs

@@ -6,6 +6,7 @@ import { promises as fs } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { copyDir, removePath, replaceInFile, pathExists } from './utils.mjs';
+import { writeVersionFile } from './upgrade.mjs';
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 // packages/create-vasvibe/src → packages/create-vasvibe/template
@@ -21,6 +22,8 @@ const TOOLCHAIN_PATHS = {
 export async function scaffold({
   targetDir,
   projectName,
+  version,
+  workDepth = 'standard',
   includeOpencode,
   includeClaude,
   includeGithub,
@@ -52,11 +55,16 @@ export async function scaffold({
 
   // 4. Replace placeholders in well-known files.
   const year = String(new Date().getFullYear());
-  const replacements = { projectName, year };
-  for (const rel of ['README.md', 'PROJECT_README.example.md', '.gitignore', 'AGENT_PERSONAS.md', 'GIT_STRUCTURE_GUIDE.md']) {
+  const replacements = { projectName, year, workDepth };
+  for (const rel of ['README.md', 'PROJECT_README.example.md', '.gitignore', 'AGENT_PERSONAS.md', 'GIT_STRUCTURE_GUIDE.md', 'project_overview_example.md']) {
     const f = path.join(targetDir, rel);
     if (await pathExists(f)) await replaceInFile(f, replacements);
   }
+
+  // 5. Write version tracking file.
+  if (version) {
+    await writeVersionFile(targetDir, version);
+  }
 }
 
 async function removeAll(targetDir, relPaths) {

package/src/upgrade.mjs

@@ -0,0 +1,121 @@
+// src/upgrade.mjs
+// Upgrade an existing vasvibe project: re-copy framework files (agents, schemas,
+// workflows) without touching user-generated content (codes/, specifications/,
+// task/, state/, project_overview.md, etc.).
+
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { copyDir, pathExists, log } from './utils.mjs';
+import pc from 'picocolors';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const TEMPLATE_DIR = path.resolve(__dirname, '..', 'template');
+const VERSION_FILE = '.vasvibe-version';
+
+// Only these paths are safe to overwrite on upgrade.
+// User content (codes/, specifications/, task/, state/, project_overview.md) is never touched.
+const FRAMEWORK_PATHS = [
+  { src: '.opencode', dest: '.opencode' },
+  { src: '.claude', dest: '.claude' },
+  { src: '.agents', dest: '.agents' },
+  { src: '.github/prompts', dest: '.github/prompts' },
+  { src: 'agent', dest: 'agent' },
+  { src: 'schemas', dest: 'schemas' },
+];
+
+export async function readVersionFile(projectDir) {
+  const versionPath = path.join(projectDir, VERSION_FILE);
+  try {
+    const content = await fs.readFile(versionPath, 'utf8');
+    return content.trim();
+  } catch {
+    return null;
+  }
+}
+
+export async function writeVersionFile(projectDir, version) {
+  await fs.writeFile(path.join(projectDir, VERSION_FILE), version + '\n', 'utf8');
+}
+
+export async function isVasvibeProject(projectDir) {
+  // A vasvibe project has either .vasvibe-version or at least one agent directory.
+  if (await pathExists(path.join(projectDir, VERSION_FILE))) return true;
+  if (await pathExists(path.join(projectDir, 'agent/workflows'))) return true;
+  if (await pathExists(path.join(projectDir, '.opencode/agents'))) return true;
+  return false;
+}
+
+export async function upgrade({ targetDir, currentVersion, newVersion, dryRun = false }) {
+  if (!(await pathExists(TEMPLATE_DIR))) {
+    throw new Error(`Template directory not found at ${TEMPLATE_DIR}.`);
+  }
+
+  const updated = [];
+  const skipped = [];
+
+  for (const { src, dest } of FRAMEWORK_PATHS) {
+    const srcPath = path.join(TEMPLATE_DIR, src);
+    const destPath = path.join(targetDir, dest);
+
+    if (!(await pathExists(srcPath))) {
+      skipped.push(src);
+      continue;
+    }
+    // Only update if the destination already exists in the project
+    // (respect the user's original toolchain choices).
+    if (!(await pathExists(destPath))) {
+      skipped.push(dest + ' (not in project)');
+      continue;
+    }
+
+    if (!dryRun) {
+      await copyDir(srcPath, destPath);
+    }
+    updated.push(dest);
+  }
+
+  if (!dryRun) {
+    await writeVersionFile(targetDir, newVersion);
+  }
+
+  return { updated, skipped };
+}
+
+export async function runUpgrade({ targetDir, newVersion, dryRun }) {
+  const currentVersion = await readVersionFile(targetDir);
+
+  log.blank();
+  if (currentVersion) {
+    log.info(`Current version: ${pc.yellow(currentVersion)}`);
+  } else {
+    log.warn('No .vasvibe-version file found — project may have been created before version tracking was added.');
+  }
+  log.info(`Upgrading to:    ${pc.green(newVersion)}`);
+  log.blank();
+
+  if (dryRun) {
+    log.step('Dry run — no files will be changed.');
+    log.blank();
+  }
+
+  const { updated, skipped } = await upgrade({ targetDir, currentVersion, newVersion, dryRun });
+
+  for (const p of updated) {
+    log.success(`Updated: ${pc.cyan(p)}`);
+  }
+  for (const p of skipped) {
+    log.step(`Skipped: ${pc.dim(p)}`);
+  }
+
+  log.blank();
+  if (dryRun) {
+    log.info('Run without --dry-run to apply the upgrade.');
+  } else {
+    log.success(`Upgraded to ${pc.green(newVersion)}`);
+    log.blank();
+    log.step('Review the changes with ' + pc.cyan('git diff') + ' before committing.');
+    log.step('Your codes/, specifications/, task/, and state/ directories were not touched.');
+  }
+  log.blank();
+}

package/template/.agents/skills/developer/SKILL.md

@@ -41,9 +41,8 @@ memory: project
 
 3.  **Update Task Status - START (CRITICAL):**
     - Cari task yang sesuai dengan spesifikasi yang akan dikerjakan di `task/task_list.md`.
-    - **UPDATE status task** dari `not_started` menjadi `development`.
-    - Update field **"Last Updated"** dengan timestamp saat ini [YYYY-MM-DD HH:MM].
-    - Update field **"Assigned To"** dengan "Developer Agent".
+    - Tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: `- Development: [YYYY-MM-DD HH:MM] (Developer Agent)`.
+    - **UPDATE Current Status** menjadi `development`.
 4.  **Directory Check:** Cek apakah folder `codes/` ada. Jika tidak, **BUAT FOLDERNYA**.
 5.  **Action (Coding):**
     - Sebelum memulai coding, pastikan Anda memahami seluruh spesifikasi dengan baik.
@@ -84,9 +83,8 @@ memory: project
 
 7.  **Update Task Status - COMPLETE (CRITICAL):**
     - Setelah development selesai dan log sudah dibuat, kembali ke `task/task_list.md`.
-    - **UPDATE status task** dari `development` menjadi `ready_to_test`.
-    - Update field **"Last Updated"** dengan timestamp saat ini [YYYY-MM-DD HH:MM].
-    - Tambahkan notes di field **"Notes"** jika ada informasi penting (misal: "Butuh environment variable X").
+    - Tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: `- Ready to Test: [YYYY-MM-DD HH:MM] (Developer Agent)`.
+    - **UPDATE Current Status** menjadi `ready_to_test`.
 
 **INPUT SAYA:**
 "Tolong implementasikan spesifikasi berikut: [NAMA FILE SPEC]"

package/template/.agents/skills/pm/SKILL.md

@@ -36,7 +36,7 @@ description: Brief description of what this Skill does and when to use it
      - **P3 (Low):** Fitur enhancement atau nice-to-have.
 
 4. **TASK LIST STRUCTURE:**
-   File `task/task_list.md` harus mengikuti format berikut:
+   File `task/task_list.md` harus mengikuti format list dengan status log berbaris ke bawah berikut:
 
    ```markdown
    # TASK LIST - [Nama Project]
@@ -48,69 +48,39 @@ description: Brief description of what this Skill does and when to use it
 
    ## Priority 0 (Critical)
 
-   ### [TASK-000] Environment Setup
-   - **Spec:** `specifications/000_spec_environment_setup.md`
-   - **Status:** `not_started`
-   - **Assigned To:** Developer Agent
-   - **Dependencies:** None
-   - **Description:** Setup development environment dengan Docker containers
-   - **Last Updated:** [YYYY-MM-DD HH:MM]
-   - **Notes:** -
-
-   ---
+   - Task 000: Environment Setup
+     - Spesifikasi: [spec] ../specifications/000_spec_environment_setup.md
+     - Current Status: not_started
+     - Status Logs: 
+        - Task Created: [YYYY-MM-DD HH:MM] (PM Agent)
 
    ## Priority 1 (High)
 
-   ### [TASK-001] User Authentication - Login
-   - **Spec:** `specifications/001_spec_login.md`
-   - **Status:** `not_started`
-   - **Assigned To:** Developer Agent
-   - **Dependencies:** TASK-000
-   - **Description:** Implementasi fitur login user
-   - **Last Updated:** [YYYY-MM-DD HH:MM]
-   - **Notes:** -
-
-   ---
+   - Task 001: [Nama Task]
+     - Spesifikasi: [spec] ../specifications/001_spec_....md
+     - Current Status: not_started
+     - Status Logs: 
+        - Task Created: [YYYY-MM-DD HH:MM] (PM Agent)
 
    ## Priority 2 (Medium)
 
-   ### [TASK-XXX] [Nama Task]
-   - **Spec:** `specifications/XXX_spec_...md`
-   - **Status:** `not_started`
-   - **Assigned To:** -
-   - **Dependencies:** TASK-XXX
-   - **Description:** [Deskripsi singkat]
-   - **Last Updated:** [YYYY-MM-DD HH:MM]
-   - **Notes:** -
-
-   ---
+   - Task XXX: [Nama Task]
+     - Spesifikasi: [spec] ../specifications/XXX_spec_....md
+     - Current Status: not_started
+     - Status Logs: 
+        - Task Created: [YYYY-MM-DD HH:MM] (PM Agent)
 
-   ## Blocked Tasks
+   ## Priority 3 (Low)
 
-   ### [TASK-XXX] [Nama Task]
-   - **Spec:** `specifications/XXX_spec_...md`
-   - **Status:** `blocked`
-   - **Assigned To:** -
-   - **Dependencies:** TASK-XXX
-   - **Blocker Reason:** [Alasan kenapa task ini blocked]
-   - **Description:** [Deskripsi singkat]
-   - **Last Updated:** [YYYY-MM-DD HH:MM]
-   - **Notes:** -
-
-   ---
-
-   ## Completed Tasks
-
-   ### [TASK-XXX] [Nama Task]
-   - **Spec:** `specifications/XXX_spec_...md`
-   - **Status:** `done`
-   - **Assigned To:** Developer Agent
-   - **Dependencies:** TASK-XXX
-   - **Description:** [Deskripsi singkat]
-   - **Completed Date:** [YYYY-MM-DD HH:MM]
-   - **Notes:** Validated by [Nama]
+   - Task XXX: [Nama Task]
+     - Spesifikasi: [spec] ../specifications/XXX_spec_....md
+     - Current Status: not_started
+     - Status Logs: 
+        - Task Created: [YYYY-MM-DD HH:MM] (PM Agent)
    ```
 
+   **Aturan status logs:** Saat task baru dibuat, PM Agent hanya menuliskan baris "Task Created". Agent lain (Analyst, Developer, Tester, Fixer) akan menambahkan baris log mereka sendiri di bawahnya secara dinamis saat mereka mengambil atau menyelesaikan pekerjaan. Update `Current Status` sesuai tahap saat ini.
+
 5. **STATUS DEFINITIONS:**
    Pastikan setiap task memiliki salah satu status berikut:
    - `not_started`: Task belum dikerjakan sama sekali

package/template/.claude/agents/analyst.md

@@ -1,5 +1,10 @@
-**ACT AS:** Lead System Analyst & DevOps Architect.
-**CONTEXT:** Mendefinisikan spesifikasi teknis dan infrastruktur proyek.
+---
+name: analyst
+description: Lead System Analyst — creates technical specifications, user stories, API contracts, and feature spec files in specifications/. Invoke when a new feature needs to be defined before development starts.
+---
+
+**ACT AS:** Lead System Analyst.
+**CONTEXT:** Mendefinisikan spesifikasi teknis fitur dan infrastruktur proyek. Untuk kebutuhan server sizing dan deployment architecture, koordinasikan dengan SysArch Agent.
 
 **INSTRUCTION STEPS:**
 1.  **Read Context:** Baca `project_overview.md`.
@@ -56,5 +61,14 @@
 
 **INPUT SAYA:**
 "[INPUT USER DISINI]"
+## Work Depth
+> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
+
+| Level | Behavior |
+|-------|----------|
+| **fast** | User stories + AC minimal, skip edge cases dan full API contract |
+| **standard** | Spec lengkap — semua section template diisi |
+| **deep** | + Threat modeling notes, semua API contract lengkap, validasi cross-spec consistency |
+
 ## State Management
 > 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/.claude/agents/developer.md

@@ -1,3 +1,8 @@
+---
+name: developer
+description: Senior Fullstack Developer — implements features, writes source code in codes/, and creates unit tests based on approved spec files. Invoke when a specification is approved and ready to be coded.
+---
+
 **ACT AS:** Senior Fullstack Developer.
 **CONTEXT:** Mengimplementasikan fitur berdasarkan spesifikasi.
 
@@ -8,7 +13,7 @@
     - Baca file spesifikasi target (misal: `specifications/001_...md`).
 
 2.  **Update Task Status - START (CRITICAL):**
-    - Di `task/task_list.md`, update checklist baris task yang sesuai: tandai kolom `development` dengan `☑`.
+    - Di `task/task_list.md`, tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Development: [YYYY-MM-DD HH:MM] (Developer Agent)'. Update juga 'Current Status'.
     - Di file detail task `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md`, **APPEND** entry baru ke Status Log:
       ```
       | [YYYY-MM-DD HH:MM] | dev agent | development started | - |
@@ -24,7 +29,7 @@
     - Pastikan spesifikasi yang akan diimplementasikan sudah disetujui oleh human Analyst. Jika belum, hentikan pekerjaanmu dan minta klarifikasi.
     - Tulis source code yang sesuai dengan Tech Stack di `project_overview.md`.
     - Simpan file source code di dalam folder `codes/`.
-    - Perhatikan detail UI/UX jika ada instruksi visual. **CRITICAL:** Wajib gunakan skill `ui-ux-pro-max` dan `modern-web-guidance` untuk menghasilkan UI/UX kelas premium, modern, animasi halus, dan mengikuti best-practice terbaru web API. Gunakan command atau tools yang tersedia untuk mengaktifkan skill tersebut.
+    - Perhatikan detail UI/UX jika ada instruksi visual. **CRITICAL:** Wajib gunakan skill `ui-ux-pro-max` untuk menghasilkan UI/UX kelas premium, modern, animasi halus, dan mengikuti best-practice terbaru web API. Gunakan command atau tools yang tersedia untuk mengaktifkan skill tersebut.
     - Perhatikan apakah setiap spesifikasi terdiri dari frontend dan backend atau salah satu saja.
     - **SECURITY (CRITICAL):** DILARANG KERAS men-hardcode credentials (API keys, secrets, passwords) di source code. Semua harus via environment variables (`.env`). Pastikan key baru didaftarkan di `.env.example`.
     - Lakukan *Self-Reflection*: "Apakah kode ini aman? Apakah efisien?"
@@ -60,7 +65,7 @@
     - Jika file `dev_log.md` sudah ada (misalnya dari sesi sebelumnya), **APPEND** section baru ke bagian Revision History.
 
 6.  **Update Task Status - COMPLETE (CRITICAL):**
-    - Di `task/task_list.md`, update checklist baris task yang sesuai: tandai kolom `ready_to_test` dengan `☑`.
+    - Di `task/task_list.md`, tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Ready to Test: [YYYY-MM-DD HH:MM] (Developer Agent)'. Update juga 'Current Status'.
     - Di file detail task `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md`, **APPEND** entry baru ke Status Log:
       ```
       | [YYYY-MM-DD HH:MM] | dev agent | ready to test | [catatan penting jika ada] |
@@ -68,5 +73,14 @@
 
 **INPUT SAYA:**
 "Tolong implementasikan spesifikasi berikut: [NAMA FILE SPEC]"
+## Work Depth
+> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
+
+| Level | Behavior |
+|-------|----------|
+| **fast** | Implementasi core feature, skip unit tests, minimal error handling |
+| **standard** | Implementasi + unit tests + self-reflection security |
+| **deep** | + Full test coverage, strict input validation, security hardening di setiap layer |
+
 ## State Management
 > 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/.claude/agents/devops.md

@@ -1,3 +1,8 @@
+---
+name: devops
+description: DevOps Engineer — creates Dockerfiles, docker-compose configs, CI/CD pipeline files, and manages deployment infrastructure. Invoke for environment setup, containerization, or CI/CD tasks.
+---
+
 **ACT AS:** Senior DevOps & Platform Engineer.
 **CONTEXT:** Mengotomasi deployment, membuat CI/CD pipelines, dan mengonfigurasi infrastruktur (Docker, GitHub Actions, dll) untuk product code (`codes/`).
 
@@ -25,5 +30,14 @@
 4. **Update Task Status:**
    - Beritahu Orchestrator/PM/Human bahwa setup DevOps telah selesai.
 
+## Work Depth
+> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
+
+| Level | Behavior |
+|-------|----------|
+| **fast** | Dockerfile basic + docker-compose minimal |
+| **standard** | Full CI/CD pipeline sesuai template |
+| **deep** | + Multi-stage builds, security scanning di pipeline, rollback strategy, monitoring config |
+
 ## State Management
 > 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/.claude/agents/document.md

@@ -1,3 +1,8 @@
+---
+name: document
+description: Technical Writer — generates and updates project FSD documentation, API documentation, and CHANGELOG. Invoke after features are completed and ready to be documented.
+---
+
 **ACT AS:** Senior Technical Writer.
 **CONTEXT:** Membuat Functional Specification Document (FSD) dan dokumentasi proyek yang lengkap berdasarkan spesifikasi dan log development.
 
@@ -31,9 +36,18 @@
    - **5. Glossary:** Daftar istilah teknis proyek.
 
 5. **Update Task Status (CRITICAL):**
-   - Setelah selesai, update status document task di `task/task_list.md` menjadi `done`.
+   - Setelah selesai, update status document task di `task/task_list.md` menjadi `done`, dan tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Done: [YYYY-MM-DD HH:MM] (Document Agent)'.
 
 **INPUT SAYA:**
 "Tolong hasilkan Project FSD dan dokumentasi API yang lengkap sekarang."
+## Work Depth
+> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
+
+| Level | Behavior |
+|-------|----------|
+| **fast** | Skip dokumentasi, cukup update task status |
+| **standard** | Update API docs dan FSD sesuai spesifikasi |
+| **deep** | + Deployment guide, troubleshooting section, diagram arsitektur |
+
 ## State Management
 > 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`

package/template/.claude/agents/fixer.md

@@ -1,3 +1,8 @@
+---
+name: fixer
+description: Bug Fixer — analyzes root causes of bugs and implements fixes. Invoke when a bug, test failure, or error has been identified and needs to be resolved.
+---
+
 **ACT AS:** Maintenance & Reliability Engineer.
 **CONTEXT:** Tugas Anda adalah memperbaiki bug, refactoring, atau melakukan penyesuaian pada kode yang sudah ada.
 
@@ -16,7 +21,7 @@
     - Temukan file detail task di `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md` yang sesuai.
 
 2.  **Update Task Status - START (CRITICAL):**
-    - Di `task/task_list.md`, update checklist baris task yang sesuai: tandai kolom `fixing` dengan `☑`.
+    - Di `task/task_list.md`, tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Fixing Issues: [YYYY-MM-DD HH:MM] (Fixer Agent)'. Update juga 'Current Status'.
     - Di file detail task `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md`, **APPEND** entry baru ke Status Log:
       ```
       | [YYYY-MM-DD HH:MM] | fixer agent | fixing started | Issues: [ringkasan issue] |
@@ -58,7 +63,7 @@
     - Jika `fixing_log.md` sudah ada, **APPEND** "Fix Entry" baru di bawah entry sebelumnya.
 
 5.  **Update Task Status - COMPLETE (CRITICAL):**
-    - Di `task/task_list.md`, update checklist baris task yang sesuai: tandai kolom `ready_to_test` dengan `☑`, hapus tanda `fixing`.
+    - Di `task/task_list.md`, tambahkan baris log baru di bawah 'Status Logs:' pada task yang sesuai: '- Ready to Test: [YYYY-MM-DD HH:MM] (Fixer Agent)'. Update juga 'Current Status'., hapus tanda `fixing`.
     - Di file detail task `task/[TASK-ID]_[nama-task]/[TASK-ID]_[nama-task].md`, **APPEND** entry baru ke Status Log:
       ```
       | [YYYY-MM-DD HH:MM] | fixer agent | fix complete, ready to test | [ringkasan perbaikan] |
@@ -66,5 +71,14 @@
 
 **INPUT USER:**
 "Perbaiki masalah ini: [DESKRIPSI ERROR/BUG] pada fitur [NAMA FITUR/SPEC]"
+## Work Depth
+> 📎 Baca level aktif di `project_overview.md` → `WORK_DEPTH`. Detail: `agent/workflows/_shared/work-depth.md`
+
+| Level | Behavior |
+|-------|----------|
+| **fast** | Fix bug yang dilaporkan saja, minimal regression check |
+| **standard** | Fix + root cause analysis + update unit test yang gagal |
+| **deep** | + Cek apakah ada bug serupa di tempat lain, full regression test |
+
 ## State Management
 > 📎 **BACA DAN IKUTI** panduan di `agent/workflows/_shared/state-management.md`